📖 README → 飞书接入指南 → 飞书配置参考

OpenCrew 飞书最小增量配置

适用：已经在本机安装并能运行 OpenClaw（能执行 openclaw status），且飞书已接入（完成了飞书接入指南）。

原则：

不提供"完整 openclaw.json"（避免误覆盖 auth/models/gateway）

只提供 最小增量：新增 Agents + 飞书群组绑定 + A2A 限制

可回滚：删除我们新增的片段 + 删除新建的 workspace 目录

改之前先做备份（强烈建议）

cp ~/.openclaw/openclaw.json ~/.openclaw/openclaw.json.bak.$(date +%Y%m%d-%H%M%S)

你需要准备的占位符

飞书群组 ID（oc_xxxxxxxxxxxxxxxx 格式）：
- <FEISHU_GROUP_ID_HQ>（总部群 → CoS）
- <FEISHU_GROUP_ID_CTO>（技术群 → CTO）
- <FEISHU_GROUP_ID_BUILD>（执行群 → Builder）
- <FEISHU_GROUP_ID_INVEST>（投资群 → CIO，可选）
- <FEISHU_GROUP_ID_KNOW>（知识群 → KO）
- <FEISHU_GROUP_ID_OPS>（运维群 → Ops）
- <FEISHU_GROUP_ID_RESEARCH>（调研群 → Research，可选）

获取方法见：飞书接入指南 Step 6

需要加到 `~/.openclaw/openclaw.json` 的最小增量

说明：以下片段假设你已经有自己的 openclaw.json。你只需要把这些新增项合并进去即可。

如果你已经有同名 agent id（例如已存在 cos/cto），请改成不冲突的 id（例如 crew-cos），并同步修改 bindings。

A) 新增 Agents（`agents.list`）

把这些 agent 追加到你现有的 agents.list 里（不要删除你原来的 main）：

{
  "agents": {
    "list": [
      {
        "id": "cos",
        "name": "Chief of Staff",
        "workspace": "~/.openclaw/workspace-cos",
        "subagents": { "allowAgents": ["cos", "cto", "research", "ko", "builder"] },
        "heartbeat": { "every": "12h", "target": "feishu", "to": "group:<FEISHU_GROUP_ID_HQ>" }
      },
      {
        "id": "cto",
        "name": "CTO / Tech Partner",
        "workspace": "~/.openclaw/workspace-cto",
        "subagents": { "allowAgents": ["cto", "builder", "research", "ko"] }
      },
      {
        "id": "builder",
        "name": "Builder / Executor",
        "workspace": "~/.openclaw/workspace-builder",
        "subagents": { "allowAgents": ["builder"] }
      },
      {
        "id": "cio",
        "name": "CIO / Domain Specialist (Optional)",
        "workspace": "~/.openclaw/workspace-cio",
        "subagents": { "allowAgents": ["cio", "research", "ko"] }
      },
      {
        "id": "ko",
        "name": "Knowledge Officer",
        "workspace": "~/.openclaw/workspace-ko",
        "subagents": { "allowAgents": ["ko"] },
        "heartbeat": { "every": "12h", "target": "feishu", "to": "group:<FEISHU_GROUP_ID_KNOW>" }
      },
      {
        "id": "ops",
        "name": "Operations / Governance",
        "workspace": "~/.openclaw/workspace-ops",
        "subagents": { "allowAgents": ["ops", "ko"] }
      },
      {
        "id": "research",
        "name": "Research Worker (Spawn-only)",
        "workspace": "~/.openclaw/workspace-research",
        "subagents": { "allowAgents": [] }
      }
    ]
  }
}

B) A2A / 子智能体保护（`tools` + `session`）

{
  "tools": {
    "agentToAgent": { "enabled": true, "allow": ["cos", "cto", "ops"] },
    "subagents": { "tools": { "deny": ["group:sessions"] } }
  },
  "session": {
    "agentToAgent": { "maxPingPongTurns": 4 }
  }
}

C) 飞书群组绑定（`bindings`）

