☰
OpenClaw 考研帮手:飞书与 QQ-bot 双通道配置手册(含 TaoToken 统一 Key 接入)
2026/10/3 22:12:42 网站建设 项目流程

1. 考研信息轰炸下,我为什么把 OpenClaw 接进了飞书和 QQ

考研这件事,信息差比努力更折磨人。复试线什么时候出、调剂系统几点开、目标院校研究生院官网半夜有没有偷偷更新通知,这些节点错过一个,可能一整年的准备就白费。我去年帮表弟盯复试信息,靠人肉刷新网页,结果还是漏了一条下午五点发布的调剂公告。后来我把 OpenClaw 部署到一台轻量服务器上,让它同时挂在飞书和 QQ 两个入口,每小时自动抓取目标院校的研究生院页面,有更新就推送到我手机。这套方案的核心不是 OpenClaw 本身多神奇,而是它支持多通道接入——飞书机器人适合做结构化通知和文件归档,QQ-bot 适合做即时提醒和群内共享,两条链路跑同一套 Agent 逻辑,API Key 却只需要在 TaoToken 统一管理一份。

OpenClaw 是什么?你可以把它理解成一个能动手的 AI 智能体。传统大模型只能给你文字建议,OpenClaw 能真的去打开浏览器、抓取页面、整理文件、发送消息。它支持飞书、钉钉、QQ、企业微信、Telegram、Discord 等通道,你配置好之后,在飞书里发一句“帮我查一下北航计算机复试线”,它就会去执行抓取任务并把结果发回来。适合谁?适合需要自动化处理重复信息任务的人,尤其是考研、考公、求职这类信息密集场景。我实测下来,一台 2 核 2G 的轻量服务器就能跑,成本可控,配置也不算复杂。

但问题来了:OpenClaw 默认要配置模型 API Key,如果你同时接飞书和 QQ-bot,难道要维护两套 Key?而且不同通道的模型调用如果分散在不同平台,额度、计费、排查都麻烦。我的做法是把 API Key 统一收到 TaoToken 这个通道上,OpenClaw 的模型调用全部走同一个 Base URL 和 Key,飞书和 QQ-bot 只是消息入口不同,底层模型能力完全一致。这样你只需要在 TaoToken 控制台管理一份 Key,两个通道同时生效。

这篇文章我会按实际配置顺序走:先讲 OpenClaw 的环境准备和 TaoToken 统一 Key 的接入位置,然后给出飞书机器人和 QQ-bot 两条链路的可复制配置片段,接着用一条实际请求验证两个入口是否都通,最后把我在配置过程中踩过的报错和排查方法列出来。目标很明确:一次配置,两个消息入口同时跑通,API Key 只维护一份。

2. TaoToken 统一 Key 接入 OpenClaw 的前置准备

在动飞书和 QQ-bot 之前,先把 OpenClaw 的模型调用通道固定下来。这一步不做,后面两个通道各自配 Key,出了问题你都不知道是通道问题还是模型问题。TaoToken 在这里的角色是统一 API 入口,OpenClaw 通过它调用模型,你只需要在 TaoToken 控制台创建一次 Key,然后把这个 Key 写进 OpenClaw 的配置里,飞书和 QQ-bot 共用。

先确认你的 OpenClaw 已经部署好。我用的是轻量应用服务器,2 核 2G,系统选 Alibaba Cloud Linux 3,重置系统时选 OpenClaw 应用镜像。部署完成后,在服务器控制台的应用详情页,先放通 OpenClaw 服务运行端口的防火墙,然后获取 WebUI 地址。默认 Gateway 监听http://127.0.0.1:18789,如果你要在本地测试,可以用内网穿透把 18789 暴露出去;如果部署在公网服务器,直接配域名和反向代理即可。

接下来是 TaoToken 的 Key 创建。访问 TaoToken 控制台,进入 API Keys 页面,创建一个新 Key。这个 Key 就是 OpenClaw 调用模型的凭证。创建时建议命名清楚,比如openclaw-kaoyan,方便后面排查。创建完成后复制 Key,注意不要泄露,后面配置里会用到。

OpenClaw 的模型配置有两种方式:一种是通过openclaw config set命令逐项设置,另一种是直接编辑配置文件。我推荐用配置文件,因为飞书和 QQ-bot 的配置项比较多,集中管理更清晰。OpenClaw 的配置文件通常位于~/.openclaw/config.json或安装目录下的config文件夹,具体路径可以用openclaw config path查看。

