news 2026/9/26 9:33:42

Openclaw记录02.飞书,钉钉,QQ,企微,接入openclaw

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
Openclaw记录02.飞书,钉钉,QQ,企微,接入openclaw

1. 四端接入 Openclaw 到底难在哪

Openclaw 本身是一个把大模型能力接到聊天工具里的网关,飞书、钉钉、QQ、企微这四个平台都能接。但真正动手时你会发现,难点不在 Openclaw,而在四个平台各自的鉴权方式、回调地址、事件订阅机制完全不一样。飞书走长连接、钉钉要装插件再验证连接通道、QQ 有专门的机器人入口、企微还得在管理后台开 API 模式,每一步的字段名和操作路径都不同。

我这次的目标很明确:用 TaoToken 作为统一的 Key/API 通道,把四端消息收发一次性跑通。TaoToken 在这里的角色是鉴权入口和模型调用通道,你只需要在 Openclaw 里配一次 API Key,四个平台共用同一套模型出口,不用每个平台单独去申请模型额度。适合已经装好 Openclaw、想让机器人在多个聊天工具里同时在线的人。

下面按「先配 TaoToken,再逐平台接入,最后统一验证」的顺序来写,每一步都给可复制的命令和配置骨架。

2. 先把 TaoToken 的 Key 和通道配好

Openclaw 调用模型需要 base_url 和 api_key,这两个都从 TaoToken 拿。打开 https://taotoken.net/api 对应的控制台,在 API Keys 页面创建一个新 Key,复制出来备用。这个 Key 是四个平台共用的,不用每个平台建一个。

拿到 Key 之后,在 Openclaw 的配置文件里写入模型通道。Openclaw 的配置一般在~/.openclaw/config.toml,你也可以用openclaw config set命令逐项写。下面是一个 config.toml 骨架,把 base_url 和 api_key 换成你自己的:

[model] provider = "openai-compatible" base_url = "https://taotoken.net/api" api_key = "sk-你的TaoToken密钥" model = "claude-sonnet-4-20250514" [gateway] port = 18789 host = "0.0.0.0" [channels.feishu] enabled = false [channels.dingtalk] enabled = false [channels.qqbot] enabled = false [channels.wecom] enabled = false

这里base_url填 TaoToken 的 API 地址,api_key填刚才创建的 Key。model字段按你实际要用的模型名填。四个 channel 先全部关掉,等逐个配好再打开。

配完执行一次重启,让网关加载新配置:

openclaw gateway restart

重启后可以用openclaw config get model确认 base_url 和 api_key 已经生效。如果这一步报错,先检查 Key 有没有复制完整、base_url 有没有多空格。

3. 飞书接入:长连接 + 事件订阅

飞书这边先去 https://open.feishu.cn 开发者后台,创建企业自建应用,记下 App ID 和 App Secret。然后在「添加应用能力」里加上机器人。

终端里执行:

openclaw channels add

选择 Feishu,依次输入 App ID 和 App Secret。配好后重启网关:

openclaw gateway restart

回到飞书后台,做三件事。第一,在「事件与回调 / 事件配置」里把订阅方式改成长连接,添加「接收消息」事件。第二,在「回调配置」里同样改成长连接。第三,在「权限管理」里开通消息和通讯录相关权限,建议全选必选项。最后去「版本管理与发布」创建版本并发布。

发布后在飞书桌面版工作台找到刚创建的机器人,发一条消息。如果机器人返回一串配对码,在终端执行:

openclaw pairing approve feishu XXXXXXXX openclaw gateway restart

配对码是飞书用来确认机器人归属的,执行完就能正常对话了。

4. 钉钉接入:插件 + 连接通道验证

钉钉去 https://open-dev.dingtalk.com 创建应用,拿到 ClientID 和 ClientSecret。在「添加应用能力」里创建机器人并配置,然后去「权限管理」全选开通,最后在「版本管理与发布」里创建新版并发布。

钉钉需要额外装一个开源插件:

openclaw plugins install @soimy/dingtalk@latest openclaw channels add --channel dingtalk openclaw config set channels.dingtalk.enabled true openclaw config set channels.dingtalk.clientId 你的ClientID openclaw config set channels.dingtalk.clientSecret 你的ClientSecret openclaw gateway restart

重启后回到钉钉开放平台,在「事件订阅」里点「验证连接通道」,确认显示连接成功。这一步很关键,钉钉必须验证通过才会推送消息。

然后在钉钉软件里建一个群,把机器人加进群聊。在群里 @机器人,或者点机器人打开单独聊天窗口发消息。钉钉这边群聊机器人是必做的,单聊窗口有时不触发事件。

5. QQ 接入:龙虾入口 + QQBot 插件

QQ 走的是专门的机器人入口 https://q.qq.com/qqbot/openclaw/ ,在这个页面创建机器人,拿到 AppID 和 AppSecret。注意 QQ 的凭证格式是AppID:AppSecret拼在一起。

