OpenClaw

主题

IM 渠道接入指南 ​

OpenClaw 支持接入多种主流 IM 平台，实现跨平台统一消息处理。

支持的平台 ​

国内平台 ​

平台特点适用场景
企业微信企业办公首选企业内部协作、办公自动化
QQ 机器人个人用户友好个人助手、娱乐机器人
钉钉企业级安全企业办公、流程审批
飞书协作功能强团队协作、知识管理

海外平台 ​

平台特点适用场景
WhatsApp全球用户最多国际业务、客服支持
Telegram开放性强技术社区、频道订阅
Discord社区功能强游戏社区、兴趣社群

企业微信接入 ​

企业微信是腾讯官方支持的平台，接入最简便。

方式一：长连接模式（推荐） ​

无需配置域名，简单快捷。

步骤一：创建企业微信应用

  1. 登录 企业微信管理后台
  2. 进入【应用管理】>【创建应用】
  3. 填写应用信息（名称、logo等）

步骤二：获取应用凭证

进入刚创建的应用，获取以下信息：

  • 企业 ID (CorpId)：我的企业 > 页面最下方
  • AgentId：应用详情页
  • Secret：应用详情页

步骤三：配置 OpenClaw

在腾讯云 Lighthouse 控制台或 SSH 连接服务器：

bash
# 进入 OpenClaw 配置
openclaw configure

# 选择企业微信通道
# 输入 CorpId、AgentId、Secret

步骤四：设置企业可信 IP

在应用详情页找到「企业可信IP」，填入服务器的公网 IP。

方式二：API 模式 ​

支持 AI 主动发送消息。

配置步骤：

  1. 创建机器人
  2. 获取 API 凭证
  3. 配置回调地址
  4. 验证连接

验证接入 ​

bash
# 测试企业微信连接
openclaw im test wecom

# 查看日志
openclaw im logs wecom

QQ 机器人接入 ​

腾讯 QQ 开放平台提供零门槛创建 QQBOT。

快速接入 ​

步骤一：创建机器人

访问 QQ 开放平台，使用 QQ 登录。

步骤二：获取凭证

创建机器人后获取：

  • AppID
  • Token

步骤三：配置 OpenClaw

bash
# 配对 QQ 机器人
openclaw pair qq

# 输入 AppID 和 Token

飞书接入 ​

步骤一：创建飞书应用 ​

  1. 登录 飞书开发者平台
  2. 选择【创建企业自建应用】
  3. 填写应用名称（如"OpenClaw 助手"）

步骤二：添加机器人能力 ​

在应用管理页面：

  1. 左侧导航栏 >【添加应用能力】
  2. 选择【机器人】

步骤三：获取应用凭证 ​

在应用管理页面获取：

  • App ID
  • App Secret

步骤四：配置事件订阅 ​

  1. 左侧导航栏 >【事件与回调】
  2. 事件配置和回调配置均使用「长连接模式」

步骤五：配置 OpenClaw ​

bash
# 进入配置
openclaw configure

# 选择飞书通道
# 输入 App ID 和 App Secret

步骤六：发布应用 ​

在飞书开发者后台：

  1. 点击【创建版本并发布】
  2. 设置可用范围
  3. 发布到企业

钉钉接入 ​

步骤一：创建钉钉应用 ​

  1. 登录 钉钉开发者后台
  2. 选择【企业内部开发】>【创建应用】

步骤二：获取凭证 ​

在应用详情页获取：

  • AppKey
  • AppSecret

步骤三：配置机器人 ​

  1. 在应用详情页 >【功能管理】
  2. 开启【机器人】能力
  3. 配置消息接收地址

步骤四：配置 OpenClaw ​

bash
# 配对钉钉
openclaw pair dingtalk

# 输入 AppKey 和 AppSecret

WhatsApp 接入 ​

适合海外用户和国际业务。

步骤一：准备服务器 ​

推荐选择香港或新加坡地域的云服务器。

步骤二：配置 WhatsApp ​

bash
# 配对 WhatsApp
openclaw pair whatsapp

# 扫描二维码或输入验证码

步骤三：访问控制 ​

安全警告

始终设置 channels.whatsapp.allowFrom，限制允许发消息的号码。

json
{
  "channels": {
    "whatsapp": {
      "allowFrom": ["+1234567890"]
    }
  }
}

Telegram 接入 ​

步骤一：创建 Bot ​

  1. 在 Telegram 中搜索 @BotFather
  2. 发送 /newbot
  3. 按提示设置 Bot 名称

步骤二：获取 Token ​

BotFather 会返回 Bot Token，格式：123456789:ABCdefGHIjklMNOpqrsTUVwxyz

步骤三：配置 OpenClaw ​

bash
# 配对 Telegram
openclaw pair telegram

# 输入 Bot Token

Discord 接入 ​

步骤一：创建应用 ​

  1. 访问 Discord Developer Portal
  2. 点击【New Application】
  3. 填写应用名称

步骤二：创建 Bot ​

  1. 左侧菜单 >【Bot】
  2. 点击【Add Bot】
  3. 复制 Bot Token

步骤三：邀请 Bot ​

在【OAuth2】>【URL Generator】：

  1. 勾选 bot 权限
  2. 设置 Bot 权限
  3. 复制邀请链接
  4. 在浏览器打开链接邀请 Bot 加入服务器

步骤四：配置 OpenClaw ​

bash
# 配对 Discord
openclaw pair discord

# 输入 Bot Token

多平台统一管理 ​

统一配置 ​

OpenClaw 支持通过一个网关同时服务多个平台：

json
{
  "channels": {
    "wecom": {
      "enabled": true,
      "corpId": "your-corp-id",
      "agentId": "your-agent-id",
      "secret": "your-secret"
    },
    "qq": {
      "enabled": true,
      "appId": "your-app-id",
      "token": "your-token"
    },
    "feishu": {
      "enabled": true,
      "appId": "your-app-id",
      "appSecret": "your-app-secret"
    }
  }
}

管理命令 ​

bash
# 查看所有通道状态
openclaw im status

# 测试指定通道
openclaw im test <platform>

# 查看通道日志
openclaw im logs <platform>

# 重启通道
openclaw im restart <platform>

常见问题 ​

连接失败 ​

bash
# 诊断问题
openclaw doctor

# 检查网络
ping open.feishu.cn  # 飞书
ping q.qq.com        # QQ

# 查看详细日志
openclaw logs --level debug

消息不响应 ​

检查以下配置：

  1. 服务器公网 IP 是否正确配置
  2. 回调地址是否可访问
  3. 权限是否正确设置
  4. 防火墙是否放行端口

多平台冲突 ​

如果同时接入多个平台，确保：

  • 每个平台配置正确的凭证
  • 消息路由规则正确
  • 会话隔离配置正确

相关教程 ​

腾讯云开发者社区 ​

下一步 ​

基于 MIT 许可发布

Copyright © 2026 OpenClaw 知识库