在配置文件里,模型相关的字段主要关注这几个:model.baseUrl、model.apiKey、model.modelId。Base URL 填 TaoToken 的 API 地址https://taotoken.net/api,注意不要加 UTM 参数。API Key 填你刚才创建的那串。Model ID 根据你的需求选,考研信息抓取和摘要任务,选一个上下文长度够、响应稳定的模型即可。如果你用的是 Coding Plan 套餐,模型 ID 可以填qwen3.5-plus或kimi-k2.5这类,具体以 TaoToken 控制台展示的可用模型为准。

这里有一个关键点:OpenClaw 的模型配置是全局的,飞书和 QQ-bot 作为通道,只是消息的入口和出口,它们不单独持有模型 Key。所以你在配置文件里改一次model.apiKey,两个通道同时生效。这就是统一 Key 的意义——不用在飞书后台填一遍、QQ 后台再填一遍,也不用担心两个通道的额度对不上。

配置片段大概长这样,你可以直接复制到config.json的对应位置:

{ "model": { "baseUrl": "https://taotoken.net/api", "apiKey": "sk-你的TaoTokenKey", "modelId": "qwen3.5-plus", "maxTokens": 4096, "temperature": 0.3 }, "channels": { "feishu": { "enabled": true, "appId": "", "appSecret": "", "encryptKey": "", "verificationToken": "" }, "qqbot": { "enabled": true, "appId": "", "appSecret": "" } } }

注意channels下面的feishu和qqbot字段先留空,下一步我们分别填。model部分先配好,保存后可以用openclaw config validate检查语法。如果返回config is valid,说明模型通道已经就绪。接下来我们分别配置飞书和 QQ-bot 的通道参数。

3. 飞书机器人与 QQ-bot 双通道可复制配置

这一节是核心操作部分,我会把飞书和 QQ-bot 的配置拆开讲,每个通道给出可复制的配置片段和参数填写位置。你按顺序操作,最后两个通道会共用同一个 TaoToken Key。

3.1 飞书机器人配置:App ID、App Secret 与事件订阅

飞书这边需要先在飞书开放平台创建企业自建应用。访问飞书开放平台,点击“创建企业自建应用”,填写应用名称,比如“考研信息助手”,上传头像后创建。创建完成后,进入“凭证与基础信息”页面,拿到App ID和App Secret。这两个值填到 OpenClaw 配置文件的channels.feishu下面。

"feishu": { "enabled": true, "appId": "cli_xxxxxxxxxx", "appSecret": "xxxxxxxxxxxxxxxx", "encryptKey": "", "verificationToken": "" }

encryptKey和verificationToken如果飞书后台没有开启加密,留空即可。如果你在飞书后台设置了 Encrypt Key,这里必须填一样的值,否则消息会解密失败。

接下来配置飞书的事件订阅。在飞书应用后台进入“事件订阅”页面,请求地址 URL 填你的 OpenClaw Gateway 地址加/webhook/feishu。如果你部署在公网服务器,域名是https://your-domain.com,就填https://your-domain.com/webhook/feishu。如果是本地测试,用内网穿透工具把 18789 暴露出去,比如ngrok http 18789,然后把生成的https://xxxx.ngrok.io/webhook/feishu填进去。

事件订阅里需要添加“接收消息”事件,事件标识是im.message.receive_v1。这一步很关键,不订阅这个消息事件,机器人收不到用户发的消息。另外,飞书的事件与回调一定要配置长链接,否则无法与机器人对话。

权限管理页面需要添加以下权限:im:message(发送消息)、im:message.group_at_msg:readonly(接收群 @ 消息)、im:message.p2p_msg:readonly(接收私聊消息)、im:resource(下载图片等资源)。权限添加后需要发布版本,在“版本管理与发布”中创建版本,填写版本号如1.0.0,申请发布,等企业管理员审核通过。

审核通过后,在飞书里给机器人发一条消息,比如“你好”,OpenClaw 会回复一个配对码。然后在终端执行:

openclaw pairing approve feishu <收到的配对码>

配对成功后,飞书通道就通了。你可以在飞书里发“帮我查一下今天有没有新的复试通知”,OpenClaw 会调用模型并执行任务。

3.2 QQ-bot 配置:AppID 与 AppSecret 填写位置

