openclaw配置多个QQ机器人(QBot),全程按“三步走”流程操作,步骤清晰、可直接落地

核心说明：本教程仅针对 coderzhang Agent 配置独立QQ机器人（QBot），全程按“三步走”流程操作，步骤清晰、可直接落地，确保配置成功。

一、教程核心步骤（三步走）

第一步：创建coderzhang Agent（编程高手Agent）

首先创建coderzhang Agent，并为其指定独立的工作区（workspace），执行以下唯一创建命令，无需创建其他Agent：

openclaw agents add –workspace ~/.openclaw/workspace-coderzhang coderzhang

说明：该命令会自动创建Agent，并在指定路径（~/.openclaw/workspace-coderzhang）生成对应工作区，后续配置机器人需依赖此工作区。

第二步：为coderzhang Agent添加QQ机器人（QBot）渠道

关键注意事项：添加机器人前，必须切换到coderzhang Agent的专属工作区，否则机器人与Agent无法成功绑定，导致配置失败。

操作步骤（分系统执行，选择对应命令）：

1. 切换到coderzhang的工作区

# Windows系统执行

set OPENCLAW_WORKSPACE=C:\Users\Administrator\.openclaw\workspace-coderzhang

# Linux/Mac系统执行（补充，方便不同系统使用）

export OPENCLAW_WORKSPACE=~/.openclaw/workspace-coderzhang

2. 添加QQ机器人渠道

切换工作区后，执行以下命令添加QQ机器人（account设为bot2，token替换为自己的机器人ID和密钥，格式：ID:密钥）：

openclaw channels add –channel qqbot –account bot2 –token “1903650105:Dd3UwOrKoInJpMtRzY8teQD0ocRG6xog”

通用示例（可直接替换token使用）：

openclaw channels add –channel qqbot –account bot2 –token “机器人ID:密钥”

第三步：修改配置文件（Openclaw.json），完成Agent与机器人绑定

添加完机器人渠道后，需在Openclaw.json配置文件中添加绑定规则，让coderzhang Agent与bot2机器人关联，具体操作如下：

1. 找到Openclaw.json文件

该文件为OpenClaw的核心配置文件，默认路径与工作区同级，可根据自身安装路径查找。

2. 配置bindings节点

在文件中找到（或添加）”bindings”数组，添加coderzhang Agent与bot2机器人的绑定规则，完整配置如下（可直接复制替换对应节点）：

“bindings”: [

    {

      “agentId”: “main”,

      “match”: {

        “channel”: “qqbot”,

        “accountId”: “default”

      }

    },

    {

      “agentId”: “coderzhang”,

      “match”: {

        “channel”: “qqbot”,

        “accountId”: “bot2”

      }

    }

  ]

说明：”agentId”需与创建的Agent名称（coderzhang）一致，”accountId”需与添加机器人时的account（bot2）一致，否则绑定失败。

二、配置验证与完成说明

完成以上三步后，重启OpenClaw服务，即可验证配置是否生效：

1. 重启OpenClaw，确保配置文件修改生效；

2. 发送消息至bot2机器人，若coderzhang Agent能正常响应，说明配置成功；

3. 至此，coderzhang Agent单独配置QQ机器人的全部流程完成。