首页教程第 7 章
第 7 章进阶18 分钟阅读

国内渠道接入

连接飞书、钉钉、企业微信,让 AI 助手融入你的工作环境

本章内容
  • 1国内渠道概览
  • 2飞书接入
  • 3钉钉接入
  • 4企业微信接入
  • 5国内渠道使用技巧

国内渠道概览

飞书、钉钉、企业微信是国内企业最常用的协作工具。OpenClaw 支持通过机器人/应用的方式接入这三个平台,让 AI 助手直接在你的工作群里响应指令。

平台接入方式适用场景配置难度
飞书自建应用 + WebSocket企业内部自动化、文档处理
钉钉自定义机器人 / 企业内部应用团队通知、任务管理低/中
企业微信企业自建应用企业内部流程、客服场景

飞书接入

飞书(Lark)通过自建应用的方式接入,支持消息收发、文档操作、日历管理等丰富功能。

1

访问 open.feishu.cn,使用飞书账号登录开放平台

2

点击"创建企业自建应用",填写应用名称和描述

3

进入"凭证与基础信息"页面,复制 App ID 和 App Secret

4

在"权限管理"中开启"接收消息"和"发送消息"权限

5

在"事件订阅"中配置 WebSocket 长连接模式(推荐)

6

将应用发布并添加到目标群聊

安装飞书插件
# 安装飞书渠道插件
npm install -g @openclaw/channel-feishu

# 配置飞书应用凭证
openclaw channels add feishu \
  --app-id "cli_xxxxxxxxxxxxxxxx" \
  --app-secret "你的App Secret"

# 重启网关
openclaw gateway restart
配置文件方式
{
  "channels": {
    "feishu": {
      "appId": "cli_xxxxxxxxxxxxxxxx",
      "appSecret": "你的App Secret",
      "verificationToken": "你的验证Token(可选)",
      "encryptKey": "你的加密Key(可选)"
    }
  }
}

💡 推荐使用 WebSocket 长连接模式,无需公网 IP 也能接收消息,适合本地部署的用户。

✅ 配置完成后,在飞书群中 @你的机器人 发送消息,即可触发 AI 响应。

钉钉接入

钉钉提供两种接入方式:自定义机器人(简单,仅支持发消息)和企业内部应用(完整,支持收发消息)。推荐使用企业内部应用方式。

1

在钉钉群聊中,点击右上角"群设置" → "智能群助手" → "添加机器人"

2

选择"自定义"机器人,填写名称

3

复制 Webhook 地址(格式:https://oapi.dingtalk.com/robot/send?access_token=xxx)

4

在 OpenClaw 中配置 Webhook URL

配置钉钉自定义机器人
# 安装钉钉渠道插件
npm install -g @openclaw/channel-dingtalk

# 配置自定义机器人(仅支持发消息)
openclaw channels add dingtalk-webhook \
  --webhook "https://oapi.dingtalk.com/robot/send?access_token=你的token" \
  --secret "你的签名密钥(如果开启了安全设置)"
1

访问 open.dingtalk.com,使用管理员账号登录

2

创建"企业内部应用" → "机器人"类型

3

在"消息接收"中配置消息推送地址或开启 Stream 模式

4

复制 AppKey 和 AppSecret

5

在 OpenClaw 中配置

配置钉钉企业应用
# 配置钉钉企业内部应用
openclaw channels add dingtalk \
  --app-key "你的AppKey" \
  --app-secret "你的AppSecret" \
  --mode stream  # 推荐使用 Stream 模式,无需公网IP

# 重启网关
openclaw gateway restart
配置文件方式
{
  "channels": {
    "dingtalk": {
      "appKey": "你的AppKey",
      "appSecret": "你的AppSecret",
      "mode": "stream",
      "robotCode": "你的机器人编码"
    }
  }
}

企业微信接入

企业微信(WeCom)通过企业自建应用接入,适合已经在使用企业微信的团队,可以直接在企业微信中与 AI 助手交互。

1

访问 work.weixin.qq.com/wework_admin,使用管理员账号登录

2

进入"应用管理" → "自建" → "创建应用"

3

填写应用名称,选择可见范围

4

在应用详情页复制 AgentId、CorpID 和 Secret

5

在"接收消息"中配置服务器 URL(需要公网 IP)或使用企业微信代理

安装企业微信插件
# 安装企业微信渠道插件
npm install -g @openclaw/channel-wecom

# 配置企业微信
openclaw channels add wecom \
  --corp-id "你的企业CorpID" \
  --agent-id "你的应用AgentID" \
  --secret "你的应用Secret" \
  --token "消息接收Token" \
  --encoding-aes-key "消息加密Key"
配置文件方式
{
  "channels": {
    "wecom": {
      "corpId": "你的企业CorpID",
      "agentId": 1000001,
      "secret": "你的应用Secret",
      "token": "消息接收Token",
      "encodingAESKey": "消息加密Key(43位)"
    }
  }
}

⚠️ 企业微信的消息接收需要公网可访问的 HTTPS 地址。如果你在本地部署,可以使用 ngrok 或 frp 进行内网穿透,或者将 OpenClaw 部署到云服务器。

💡 企业微信支持发送文字、图片、文件、卡片消息等多种格式,配合 OpenClaw 可以实现非常丰富的交互体验。

国内渠道使用技巧

使用国内渠道时,有几个实用技巧可以提升体验:

1

在飞书/钉钉群中设置"关键词触发",只有包含特定词汇的消息才转发给 AI,避免误触发

2

配置"白名单用户",只允许特定成员触发 AI,防止群成员滥用

3

使用"群机器人"模式时,可以在消息开头加 @ 机器人名称来明确触发

4

对于企业场景,建议创建专用的"AI 助手群",而不是在所有工作群中启用

安全配置示例
{
  "channels": {
    "feishu": {
      "appId": "cli_xxx",
      "appSecret": "xxx",
      "allowUsers": ["user_id_1", "user_id_2"],
      "triggerKeywords": ["@AI", "/run", "帮我"],
      "replyInThread": true
    }
  }
}

遇到问题?

加入 Telegram 社群,和数千名开发者一起学习,快速获得解答。

加入 Telegram 社群