1.打开飞书——创建群组

2.添加群组名称以及群成员

3.左侧打开创建的群组——点击三个点——设置

4.添加机器人

5.选择对应的机器人，依次添加进来，可以添加多个机器人

6.在群里@所有人或者单独机器人发现都没有回复，接下来我们需要配置下

7.查找群组id

8.openclaw.json配置修改

8.1 为群聊 Agent 添加工具权限

• 改动前：mainAgent 未配置工具权限，群聊中无法调用模型或工具。
• 改动后：为所有群聊 Agent 添加 tools.profile，确保能执行回复逻辑。

// agents.list 中各 Agent 新增
{
  "id": "main",
  "model": "sensenova/sensenova-6.7-flash-lite",
+ "tools": { "profile": "minimal" }  // 轻量权限（接待用）
},
{
  "id": "manager",
+ "tools": { "profile": "full" }     // 完整权限（执行任务）
},
{
  "id": "writer",
+ "tools": { "profile": "full" }     // 完整权限（写作任务）
}

// 完整list
"list": [
      {
        "id": "main",
        "model": "sensenova/sensenova-6.7-flash-lite",
	    "tools": {
          "profile": "minimal"
        }
      },
      {
        "id": "manager",
        "name": "manager",
        "workspace": "/root/.openclaw/workspace/manager",
        "agentDir": "/root/.openclaw/agents/manager/agent",
        "model": "deepseek/deepseek-v4-flash",
	    "tools": {
          "profile": "full"
        }
      },
      {
        "id": "writer",
        "name": "writer",
        "workspace": "/root/.openclaw/workspace/writer",
        "agentDir": "/root/.openclaw/agents/writer/agent",
        "model": "zai/glm-4.5-air",
	    "tools": {
          "profile": "full"
        }
      }
    ]

# 完整agents
"agents": {
    "defaults": {
      "workspace": "/root/.openclaw/workspace",
      "models": {
        "deepseek/deepseek-v4-flash": {
          "alias": "DeepSeek"
        },
        "zai/glm-4.5-air": {
          "alias": "GLM"
        },
        "sensenova/sensenova-6.7-flash-lite": {
          "alias": "SenseNova"
        }
      },
      "model": {
        "primary": "deepseek/deepseek-v4-flash"
      }
    },
    "list": [
      {
        "id": "main",
        "model": "sensenova/sensenova-6.7-flash-lite",
	    "tools": {
          "profile": "minimal"
        }
      },
      {
        "id": "manager",
        "name": "manager",
        "workspace": "/root/.openclaw/workspace/manager",
        "agentDir": "/root/.openclaw/agents/manager/agent",
        "model": "deepseek/deepseek-v4-flash",
	    "tools": {
          "profile": "full"
        }
      },
      {
        "id": "writer",
        "name": "writer",
        "workspace": "/root/.openclaw/workspace/writer",
        "agentDir": "/root/.openclaw/agents/writer/agent",
        "model": "zai/glm-4.5-air",
	    "tools": {
          "profile": "full"
        }
      }
    ]
  },

8.2 明确群聊权限策略（准入控制）

• 改动前：可能未显式配置群聊权限，或策略过严。
• 改动后：通过 groupPolicy+ groupAllowFrom+ groups三层控制，确保只有目标群能进，且无需 @ 即可回复。

 // channels.feishu 新增/调整
{
  "groupPolicy": "allowlist",          // 仅允许指定群组
  "groupAllowFrom": ["oc_533b58bb625e411111a81efbc5737e"],  // 目标群ID
  "requireMention": true,              // 全局默认需@，但被群配置覆盖
  "groups": {
    "oc_533b58bb625e4ee7bb3fa81efbc5737e": {
      "requireMention": true          // 该群需@回复
    }
  }
}

