Openclaw飞书多 Agent 配置指南

最近很火的openclaw，不知道大家有没有用上了没有，对于大部分人来说可能用处不是互联网炒作的那么玄乎，当然能用好的人价值是非常大的，其实也比较费钱，就看能否产生对等的价值。不然对普通人来说还是直接用大模型的web或者APP聊天比较合适。

其实安装部署应该是不难，不知道为啥腾讯哪里这么多人要帮忙部署的，一时的跟风并不是什么好事。

我也是尝试把openclaw部署在服务器，体验一下，看能否用到工作中，服务器部署，大厂都已经做好了镜像，一键安装就搞定了。

应用到工作，需要有多个角色，对于我这种不懂代码的人，费了点时间才折腾完工，下面把相关的过程分享一下。

我是做跨境电商的，我把我需要的几个角色定义了一下，分别给的角色为：

1，广告优化师，2，Shopify 运营，3，产品经理，4，开发工程师，5，社媒运营，6，平面设计师

把每个角色的描述，需要做的任务写好，发给openclaw他会转换成他们的标准格式，创建独立的工作空间

首先. 创建 6 个飞书应用

登录 飞书开放平台，创建以下 6 个应用，先按照网上很多教程那样建一个基础的，后续根据各个工作性质在开放不同的权限。

然后 获取凭证信息

每个应用创建后，在「凭证与基础信息」页面获取：

• App ID (格式：cli_xxxxxxxxxxxxxxxx)
• App Secret (格式：xxxxxxxxxxxxxxxxxxxxxxxx)

配置步骤

第一步：更新 openclaw.json

1. 备份当前配置，当然也可以进入文件管理下载openclaw.json文件，以防万一

cp ~/.openclaw/openclaw.json ~/.openclaw/openclaw.json.bak

2. 编辑配置文件，可以在服务器打开直接编辑，也可以用下载下来的文件另存一份再编辑。参考 OPENCLAW_CONFIG_TEMPLATE.json
3. 关键配置项：

{
  "channels": {
    "feishu": {
      "enabled": true,
      "accounts": {
        "ad-optimizer": {
          "appId": "cli_你的 APP_ID",
          "appSecret": "你的 APP_SECRET",
          "botName": "广告优化师"
        }
        // ... 其他 5 个应用
      }
    }
  },
  "bindings": [
    {
      "agentId": "ad-optimizer",
      "match": {
        "channel": "feishu",
        "accountId": "ad-optimizer"
      }
    }
    // ... 其他 5 个绑定
  ]
}

第二步：配置飞书应用事件订阅

对每个应用执行以下操作：

1. 进入「事件订阅」页面
2. 设置请求地址：
   http://你的服务器IP:18988/webhook/feishu
   

3. 加密密钥和验证令牌可留空
4. 开通以下权限：
   • im:chat:readonly - 读取会话信息
   • im:message:send_as_bot - 以机器人身份发送消息
   • im:message.group_msg - 接收群聊消息
   • im:message.p2p_msg - 接收私聊消息
   • cardkit:card:write - 重要！发送消息卡片

第三步：发布应用 ⚠️

最容易踩坑的一步！

1. 点击「版本管理与发布」
2. 创建版本（填写版本号、更新说明）
3. 申请发布
4. 等待管理员审核通过

⚠️ 关键提醒：权限必须发布后才生效！不走发布流程，机器人永远是哑巴！

第四步：重启 Gateway

openclaw gateway restart

第五步：验证配置

1. 在飞书中搜索每个机器人
2. 发送测试消息
3. 检查回复是否正常

避坑指南

坑 1：权限未发版，机器人当哑巴

现象：日志报 Access denied. [cardkit:card:write]

解法：

1. 开通 cardkit:card:write 权限
2. 创建新版本 → 申请发布 → 审核通过
3. 必须走发布流程！

坑 2：A 机器人用了 B 的大脑

现象：私聊开发工程师，回复的却是产品经理的内容

解法：

• Binding 必须锁定 accountId
• 最稳妥写法：只匹配 channel + accountId（不加 peer）

坑 3：群里机器人无限对话

现象：群里发一句话，多个机器人互相接话

解法：

"groups": {
  "requireMention": true
}

坑 4：JSON 语法错误

现象：Gateway 启动失败，报 JSON 错误

解法：

• 用 VS Code 编辑，有语法高亮
• 运行 openclaw doctor --fix 自动修复
• 验证：cat ~/.openclaw/openclaw.json | jq .

Agent 间协作

配置 agentToAgent 后，机器人之间可以互相调用：

"tools": {
  "agentToAgent": {
    "enabled": true,
    "allow": ["ad-optimizer", "shopify-ops", "ecom-pm", "shopify-dev", "social-media", "graphic-designer"]
  }
}

使用方式：
在群里 @工程师 说："这个设计稿让平面设计师看一下"

后续工作

每个 Agent 需要单独初始化

1. 进入各 Agent 工作空间
2. 填写 USER.md 中的待填写信息
3. 完成 BOOTSTRAP.md 中的清单
4. 删除 BOOTSTRAP.md

工作空间路径