Hướng dẫn sử dụng Nanobot: Giải pháp thay thế OpenClaw gọn nhẹ

Nanobot là trợ lý AI cá nhân gọn nhẹ, một lựa chọn thay thế cho OpenClaw. Nó nhỏ hơn 98% so với OpenClaw trong khi vẫn cung cấp các chức năng cốt lõi tương tự. Giống như OpenClaw, Nanobot có thể chạy trên máy tính của bạn, kết nối với các ứng dụng yêu thích và, nhờ kích thước nhỏ, bạn có thể dễ dàng kiểm tra mã nguồn.

Bài viết này sẽ hướng dẫn bạn cách thiết lập Nanobot từ đầu và khám phá cách xây dựng một AI agent đầy đủ tính năng chỉ trong vài phút. Một số vấn đề cần lưu ý khi sử dụng công nghệ này cũng sẽ được đề cập.

Nanobot là gì?

Nanobot là một lựa chọn thay thế cho OpenClaw đã trở nên rất phổ biến, nhanh chóng thu hút hơn 21.000 lượt đánh giá trên GitHub tính đến thời điểm viết bài này. Giống như OpenClaw, nó hỗ trợ các nền tảng nhắn tin phổ biến như Discord, Slack và Telegram.

Giống như agent OpenClaw, agent Nanobot cũng có thể tham gia vào mạng xã hội Moltbook.

Điều kiện tiên quyết để chạy Nanobot

Để làm theo hướng dẫn này, bạn cần một vài điều cơ bản:

• Python 3.11 trở lên được cài đặt trên máy tính của bạn (Mac, Windows hoặc Linux).
• API key từ nhà cung cấp như OpenRouter, OpenAI hoặc Anthropic, hoặc thiết lập mô hình cục bộ thông qua Ollama.
• Một tài khoản Telegram (Bài viết sẽ sử dụng Telegram cho giao diện vì nó dễ thiết lập nhất).

Hướng dẫn sử dụng Nanobot từng bước: Xây dựng một "Research Agent"

Hãy cùng xây dựng một agent trong Telegram, có thể tìm kiếm trên web và ghi nhớ sở thích của bạn.

Bước 1: Cài đặt Nanobot

Cách dễ nhất để cài đặt các công cụ Python hiện nay là sử dụng pip hoặc uv, giúp chúng được tách biệt khỏi Python hệ thống của bạn. Nếu bạn không có những công cụ đó, pip tiêu chuẩn cũng hoạt động.

Mở terminal và chạy:

# run inside your env
pip install nanobot-ai 
# OR if you prefer uv
uv tool install nanobot-ai

Sau khi cài đặt xong, bạn sẽ thấy một thông báo tương tự như bên dưới:

Successfully installed nanobot-0.4.1

Bước 2: Lấy token giao diện

Để thiết lập giao diện:

• Mở Telegram và tìm kiếm @BotFather
• Nhập /newbot và làm theo hướng dẫn
• Sao chép token bạn nhận được từ BotFather
• Tiếp theo, lấy ID người dùng của bạn để đảm bảo bot chỉ chấp nhận lệnh từ bạn. Tìm kiếm @userinfobot trong Telegram và nhấn bắt đầu. Sao chép ID người dùng.

Bước 3: Khởi tạo

Chạy nanobot onboard để khởi tạo bot của bạn. Bạn sẽ thấy một thông báo tương tự như bên dưới:

✓ Created config at /Users/derrickmwiti/.nanobot/config.json
✓ Created workspace at /Users/derrickmwiti/.nanobot/workspace
  Created AGENTS.md
  Created SOUL.md
  Created USER.md
  Created memory/MEMORY.md
  Created memory/HISTORY.md
🐈 nanobot is ready!
Next steps:
  1. Add your API key to ~/.nanobot/config.json
     Get one at: https://openrouter.ai/keys
  2. Chat: nanobot agent -m "Hello!"
Want Telegram/WhatsApp? See: https://github.com/HKUDS/nanobot#-chat-apps

Bước 4: Cấu hình

Chạy lệnh bên dưới và thêm API key của nhà cung cấp mô hình bạn muốn sử dụng vào phần nhà cung cấp:

nano ~/.nanobot/config.json

Chỉnh sửa file để thêm API key của nhà cung cấp bạn đã chọn:

{
  "workspace": "./workspace",
  "providers": {
    // Option 1: OpenAI
    "openai": {
      "apiKey": "sk-YOUR-OPENAI-KEY-HERE",
      "model": "gpt-4o"
    },
    // Option 2: Anthropic (Claude)
    "anthropic": {
      "apiKey": "sk-ant-YOUR-CLAUDE-KEY-HERE",
      "model": "claude-3-5-sonnet-20240620"
    },
    // Option 3: Google Gemini
    "google": {
      "apiKey": "AIza-YOUR-GOOGLE-KEY-HERE",
      "model": "gemini-1.5-pro"
    },
    // Option 4: OpenRouter (Best for flexibility)
    "openrouter": {
      "apiKey": "sk-or-YOUR-OPENROUTER-KEY-HERE",
      "model": "nousresearch/hermes-3-llama-3.1-405b"
    },
    // Option 5: Local (Ollama or vLLM)
    "local": {
      "apiBase": "http://localhost:11434/v1",
      "apiKey": "ollama",
      "model": "llama3"
    }
  },
  "channels": {
    "telegram": {
      "enabled": true,
      "token": "YOUR_TELEGRAM_BOT_TOKEN",
      "allowFrom": ["YOUR_NUMERIC_USER_ID"]
    }
  }
}

Chỉnh sửa phần Telegram, thêm token và ID người dùng mà bạn đã nhận được trước đó. Bạn cần làm điều này để chỉ mình bạn mới có thể gửi chỉ thị cho agent của mình.

"telegram": {
      "enabled": true,
      "token": "",
      "allowFrom": [""],
      "proxy": null
}

Chỉnh sửa phần agent để phản ánh nhà cung cấp đã chọn:

"agents": {
    "defaults": {
      "workspace": "~/.nanobot/workspace",
      "model": "openai/gpt-5",
      "maxTokens": 8192,
      "temperature": 0.7,
      "maxToolIterations": 20,
      "memoryWindow": 50
    }
  }

Kiểm tra agent của bạn trên terminal:

nanobot agent -m "Hello"   

🐈 nanobot
Hi there! How can I help you today?    

Bước 5: Thiết lập Gateway

Để hoàn tất quá trình tích hợp Telegram, hãy chạy lệnh sau trong terminal:

nanobot gateway

Như bạn thấy trong các tin nhắn bên dưới, giờ bạn đã có thể thấy Telegram đã được kích hoạt:

🐈 Starting nanobot gateway on port 18790...
2026-02-13 09:59:35.405 | INFO     | nanobot.channels.manager:_init_channels:46 - Telegram channel enabled
✓ Channels enabled: telegram
✓ Heartbeat: every 30m
2026-02-13 09:59:35.406 | INFO     | nanobot.cron.service:start:154 - Cron service started with 0 jobs
2026-02-13 09:59:35.406 | INFO     | nanobot.heartbeat.service:start:81 - Heartbeat started (every 1800s)
2026-02-13 09:59:35.406 | INFO     | nanobot.agent.loop:run:116 - Agent loop started
2026-02-13 09:59:35.406 | INFO     | nanobot.channels.manager:start_all:159 - Starting telegram channel...
2026-02-13 09:59:35.406 | INFO     | nanobot.channels.manager:_dispatch_outbound:187 - Outbound dispatcher started
2026-02-13 09:59:35.411 | INFO     | nanobot.channels.telegram:start:140 - Starting Telegram bot (polling mode)...
2026-02-13 09:59:39.245 | INFO     | nanobot.channels.telegram:start:148 - Telegram bot @mwitibananabot connected
2026-02-13 09:59:39.417 | DEBUG    | nanobot.channels.telegram:start:152 - Telegram bot commands registered

Hãy truy cập Telegram và thử nghiệm:

Bạn có thể tìm hiểu cách sử dụng Claude Code của Anthropic để cải thiện quy trình phát triển phần mềm thông qua một ví dụ thực tế sử dụng thư viện Supabase Python.

Chạy Nanobot ngoại tuyến và cục bộ

Giống như OpenClaw, một trong những ưu điểm lớn nhất của Nanobot là tính riêng tư. Bạn có thể sử dụng nó mà không cần gửi bất kỳ dữ liệu nào đến bất kỳ nhà cung cấp dịch vụ đám mây nào. Vì Nanobot hỗ trợ vllm và các điểm cuối tương thích với OpenAI, bạn có thể trỏ nó đến một trình chạy mô hình cục bộ như Ollama.

• Cài đặt Ollama và chạy ollama
• Cập nhật phần provider trong config.json của bạn.

Hãy xem hướng dẫn sử dụng OpenClaw với Ollama để tìm hiểu cách xây dựng một trình phân tích dữ liệu AI hoàn toàn cục bộ bằng OpenClaw và Ollama, điều phối các quy trình làm việc nhiều bước, phân tích tập dữ liệu và tạo báo cáo trực quan, mà không cần gửi dữ liệu của bạn lên đám mây.

Kết luận

Nanobot chứng minh rằng phần mềm mạnh mẽ không nhất thiết phải cồng kềnh. Nó cung cấp các tính năng cốt lõi tương tự như OpenClaw trong khi kích thước nhỏ hơn đáng kể. Tuy nhiên, nó vẫn gặp vấn đề tương tự về bảo mật, vì vậy bạn nên thiết lập nó trong môi trường sandbox để ngăn ngừa các sự cố nghiêm trọng như mất toàn bộ dữ liệu trên ổ cứng.