// 完整channels
 "channels": {
    "feishu": {
      "enabled": true,
      "defaultAccount": "main",
      "accounts": {
        "main": {
          "appId": "cli_aa83f01aa5f9dcbd",
          "appSecret": "CQ9pHgmikiJjDtafEyIfxeGsDtDEt0iQ",
          "name": "Primary bot",
          "tts": {
            "providers": {
              "openai": {
                "voice": "shimmer"
              }
            }
          }
        },
        "manager": {
          "appId": "cli_aa80568dbb78dcc4",
          "appSecret": "7ThoSzzTpkC2DfIcnWwUyg21WWBCriWN",
          "name": "Manager bot"
        },
        "writer": {
          "appId": "cli_aa81ae19deb9dcc6",
          "appSecret": "XCZq86IH3JG5FcpHJ6ad8cVkNNWTYY7s",
          "name": "Writer bot"
        }
      },
      "domain": "feishu",
      "dmPolicy": "allowlist",
      "allowFrom": [
        "ou_75dce55c2f809dfc09f52c8bc526c294",
        "ou_89a264d33137392b4e7e74f63be35f23",
        "ou_01dac560d8cb4ef22dd17083ff49b741"
      ],
      "groupPolicy": "allowlist",
      "groupAllowFrom": ["oc_533b58bb625e4ee7bb3fa81efbc5737e"],
      "requireMention": true,
      "groups": {
        "oc_533b58bb625e4ee7bb3fa81efbc5737e": {
          "requireMention": false
        }
      }
    }
  },

8.3 解除 mainAgent 的「仅私聊」限制

• 改动前：main的绑定强制限定为指定用户的私聊，群聊无法命中。
• 改动后：删除 peer字段，允许 main接收群聊消息。

// bindings 中 main 的配置
{
  "agentId": "main",
  "match": {
    "channel": "feishu",
    "accountId": "main"
-   "peer": { "kind": "direct", "id": "ou_75dce55c2f809dfc09f52c8bc526c294" }
  }
}

// 完整bindings
"bindings": [
    {
      "agentId": "main",
      "match": {
        "channel": "feishu",
        "accountId": "main"
      }
    },
    {
      "agentId": "manager",
      "match": {
        "channel": "feishu",
        "accountId": "manager"
      }
    },
    {
      "agentId": "writer",
      "match": {
        "channel": "feishu",
        "accountId": "writer"
      }
    }
  ],

8.4 确认 bindings路由正确（防消息串线）

• 改动后：确保三个 Agent 分别对应三个飞书账号，群聊消息不会串到其他 Agent。

// 确认配置
"bindings": [
    {
      "agentId": "main",
      "match": {
        "channel": "feishu",
        "accountId": "main"
      }
    },
    {
      "agentId": "manager",
      "match": {
        "channel": "feishu",
        "accountId": "manager"
      }
    },
    {
      "agentId": "writer",
      "match": {
        "channel": "feishu",
        "accountId": "writer"
      }
    }
  ],

8.5 群聊@不回复问题处理

• 群聊会话里代理生成的是普通文本回复（stopReason: stop），没有调用 message 工具发消息。
• 这就是根因：群聊 visibleReplies 默认值是 “message_tool”。
• 这意味着在群里，代理的普通文本回复被静默抑制，只有明确用 message 工具发送的内容才会显示。私聊不受这个规则限制
• 修改为下列配置，并重启gateway生效

// 原配置（默认行为）
// 群聊中普通回复 → 不显示

// 新配置
messages: {
  groupChat: {
    visibleReplies: "automatic"   // 群聊回复跟私聊一样，自动可见
  }
}

8.6 群聊功能汇总

• 准入：只有指定群能进（groupPolicy+ groupAllowFrom）
• 触发：群里需 @ 即可回复（groups.<chat_id>.requireMention: true）
• 执行：Agent 有权限调用模型/工具（tools.profile）
• 路由：消息正确分配到对应 Agent（bindings）

9.飞书群聊@所有人，全部回复

10.openclaw飞书群聊配置参考文档

https://docs.openclaw.ai/zh-CN/channels/feishu#群组配置示例