**ナノボット：オープンクローに代わる超軽量な選択肢**

🐈 nanobot
Clawdbot からインスパイアされた超軽量個人 AI アシスタント。

⚡️ 約 4,000 行のコードで実装 – Clawdbot の 430k+ 行に対し 99 % 小さくなっています。

📢 ニュース

主な特徴

• 🪶 超軽量 – 約 4,000 行、Clawdbot より 99 % 小さいコードベース。
• 🔬 研究向け – クリーンで読みやすく、研究者が簡単に理解・修正・拡張できる設計。
• ⚡️ 高速起動 – 軽量化により起動速度が速く、リソース使用も抑えられます。
• 💎 使いやすい – ワンクリックでデプロイ可能。

アーキテクチャ

✨ 主要機能

• 発見 • 洞察 • トレンド
• 開発 • デプロイ • 拡張
• スケジュール • 自動化 • 整理
• 学習 • 記憶 • 推論

インストール

ソースから（最新機能、開発推奨）

git clone https://github.com/HKUDS/nanobot.git
cd nanobot
pip install -e .

uv

で（安定版・高速）

uv tool install nanobot-ai

PyPI から（安定版）

pip install nanobot-ai

クイックスタート

1. Tip: API キーを

   ~/.nanobot/config.json

   に設定します。
   API キー取得: OpenRouter (LLM) · Brave Search (任意、ウェブ検索)。
   コスト削減のために

   minimax/minimax-m2

   モデルへ切り替えることも可能です。

2. 初期化

   nanobot onboard
   

3. 設定 (

   ~/.nanobot/config.json

   )

   {
     "providers": {
       "openrouter": { "apiKey": "sk-or-v1-xxx" }
     },
     "agents": {
       "defaults": { "model": "anthropic/claude-opus-4-5" }
     },
     "tools": {
       "web": {
         "search": { "apiKey": "BSA-xxx" }
       }
     }
   }
   

4. チャット

   nanobot agent -m "What is 2+2?"
   

   完了！わずか 2 分で動作する AI アシスタントが手に入ります。

ローカルモデル（vLLM）

自前のローカル LLM を vLLM や OpenAI 互換サーバー経由で利用できます。

1. vLLM サーバー起動

   vllm serve meta-llama/Llama-3.1-8B-Instruct --port 8000
   

2. 設定 (

   ~/.nanobot/config.json

   )

   {
     "providers": { "vllm": { "apiKey": "dummy", "apiBase": "http://localhost:8000/v1" } },
     "agents": { "defaults": { "model": "meta-llama/Llama-3.1-8B-Instruct" } }
   }
   

3. チャット

   nanobot agent -m "Hello from my local LLM!"
   

Tip: ローカルサーバーは認証不要のため、

apiKey

は空でなく任意文字列で構いません。

チャットアプリ

Telegram・WhatsApp・Feishu などを通じていつでもどこでも nanobot と対話できます。

チャンネル設定

Telegram（推奨）

1. ボット作成
   Telegram →

   @BotFather

   を検索 →

   /newbot

   → 指示に従いトークンを取得。

2. 設定

   {
     "channels": { "telegram": { "enabled": true, "token": "YOUR_BOT_TOKEN", "allowFrom": ["YOUR_USER_ID"] } }
   }
   

   ユーザー ID は

   @userinfobot

   で取得。

3. 起動

   nanobot gateway
   

WhatsApp

1. Node.js ≥18 が必要。
2. デバイスをリンク

   nanobot channels login
   # QR をスキャン（WhatsApp → 設定 → 連携済みデバイス）
   

3. 設定

   {
     "channels": { "whatsapp": { "enabled": true, "allowFrom": ["+1234567890"] } }
   }
   

4. 起動（2 つのターミナルで実行）

   # ターミナル 1
   nanobot channels login
   
   # ターミナル 2
   nanobot gateway
   

Feishu (飛書)

WebSocket 長接続を利用し、パブリック IP は不要です。

pip install nanobot-ai[feishu]

1. Feishu ボット作成
   Feishu Open Platform → 新規アプリ → Bot 機能を有効化。
   権限:

   im:message

   （送信）。
   イベント:

   im.message.receive_v1

   （受信）。
   長接続モードを選択し、nanobot を先に起動して接続を確立。

