NanoClaw

概述

NanoClaw 是一款运行在容器中的个人 AI 代理，专为轻量级、安全可控的自动化场景设计。它支持 WhatsApp、Telegram 等主流即时通讯平台，允许用户通过配置文件定制 AI 行为与交互逻辑。

学完本教程后，你将能够：

• 在本地或服务器上快速部署 NanoClaw 容器
• 将 AI 代理接入 WhatsApp 或 Telegram 账号
• 自定义代理的回复规则、角色设定与触发关键词
• 实现消息自动回复、信息摘要、任务提醒等基础功能

前置条件

• 一台运行 Linux 或 macOS 的机器（Windows 建议使用 WSL2）
• 已安装 Docker（版本 20.10+）与 Docker Compose（版本 2.0+）
• 一个 Telegram Bot Token 或 WhatsApp Business API 账号
• 基础命令行操作能力

分步操作

1. 拉取 NanoClaw 镜像

docker pull nanoclaw/nanoclaw:latest

2. 创建配置文件

在项目目录下新建 config.yaml，内容如下：

platform: telegram  # 可选 telegram / whatsapp
bot_token: "YOUR_BOT_TOKEN_HERE"
agent:
  name: "助手"
  system_prompt: "你是一个友好的个人助理，用中文回复，回答简洁。"
  temperature: 0.7
  max_tokens: 150

注意： bot_token 需替换为真实值。WhatsApp 用户需额外填写 API Key 与 Phone Number ID。

3. 启动容器

docker run -d \
  --name nanoclaw \
  -v $(pwd)/config.yaml:/app/config.yaml \
  -p 8080:8080 \
  nanoclaw/nanoclaw:latest

预期结果：终端无报错，容器状态为 Up。可通过 docker logs nanoclaw 查看启动日志，确认 Connected to [platform] 字样。

4. 测试代理功能

• Telegram：向你的 Bot 发送 /start，应收到预设问候语。
• WhatsApp：向绑定号码发送任意消息，代理应在 3 秒内回复。

常见问题与排查

下一步

• 在 config.yaml 中增加 commands 字段，定义自定义指令（如 /weather）
• 使用 filters 字段限制代理仅响应特定群组或关键词
• 集成外部 API（如天气、日历），通过 tools 配置扩展能力