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.

Nanobot kết nối các mô hình mã nguồn mở và mã nguồn đóng yêu thích của bạn để chạy một agent lập trình cục bộ. Sau khi bạn gửi tin nhắn qua Telegram, WhatsApp hoặc terminal, agent sẽ phản hồi bằng cách chạy các lệnh trên máy tính của bạn, chẳng hạn như đọc nhật ký, thực thi script và tìm kiếm file.

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.

Các khả năng chính của Nanobot

Mặc dù nhỏ gọn, Nanobot đáp ứng 3 nhu cầu chính của một agent mạnh mẽ:

• Bộ nhớ có trạng thái: Nanobot xây dựng một đồ thị cục bộ về lịch sử của bạn. Điều đó có nghĩa là nếu bạn đang thực hiện một dự án phân tích dữ liệu Python hôm nay, nó vẫn sẽ nhớ điều này ngay cả một tuần sau.
• Không phụ thuộc vào mô hình: Bạn không bị ràng buộc bởi bất kỳ nhà cung cấp mô hình cụ thể nào. Bạn có thể sử dụng mô hình của OpenAI, Anthropic, hoặc thậm chí là các mô hình cục bộ chạy trên phần cứng của riêng bạn.
• Giao diện người dùng tức thời: Nanobot có thể được sử dụng trong các ứng dụng nhắn tin yêu thích của bạn, có nghĩa là bạn tiếp tục sử dụng giao diện mà bạn đã quen thuộc.

Đ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.

Nâng cấp Nanobot: Agent "đa năng"

Bây giờ quá trình thiết lập đã hoàn tất, đã đến lúc làm cho agent của bạn hoạt động hiệu quả hơn. Hầu hết các mô hình chỉ có thông tin đến ngày kết thúc của dữ liệu huấn luyện. Chúng ta có thể làm cho nó hoạt động hiệu quả hơn bằng cách kết nối nó với Internet.

Nanobot hỗ trợ Model Context Protocol (MCP), bổ sung các khả năng cho agent của bạn, chẳng hạn như tìm kiếm trên web hoặc truy vấn cơ sở dữ liệu. Hãy thêm Brave Search Server để cho phép agent truy cập Internet:

1. Lấy API key từ Brave
2. Cập nhật cấu hình với key đó

"tools": {
    "web": {
      "search": {
        "apiKey": "",
        "maxResults": 5
      }
    },
    "exec": {
      "timeout": 60
    },
    "restrictToWorkspace": false
  }

Khởi động lại gateway của bạn.

Bây giờ, trong Telegram, hãy đặt câu hỏi như “Giá cổ phiếu Apple hiện tại là bao nhiêu?” Trên cửa sổ terminal, bạn có thể thấy nó thực sự đang tìm kiếm trên web:

2026-02-13 10:14:48.753 | INFO     | nanobot.agent.loop:_process_message:164 - Processing message from telegram:7045522516: What is the current price of the Apple Stock
2026-02-13 10:14:59.726 | INFO     | nanobot.agent.loop:_process_message:246 - Tool call: web_search({"query": "AAPL stock price Yahoo Finance", "count": 5})
2026-02-13 10:15:22.066 | INFO     | nanobot.agent.loop:_process_message:246 - Tool call: web_fetch({"url": "https://finance.yahoo.com/quote/AAPL/", "extractMode": "text", "maxChars": 20000})
2026-02-13 10:15:26.886 | INFO     | nanobot.agent.loop:_process_message:246 - Tool call: web_fetch({"url": "https://www.google.com/finance/quote/AAPL:NASDAQ", "extractMode": "text", "maxChars": 20000})
2026-02-13 10:15:51.361 | INFO     | nanobot.agent.loop:_process_message:246 - Tool call: web_fetch({"url": "https://query1.finance.yahoo.com/v7/finance/quote?symbols=AAPL", "extractMode": "text", "maxChars": 20000})
2026-02-13 10:15:52.018 | INFO     | nanobot.agent.loop:_process_message:246 - Tool call: web_fetch({"url": "https://query2.finance.yahoo.com/v10/finance/quoteSummary/AAPL?modules=price", "extractMode": "text", "maxChars": 20000})
2026-02-13 10:16:07.071 | INFO     | nanobot.agent.loop:_process_message:246 - Tool call: web_fetch({"url": "https://www.marketwatch.com/investing/stock/aapl", "extractMode": "text", "maxChars": 20000})
2026-02-13 10:16:07.406 | INFO     | nanobot.agent.loop:_process_message:246 - Tool call: web_fetch({"url": "https://finviz.com/quote.ashx?t=AAPL", "extractMode": "text", "maxChars": 20000})
2026-02-13 10:16:35.897 | INFO     | nanobot.agent.loop:_process_message:246 - Tool call: web_fetch({"url": "https://financialmodelingprep.com/api/v3/quote/AAPL?apikey=demo", "extractMode": "text", "maxChars": 20000})
2026-02-13 10:16:36.919 | INFO     | nanobot.agent.loop:_process_message:246 - Tool call: web_fetch({"url": "https://stooq.com/q/l/?s=aapl.us&i=5", "extractMode": "text", "maxChars": 20000})
2026-02-13 10:17:14.870 | INFO     | nanobot.agent.loop:_process_message:266 - Response to telegram:7045522516: Reflection:
- JS-heavy sites (Yahoo/Google) hid the live quote; Yahoo's JSON APIs blocked (401). 
- Finviz returned a pr...

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.