openclaw-add-feishu-bot

将飞书机器人添加到 Openclaw

自动完成在 openclaw 中注册新飞书机器人的整个工作流：编辑 JSON 配置、创建工作区、重启网关，以及按需批准配对。

必填信息

开始前，请向用户收集以下信息（如果有缺失，请在一条消息中询问）：

字段	描述	示例
agentId	此机器人/Agent 的简短唯一名称	dabao
appId	飞书开放平台中的飞书 App ID	cli_xxxxxxxxxxxx
appSecret	飞书 App Secret	your-app-secret-here
pairingCode	（可选）如果机器人已添加到群组，则填写配对码	LNPQR9W9

步骤

按顺序执行所有步骤。先读取配置文件，以便有针对性地修改，而不是覆盖整个文件。

步骤 1 — 读取当前配置

Read ~/.openclaw/openclaw.json

步骤 2 — 编辑 channels.feishu

如果 feishu 使用旧的单账号格式（顶层包含 appId/appSecret，且没有 accounts 键）：

迁移为多账号结构 — 替换整个 feishu 块：

"feishu": {
  "enabled": true,
  "domain": "feishu",
  "groupPolicy": "open",
  "defaultAccount": "default",
  "accounts": {
    "default": {
      "appId": "<existing-appId>",
      "appSecret": "<existing-appSecret>"
    },
    "<agentId>": {
      "appId": "<new-appId>",
      "appSecret": "<new-appSecret>"
    }
  }
}

如果 feishu 已有 accounts（多账号格式）：

只需在 accounts 中添加新账号条目：

"<agentId>": {
  "appId": "<appId>",
  "appSecret": "<appSecret>"
}

步骤 3 — 将 Agent 添加到 agents.list

追加到 agents.list 数组：

{
  "id": "<agentId>",
  "workspace": "~/.openclaw/workspace-<agentId>",
  "subagents": {
    "allowAgents": ["*"]
  }
}

步骤 4 — 将绑定添加到 bindings

追加到 bindings 数组：

{
  "agentId": "<agentId>",
  "match": {
    "channel": "feishu",
    "accountId": "<agentId>"
  }
}

步骤 5 — 添加到 tools.agentToAgent.allow

在 tools.agentToAgent 下的 allow 数组中添加 "<agentId>"。

步骤 6 — 创建工作区目录

mkdir -p ~/.openclaw/workspace-<agentId>

步骤 7 — 重启网关

launchctl kickstart -k gui/$(id -u)/ai.openclaw.gateway

步骤 8 — 批准配对（如果提供了配对码）

如果用户提供了 pairingCode：

openclaw pairing approve feishu <pairingCode>

如果没有，请提醒用户在将机器人添加到群组后运行此命令：

openclaw pairing approve feishu <code>

完成后

确认：

• 添加的账号（default → <agentId>）
• 绑定：feishu / <agentId> → Agent <agentId>
• 工作区：~/.openclaw/workspace-<agentId>
• 网关已重启 ✓
• 配对：已批准或待处理

如果配对仍在等待中，请告知用户先将机器人添加到目标群组，然后运行批准命令。