打造你的家庭 AI 助手（三）：QQ 机器人接入你的 OpenClaw，用 TaoToken 统一 Key 打通配置

1. 家庭 AI 助手接 QQ 机器人卡点其实在 Key 管理OpenClaw 是一个可以跑在自己机器上的 AI 助手网关它能接飞书、接 QQ 机器人、接各种聊天通道把大模型的对话能力塞进你日常用的 IM 里。QQ 机器人接入 OpenClaw 这件事本身不复杂官方插件几条命令就能装完真正让人头疼的是后面那堆模型 Key主模型一个 Key、备用模型一个 Key、语音转写一个 Key、图片理解又一个 Key散落在openclaw.json、环境变量、插件配置里改一次要翻五个文件。这篇是「打造你的家庭 AI 助手」系列第三篇聚焦家庭场景下把 QQ 机器人接进 OpenClaw 时的多模型 Key 管理问题。适合已经装好 OpenClaw、想让家里人在 QQ 里直接 机器人问问题、但被一堆 API Key 配置绕晕的人。我会给出可复制的config.toml与settings.json骨架演示用 TaoToken 统一 Key 和 API 通道完成接入最后附一条消息回环验证动作确认 QQ 机器人和 OpenClaw 真的连通了。先说清楚一个前提QQ 开放平台对机器人有 IP 白名单机制家用宽带动态 IP 会导致频繁掉线。如果你只有家用宽带建议先看系列第二篇的飞书方案如果你有云服务器或固定 IP那这篇的配置可以直接抄。2. 为什么用 TaoToken 统一 Key而不是每个模型单独配OpenClaw 的模型调用走的是 OpenAI 兼容协议这意味着任何提供兼容接口的服务都能接。问题在于家庭 AI 助手往往不止用一个模型日常闲聊用便宜的小模型写代码切到强模型图片理解再换一个多模态模型。如果每个都去对应平台注册、拿 Key、配额度光是管理就够烦的。TaoToken 在这里的角色是一个统一的 API 通道你只需要一个 Key就能在 OpenClaw 里切换不同模型不用为每个模型单独维护凭证。对家庭场景来说这解决了三个实际问题。第一是配置收敛。OpenClaw 的config.toml里模型段只写一份base_url和api_key换模型只改model字段不用动 Key。第二是额度集中。家里人用机器人问问题消耗都走同一个通道月底看一个账单就行不用在四五个平台之间对账。第三是接入简单。TaoToken 的接口地址是https://taotoken.net/api兼容 OpenAI 的/v1/chat/completionsOpenClaw 原生支持这种格式不需要写适配层。需要提醒的是TaoToken 是正规的 API 聚合通道不是那种来路不明的中转。你拿到的 Key 在控制台里可以自己管理、自己轮换接入文档也写得很清楚。下面所有配置里的 Key 都建议用环境变量注入别硬编码进文件。3. 前置准备拿 Key、装插件、确认版本动手之前先把三件事做完后面配置才不会卡。第一件去 TaoToken 控制台创建一个 API Key。打开https://taotoken.net/api-keys登录后点创建复制那串以sk-开头的字符串。这个 Key 只显示一次先存到密码管理器里。同时建议在控制台里看一眼可用模型列表记下你打算用的模型名比如gpt-4o-mini这类后面config.toml要填。第二件确认 OpenClaw 已经装好并且能跑起来。在终端执行openclaw --version能打印版本号就说明没问题。如果提示命令找不到回到系列第一篇把安装补上。第三件安装 QQ Bot 插件。官方现在有专门的 OpenClaw 入口命令是生成好的直接复制openclaw plugins install tencent-connect/openclaw-qqbotlatest装完之后用openclaw plugins list确认插件出现在列表里。这一步在小内存机器上可能要等一两分钟别急着中断。关于 QQ 开放平台那边的应用创建、AppID 和 AppSecret 获取、IP 白名单配置流程和之前一样登录 QQ 开放平台进应用管理创建机器人拿到AppID和AppSecret然后把你的服务器公网 IP 加进白名单。Token 的格式是AppID:AppSecret中间用冒号连接。这部分平台界面可能会调整以你看到的实际页面为准。4. 可复制配置config.toml 与 settings.json 骨架OpenClaw 的配置分两块模型和通道走config.toml插件级参数走settings.json。下面两份骨架可以直接抄把尖括号里的内容替换成你自己的。先看config.toml重点是[models.default]这一段base_url指向 TaoToken 的 API 地址api_key用环境变量引用# ~/.openclaw/config.toml [gateway] port 18789 host 0.0.0.0 [models.default] provider openai-compatible base_url https://taotoken.net/api api_key ${TAOTOKEN_API_KEY} model gpt-4o-mini timeout 60 [models.fallback] provider openai-compatible base_url https://taotoken.net/api api_key ${TAOTOKEN_API_KEY} model gpt-4o timeout 60 [channels.qqbot] enabled true token ${QQBOT_TOKEN}这里有两个设计点值得说。一是default和fallback共用同一个base_url和api_key只是model不同这就是统一 Key 的好处主模型挂了切备用不用改凭证。二是api_key和token都写成${VAR}形式OpenClaw 启动时会从环境变量读取避免明文躺在文件里。环境变量在~/.bashrc或~/.zshrc里加两行export TAOTOKEN_API_KEYsk-你的TaoToken密钥 export QQBOT_TOKEN你的AppID:你的AppSecret改完执行source ~/.bashrc让它生效。注意QQBOT_TOKEN里那个冒号是必须的格式错了插件会报鉴权失败。再看settings.json这个文件管插件级行为路径通常在~/.openclaw/settings.json{ plugins: { qqbot: { enabled: true, requireMention: true, replyWithMarkdown: true, maxMessageLength: 2000, timeout: 30 } }, logging: { level: info, file: ~/.openclaw/logs/gateway.log } }requireMention设为true表示群里必须 机器人才触发避免它乱插话。replyWithMarkdown打开后模型返回的 Markdown 会尽量渲染代码块在 QQ 里显示更清楚。maxMessageLength是单条消息上限超长内容 OpenClaw 会自动分段。两份文件都改完重启网关openclaw gateway restart想前台看日志就用openclaw gateway --port 18789 --verbose调试阶段推荐这个报错能第一时间看到。5. 验证请求一条消息回环确认连通配置写完不代表通了得做一次端到端验证。我习惯用「消息回环」这个动作在 QQ 里给机器人发一条特定内容看它能不能原样或按预期回过来。第一步在 QQ 开放平台把你的 QQ 号加为测试用户沙箱模式下必须加否则收不到消息。然后在 QQ 里搜索你的机器人名称发起私聊或者把它拉进一个群。第二步私聊里直接发一句ping如果 OpenClaw 和模型都正常几秒内会收到回复。想更明确地确认是模型在回而不是插件在回发这个请回复回环测试成功当前模型是 gpt-4o-mini第三步看网关日志确认请求真的走到了 TaoToken。前台运行时终端会打印类似这样的行[qqbot] received message from userxxx content请回复回环测试成功... [model] POST https://taotoken.net/api/v1/chat/completions modelgpt-4o-mini [model] response 200 tokens42 [qqbot] sent reply to userxxx看到POST https://taotoken.net/api/v1/chat/completions且返回 200就说明 QQ 机器人 → OpenClaw → TaoToken → 模型 → 回 QQ 这条链路全通了。群聊里再 机器人发一次同样的内容确认requireMention生效。如果想让验证更彻底可以在 TaoToken 控制台的用量页面看这次请求有没有计费记录有记录就百分百确认走的是你的 Key。6. 本篇常见错排查配置过程中最容易踩的坑集中在鉴权和网络两块下面按现象给排查路径。机器人显示离线。先查服务器公网 IP 是否还在 QQ 开放平台的白名单里家用宽带 IP 变了就会掉。再确认openclaw gateway进程还在跑ps aux | grep openclaw看一眼。最后检查QQBOT_TOKEN格式必须是AppID:AppSecret少冒号或多空格都会鉴权失败。收不到群消息。九成是没 机器人。确认settings.json里requireMention是true的情况下群里必须 才触发。另外确认你的 QQ 号已在沙箱测试用户列表里没加的话平台不会把消息推给你。模型报 401 或 403。这是 TaoToken Key 的问题。检查TAOTOKEN_API_KEY环境变量有没有生效在终端echo $TAOTOKEN_API_KEY看输出。如果 Key 正确还报错去控制台确认 Key 没过期、额度没用完。注意base_url结尾不要多加/v1OpenClaw 会自己拼路径写成https://taotoken.net/api就行。模型报 404 model not found。config.toml里的model字段写错了或者你用的模型名不在 TaoToken 支持列表里。去控制台模型列表核对一遍名字要完全一致。回复超时。把timeout从 60 调大或者换一个响应更快的模型。家庭网络出口带宽小的时候长回复容易超时maxMessageLength调小一点也有帮助。插件装完不生效。执行openclaw plugins list确认插件在列然后openclaw gateway restart重启。有时候插件装了但网关没重载配置不生效。排查完这些你的家庭 AI 助手基本就能在 QQ 里稳定跑了。家里人 一下就能问问题模型切换只改config.toml里一个字段Key 始终是 TaoToken 那一个。想长期跑编码类或 Agent 类任务的话可以看看 Coding Plan额度模型更适合高频调用单纯验证模型连通性模型对话页面点几下就能测接入细节和参数说明都在接入文档里。