📱 频道配置

让 OpenClaw 连接到你常用的聊天 App,微信-style 的 AI 助手

🎯 什么是频道?

简单来说,频道就是 OpenClaw 和你的聊天 App 之间的桥梁。 配置好频道后,你就可以在微信、Telegram、Discord 等 App 里直接跟 AI 助手聊天, 就像和朋友发消息一样简单。

💡 推荐组合:Telegram(最稳定)+ WebChat(最快体验)
🏢 企业用户:Slack(国际团队)/ 飞书(国内团队)
🎮 开发者:Discord(代码友好)
🇨🇳 国内用户:飞书(访问快、中文好)

📊 频道对比

平台 难度 适合人群 特点
💬 WhatsApp ⭐⭐ 中等 普通用户 全球最常用,手机扫码就能连,但要注意风控
✈️ Telegram ⭐ 简单 技术人员 最稳定,配置最简单,程序员首选
🎮 Discord ⭐⭐ 中等 开发者/玩家 游戏玩家首选,支持 Slash 命令,社区氛围好
💼 Slack ⭐⭐⭐ 稍复杂 企业团队 团队协作首选,适合公司内部使用
🚀 Feishu ⭐⭐ 中等 字节跳动出品,国内公司首选,功能和 Slack 很像但国内访问快
🌐 WebChat ⭐ 最简单 新手体验 无需配置,开箱即用,浏览器直接聊

📝 详细配置指南

💬

WhatsApp

全球最常用,手机扫码就能连,但要注意风控

难度: ⭐⭐

✅ 优点

  • • 用户最多
  • • 扫码即可
  • • 稳定可靠

❌ 缺点

  • • 手机离线就断连
  • • 频繁重连可能被封
  • • 需要保持手机解锁

🚀 配置步骤

1
openclaw channels login whatsapp

启动 WhatsApp 登录流程

2
# 扫描终端显示的二维码

用手机 WhatsApp 扫码

3
openclaw channels status

验证连接状态

⚙️ 配置示例

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

💡 小贴士

  • 📱 手机一定要保持 WhatsApp 在线,锁屏没关系但不要杀后台
  • 🔒 建议设置 allowFrom 白名单,防止陌生人骚扰
  • ⚠️ 如果频繁断线重连,WhatsApp 可能会临时封禁 Web 端
  • 💡 群聊建议开启 requireMention(@提及才回复),避免刷屏
✈️

Telegram

最稳定,配置最简单,程序员首选

难度: ⭐

✅ 优点

  • • 配置最简单
  • • Bot API 稳定
  • • 支持 Markdown
  • • 群组功能强大

❌ 缺点

  • • 国内需要代理
  • • 手机号可能被封

🚀 配置步骤

1
# 1. 找 @BotFather 申请 Bot

发送 /newbot 命令

2
# 2. 复制给你的 Bot Token

格式如: 123456:ABC-DEF...

3
openclaw channels login telegram

粘贴 Token 完成配置

⚙️ 配置示例

{
  "channels": {
    "telegram": {
      "token": "YOUR_BOT_TOKEN",
      "allowFrom": ["@your_username"],
      "streamMode": "on"
    }
  }
}

💡 小贴士

  • 🤖 去 @BotFather 申请 Bot,记住选个酷炫的名字
  • 🔒 一定要设置 allowFrom 或配置群组白名单,否则任何人都能用你的 Bot
  • ✨ streamMode 开启后支持打字效果,体验更好
  • 📢 支持群组和频道,群聊记得给 Bot 管理员权限
🎮

Discord

游戏玩家首选,支持 Slash 命令,社区氛围好

难度: ⭐⭐

✅ 优点

  • • 支持 Slash 命令
  • • 代码块显示完美
  • • 社区活跃
  • • 权限系统细

❌ 缺点

  • • 需要创建 Application
  • • 配置稍复杂

🚀 配置步骤

1
# 1. 访问 Discord Developer Portal

https://discord.com/developers/applications

2
# 2. New Application → Bot

创建应用并添加 Bot

3
# 3. 复制 Bot Token

Reset Token 后复制

4
# 4. OAuth2 → URL Generator

勾选 bot + 权限,生成邀请链接

5
openclaw channels login discord

粘贴 Token 完成配置

⚙️ 配置示例

{
  "channels": {
    "discord": {
      "token": "YOUR_BOT_TOKEN",
      "dmPolicy": "pairing",
      "allowFrom": ["your_discord_id"]
    }
  }
}

💡 小贴士

  • 🎮 Discord 是最适合技术讨论的,代码块显示完美
  • 🔐 dmPolicy: 'pairing' 表示私聊需要配对,安全推荐
  • 💬 群聊中默认需要 @提及才会回复
  • ⚙️ 在 Discord Developer Portal 可以设置 Bot 头像和描述
💼

Slack

团队协作首选,适合公司内部使用

难度: ⭐⭐⭐

✅ 优点

  • • 企业友好
  • • threading 支持
  • • 应用市场丰富

❌ 缺点

  • • 配置最复杂
  • • 需要 Event Subscriptions
  • • 公网 IP 或隧道

