快速开始

本指南将帮助你快速安装和配置 OpenClaw 飞书插件。

环境要求

• Node.js: v22 或更高版本
• OpenClaw: 2026.2.26 或更高版本

安装步骤

1. 安装 OpenClaw 飞书插件

使用官方安装命令：

npx -y @larksuite/openclaw-lark-tools install

升级插件：

npx -y @larksuite/openclaw-lark-tools update

2. 在飞书开放平台创建应用

1. 访问 飞书开放平台
2. 创建自建应用
3. 获取 App ID 和 App Secret

3. 配置应用权限

在应用的权限管理中开通以下权限：

必需权限

权限名称	说明
im:message:send_as	发送消息
im:message:send_as_bot	以机器人身份发送消息
im:message:receive	接收消息
im:chat:readonly	读取群聊信息
im:chat:update_group_name	更新群名称

可选权限（根据需要开通）

权限名称	说明
doc:readonly	读取文档
doc:upload	上传文档
doc:create	创建文档
bitable:readonly	读取多维表格
bitable:create	创建多维表格
calendar:readonly	读取日历
calendar:event:create	创建日程
task:readonly	读取任务
task:create	创建任务

4. 配置 OpenClaw

编辑 ~/.openclaw/openclaw.json：

{
  "channels": {
    "feishu": {
      "enabled": true,
      "appId": "你的App_ID",
      "appSecret": "你的App_Secret"
    }
  }
}

5. 启动 OpenClaw

openclaw gateway restart

首次授权

插件安装完成后，用户需要通过 OAuth 进行授权：

1. 用户发送消息给机器人
2. 机器人自动发送授权卡片
3. 用户点击授权并完成登录
4. 授权成功后即可使用全部功能

验证安装

发送一条测试消息给机器人，确认响应正常。

下一步

• 配置指南 - 了解更多配置选项
• 工具参考 - 了解所有可用工具