OpenClaw 飞书 / Lark 接入说明

OpenClaw 官方已经支持飞书 / Lark 消息通道。对国内用户来说，这通常比 Telegram 更顺手，也更适合团队内部协作。

返回热门工具 Windows 使用说明 macOS / Linux 使用说明
开始前先做这一步：先把 OpenClaw 本体安装好，并准备你自己的 Codex / Claude / Gemini 真实 Key。飞书通道只负责消息入口，不替代模型 Key 配置。

适合什么场景

适合
想把 OpenClaw 接进飞书私聊、团队群聊，作为日常问答、辅助开发和团队协作机器人。
不适合
只想在本地终端里使用 OpenClaw，不需要消息通道或团队聊天入口。

接入步骤

1

先在飞书开放平台创建应用

到飞书开放平台创建企业自建应用，开通机器人能力，并记录 App ID 与 App Secret。

入口可直接打开：open.feishu.cn。如果你使用国际版 Lark，可改走对应的 Lark 开放平台。

2

先确认 OpenClaw 版本

openclaw --version

建议使用较新的 OpenClaw 版本；如果版本偏旧，先更新后再继续配置飞书通道。

3

推荐两种接入方式

# 新装 OpenClaw，推荐先走引导
openclaw onboard

# 已经装好 OpenClaw，再单独添加飞书通道
openclaw channels login --channel feishu
# 或
openclaw channels add

如果你已经完成本地模型配置，通常直接用 openclaw channels login --channel feishu 或 openclaw channels add 更直接。

4

在 OpenClaw 中添加飞书通道

openclaw channels add

在交互式配置里选择 Feishu / Lark，再按提示填写应用信息。

5

推荐填写这些关键项

  • FEISHU_APP_ID：你的飞书应用 App ID
  • FEISHU_APP_SECRET：你的飞书应用 App Secret
  • FEISHU_DOMAIN：国内飞书填 feishu，国际版 Lark 填 lark
  • FEISHU_CONNECTION_MODE：推荐 websocket
6

重启网关

openclaw gateway restart

重启后，去飞书里私聊机器人或把机器人拉进群即可开始测试。群聊中建议通过 @ 提及机器人来触发。

默认行为与权限控制

私聊
默认通常走 dmPolicy = pairing。首次私聊机器人时，未知用户会拿到配对码，需要你在终端里批准。
配对审批
openclaw pairing list feishu 查看请求，openclaw pairing approve feishu <CODE> 批准。
群聊
默认通常不是“所有群都自动可用”。群里建议通过 @ 提及机器人来触发，同时按你的 group allowlist / policy 控制哪些群能用。
连接模式
推荐 websocket，这样通常不需要额外暴露公网 webhook 地址；只有你明确需要 HTTP 回调时再考虑 webhook。

排查命令

# 查看网关状态
openclaw gateway status

# 重启网关
openclaw gateway restart

# 查看配对请求
openclaw pairing list feishu

# 跟随日志
openclaw logs --follow

如果飞书里私聊机器人没有回应，先看网关状态和日志，再确认 App ID / Secret、pairing、群聊 allowlist 是否配置正确。

补充说明

  • 飞书 / Lark 通道只负责消息入口，不会替代你的模型配置。
  • 模型仍然走你在 OpenClaw 中配置好的 Codex / Claude / Gemini provider。
  • 如果你只想本地终端使用 OpenClaw，可以不接飞书通道。
  • 本页只介绍 OpenClaw 如何接飞书；飞书开放平台里更细的应用审核、发布范围、企业权限策略，仍以飞书官方控制台为准。