QQBot Multi-Bind — QQBot 多账号绑定

QQBot 多账号绑定配置 配置格式说明 channels.qqbot.accounts 使用对象格式，每个 accountId 作为 key： "accounts": { "": { "enabled": true, "appId": "", "clientSecret": "" } } 顶层 appId/clientSecret 是默认账户（accountId = "default"） accounts 下的每个 key 就是该账户的 accountId 每个账户可独立配置 enabled、name、allowFrom、systemPrompt 等

首次安装 QQBot（从零开始） 步骤 1 — 在 QQ 开放平台创建机器人 访问 QQ 开放平台，用手机 QQ 扫码登录 点击「创建机器人」 记录 AppID 和 AppSecret（AppSecret 只显示一次，务必保存好） 注意：创建后机器人会出现在 QQ 消息列表，但会回复"机器人去火星了"，需完成配置才能正常使用。

步骤 2 — 安装插件 方式 A：npm 安装（推荐） openclaw plugins install @tencent-connect/openclaw-qqbot 方式 B：源码一键安装 git clone https://github.com/tencent-connect/openclaw-qqbot.git && cd openclaw-qqbot bash ./scripts/upgrade-via-source.sh --appid YOUR_APPID --secret YOUR_SECRET 方式 C：手动安装 git clone https://github.com/tencent-connect/openclaw-qqbot.git && cd openclaw-qqbot npm install --omit=dev openclaw plugins install .

步骤 3 — 配置 OpenClaw CLI 方式（推荐） openclaw channels add --channel qqbot --token "AppID:AppSecret" 手动编辑配置文件 编辑 ~/.openclaw/openclaw.json： { "channels": { "qqbot": { "enabled": true, "appId": "Your AppID", "clientSecret": "Your AppSecret" } } }

步骤 4 — 启动测试 openclaw gateway

多账号配置（新增第二个机器人） 前置条件 已有 OpenClaw 安装并运行 已有 qqbot 插件安装 已有至少一个 agent（如 main） 新的 QQBot AppID 和 ClientSecret

方式一：CLI 命令添加（推荐） openclaw channels add --channel qqbot --account --token "AppID:AppSecret" 示例： openclaw channels add --channel qqbot --account bot2 --token "222222222:secret-of-bot-2" 然后添加 agent 绑定： openclaw agents add 如需要新 agent 编辑 ~/.openclaw/openclaw.json，在 bindings 中添加： { "agentId": "", "match": { "channel": "qqbot", "accountId": "" } }

方式二：手动编辑配置

• 创建新 Agent（如需要）

• 编辑 ~/.openclaw/openclaw.json 添加账号到 accounts：

完整示例配置 { "agents": { "list": [ { "id": "main", "model": "bailian/kimi-k2.5" }, { "id": "coding", "model": "bailian/kimi-k2.5" }, { "id": "notify", "model": "bailian/kimi-k2.5" } ] }, "channels": { "qqbot": { "enabled": true, "allowFrom": [""], "accounts": { "main": { "enabled": true, "appId": "1903000001", "clientSecret": "secret-1" }, "coding": { "enabled": true, "appId": "1903000002", "clientSecret": "secret-2" }, "notify": { "enabled": true, "appId": "1903000003", "clientSecret": "secret-3" } } } }, "bindings": [ { "agentId": "main", "match": { "channel": "qqbot", "accountId": "main" } }, { "agentId": "coding", "match": { "channel": "qqbot", "accountId": "coding" } }, { "agentId": "notify", "match": { "channel": "qqbot", "accountId": "notify" } } ] }

常见问题 Q: 一个 agent 可以绑定多个 QQBot 吗？ A: 可以！添加多个 bindings 指向同一个 agentId。 Q: 一个 QQBot 可以发给多个 agent 吗？ A: 不可以，一个消息只能路由到一个 agent。 Q: 如何删除某个 QQBot？ A: 从 accounts 和 bindings 中删除对应条目，重启 gateway。 Q: 如何与另一个 agent 对话？ A: openclaw agent --agent --message "你的消息" Q: 如何启用跨 agent 会话访问？ A: 在 openclaw.json 中添加： { "tools": { "sessions": { "visibility": "all" } } } 然后重启 gateway。