OpenClaw WhatsApp / Telegram 接入指南

📋 支持的聊天渠道

OpenClaw 支持多种聊天平台，可以通过 Gateway 网关统一连接：

• WhatsApp – 最受欢迎，需要二维码配对
• Telegram – 最简单的设置，只需 Bot Token
• Discord – 服务器和频道支持
• iMessage – 通过 BlueBubbles
• Signal – 注重隐私
• Slack – 企业工作区

📱 WhatsApp 接入

快速开始

openclaw channels login

运行命令后会显示二维码，用手机 WhatsApp 扫描即可。

配置白名单

{  "channels": {    "whatsapp": {      "allowFrom": ["+15555550123"],      "groups": { "*": { "requireMention": true } }    }  }}

自聊天模式

如果你想在个人 WhatsApp 上使用：

{  "channels": {    "whatsapp": {      "selfChatMode": true,      "dmPolicy": "allowlist",      "allowFrom": ["+你的手机号"]    }  }}

✈️ Telegram 接入

创建 Bot

1. 在 Telegram 中搜索 @BotFather
2. 发送 /newbot
3. 设置 Bot 名称和用户名
4. 复制获得的 Bot Token

连接 OpenClaw

openclaw channels login --channel telegram

或手动配置：

{  "channels": {    "telegram": {      "botToken": "your-bot-token"    }  }}

基本配置

{  "channels": {    "telegram": {      "blockStreaming": false,      "streamMode": "partial"    }  }}

🔒 安全设置

私信策略

• open – 允许所有人
• allowlist – 仅白名单用户
• pairing – 需要配对批准

群组配置

{  "messages": {    "groupChat": {      "mentionPatterns": ["@openclaw"]    }  }}

⚠️ 常见问题

WhatsApp 被登出

openclaw channels logout
openclaw channels login --verbose

消息未触发

1. 检查发送者是否在白名单中
2. 群聊是否需要 @提及
3. 查看日志：openclaw logs --follow

配对码未到达

openclaw pairing list <channel>

每个渠道最多 3 个待处理配对请求。

🔧 调试命令

# 检查渠道状态openclaw channels status

# 探测运行中的渠道openclaw channels status --probe

# 查看连接日志openclaw logs --follow | grep "connection\|disconnect"

🔗 相关资源

• WhatsApp 详细配置
• Telegram 详细配置
• 渠道故障排除