场景目标： 在同一个 OpenClaw 网关下，运行多个独立的飞书机器人（例如：主助手、工作助手、以及新增的 OpenClaw 助手）。每个机器人不仅配置独立的飞书 AppID，而且拥有**完全独立的 Agent 身份、记忆工作区和会话隔离**。

第一阶段：OpenClaw 配置修改

Step 1: 配置底层会话隔离策略

为了让不同账号和用户的会话互不干扰，首先要将单聊的作用域设为最细粒度（按账号+渠道+用户）。 在终端执行快捷命令：

openclaw config set session.dmScope "per-account-channel-peer"

Step 2: 注册新的 Agent 身份

修改 ~/.openclaw/openclaw.json，在 agents.list 数组中添加你的新 Agent（例如 OpenClaw），为其指定独立的工作目录 workspace：

"agents": {
  "list": [
    // ... 已有的 main 和 work ...
    {
      "id": "openclaw",
      "name": "OpenClaw Assistant",
      "workspace": "~/.openclaw/workspace-openclaw",
      "model": {
        "primary": "minimax/MiniMax-M2.7"
      }
    }
  ]
}

Step 3: 在飞书渠道中添加新账号

在 channels.feishu.accounts 下新增一个节点，填入飞书开发者后台获取的 App ID 和 Secret：

"channels": {
  "feishu": {
    "accounts": {
      // ... 已有的 default 和 work ...
      "openclaw": {
        "appId": "xxxx",
        "appSecret": "xxxxx",
        "botName": "OpenClaw Assistant"
      }
    }
  }
}

Step 4: 配置路由绑定（Binding）

最关键的一步，必须将飞书的账号 ID 和刚才注册的 Agent ID 绑定起来，否则即使隔离了账号，系统依然会走默认 Agent 的记忆区。 在顶层的 bindings 数组中增加一条规则：

"bindings": [
  { "agentId": "main", "match": { "channel": "feishu", "accountId": "default" } },
  { "agentId": "work", "match": { "channel": "feishu", "accountId": "work" } },
  { "agentId": "openclaw", "match": { "channel": "feishu", "accountId": "openclaw" } }
]

Step 5: 重启 OpenClaw 网关

openclaw gateway restart

---

第二阶段：飞书开发者后台配置与排错坑点

如果你发消息给新机器人，**发现机器人毫无反应，且 OpenClaw 日志里完全没有 received message from...** 的记录，那一定是飞书拦截了消息。请严格按以下顺序检查：

坑点 1：缺少机器人能力或核心权限

1. 确保在“**添加应用能力**”中开启了“**机器人 (Bot)**”。 2. 确保在“**权限管理**”中开通了消息获取权限： - 获取与发送单聊、群组消息 (im:message) - 接收群聊中@机器人消息事件 (im:message.group_at_msg:readonly) - 接收单聊消息事件 (im:message.p2p_msg:readonly)

坑点 2：事件订阅缺失（极易遗漏）

在“**事件与回调**”页面中： 1. 订阅方式选为“**使用长连接（WebSocket）接收**”。 2. **重点**：不能只选订阅方式，必须在下方点击“**添加事件**”，然后一定要勾选 im.message.receive_v1（接收消息）。 *(注意：不要选 v2，目前框架依赖 v1 格式的事件推送)*

坑点 3：配置改了却没有发布新版本（99% 的错误根源）

飞书所有的权限增加、事件修改，**点击保存后都不会立刻生效！** 必须去： 1. “**版本管理与发布**” -> 创建新版本 2. 填写版本号 -> **申请发布** 3. 等待状态变为“**已发布（Published）**”后，配置才会真正生效送达 OpenClaw。

---

第三阶段：用户白名单配提示授权 (Pairing)

如果你走完了前面两步，发消息时不仅不回，反而在终端输入 /feishu auth 或者收到一条特殊的提示，说明触发了 OpenClaw 的权限保护：

现象： 收到类似如下的系统提示回复：

OpenClaw: access not configured.
Your Feishu user id: xxx
Pairing code: xxx
Ask the bot owner to approve with:
openclaw pairing approve feishu xxx

原因： OpenClaw 默认对单聊执行安全的 pairing 策略，防止未授权的公司同事消耗你的 Token 或触碰隐私。

解决步骤： 直接复制提示中的命令，在运行 OpenClaw 的机器**终端**执行：

openclaw pairing approve feishu xxx

出现 Approved 提示后，此 ou_xxx 账号即被加入白名单，配对成功！至此，一个拥有完全独立隔离记忆、能够顺畅交互的新飞书 Agent 就彻底配置完成了。🎉