QQ-bot 的配置比飞书简单一些。访问 QQ 开放平台,进入机器人创建页面,创建一个 QQ 机器人。创建完成后,在机器人管理页面拿到AppID和AppSecret。这两个值填到 OpenClaw 配置文件的channels.qqbot下面。

"qqbot": { "enabled": true, "appId": "你的QQ机器人AppID", "appSecret": "你的QQ机器人AppSecret" }

填完后保存配置文件。QQ-bot 不需要像飞书那样配置事件订阅 URL,OpenClaw 会通过 QQ 开放平台的 WebSocket 或回调机制接收消息。你只需要确保服务器能访问 QQ 开放平台的接口即可。

配置完成后,重启 OpenClaw 服务:

openclaw restart

然后在 QQ 里找到你创建的机器人,发一条消息测试。如果机器人回复了内容,说明 QQ-bot 通道也通了。

这里有一个容易忽略的点:飞书和 QQ-bot 的配置都在同一个config.json里,model部分共用同一个 TaoToken Key。你不需要在飞书后台填任何模型 Key,也不需要在 QQ 后台填。所有模型调用都走 OpenClaw 的model配置,而model.apiKey指向 TaoToken。这就是统一 Key 的好处——两个通道,一份 Key,一处修改,两处生效。

如果你用的是 CC Switch 或 Cline MCP 这类工具来管理配置,注意 Base URL、Key、Model ID 三件套要写全。Base URL 是https://taotoken.net/api,Key 是 TaoToken 控制台创建的 Key,Model ID 根据套餐选。这三项在 OpenClaw 的model字段里对应baseUrl、apiKey、modelId。

4. 验证双通道连通性与实际考研信息推送

配置完成后,不要急着上生产任务,先做连通性验证。验证分两步:先确认模型通道通,再确认两个消息入口都能触发模型调用。

第一步,用 OpenClaw 的命令行工具直接测试模型调用。执行:

openclaw model test --prompt "回复:通道正常"

如果返回类似通道正常的内容,说明 TaoToken 的 Base URL 和 Key 配置正确,模型调用链路是通的。如果报错,先检查model.baseUrl是否填了https://taotoken.net/api,注意不要多写斜杠或路径。再检查apiKey是否复制完整,有没有多余空格。

第二步,在飞书里给机器人发一条消息:“帮我总结一下今天的研究生院通知”。观察 OpenClaw 的日志输出,正常流程是:飞书 webhook 收到消息 → OpenClaw 路由到 Agent → Agent 调用 TaoToken 模型 → 模型返回结果 → OpenClaw 通过飞书 API 回复消息。如果飞书收到回复,说明飞书通道和模型通道都通了。

第三步,在 QQ 里给机器人发同样的消息。如果 QQ 也收到回复,说明两个通道共用同一套模型配置,统一 Key 接入成功。

我实际跑的时候,用了一个考研复试信息抓取任务来验证。指令是:“每小时检查一次北航计算机学院研究生招生页面,如果有新通知,把标题和链接推送到飞书和 QQ。” OpenClaw 的 Skill 会定时执行抓取,发现更新后分别调用飞书和 QQ-bot 的发送接口。实测下来,飞书那边收到的是结构化消息,包含标题、链接和时间;QQ 那边收到的是简洁提醒,适合快速查看。两个通道的消息内容可以不一样,但底层模型调用是同一个 TaoToken Key。

验证过程中,你可以用openclaw logs --follow实时查看日志。如果看到model request success和channel send success交替出现,说明整条链路正常。如果某个通道失败,日志里会显示具体的错误码,下一步我们专门排查。

这里提醒一句:飞书的事件订阅 URL 必须是公网可访问的,如果你用内网穿透,ngrok 的免费版每次重启会换域名,需要重新填到飞书后台。生产环境建议用固定域名加反向代理。QQ-bot 这边对公网 IP 没有硬性要求,但服务器需要能出网访问 QQ 开放平台接口。

5. 双通道配置常见报错排查:401、local proxy failed 与 OAuth

配置过程中最容易卡住的就是报错。我把飞书和 QQ-bot 双通道场景下常见的几个错误列出来,对照你的日志排查。

401 Unauthorized:这个报错通常出现在模型调用阶段。日志里会显示model request failed: 401。原因一般是 TaoToken 的 API Key 填错、过期或者没有复制完整。检查config.json里model.apiKey的值,确认没有多余空格或换行。如果 Key 正确,检查model.baseUrl是否填了https://taotoken.net/api,不要填成其他路径。另外,如果你在 TaoToken 控制台删除了旧 Key,记得同步更新配置文件。