{
  "bindings": [
    { "agentId": "cos", "match": { "channel": "feishu", "peer": { "kind": "group", "id": "<FEISHU_GROUP_ID_HQ>" } } },
    { "agentId": "cto", "match": { "channel": "feishu", "peer": { "kind": "group", "id": "<FEISHU_GROUP_ID_CTO>" } } },
    { "agentId": "builder", "match": { "channel": "feishu", "peer": { "kind": "group", "id": "<FEISHU_GROUP_ID_BUILD>" } } },
    { "agentId": "cio", "match": { "channel": "feishu", "peer": { "kind": "group", "id": "<FEISHU_GROUP_ID_INVEST>" } } },
    { "agentId": "ko", "match": { "channel": "feishu", "peer": { "kind": "group", "id": "<FEISHU_GROUP_ID_KNOW>" } } },
    { "agentId": "ops", "match": { "channel": "feishu", "peer": { "kind": "group", "id": "<FEISHU_GROUP_ID_OPS>" } } },
    { "agentId": "research", "match": { "channel": "feishu", "peer": { "kind": "group", "id": "<FEISHU_GROUP_ID_RESEARCH>" } } }
  ]
}

D) 飞书 allowlist（`channels.feishu`）

⚠️ 注意：飞书的 OpenClaw 插件目前不支持 thread（话题）隔离。同一群组内的所有对话是平铺的，不能按 thread 隔离不同任务。详情见飞书接入指南 — Thread 限制。

{
  "channels": {
    "feishu": {
      "groups": {
        "<FEISHU_GROUP_ID_HQ>": { "allow": true, "requireMention": false },
        "<FEISHU_GROUP_ID_CTO>": { "allow": true, "requireMention": false },
        "<FEISHU_GROUP_ID_BUILD>": { "allow": true, "requireMention": false },
        "<FEISHU_GROUP_ID_INVEST>": { "allow": true, "requireMention": false },
        "<FEISHU_GROUP_ID_KNOW>": { "allow": true, "requireMention": false },
        "<FEISHU_GROUP_ID_OPS>": { "allow": true, "requireMention": false },
        "<FEISHU_GROUP_ID_RESEARCH>": { "allow": true, "requireMention": false }
      }
    }
  }
}

可选：开启 @mention gate（降噪；建议你跑通后再开）

开源版默认把知识群 / 运维群设为 requireMention: false，优先保证"照着做就能跑起来"。

如果你希望它们更安静（只在你显式 @mention 时才触发），把下面两项改成 true：

{
  "channels": {
    "feishu": {
      "groups": {
        "<FEISHU_GROUP_ID_KNOW>": { "allow": true, "requireMention": true },
        "<FEISHU_GROUP_ID_OPS>": { "allow": true, "requireMention": true }
      }
    }
  }
}

E) Heartbeat（推荐默认开启：本 snippet 已为 CoS/KO 开启）

很多人以为"有了 HEARTBEAT.md 文件就会自动跑心跳"，但 心跳是否运行由 openclaw.json 决定。

在上面的 agents.list 示例里，我们已经为 cos / ko 加了：

heartbeat.every = "12h"（≈每天 2 次）
heartbeat.target = "feishu" + to = "group:<...>"

重要规则（来自 OpenClaw 文档）：如果 agents.list[] 里任何一个 agent 配了 heartbeat 块，那么只有配置了 heartbeat 的 agents 才会运行心跳。因此：如果你原本依赖 agents.defaults.heartbeat 跑"全局心跳"，引入 per-agent heartbeat 后行为会变化。

如果你不想让 CoS/KO 运行心跳：删除这两个 agent 条目中的 heartbeat 块即可。验证心跳是否在跑：

openclaw system heartbeat last
# 需要时可手动启用/禁用
openclaw system heartbeat enable
openclaw system heartbeat disable

F) 工作区目录准备（强烈建议）

OpenCrew 的工作流会用到一些子目录（用于 daily memory、KO inbox/knowledge、CTO scars/patterns）。建议先创建（不会影响你现有配置）：

mkdir -p ~/.openclaw/workspace-{cos,cto,builder,cio,ko,ops,research}/memory
mkdir -p ~/.openclaw/workspace-ko/{inbox,knowledge}
mkdir -p ~/.openclaw/workspace-cto/{scars,patterns}

应用后：重启 + 验证

openclaw gateway restart
openclaw status

验证建议：

在技术群 @机器人发消息 → CTO 应答
让 CTO 给 Builder 派任务 → Builder 在执行群回复

回滚方式（很重要）

直接恢复备份：

cp ~/.openclaw/openclaw.json.bak.<timestamp> ~/.openclaw/openclaw.json
openclaw gateway restart

或手动回滚：

从 openclaw.json 删除本文件中新增的：
- agents.list 里新增的 OpenCrew agents
- bindings 新增条目
- channels.feishu.groups 的 allowlist 条目
- tools.agentToAgent / session.agentToAgent 的增量
（可选）删除新建目录：~/.openclaw/workspace-{cos,cto,builder,cio,ko,ops,research}

FilesExpand file tree

CONFIG_SNIPPET_FEISHU.md

Latest commit

History