济南 OpenClaw 飞书接入怎么做：先把官方流程跑通，再谈工作流。

适合谁看

• 想把飞书消息接进 OpenClaw 的一人公司
• 需要先跑通机器人回复与消息同步的小团队
• 准备做本地部署、但不想一上来踩一堆配置坑的人

你会拿到什么

• 官方能力边界：OpenClaw 是自托管 Gateway，不是单独的飞书插件壳子
• 真实接入步骤：从 `openclaw onboard` 到 Feishu 长连接事件订阅
• 常见坑位：权限、网关状态、事件配置、Lark 域名差异

第 1 步：先把 OpenClaw 网关跑起来

• 安装后先跑 `openclaw onboard`，让向导把基础配置写好。
• 随后执行 `openclaw gateway status`，确认网关已经起来。
• 再用 `openclaw dashboard` 或本地控制台确认最基本的聊天能力可用。

这一层没通，后面飞书事件订阅即便填完也大概率收不到消息。

第 2 步：去 Feishu 开应用并拿凭证

• 进入 Feishu Open Platform 新建企业应用。
• 在 Credentials & Basic Info 里拿到 App ID 和 App Secret。
• 如果你用的是国际版 Lark，官方文档提醒要额外设置 `domain: \"lark\"`。

这一步最重要的是保管好 App Secret，不要乱散发。

第 3 步：权限别乱猜，按文档开

• Feishu 文档给了可批量导入的 scopes 列表，包括消息读取、发送、资源访问等权限。
• 至少要关注 `im:message`、`im:message:readonly`、`im:message:send_as_bot` 这类核心权限。
• 没批对权限，最常见现象就是应用能建起来，但机器人不收消息、不回消息。

这一步不要省，很多人就是卡在权限没配齐。

第 4 步：先开 Bot，再配事件订阅

• 先启用 Feishu 应用里的 Bot 能力并设置机器人名称。
• 官方文档强调：配事件订阅前，要先完成 `openclaw channels add` 且保证网关正在运行。
• 在 Event Subscription 里选择“Use long connection to receive events”，并添加 `im.message.receive_v1`。

如果网关没开就去配长连接，保存失败或者后续不生效，是非常常见的问题。