local proxy failed:这个报错说明 OpenClaw 在尝试通过本地代理访问模型接口时失败了。常见原因是服务器网络环境限制了出站请求,或者你配置了不必要的代理。检查model.baseUrl是否可以直接访问,可以在服务器上执行curl -I https://taotoken.net/api看返回状态。如果返回 200 或 401,说明网络通;如果超时,检查服务器安全组和出站规则。注意不要配置任何非必要的网络中转,保持直连即可。

reading choices 报错:这个错误通常出现在模型返回格式解析阶段。日志里会显示failed to read choices from response。原因是模型返回的 JSON 结构不符合 OpenClaw 的预期。检查model.modelId是否填了 TaoToken 支持的模型 ID。如果你填了一个不存在的模型名,接口可能返回错误结构。另外,maxTokens设置过小也可能导致返回被截断,解析失败。建议先设 4096,稳定后再调整。

OAuth 相关报错:飞书通道配置时,如果 App ID 或 App Secret 填错,日志会显示feishu oauth failed或invalid app credentials。检查飞书开放平台“凭证与基础信息”页面的 App ID 和 App Secret,确保和配置文件里一致。如果飞书应用没有发布版本,或者权限没有审核通过,也会报 OAuth 错误。确认应用状态是“已发布”,并且权限列表里有im:message等必要权限。

QQ-bot 无响应:如果 QQ 发消息后机器人不回复,先检查channels.qqbot.enabled是否为true,再检查 AppID 和 AppSecret 是否正确。然后看日志里有没有qqbot websocket connected或qqbot callback received。如果没有,说明 OpenClaw 没有成功连接到 QQ 开放平台。检查服务器是否能访问 QQ 开放平台的接口地址,以及机器人是否已经在 QQ 开放平台审核通过。

飞书配对码不出现:在飞书发消息后没有收到配对码,检查事件订阅的请求地址 URL 是否填对,以及是否订阅了im.message.receive_v1事件。另外,飞书的事件与回调必须配置长链接,否则消息无法推送到 OpenClaw。如果用的是 ngrok,确认 ngrok 进程还在运行,并且域名没有变。

排查时建议打开 debug 日志:

openclaw logs --level debug --follow

这样能看到每一步的详细输出,包括模型请求的 URL、返回状态码、通道发送结果。根据错误码定位问题,比盲目改配置快得多。

6. 把 Key 收拢到一处,让两个入口长期稳定跑

配置跑通之后,日常维护其实很简单。你不需要每天去飞书后台和 QQ 后台检查 Key,也不需要担心两个通道的模型额度对不上。所有模型调用都走 OpenClaw 的model配置,而model.apiKey指向 TaoToken。如果哪天需要换模型或者换 Key,只改config.json里model那一段,重启 OpenClaw,飞书和 QQ-bot 同时生效。

我自己的习惯是,把config.json里的model部分单独备份一份,标注好 Key 的创建时间和用途。如果 TaoToken 控制台有多个 Key,建议给 OpenClaw 单独用一个,命名清楚,比如openclaw-kaoyan-feishu-qq。这样在控制台看调用量的时候,能直接对应到这套双通道配置。

另外,考研信息抓取这类任务,建议把定时频率设成每小时一次,不要太高。太频繁的抓取可能触发目标网站的访问限制,也会增加模型调用量。OpenClaw 的 Skill 支持配置interval参数,你可以根据目标院校官网的更新频率调整。如果只是盯复试线这种关键节点,每天早晚各一次也够用。

最后说一个实际经验:飞书和 QQ-bot 的消息格式可以差异化配置。飞书适合发长文本和文件,你可以让 OpenClaw 把抓取到的通知整理成 Markdown 表格发过去;QQ 适合发短提醒,只推标题和链接。这样两个通道各司其职,信息不会互相干扰。配置入口在 OpenClaw 的channels下面,每个通道可以单独设置消息模板,但模型调用还是共用同一个 TaoToken Key。

如果你还没创建 TaoToken 的 Key,可以先去控制台建一个,然后按上面的配置片段填到 OpenClaw 里。飞书和 QQ-bot 的通道配置可以并行做,互不影响。遇到报错就对照第 5 节的排查清单,基本能覆盖大部分问题。

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询