💬 消息渠道配置
OpenClaw 支持多种聊天渠道,一个 Gateway 可以同时连接多个渠道。
Telegram 机器人接入(详细步骤)🌟
Telegram 是最推荐的渠道,配置简单且功能完整。
第一步:创建 Telegram Bot
- 打开 Telegram,搜索 @BotFather(注意验证蓝色勾)
- 发送
/newbot - 按提示输入机器人名称(如
My OpenClaw Bot) - 输入用户名(必须以
bot结尾,如my_openclaw_bot) - 复制 Bot Token(形如
123456789:ABCdefGHIjklMNO)
💡 提示: 可选设置(在 @BotFather 中):
-
-
-
/setprivacy → Disable(让 Bot 能看到群聊所有消息)-
/setjoingroups → Enable(允许添加到群组)第二步:配置 OpenClaw
// ~/.openclaw/openclaw.json
{
channels: {
telegram: {
enabled: true,
botToken: "123456789:ABCdefGHIjklMNO",
dmPolicy: "pairing", // 首次聊天需要配对码
groups: {
"*": { requireMention: true }, // 群组中需要 @机器人
},
},
},
}
或者用环境变量:
echo "TELEGRAM_BOT_TOKEN=123456789:ABCdefGHIjklMNO" >> ~/.openclaw/.env
第三步:重启 Gateway 并配对
openclaw gateway restart
然后在 Telegram 中给你的 Bot 发消息,会收到一个配对码。用命令批准:
# 查看待配对列表
openclaw pairing list telegram
# 批准配对
openclaw pairing approve telegram <配对码>
⚠️ Telegram 常见问题
| 问题 | 解决方案 |
|---|---|
| Bot 不回复 | 检查 Token 是否正确,Gateway 是否运行 |
| 群里不回复 | 需要 @机器人 或关闭 Privacy Mode |
| 国内连不上 | 配置代理 proxy: "socks5://127.0.0.1:7890" |
| IPv6 问题 | 在配置中加 network: { autoSelectFamily: false } |
Telegram 进阶配置
{
channels: {
telegram: {
enabled: true,
botToken: "xxx",
dmPolicy: "pairing",
allowFrom: ["tg:你的用户ID"], // 指定允许的用户
groups: {
"*": { requireMention: true },
"-1001234567890": { // 特定群组配置
requireMention: false, // 不需要@就回复
allowFrom: ["@admin"],
},
},
streamMode: "partial", // 流式输出(打字效果)
proxy: "socks5://127.0.0.1:7890", // 代理(国内需要)
replyToMode: "first", // 回复模式
},
},
}
💡 提示: 获取你的 Telegram 用户 ID:给 Bot 发消息后运行
openclaw logs --follow,在日志中找 from.id。飞书机器人接入
第一步:创建飞书应用
- 登录 飞书开放平台
- 创建企业自建应用
- 添加「机器人」能力
- 配置权限:
im:message、im:message.group_at_msg、im:chat - 发布应用
第二步:配置事件订阅
⚠️ 这一步很容易遗漏!
- 在应用管理中找到「事件订阅」
- 设置请求地址:
http://你的服务器IP:18789/feishu - 添加事件:
im.message.receive_v1
第三步:配置 OpenClaw
{
channels: {
feishu: {
enabled: true,
appId: "cli_xxxx",
appSecret: "xxxx",
verificationToken: "xxxx", // 事件订阅验证token
encryptKey: "xxxx", // 加密密钥(可选)
},
},
}
📖 参考: 详细教程参考:保姆级飞书对接教程
钉钉接入
配置步骤
- 登录 钉钉开放平台
- 创建应用,添加机器人
- 配置事件回调地址
阿里云用户可直接使用预置镜像,内置钉钉对接功能。
Discord 接入
第一步:创建 Discord Bot
- 登录 Discord Developer Portal
- New Application → 创建应用
- Bot → Add Bot → 复制 Token
- 开启
MESSAGE CONTENT INTENT - 生成邀请链接,将 Bot 添加到服务器
第二步:配置
{
channels: {
discord: {
enabled: true,
token: "你的Discord Bot Token",
dm: {
enabled: true,
policy: "pairing",
},
guilds: {
"服务器ID": {
channels: {
general: { allow: true },
},
},
},
},
},
}
WhatsApp 接入
WhatsApp 使用扫码方式连接:
{
channels: {
whatsapp: {
dmPolicy: "pairing",
allowFrom: ["+86你的手机号"],
},
},
}
启动后会在终端显示二维码,用 WhatsApp 扫码绑定。
⚠️ WhatsApp 注意事项:
- 需要一个独立手机号(不建议用主号)
- 国内使用需要代理
- 存在封号风险,谨慎使用
微信
⚠️ OpenClaw 不直接支持微信。微信对第三方 Bot 有严格限制,强行接入有封号风险。
社区方案:通过 WeCom(企业微信)或第三方桥接工具间接接入,但不推荐。
多渠道同时使用
OpenClaw 的强大之处在于一个 Gateway 可以同时连接多个渠道:
{
channels: {
telegram: {
enabled: true,
botToken: "xxx",
},
discord: {
enabled: true,
token: "xxx",
},
whatsapp: {
allowFrom: ["+86xxx"],
},
},
}
所有渠道共享同一个 Agent 和记忆系统,在 Telegram 上聊的内容,Agent 在 Discord 上也记得 ✨
下一步 → 模型配置进阶
💡 学完这章想实战?加入社群获得 $50 算力额度 + 实时答疑
加入社群 ¥49加入 Claw101 社区
解锁第 7-13 章、持续更新资源和实战交流,扫码即可加入社区。
长按识别二维码,支付后自动弹出群二维码