nanobot-rs

中文文档: README.md

nanobot-rs is a complete Rust port of the original nanobot, designed to preserve the original workflow and toolchain while improving stability for concurrency and deployment.

Features

• Agent loop: LLM calls, tool execution, session context, and error handling
• Config system: ~/.nanobot/config.json with provider auto-matching
• Session and memory: JSONL session persistence + memory/MEMORY.md
• Tooling:
  • read_file / write_file / edit_file / list_dir
  • exec
  • web_search / web_fetch
  • message / spawn / cron
• Scheduling and heartbeat:
  • CronService (add/list/remove/enable/run + persistence)
  • HeartbeatService
• Multi-channel support:
  • Telegram (long polling, media download, voice transcription)
  • Discord (Gateway + REST, with typing indicator)
  • WhatsApp (Node bridge)
  • Feishu (REST send; optional WebSocket receive feature)
  • DingTalk (optional Stream receive feature)
• Built-in skills synced from the original project (skills/*)

Requirements

• Rust stable (recommended 1.85+)
• Optional:
  • Node.js 18+ (for WhatsApp bridge login)
  • Brave Search API key (web_search)
  • Groq API key (audio transcription)

Quick Start

1. Initialize

cargo run -- onboard

2. Configure API key

Edit ~/.nanobot/config.json:

{
  "providers": {
    "openai": {
      "apiKey": "sk-xxx"
    },
    "openrouter": {
      "apiKey": "sk-or-xxx",
      "extraHeaders": {
        "HTTP-Referer": "https://example.com",
        "X-Title": "nanobot-rs"
      }
    }
  },
  "agents": {
    "defaults": {
      "model": "gpt-4o-mini"
    }
  }
}

If you use DingTalk, add this under channels:

{
  "channels": {
    "dingtalk": {
      "enabled": true,
      "clientId": "dingxxx",
      "clientSecret": "secretxxx",
      "allowFrom": []
    }
  }
}

3. Chat directly

cargo run -- agent -m "Hello"

4. Start gateway

cargo run -- gateway

Common Commands

# Status and version
cargo run -- status
cargo run -- version

# Interactive mode
cargo run -- agent

# Channels
cargo run -- channels status
cargo run -- channels login

# Cron jobs
cargo run -- cron list
cargo run -- cron add -n daily -m "Good morning" --cron "0 9 * * *"
cargo run -- cron enable <job_id>
cargo run -- cron run <job_id>
cargo run -- cron remove <job_id>

Feishu WebSocket Receive

Default build supports Feishu sending. To enable Feishu WebSocket receive:

cargo run --features feishu-websocket -- gateway

DingTalk Stream Receive

Default builds do not include DingTalk Stream. Enable it with:

cargo run --features dingtalk-stream -- gateway

WhatsApp Login

channels login will automatically:

• Prepare ~/.nanobot/bridge
• Run npm install
• Run npm run build
• Start bridge and print QR login flow in terminal

Development

cargo fmt
cargo test
cargo check --features feishu-websocket
cargo check --features dingtalk-stream

License

MIT