安装腾讯官方的 QQBot 插件:

openclaw plugins install @tencent-connect/openclaw-qqbot@latest openclaw channels add --channel qqbot --token "你的AppID:你的AppSecret" openclaw gateway restart

配好后回到那个专用入口页面,选择你创建的机器人,把鼠标悬停在「扫码聊天」按钮上会出现二维码,用 QQ 扫码就能开始对话。下次想找机器人,去 QQ 的「联系人 / 机器人」里点进去就行。

QQ 这边的坑是 token 格式,冒号前后不能有空格,AppID 和 AppSecret 顺序也不能反,否则插件会报鉴权失败。

6. 企微接入:API 模式 + 配对码

企业微信去 https://work.weixin.qq.com 管理后台,进「Management Tool / Intelligent Zone / Intelligent robot」,创建机器人时选API 模式创建,拿到 AppID 和 AppSecret。

安装企微插件:

openclaw plugins install @sunnoy/wecom@latest openclaw gateway restart openclaw channels add --channel wecom

按提示输入 AppID 和 AppSecret。配好后打开企业微信,进「通讯录 / 智能机器人」,选择刚创建的机器人开始对话。如果返回一串配对码,在终端执行:

openclaw pairing approve wecom 364XVRXD openclaw gateway restart

企微的配对码和飞书类似,都是用来绑定机器人和当前 Openclaw 实例的。执行完就能正常收发消息。

7. 四端常见报错排查

配的过程中最容易卡在几个地方,我整理成表格对照:

现象可能原因处理方式
飞书发消息无响应事件订阅没改长连接回后台把事件配置和回调配置都改成长连接
钉钉验证连接通道失败插件没装或 clientId 写错重装@soimy/dingtalk,核对 clientId/clientSecret
QQ 插件报鉴权失败token 格式不对确认是AppID:AppSecret,冒号无空格
企微机器人不回复没执行 pairing approve用返回的配对码执行openclaw pairing approve wecom 码
四端都通但模型不回复TaoToken Key 或 base_url 错openclaw config get model检查,重设 api_key
重启后配置丢失没写入 config.toml用openclaw config set逐项写,别只改内存

排查顺序建议从模型通道开始:先用openclaw config get model确认 TaoToken 的 base_url 和 api_key 没问题,再看单个平台的 channel 是否 enabled,最后看平台后台的事件订阅和权限。模型通道不通的话,四个平台会一起哑掉,先排除这个能省很多时间。

插件更新可以用:

openclaw plugins update feishu openclaw plugins update dingtalk openclaw plugins update wecom openclaw plugins update qqbot

8. 统一 Key 通道后的收尾建议

四端跑通之后,日常维护其实很轻。TaoToken 的 Key 是共用的,换模型或者换额度只需要改 config.toml 里[model]那一段,四个平台同时生效,不用逐个平台去改。这一点在多平台场景下省事很多。

如果你后面要长期跑编码类或 Agent 类任务,可以去看一下 Coding Plan 的额度方案,比按次调用更适合高频场景。接入过程中遇到鉴权或回调问题,直接查 API Keys 和接入文档两页基本能覆盖。模型效果想先试试,用模型对话页面发几条消息验证一下再往 Openclaw 里配,能少走弯路。

版权声明: 本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若内容造成侵权/违法违规/事实不符,请联系邮箱:809451989@qq.com进行投诉反馈,一经查实,立即删除!
网站建设 2026/9/26 9:32:30

Claude Code 接入 MySQL:用 TaoToken 统一 Key 打通数据库查询链路

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

作者头像 李华
网站建设 2026/9/26 9:31:04

Windows 12 ISO 下载真相:官方镜像获取与安全验证指南

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

作者头像 李华
网站建设 2026/9/26 9:31:03

Atlas 300V 24G推理卡YOLO部署全流程与调优实战

"atlas 300v 24g 是运算加速卡吗"——这个问题最近在好几个群里被翻来覆去地讨论,每次看到我都想多嘴一句:是,但它不是你想的那种"运算加速卡"。它是一张AI推理加速卡,确切地说是昇腾310P系列的Atlas 300V 24…

作者头像 李华
网站建设 2026/9/26 9:30:11

振动筛跨行业应用图谱:从砂石厂到食品医药的选型与运维指南

去年在南方一家面粉厂做工艺回访,车间里那台嗡嗡作响、装在不锈钢支架上的"清粉筛",我一眼就看出是振动筛的骨架——电机、偏心块、弹簧总成、筛箱,一个部件都不陌生,只不过筛网换成了180目的精细网,外壳做了…

作者头像 李华
网站建设 2026/9/26 9:30:04

从 SIM 卡读取联系人:TaoToken 统一 Key 通道下的配置与验证

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

作者头像 李华
网站建设 2026/9/26 9:29:45

jd-gui全攻略:Java反编译工具下载、乱码解决与命令行批量反编译

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

作者头像 李华