🚀 配置步骤

1
# 1. api.slack.com/apps

创建 New App

2
# 2. 添加 Bot Token Scopes

chat:write, channels:read...

3
# 3. 开启 Event Subscriptions

设置 Request URL

4
# 4. 订阅 message.channels

添加事件订阅

5
openclaw channels login slack

粘贴 Bot Token

⚙️ 配置示例

{
  "channels": {
    "slack": {
      "token": "xoxb-your-bot-token",
      "signingSecret": "your-signing-secret",
      "requireMention": true
    }
  }
}

💡 小贴士

  • 🏢 Slack 最适合公司内部使用,可以和现有工作流结合
  • 🌐 Event Subscriptions 需要公网访问,本地测试用 ngrok
  • 💡 建议只订阅特定频道,避免消息太多
  • 🔧 可以在 Slack App 管理后台精细化权限
🚀

Feishu

字节跳动出品,国内公司首选,功能和 Slack 很像但国内访问快

难度: ⭐⭐

✅ 优点

  • • 国内访问快
  • • 中文支持好
  • • 和 Lark 互通
  • • 文档协作强

❌ 缺点

  • • 需要创建自定义应用
  • • Webhook 配置稍复杂
  • • 国际版叫 Lark

🚀 配置步骤

1
# 1. 打开飞书开放平台

https://open.feishu.cn/app

2
# 2. 创建企业自建应用

点击'创建应用' → 选择'企业自建应用'

3
# 3. 添加机器人能力

在'应用能力'中添加'机器人'

4
# 4. 获取 App ID 和 Secret

在'凭证与基础信息'中查看

5
# 5. 配置事件订阅

设置 Encrypt Key 和 Verification Token

6
# 6. 把机器人添加到群

在群里添加你的自建应用

7
openclaw channels login feishu

输入 App ID 和 Secret 完成配置

⚙️ 配置示例

{
  "channels": {
    "feishu": {
      "appId": "cli_xxxxx",
      "appSecret": "xxxxxxxx",
      "encryptKey": "optional",
      "verificationToken": "optional",
      "allowFrom": ["ou_xxxxx"],
      "groups": {
        "*": { "requireMention": true }
      }
    }
  }
}

💡 小贴士

  • 🚀 飞书和 Lark 其实是同一个东西,国际版叫 Lark,国内版叫飞书
  • 🔧 创建应用时选'企业自建应用',不是'应用商店应用'
  • 💡 如果只需要 Webhook 方式,可以用更简单的方式配置
  • 📱 飞书移动端体验很好,支持语音、富文本、卡片消息
  • ⚠️ 注意区分 App ID (cli_开头) 和 App Secret,Secret 只显示一次
🌐

WebChat

无需配置,开箱即用,浏览器直接聊

难度: ⭐

✅ 优点

  • • 零配置
  • • 打开即用
  • • 支持文件上传

❌ 缺点

  • • 需要保持浏览器打开
  • • 移动端体验一般

🚀 配置步骤

1
openclaw dashboard

自动打开浏览器

2
# 或手动访问

http://127.0.0.1:18789

💡 小贴士

  • 🚀 最快体验 OpenClaw 的方式,不用配任何频道
  • 💻 界面和 ChatGPT 类似,支持多会话管理
  • 📁 可以直接拖拽上传文件
  • 🔒 只在本地运行,数据不上传云端

🔧 通用配置选项

无论配置哪个频道,下面这些选项都是通用的:

私聊 (DM)

一对一对话,最常用

dmPolicy: 'pairing' | 'open'
安全模式:

需要发送配对码验证

开放模式:

任何人都能直接对话(不安全)

群聊 (Group)

多人聊天室

requireMention: true | false
安全模式:

开放模式:

白名单 (Allowlist)

只允许特定用户使用

allowFrom: ['id1', 'id2']
安全模式:

开放模式:

🔧 常见问题

WhatsApp: 二维码扫描后一直转圈

检查手机网络,确保能访问 WhatsApp。尝试重启手机 WhatsApp 应用。

Telegram: Bot 不回复消息

检查 Bot Token 是否正确。确保给 Bot 设置了允许接收消息,检查 allowFrom 配置。

Discord: Slash 命令不显示

需要在 Discord Developer Portal 的 Interactions 中配置命令,然后重新邀请 Bot。

Slack: Event Subscriptions 验证失败

确保 Request URL 可访问(公网或隧道),检查签名密钥是否正确。

Feishu: 机器人收不到消息

检查是否在群里添加了机器人,确认'事件订阅'已开启并订阅了'消息'事件。

Feishu: 提示'app not found'或认证失败

确认使用的是 App ID (cli_开头) 而不是 App Name。检查应用是否已发布到当前企业。

🎯 最佳实践

🔐 安全第一

  • • 始终配置 allowFrom 白名单
  • • 私聊使用 dmPolicy: 'pairing'
  • • 定期检查和清理白名单

⚡ 性能优化

  • • 群聊开启 requireMention 避免刷屏
  • • 只订阅需要的消息事件
  • • 定期清理旧会话释放内存