安装OpenClaw后,通过聊天工具(如WhatsApp和Telegram)与你的本地AI助手交互是最方便的方式。Telegram设置最简单(只需Bot Token),WhatsApp则通过扫描二维码连接(类似WhatsApp Web)。

本教程基于OpenClaw官方文档(docs.openclaw.ai)和最新社区实践,所有步骤均为真实有效操作。建议先确保OpenClaw已成功安装并运行(使用 openclaw onboardopenclaw 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