Tutorial Nanobot: Alternatif OpenClaw yang Ringkas

Nanobot adalah asisten AI personal yang ringan, alternatif untuk OpenClaw. Ukurannya 98% lebih kecil daripada OpenClaw namun tetap menghadirkan fungsionalitas inti agen yang sama. Sama seperti OpenClaw, Nanobot dapat berjalan di mesin Anda, terhubung ke aplikasi favorit Anda, dan karena ukurannya kecil, Anda dapat dengan mudah memeriksa kodenya. 

Nanobot menghubungkan model sumber tertutup dan sumber terbuka favorit Anda untuk menjalankan agen pengodean lokal. Setelah Anda mengirim pesan melalui Telegram, WhatsApp, atau terminal, agen merespons dengan menjalankan perintah di mesin Anda, seperti membaca log, mengeksekusi skrip, dan mencari file. 

Dalam tutorial ini, saya akan menunjukkan cara menyiapkan Nanobot dari awal dan menjelajahi cara membangun agen AI berfitur lengkap dalam beberapa menit. Saya juga akan membahas beberapa hal jebakan yang perlu Anda waspadai saat menggunakan teknologi ini. 

Apa Itu Nanobot?

Nanobot adalah alternatif OpenClaw yang menjadi begitu populer, dengan cepat meraih lebih dari 21.000 bintang GitHub saat tulisan ini dibuat. Seperti OpenClaw, Nanobot mendukung platform perpesanan populer seperti Discord, Slack, dan Telegram. 

Sama seperti agen OpenClaw, agen Nanobot Anda juga dapat ikut meramaikan media sosial di Moltbook, seperti yang kami tunjukkan dalam tutorial Memulai dengan Moltbook kami. 

Kemampuan utama Nanobot

Meski kecil, Nanobot mencakup tiga hal utama yang Anda butuhkan dari agen yang andal: 

• Memori Berkeadaan (Stateful Memory): Nanobot membangun graf lokal dari riwayat Anda. Artinya, jika hari ini Anda mengerjakan proyek analisis data Python, seminggu kemudian ia masih akan mengetahuinya. 
• Agnostik Model: Anda tidak terkunci pada penyedia model tertentu. Anda dapat menggunakan model dari OpenAI, Anthropic, atau bahkan model lokal yang berjalan di perangkat keras Anda sendiri. 
• Antarmuka Instan: Nanobot dapat digunakan di aplikasi perpesanan favorit Anda, sehingga Anda tetap menggunakan antarmuka yang sudah Anda kenal. 

Prasyarat Menjalankan Nanobot

Untuk mengikuti tutorial ini, Anda memerlukan beberapa hal dasar:

• Python 3.11 atau lebih tinggi terpasang di komputer Anda (Mac, Windows, atau Linux).
• Kunci API dari penyedia seperti OpenRouter, OpenAI, atau Anthropic, atau siapkan model lokal melalui Ollama.
• Akun Telegram (Saya akan menggunakan Telegram sebagai antarmuka karena paling mudah disiapkan).

Tutorial Nanobot Langkah demi Langkah: Membangun "Agen Riset"

Mari kita bangun agen yang hidup di Telegram Anda, dapat menelusuri web, dan mengingat minat Anda.

Langkah 1: Instal Nanobot

Cara terbersih untuk memasang alat Python saat ini adalah menggunakan pip atau uv, yang menjaga alat tersebut terisolasi dari Python sistem Anda. Jika Anda tidak memilikinya, pip standar juga berfungsi.

Buka terminal Anda dan jalankan:

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

Setelah terpasang, Anda akan melihat pesan seperti di bawah ini:

Successfully installed nanobot-0.4.1

Langkah 2: Dapatkan Token Antarmuka Anda

Untuk menyiapkan antarmuka:

• Buka Telegram dan cari @BotFather 
• Ketik /newbot dan ikuti petunjuknya 
• Salin token yang Anda dapatkan dari BotFather 
• Selanjutnya, dapatkan ID pengguna Anda agar bot hanya menerima perintah dari Anda. Cari @userinfobot di Telegram dan klik start. Salin ID pengguna tersebut. 

Langkah 3: Inisialisasi 

Jalankan nanobot onboard untuk menginisialisasi bot Anda. Anda akan melihat pesan serupa dengan yang ada di bawah ini:

✓ 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

Langkah 4: Konfigurasi

Jalankan perintah di bawah ini dan tambahkan kunci API untuk penyedia model yang ingin Anda gunakan pada bagian providers: 

nano ~/.nanobot/config.json

Edit file untuk menambahkan kunci API ke penyedia pilihan Anda:

{
  "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"]
    }
  }
}

Edit bagian Telegram dan tambahkan token serta ID pengguna yang Anda peroleh sebelumnya. Anda perlu melakukan ini agar hanya Anda yang dapat mengirim instruksi ke agen Anda. 

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

   Ubah bagian agents agar mencerminkan penyedia yang dipilih:

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

