OpenClaw 配置飞书教程

本文档从更新 OpenClaw 开始，介绍如何将 OpenClaw 接入飞书机器人。

一、更新 OpenClaw

openclaw update

^-^ 如果已经接入过第三方飞书插件，需要先删除旧配置：

# 进入 .openclaw/extensions 目录，删除 feishu 文件夹

rm -rf ~/.openclaw/extensions/feishu

如果没有接入过，忽略此步骤。

二、创建飞书机器人

2.1 创建应用

1. 访问 飞书开发者后台


2. 点击「创建企业自建应用」


3. 填写应用名称和描述（随意填写即可）

2.2 添加机器人能力

1. 进入应用，选择「添加应用能力」


2. 在右侧「按能力添加」菜单中找到「机器人」


3. 点击添加

2.3 开通权限

进入「权限管理」，开通以下权限：

在“权限”页面，点击“批量导入”并粘贴：

{

  "scopes": {

    "tenant": [

      "aily:file:read",

      "aily:file:write",

      "application:application.app_message_stats.overview:readonly",

      "application:application:self_manage",

      "application:bot.menu:write",

      "contact:user.employee_id:readonly",

      "corehr:file:download",

      "event:ip_list",

      "im:chat.access_event.bot_p2p_chat:read",

      "im:chat.members:bot_access",

      "im:message",

      "im:message.group_at_msg:readonly",

      "im:message.p2p_msg:readonly",

      "im:message:readonly",

      "im:message:send_as_bot",

      "im:resource"

    ],

    "user": ["aily:file:read", "aily:file:write", "im:chat.access_event.bot_p2p_chat:read"]

  }

}

三、配置 OpenClaw

3.1 添加飞书渠道

openclaw channels add

在列表中选择 feishu。

3.2 处理已有配置

如果出现 Feishu already configured，选择「修改配置」。

3.3 配置参数

按提示依次配置：

填写完成后选择 finish。

3.4 后续配置选项

Configure DM access policies now? → 选 No

Add display names for these accounts? → 选 No

3.5 重启 Gateway

openclaw gateway restart

四、配置飞书事件订阅

回到飞书开发者后台：

1. 选择「事件与回调」


2. 添加事件：im.message.receive_v1


3. 订阅方式选择「使用长连接接收事件」

五、验证

现在可以在飞书中使用 OpenClaw 了！

找到你创建的机器人应用，发送消息测试是否正常响应。

六、常用命令

# 更新 OpenClaw

openclaw update



# 添加渠道

openclaw channels add



# 重启服务

openclaw gateway restart



# 查看状态

openclaw gateway status



# 查看日志

openclaw logs --follow