1. 为什么我选择用 OpenClaw 搭 QQ 机器人而不是自己写协议如果你正在搜「OpenClaw 搭建 QQ 机器人」大概率已经踩过两个坑一是 QQ 开放平台的鉴权链路自己写起来很啰嗦二是模型接入部分每换一家服务商就要改一遍代码。OpenClaw 这个开源框架的价值就在于把这两件事拆开了——它负责把 QQ 的消息协议转成标准的 HTTP 请求你只需要在config.toml里告诉它「用哪个模型、走哪个地址、拿什么 Key」。这篇要解决的核心问题很具体在本地把 OpenClaw 跑起来用 TaoToken 的统一 Key 接入模型让 QQ 机器人真正能收发消息。适合谁适合已经拿到 QQ 机器人 AppID/AppSecret、手上有一台能跑服务的机器、但卡在模型接入这一环的开发者。整条链路我实测跑通过下面给出的config.toml骨架可以直接复制改参数。先说清楚 TaoToken 在这里扮演什么角色。它是一个统一的大模型 API 接入层官网在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 入口是 https://taotoken.net/api 。你不需要为每个模型单独维护一套 Key 和 Base URLOpenClaw 的 provider 配置里填一次就行。这对 QQ 机器人这种需要长期在线、偶尔还要切换模型做对比的场景特别省事。2. 前置准备TaoToken 统一 Key 与 OpenClaw 环境2.1 拿到 TaoToken 的 API Key打开 https://taotoken.net/api-keys 登录后创建一个新的 Key。这里有个细节创建时建议给 Key 起一个能认出来的名字比如openclaw-qq-bot因为后面如果你同时跑多个机器人或做测试Key 一多就容易混。复制出来的字符串只显示一次先存到本地临时文件里。TaoToken 的 Base URL 统一用https://taotoken.net/api注意这个地址后面不加 UTM 参数直接作为 API 根路径填进配置。模型名按你实际要用的填比如gpt-4o-mini、claude-3-5-sonnet这类具体可用列表在 https://taotoken.net/models 能查到。2.2 OpenClaw 的安装与目录结构OpenClaw 的安装方式取决于你的系统。我这边用的是 Linux 服务器直接拉二进制或者用包管理器装都行。装完之后默认配置目录一般在~/.openclaw/或者项目根目录下的config/。你要确认的是config.toml到底在哪——可以用openclaw --help看它有没有--config参数或者直接find / -name config.toml 2/dev/null搜一下。QQ 机器人这边你需要提前在 QQ 开放平台创建好机器人实体拿到AppID和AppSecret。这两个值在 OpenClaw 的 channel 配置里要用。AppSecret 生成后不能再次明文查看忘了只能重置所以拿到就先存好。3. 可复制的 config.toml 骨架与 TaoToken 配置片段下面这份config.toml是我实际跑通的骨架你按注释替换成自己的值即可。重点看[provider]和[channel.qq]两段。# OpenClaw 主配置骨架 # 模型接入走 TaoToken 统一 Key [provider] # 服务商标识OpenClaw 用它来匹配请求格式 name taotoken # TaoToken 的 API 根地址注意不要带末尾斜杠 base_url https://taotoken.net/api # 这里填你在 TaoToken 创建的 Key api_key sk-你的TaoToken密钥 # 请求协议TaoToken 兼容 OpenAI 格式 api openai [provider.model] # 模型 ID按 TaoToken 模型列表里实际可用的填 id gpt-4o-mini # 显示名称日志里会用到 name gpt-4o-mini [channel.qq] # QQ 开放平台拿到的 AppID app_id 你的AppID # QQ 开放平台拿到的 AppSecret app_secret 你的AppSecret # 机器人监听的端口默认即可 port 8080 [log] # 调试阶段建议开 debug能看到请求和响应 level debug几个容易填错的地方单独说一下。base_url一定不要写成https://taotoken.net/api/v1或者带/chat/completionsOpenClaw 会自己在后面拼路径多写了就会 404。api字段填openai是因为 TaoToken 的接口遵循 OpenAI 规范不是说你只能用 OpenAI 的模型。model.id要和 TaoToken 模型列表里的标识完全一致大小写敏感。如果你想把模型换成别的只改[provider.model]里的id和name就行Key 和 Base URL 都不用动——这就是统一 Key 的好处。4. 启动机器人并验证消息收发配置写完后先做一次语法检查。OpenClaw 一般支持openclaw config validate或者启动时自动校验。我习惯直接启动看日志openclaw start --config ./config.toml如果配置没问题日志里会先打印 provider 初始化信息类似provider taotoken initialized, base_urlhttps://taotoken.net/api。然后 channel 部分会显示 QQ 机器人已连接。这时候打开 QQ找到你创建的机器人发一条测试消息比如「你好帮我算一下 23 乘以 17」。正常的话日志里会依次出现收到 QQ 消息、向 TaoToken 发起请求、收到模型响应、回传 QQ。机器人回复「391」就说明整条链路通了。如果你想单独验证 TaoToken 这一层是不是通的可以先用 curl 直接打一次接口排除 OpenClaw 的干扰curl https://taotoken.net/api/chat/completions \ -H Authorization: Bearer sk-你的TaoToken密钥 \ -H Content-Type: application/json \ -d { model: gpt-4o-mini, messages: [{role: user, content: 回复一个字通}] }返回 JSON 里有choices[0].message.content就说明 Key 和地址都没问题。这一步能帮你快速定位问题到底出在 TaoToken 侧还是 OpenClaw 侧。5. 本篇常见报错排查5.1 401 Unauthorized最常见的原因是 Key 填错或者复制时带了空格。检查api_key字段确保没有多余空白。另外确认你用的是 TaoToken 的 Key不是其他平台的。如果 Key 没问题去 https://taotoken.net/api-keys 看一下这个 Key 是不是被禁用或额度用完了。5.2 404 Not Found九成是base_url写多了。正确写法就是https://taotoken.net/api不要加/v1不要加/chat/completions。OpenClaw 内部会拼成完整路径。如果你用的是其他框架拼接规则可能不同但 OpenClaw 这边按上面写就对了。5.3 模型不存在或 model not foundmodel.id和 TaoToken 模型列表里的标识不一致。去 https://taotoken.net/models 复制准确的模型 ID注意有些模型带版本号后缀。另外确认你的 Key 有权限调用这个模型部分模型可能需要单独开通。5.4 QQ 机器人不回复但日志显示请求成功这种情况一般是 QQ 开放平台那边的回调地址或权限没配好。检查你的机器人是否已经通过审核、消息接收权限是否开启。另外 OpenClaw 的port如果被防火墙挡了QQ 平台的回调进不来也会表现为「日志有请求但用户收不到回复」。本地测试可以用内网穿透工具把端口暴露出去但注意不要用任何违规的网络工具直接用云服务器公网 IP 加安全组放行即可。5.5 启动时报 TOML 解析错误多半是引号或括号没配对。TOML 里字符串必须用双引号布尔值是小写true/false。建议用支持 TOML 语法高亮的编辑器检查一遍。如果实在找不到问题把配置精简到只剩[provider]和[channel.qq]两段逐步加回来定位。6. 接入跑通之后Key 和文档放哪整条链路跑通后你手上其实有两个需要长期维护的东西一个是 TaoToken 的 Key一个是 OpenClaw 的配置。Key 建议定期在 https://taotoken.net/api-keys 轮换尤其是机器人对外提供服务的情况下。OpenClaw 的接入细节如果遇到版本差异可以对照 https://taotoken.net/doc 里的接口说明核对参数。如果你后面想把这个机器人从「能回复」升级到「能长期跑 coding 任务或 Agent 流程」可以看一下 Coding Plan 的用法地址在 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。它和单次对话的区别在于更适合多轮、长上下文的场景QQ 机器人做知识库问答或自动化客服时会用到。调试阶段我建议把[log]的level设成debug等稳定运行一周后再改回info不然日志量会很大。另外config.toml里不要直接写生产环境的 Key 然后提交到 Git用环境变量注入或者单独的 secrets 文件更稳妥。