安装OpenClaw后,通过聊天工具(如WhatsApp和Telegram)与你的本地AI助手交互是最方便的方式。Telegram设置最简单(只需Bot Token),WhatsApp则通过扫描二维码连接(类似WhatsApp Web)。
本教程基于OpenClaw官方文档(docs.openclaw.ai)和最新社区实践,所有步骤均为真实有效操作。建议先确保OpenClaw已成功安装并运行(使用 openclaw onboard 或 openclaw dashboard 打开仪表盘)。
一、准备工作
1. 确认OpenClaw网关(Gateway)正在运行:
openclaw status
2. 打开本地仪表盘查看状态(通常 http://localhost:18789)。
3. 推荐先连接Telegram(最快),再添加WhatsApp。
二、连接Telegram(最简单,3-5分钟)
步骤1:创建Telegram Bot
1. 在Telegram中搜索并打开 @BotFather。
2. 发送命令:/newbot
3. 按照提示给Bot起一个名称和用户名(用户名必须以 bot 结尾,例如 MyClawBot)。
4. BotFather会返回一个 API Token(格式类似 7123456789:AAFxxxxxxxxxxxxxxxxxxxxxxxxxxxxx),复制保存好。
步骤2:将Token添加到OpenClaw
推荐方式:
在终端运行交互命令添加频道:
openclaw channels add
选择 Telegram,粘贴刚才的Bot Token。
或者通过仪表盘(Dashboard)→ Channels → 添加Telegram,输入Token。
步骤3:配对(Pairing)你的账号
1. 在Telegram中搜索你刚创建的Bot,打开聊天,发送 /start。
2. Bot会回复一个配对码(Pairing Code)。
3. 在OpenClaw终端中批准配对:
openclaw pairing approve telegram YOUR_CODE_HERE
4. 配置安全策略(推荐):
- dmPolicy: pairing 或 allowlist(仅允许特定用户ID)
- 获取你的Telegram User ID:发送消息给 @userinfobot 即可查看。
现在,你可以在Telegram中直接和OpenClaw聊天,例如发送“你好”测试。
三、连接WhatsApp(推荐使用独立号码)
步骤1:添加WhatsApp频道
在终端运行:
openclaw channels add
选择 WhatsApp,系统会提示安装WhatsApp插件(如果未安装,会自动处理)。
或者在仪表盘中添加WhatsApp频道。
步骤2:扫描二维码配对
1. OpenClaw会生成一个二维码或配对链接。
2. 在手机上打开WhatsApp → 设置 → 已链接设备 → 链接设备。
3. 扫描OpenClaw显示的二维码。
4. 等待连接成功(会显示“已连接”或类似提示)。
重要提示: 推荐使用一个专用的WhatsApp号码,避免影响你的个人账号。会话凭证会本地存储在你的设备上。
步骤3:配置安全策略
在配置文件或仪表盘中设置:
- allowFrom:只允许特定手机号码(E.164格式,例如 +861234567890)
- ackReaction:收到消息时的自动回复表情(如 👀)
现在,你可以在WhatsApp中直接给OpenClaw发消息,它会像真人一样回复并执行任务。
四、测试与多渠道同时使用
1. 在Telegram或WhatsApp中发送简单消息测试,例如:
- “你好”
- “今天天气怎么样”
- “帮我搜索最新新闻”
2. 打开OpenClaw仪表盘,查看所有渠道的对话记录(支持多渠道同时在线)。
3. 检查日志确认无误:
openclaw logs
五、常见问题与注意事项
- Telegram无回复:检查Bot Token是否正确、是否批准配对、dmPolicy是否设置为allowlist。
- WhatsApp二维码失效:重新运行
openclaw channels add whatsapp生成新二维码;确保使用Node.js环境而非Bun。 - WhatsApp被封风险:使用独立号码、避免高频操作;OpenClaw使用WhatsApp Web协议,相对安全,但仍需谨慎。
- 多渠道共存:可以同时连接Telegram + WhatsApp + Discord,所有消息统一由OpenClaw处理。
- 更新配置:修改后重启网关
openclaw restart或通过daemon自动重载。 - 防火墙/端口问题:确保OpenClaw能正常访问互联网。
遇到错误时,运行 openclaw doctor 检查,或查看官方文档对应频道页面。
六、进阶设置
1. 配置群组消息:设置mention-only(仅@机器人时响应)。
2. 安全加固:使用allowlist限制只有自己能使用。
3. 多设备:Telegram支持多端登录,WhatsApp可链接多个设备。
4. 完全本地化:结合Ollama模型,实现零云费用运行。
总结
通过以上步骤,你就能让OpenClaw完美接入Telegram(最快)和WhatsApp(最常用),随时随地通过手机控制你的本地AI助手。Telegram适合快速上手,WhatsApp适合日常主力使用。
连接成功后,OpenClaw不再只是聊天工具,而是能真正帮你执行任务的私人助理。
安装或连接过程中遇到问题,欢迎在评论区贴出错误信息,我可以帮你进一步排查!
官方参考链接:
Telegram频道文档:https://docs.openclaw.ai/channels/telegram
WhatsApp频道文档:https://docs.openclaw.ai/channels/whatsapp
完整文档:https://docs.openclaw.ai/
GitHub:https://github.com/openclaw/openclaw