在成功安装 OpenClaw 官方版本后，添加飞书 Bot 通常需要经过 插件安装 与 飞书端配置 两个主要步骤。

以下是一个标准的添加流程指南，结合了当前的最佳实践（2026 年 3 月数据）：

1. 安装飞书 Bot 插件

这是最核心的一步。OpenClaw 本身是一个框架，飞书 Bot 的功能是通过插件实现的。

• 打开终端：确保你的 openclaw 命令在 PATH 中。

• 执行安装指令：

openclaw plugins install @openclaw/feishu

注意：如果安装失败或提示版本冲突（旧版插件），可以尝试安装社区维护的最新版本：

openclaw plugins install @m1heng-clawd/feishu

2. 配置飞书开发者应用（在飞书开放平台）

这是在飞书端为 Bot 创建身份信息（App ID 和 App Secret）的过程。

• 访问飞书开放平台：打开 https://open.feishu.cn

• 创建自定义应用：

• 登录后，点击 ‍“创建企业自建应用”‍。

• 填写应用信息（如名称、描述、图标）。

• 添加机器人能力：

• 在左侧菜单中找到 ‍“应用能力”‍ → ‍“机器人”‍ → ‍“添加”‍。

• 注意：务必添加 ‍“机器人”‍ 能力，否则插件无法工作。

• 获取凭证：

• 前往 ‍“凭证与基础信息”‍，记录下 App ID。

• 在 ‍“安全设置”‍ 中，点击 ‍“生成 App Secret”‍ 并复制（注意保密）。

3. 在 OpenClaw 中绑定飞书信息

将飞书开发者平台的凭证输入到 OpenClaw 中。

• 交互式配置：

openclaw channels add# 交互式提示中选择 Feishu# 粘贴你的 App ID# 粘贴你的 App Secret

• 或手动修改配置文件：

• 打开 -/.openclaw/config.yaml（或 -/.clawdbot/config.yaml）。

• 添加或修改以下内容：

channels:
  feishu:
    appId: "你的App ID"
    appSecret: "你的App Secret"
    # 以下为可选配置
    # requireMention: true  # 是否需要 @ 机器人才能响应
    # groups:
    #   oc_xxxxxxxx:
    #     requireMention: true

4. (可选) 权限管理与发布

如果你希望 Bot 能够访问飞书的通讯录或知识库，需要在飞书开放平台额外开通权限。

• 权限开通：

• 在飞书左侧 ‍“版本管理与发布”‍ 中创建新版本并发布（可选择测试版本）。

• 前往 ‍“权限管理”‍ → ‍“开通权限”‍。

• 搜索并勾选如 ‍“contact:contact.base:readonly”‍（获取通讯录）等权限。

• 发布版本：

5. 重启网关

更改配置后，务必重启 OpenClaw 网关以加载新插件：

openclaw gateway restart

常见问题排查

• Bot 未响应：检查飞书是否已经在群聊中，并尝试 @ 机器人。如果配置了 requireMention: true，必须 @ 才会响应。

• 插件安装失败：尝试使用 sudo 权限或切换 Node.js 版本。

• 权限不足：部分功能（如访问通讯录）必须在飞书开放平台手动开通，否则 Bot 无法获取对应数据。

通过以上步骤，你的 OpenClaw 将成功接入飞书，实现跨平台的 AI 助手功能。