Uji agen Anda di terminal:

nanobot agent -m "Hello"   

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

Langkah 5: Siapkan Gateway

Untuk menyelesaikan integrasi Telegram, jalankan perintah di bawah ini di terminal: 

nanobot gateway

Sekarang Anda akan melihat bahwa Telegram sudah diaktifkan, seperti yang terlihat dari pesan saya di bawah ini: 

🐈 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

Buka Telegram dan uji: 

Anda dapat mempelajari cara menggunakan Claude Code dari Anthropic untuk meningkatkan alur kerja pengembangan perangkat lunak melalui contoh praktis menggunakan pustaka Supabase Python dari tutorial Claude Code kami. 

Meningkatkan Nanobot: Agen "Multi-Tool"

Sekarang penyiapan sudah selesai, saatnya membuat agen Anda lebih fungsional. Kebanyakan model hanya memiliki informasi hingga tanggal cut-off data pelatihannya. Kita dapat membuatnya lebih fungsional dengan menghubungkannya ke internet.

Nanobot mendukung Model Context Protocol (MCP), yang menambahkan kapabilitas ke agen Anda, seperti penelusuran web atau kueri basis data. Mari tambahkan Brave Search Server yang akan memungkinkan agen kita mengakses internet:

1. Dapatkan kunci API dari Brave
2. Perbarui konfigurasi dengan kunci tersebut

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

Mulai ulang gateway Anda.

Sekarang di Telegram, ajukan pertanyaan seperti “Berapa harga saham Apple saat ini?” Di terminal, Anda dapat melihat bahwa ia benar-benar menelusuri 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...

Lokal dan Privat: Menjalankan Nanobot Secara Luring

Seperti OpenClaw, salah satu keunggulan utama Nanobot adalah privasi. Anda dapat menggunakannya tanpa mengirim data apa pun ke penyedia cloud mana pun. Karena Nanobot mendukung vllm dan endpoint yang kompatibel dengan OpenAI, Anda dapat mengarahkannya ke pengelola model lokal seperti Ollama. 

1. Instal Ollama dan jalankan ollama
2. Perbarui bagian provider pada config.json Anda (lihat contoh "local" pada Langkah 4 di atas).

Lihat tutorial Menggunakan OpenClaw dengan Ollama kami untuk mempelajari cara membangun analis data AI sepenuhnya lokal menggunakan OpenClaw dan Ollama yang mengorkestrasi alur kerja multi-langkah, menganalisis dataset, dan menghasilkan laporan visual, tanpa mengirim data Anda ke cloud.

Kendala Umum Nanobot dan Pemecahan Masalah

Bahkan dengan alat sederhana seperti Nanobot, hal-hal bisa saja salah. Berikut beberapa masalah yang kemungkinan Anda hadapi dan cara mengatasinya. 

Galat connection refused

Jika Anda mencoba menjalankan Nanobot di server tetapi mencoba mengakses model lokal, Anda akan mendapatkan galat connection refused. Ini karena server daring tidak dapat mengakses komputer lokal Anda. 

Untuk mengatasinya, pastikan model open-source juga berjalan di server yang sama atau gunakan sesuatu seperti ngrok untuk menjembatani koneksi. 

Batas jendela konteks

Model lokal sering kali memiliki batas memori (context window) yang lebih kecil. Bahkan model berbasis cloud pun memiliki jendela konteks terbatas. Karena Nanobot menyimpan memorinya sebagai file sederhana, cara terbaik untuk "mereset" otaknya adalah dengan menghapus secara manual file memori di dalam folder ./workspace Anda. 

Sebagai alternatif, cukup beralih ke model dengan jendela konteks yang lebih besar, seperti gemini-1.5-pro atau Claude Opus 4.6.

Kesimpulan

Nanobot membuktikan bahwa perangkat lunak yang kuat tidak harus besar. Ia menyediakan fitur inti yang sama seperti OpenClaw namun tetap jauh lebih kecil. Namun, Nanobot masih membawa masalah yang sama terkait keamanan, jadi saya menyarankan agar Anda menyiapkannya di lingkungan sandbox untuk mencegah masalah bencana seperti seluruh hard drive Anda terhapus.  

Untuk mempelajari lebih lanjut tentang bekerja dengan alat AI, saya merekomendasikan untuk melihat panduan alat AI gratis terbaik kami. Untuk keterampilan pengodean AI yang lebih luas, cobalah kursus AI-Assisted Coding for Developers kami untuk mengembangkan keterampilan yang membuat asisten AI menjadi mitra yang lebih andal dalam alur kerja pengembangan Anda. 

Anda juga dapat mempelajari cara membangun aplikasi bertenaga AI menggunakan LLM, prompt, rantai, dan agen di LangChain dari kursus Developing LLM Applications with LangChain kami.