OpenClaw 集成飞书命令行配置指南

1.5 启用机器人能力

进入「应用能力」→「机器人」页面，开启机器人能力并配置名称。

1.6 命令行配置 OpenClaw

1.6.1 安装飞书插件

openclaw plugins install @openclaw/feishu

输出示例：

🦞 OpenClaw 2026.2.26 (bc50708) — Your config is valid, your assumptions are not.
Downloading @openclaw/feishu…
Extracting /tmp/openclaw-npm-pack-J3n6oT/openclaw-feishu-2026.2.25.tgz…
Installing to /home/ubuntu/.openclaw/extensions/feishu…
Installed plugin: feishu
Restart the gateway to load plugins.

1.6.2 添加飞书渠道

运行以下命令，根据交互式提示完成配置：

openclaw channels add

操作步骤：

1. 选择渠道类型：Feishu
2. 输入 App ID（如 cli_xxx）
3. 输入 App Secret
4. 确认配置完成

交互示例：

◇ Select a channel │ Feishu/Lark (飞书)
◇ Feishu credentials ──────────────────────────────────────────────────────────────╮
│ 1) Go to Feishu Open Platform (open.feishu.cn)
│ 2) Create a self-built app
│ 3) Get App ID and App Secret from Credentials page
│ 4) Enable required permissions: im:message, im:chat, contact:user.base:readonly
│ 5) Publish the app or add it to a test group
├───────────────────────────────────────────────────────────────────────────────────╯
◇ Enter Feishu App ID │ cli_xxxxx
◇ Enter Feishu App Secret │ xxxxxxx
◇ Feishu connection test ────────────────────────────╮
│ Connection failed: API error: app do not have bot
├─────────────────────────────────────────────────────╯
◇ Which Feishu domain? │ Feishu (feishu.cn) - China
◇ Group chat policy │ Open - respond in all groups(requires mention)
◇ Selected channels ──────────────────────────────────╮
│ Feishu — 飞书/Lark enterprise messaging. Docs: feishu
├──────────────────────────────────────────────────────╯
◇ Configure DM access policies now? (default: pairing) │ Yes
◇ Feishu DM policy │ Open (public inbound DMs)
◇ Bind configured channel accounts to agents now? │ Yes
◇ Route feishu account "default" to agent │ main (default)
Channels updated.

1.6.3 重启网关

openclaw gateway restart

1.7 配置事件订阅（关键步骤）

⚠️ 注意：在配置事件订阅前，请确保已完成 OpenClaw 渠道添加并启动网关。

在「事件订阅」页面：

1. 选择 「使用长连接接收事件」（WebSocket 模式）
2. 添加事件：im.message.receive_v1

1.8 发布应用

进入「版本管理与发布」页面，创建版本并提交审核。企业自建应用通常会自动通过审批。

二、授权与测试

2.1 发送测试消息

在飞书中找到你的机器人（可在「应用」列表中搜索），发送一条消息。

2.2 批准配对码

默认情况下，机器人会回复一个 配对码。在终端执行：

# 查看待审批列表
openclaw pairing list feishu
# 批准配对（将 <CODE> 替换为实际配对码）
openclaw pairing approve feishu <CODE>

批准后，用户即可正常对话。

💡 获取 ID 技巧：通过 openclaw logs --follow 查看日志，可以获取用户的 open_id（格式 ou_xxx）和群组 chat_id（格式 oc_xxx），用于后续高级配置。

三、可选：配置文件手动编辑

如需更精细的控制，可直接编辑配置文件 ~/.openclaw/openclaw.json：

{"channels":{"feishu":{"enabled":true,"dmPolicy":"pairing","accounts":{"main":{"appId":"cli_xxx","appSecret":"your-secret-here","botName":"企业 AI 助手"}}}}}

国际版 Lark 用户需额外配置域名：

{"channels":{"feishu":{"domain":"lark","accounts":{"main":{"appId":"cli_xxx","appSecret":"xxx"}}}}}

四、结语

通过命令行方式，你可以在任何环境中快速部署 OpenClaw 飞书机器人。这种方式特别适合自动化脚本和服务器部署，让 AI 助手无缝融入你的工作流。