QQBot 多账号绑定配置

首次安装 QQBot（从零开始）

Step 1 — 在 QQ 开放平台创建机器人

1. 访问 QQ 开放平台，用手机 QQ 扫码登录
2. 点击「创建机器人」
3. 记录 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

方式 1：CLI 向导（推荐）

openclaw channels add --channel qqbot --token "AppID:AppSecret"

方式 2：手动编辑配置文件

编辑 ~/.openclaw/openclaw.json：

{
  "channels": {
    "qqbot": {
      "enabled": true,
      "appId": "Your AppID",
      "clientSecret": "Your AppSecret"
    }
  }
}

Step 4 — 启动测试

openclaw gateway

---

多账号绑定配置（已有 QQBot，新增第二个）

前置条件

• 已有 OpenClaw 安装并运行
• 已有 qqbot 插件安装
• 已有至少一个 agent（如 main）
• 新的 QQBot AppID 和 ClientSecret

快速配置步骤

1. 创建新 Agent（如需要）

openclaw agents add <agent-name>

示例：

openclaw agents add coding

2. 编辑配置文件

修改 ~/.openclaw/openclaw.json：

2.1 在 channels.qqbot.accounts 中添加新账号

"channels": {
  "qqbot": {
    "enabled": true,
    "allowFrom": ["*"],
    "accounts": [
      {
        "accountId": "main",
        "appId": "1903000001",
        "clientSecret": "your-secret-here"
      },
      {
        "accountId": "coding",
        "appId": "1903000002",
        "clientSecret": "your-secret-here"
      }
    ]
  }
}

2.2 在 bindings 中添加路由规则

"bindings": [
  {
    "agentId": "main",
    "match": {
      "channel": "qqbot",
      "accountId": "main"
    }
  },
  {
    "agentId": "coding",
    "match": {
      "channel": "qqbot",
      "accountId": "coding"
    }
  }
]

3. 重启 Gateway

openclaw gateway restart

4. 验证配置

openclaw agents list --bindings

配置模板

添加第 N 个 QQBot 的完整步骤

1. 获取新 QQBot 信息：

   • AppID: 1903xxxxxx（从 QQ 开放平台获取）
   • ClientSecret: your-secret-here（从 QQ 开放平台获取）
   • 确定 accountId（如 work, game, notify）
   • 确定绑定哪个 agent（如 main, coding 或新建）

2. 编辑 ~/.openclaw/openclaw.json：

   在 channels.qqbot.accounts 数组末尾添加：

   {
     "accountId": "<account-id>",
     "appId": "<app-id>",
     "clientSecret": "<client-secret>"
   }
   

   在 bindings 数组末尾添加：

   {
     "agentId": "<agent-id>",
     "match": {
       "channel": "qqbot",
       "accountId": "<account-id>"
     }
   }
   

3. 重启并验证：

   openclaw gateway restart
   openclaw agents list --bindings
   

常见问题

Q: 一个 agent 可以绑定多个 QQBot 吗？

A: 可以！只需添加多个 bindings 指向同一个 agentId。

Q: 一个 QQBot 可以发给多个 agent 吗？

A: 不可以，一个消息只能路由到一个 agent。

Q: 如何删除某个 QQBot？

A: 从 accounts 和 bindings 中删除对应条目，然后重启 gateway。

示例配置

{
  "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": [
        { "accountId": "main", "appId": "1903000001", "clientSecret": "your-secret-here" },
        { "accountId": "coding", "appId": "1903000002", "clientSecret": "your-secret-here" },
        { "accountId": "notify", "appId": "1903000003", "clientSecret": "your-secret-here" }
      ]
    }
  },
  "bindings": [
    { "agentId": "main", "match": { "channel": "qqbot", "accountId": "main" } },
    { "agentId": "coding", "match": { "channel": "qqbot", "accountId": "coding" } },
    { "agentId": "notify", "match": { "channel": "qqbot", "accountId": "notify" } }
  ]
}