快速配置 OpenClaw 多 QQBot 账号绑定到不同 Agent。用于首次安装 QQBot、新增 QQBot 账号、创建 agent 绑定关系、重启 gateway 使配置生效。当用户需要安装 QQBot 插件、添加新的 QQBot 机器人或配置多账号路由时使用此技能。
channels.qqbot.accounts 使用对象格式，每个 accountId 作为 key：
json
accounts: {
enabled: true,
appId:
clientSecret:
}
}
⚠️ 注意：创建后机器人会出现在 QQ 消息列表，但会回复机器人去火星了，需完成配置才能正常使用。
方式 A：npm 安装（推荐）
bash
openclaw plugins install @tencent-connect/openclaw-qqbot
方式 B：源码一键安装
bash
git clone https://github.com/tencent-connect/openclaw-qqbot.git && cd openclaw-qqbot
bash ./scripts/upgrade-via-source.sh --appid YOURAPPID --secret YOURSECRET
方式 C：手动安装
bash
git clone https://github.com/tencent-connect/openclaw-qqbot.git && cd openclaw-qqbot
npm install --omit=dev
openclaw plugins install .
CLI 方式（推荐）
bash
openclaw channels add --channel qqbot --token AppID:AppSecret
手动编辑配置文件
编辑 ~/.openclaw/openclaw.json：
json
{
channels: {
qqbot: {
enabled: true,
appId: Your AppID,
clientSecret: Your AppSecret
}
}
}
bash
openclaw channels add --channel qqbot --account
示例：
bash
openclaw channels add --channel qqbot --account bot2 --token 222222222:secret-of-bot-2
然后添加 agent 绑定：
bash
openclaw agents add
编辑 ~/.openclaw/openclaw.json，在 bindings 中添加：
json
{
agentId:
match: {
channel: qqbot,
accountId:
}
}
添加账号到 accounts：
json
channels: {
qqbot: {
enabled: true,
allowFrom: [*],
accounts: {
main: {
enabled: true,
appId: 1903000001,
clientSecret: your-secret-here
},
enabled: true,
appId:
clientSecret:
}
}
}
}
添加路由到 bindings：
json
bindings: [
{
agentId: main,
match: { channel: qqbot, accountId: main }
},
{
agentId:
match: { channel: qqbot, accountId:
}
]
json
{
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 } }
]
}
问：一个 agent 可以绑定多个 QQBot 吗？
答：可以！添加多个 bindings 指向同一个 agentId。
问：一个 QQBot 可以发给多个 agent 吗？
答：不可以，一个消息只能路由到一个 agent。
问：如何删除某个 QQBot？
答：从 accounts 和 bindings 中删除对应条目，重启 gateway。
问：如何与另一个 agent 对话？
答：openclaw agent --agent
问：如何启用跨 agent 会话访问？
答：在 openclaw.json 中添加：
json
{
tools: {
sessions: {
visibility: all
}
}
}
然后重启 gateway。
该技能支持在以下平台通过对话安装：
帮我安装 SkillHub 和 qqbot-multi-bind-1776128468 技能
设置 SkillHub 为我的优先技能安装源，然后帮我安装 qqbot-multi-bind-1776128468 技能
skillhub install qqbot-multi-bind-1776128468
文件大小: 2.74 KB | 发布时间: 2026-4-15 14:04
