新n8n
AI工作流自动化平台，结合代码灵活性与无代码速度。
概述
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 秒内回复。
常见问题与排查
| 问题 | 原因 | 解决 |
|---|---|---|
| 容器启动后立即退出 | 配置文件格式错误 | 检查 YAML 缩进，使用 yamlint 验证 |
| 代理不回复消息 | Token 无效或平台连接失败 | 重新生成 Token，检查网络权限 |
| 回复内容不符合预期 | system_prompt 未生效 |
重启容器，确认文件挂载路径正确 |
| 内存占用过高 | 未限制容器资源 | 添加 --memory=512m 参数 |
下一步
- 在
config.yaml中增加commands字段，定义自定义指令（如/weather） - 使用
filters字段限制代理仅响应特定群组或关键词 - 集成外部 API（如天气、日历），通过
tools配置扩展能力
数据统计
数据评估
关于NanoClaw特别声明
本站此刻AI提供的NanoClaw都来源于网络，不保证外部链接的准确性和完整性，同时，对于该外部链接的指向，不由此刻AI实际控制，在4 8 月, 2026 9:29 上午收录时，该网页上的内容，都属于合规合法，后期网页的内容如出现违规，可以直接联系网站管理员进行删除，此刻AI不承担任何责任。
