- name
- qqbot-multi-bind
- description
- 快速配置 OpenClaw 多 QQBot 账号绑定到不同 Agent。用于首次安装 QQBot、新增 QQBot 账号、创建 agent 绑定关系、重启 gateway 使配置生效。当用户需要安装 QQBot 插件、添加新的 QQBot 机器人或配置多账号路由时使用此技能。
QQBot 多账号绑定配置
配置格式说明
channels.qqbot.accounts 使用对象格式，每个 accountId 作为 key：
"accounts": {
"<account-id>": {
"enabled": true,
"appId": "<app-id>",
"clientSecret": "<secret>"
}
}- 顶层
appId/clientSecret是默认账户（accountId = "default"） accounts下的每个 key 就是该账户的 accountId- 每个账户可独立配置
enabled、name、allowFrom、systemPrompt等
首次安装 QQBot（从零开始）
Step 1 — 在 QQ 开放平台创建机器人
- 访问 QQ 开放平台，用手机 QQ 扫码登录
- 点击「创建机器人」
- 记录 AppID 和 AppSecret（AppSecret 只显示一次，务必保存好）
⚠️ 注意：创建后机器人会出现在 QQ 消息列表，但会回复"机器人去火星了"，需完成配置才能正常使用。
Step 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 .Step 3 — 配置 OpenClaw
CLI 方式（推荐）
openclaw channels add --channel qqbot --token "AppID:AppSecret"手动编辑配置文件
编辑 ~/.openclaw/openclaw.json：
{
"channels": {
"qqbot": {
"enabled": true,
"appId": "Your AppID",
"clientSecret": "Your AppSecret"
}
}
}Step 4 — 启动测试
openclaw gateway多账号配置（新增第二个机器人）
前置条件
- 已有 OpenClaw 安装并运行
- 已有 qqbot 插件安装
- 已有至少一个 agent（如
main） - 新的 QQBot AppID 和 ClientSecret
方式一：CLI 命令添加（推荐）
openclaw channels add --channel qqbot --account <account-id> --token "AppID:AppSecret"示例：
openclaw channels add --channel qqbot --account bot2 --token "222222222:secret-of-bot-2"然后添加 agent 绑定：
openclaw agents add <agent-name> # 如需要新 agent编辑 ~/.openclaw/openclaw.json，在 bindings 中添加：
{
"agentId": "<agent-id>",
"match": {
"channel": "qqbot",
"accountId": "<account-id>"
}
}方式二：手动编辑配置
1. 创建新 Agent（如需要）
openclaw agents add <agent-name>2. 编辑 ~/.openclaw/openclaw.json
添加账号到 accounts：
"channels": {
"qqbot": {
"enabled": true,
"allowFrom": ["*"],
"accounts": {
"main": {
"enabled": true,
"appId": "1903000001",
"clientSecret": "your-secret-here"
},
"<new-account-id>": {
"enabled": true,
"appId": "<new-app-id>",
"clientSecret": "<new-secret>"
}
}
}
}添加路由到 bindings：
"bindings": [
{
"agentId": "main",
"match": { "channel": "qqbot", "accountId": "main" }
},
{
"agentId": "<agent-id>",
"match": { "channel": "qqbot", "accountId": "<new-account-id>" }
}
]3. 重启并验证
openclaw gateway restart
openclaw agents list --bindings完整示例配置
{
"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 <agent-name> --message "你的消息"
Q: 如何启用跨 agent 会话访问？ A: 在 openclaw.json 中添加：
{
"tools": {
"sessions": {
"visibility": "all"
}
}
}然后重启 gateway。