2. App ID と Secret を「認証情報 & 基本情報」から取得し、公開。

3. 設定

   {
     "channels": {
       "feishu": {
         "enabled": true,
         "appId": "cli_xxx",
         "appSecret": "xxx",
         "encryptKey": "",
         "verificationToken": "",
         "allowFrom": []
       }
     }
   }
   

   Tip:

   encryptKey

   と

   verificationToken

   は長接続モードでは任意。
   

   allowFrom

   : 空なら全ユーザー許可、特定 ID を追加可能。

4. 起動

   nanobot gateway
   

⚙️ 設定

設定ファイル:

~/.nanobot/config.json

プロバイダー

完全設定例

{
  "agents": { "defaults": { "model": "anthropic/claude-opus-4-5" } },
  "providers": {
    "openrouter": { "apiKey": "sk-or-v1-xxx" },
    "groq": { "apiKey": "gsk_xxx" }
  },
  "channels": {
    "telegram": { "enabled": true, "token": "123456:ABC...", "allowFrom": ["123456789"] },
    "whatsapp": { "enabled": false },
    "feishu": { "enabled": false, "appId": "cli_xxx", "appSecret": "xxx", "encryptKey": "", "verificationToken": "", "allowFrom": [] }
  },
  "tools": {
    "web": { "search": { "apiKey": "BSA..." } }
  }
}

CLI リファレンス

nanobot onboard

nanobot agent -m "…"

nanobot agent

nanobot gateway

nanobot status

nanobot channels login

nanobot channels status

定期タスク (Cron)

# 仕事を追加
nanobot cron add --name "daily" --message "Good morning!" --cron "0 9 * * *"
nanobot cron add --name "hourly" --message "Check status" --every 3600

# 仕事一覧
nanobot cron list

# 仕事削除
nanobot cron remove <job_id>

🐳 Docker

Tip:

-v ~/.nanobot:/root/.nanobot

をマウントすると、コンテナ再起動時に設定とワークスペースを保持できます。

# イメージビルド
docker build -t nanobot .

# 初回のみ設定初期化
docker run -v ~/.nanobot:/root/.nanobot --rm nanobot onboard

# ホスト上で config を編集して API キー追加
vim ~/.nanobot/config.json

# ゲートウェイ起動（Telegram/WhatsApp 接続）
docker run -v ~/.nanobot:/root/.nanobot -p 18790:18790 nanobot gateway

# 単一コマンド実行例
docker run -v ~/.nanobot:/root/.nanobot --rm nanobot agent -m "Hello!"
docker run -v ~/.nanobot:/root/.nanobot --rm nanobot status

📁 プロジェクト構成

nanobot/
├── agent/          # コアエージェントロジック
│   ├── loop.py     # エージェントループ (LLM ↔ ツール実行)
│   ├── context.py  # プロンプトビルダー
│   ├── memory.py   # 永続メモリ
│   ├── skills.py   # スキルローダー
│   ├── subagent.py # バックグラウンドタスク実行
│   └── tools/      # 内蔵ツール (spawn など)
├── skills/         # 標準スキル（github, weather, tmux…）
├── channels/       # WhatsApp 統合
├── bus/            # メッセージルーティング
├── cron/           # 定期タスク
├── heartbeat/      # プロアクティブな起動
├── providers/      # LLM プロバイダー (OpenRouter など)
├── session/        # 会話セッション
├── config/         # 設定ファイル
└── cli/            # コマンド実装

🤝 貢献 & ロードマップ

PR 歓迎です！コードベースは意図的に小さく読みやすい構成になっています。

ロードマップ

• 音声認識 – Groq Whisper 対応（Issue #13）
• マルチモーダル – 画像・音声・動画を見て聞けるように
• 長期メモリ – 重要な文脈を忘れない設計
• 推論強化 – 多段階計画と反省機能
• 拡張統合 – Discord, Slack, メール, カレンダー
• 自己改善 – フィードバックと失敗から学ぶ仕組み

⭐ Star History（ビジュアルタイムラインは省略）

ご覧いただきありがとうございます ✨ nanobot！
nanobot は教育・研究・技術交流のみに使用してください。