OpenClaw + 飞书 CLI 完整使用教程

让 AI 智能体丝滑操控飞书：消息、文档、日历、多维表格全覆盖

目录

1. 方案概述
2. 飞书 CLI 核心能力
3. 安装与配置
4. OpenClaw 接入飞书
5. 飞书 CLI 在 OpenClaw 中的使用
6. 常见问题与诊断
7. 安全建议

方案概述

飞书 CLI (lark-cli)是飞书官方开源的命令行工具，让开发者和 AI Agent 通过终端调用飞书开放平台的 2500+ API 接口。

OpenClaw（俗称"小龙虾"）是一款开源的个人 AI 助手，能理解指令、操作文件、执行程序，并与飞书等协作平台无缝整合。

两者结合后，AI 助手可以： - 自动发送飞书消息 - 创建和管理飞书文档 - 操作多维表格和电子表格 - 管理日历和会议 - 处理任务和邮件

系统架构图

flowchart TB    subgraph 用户层["用户层"]        A[用户通过 OpenClaw 发起请求]    end    subgraph OpenClaw层["OpenClaw AI 助手"]        B[理解用户意图]        C[调用飞书 CLI Skills]    end    subgraph 飞书CLI层["飞书 CLI (lark-cli)"]        D[Shortcuts 快捷命令]        E[API Commands]        F[通用 API 调用]    end    subgraph 飞书平台["飞书开放平台"]        G[日历]        H[即时通讯]        I[云文档]        J[多维表格]        K[任务]        L[邮箱]    end    A --> B    B --> C    C --> D    C --> E    C --> F    D --> G    D --> H    D --> I    E --> J    E --> K    F --> L    style 用户层 fill:#e1f5fe    style OpenClaw层 fill:#fff3e0    style 飞书CLI层 fill:#e8f5e9    style 飞书平台 fill:#fce4ec

┌─────────────────────────────────────────────────────────────┐│                        用户                                │└─────────────────────────────────────────────────────────────┘                              │                              ▼┌─────────────────────────────────────────────────────────────┐│                     OpenClaw AI 助手                        ││  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐       ││  │  理解意图    │→ │  调用工具    │→ │  执行操作    │       ││  └─────────────┘  └─────────────┘  └─────────────┘       │└─────────────────────────────────────────────────────────────┘                              │                              ▼┌─────────────────────────────────────────────────────────────┐│                     飞书 CLI (lark-cli)                    ││  ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐          ││  │  日历   │ │  消息   │ │  文档   │ │  表格   │   ...    ││  └─────────┘ └─────────┘ └─────────┘ └─────────┘          │└─────────────────────────────────────────────────────────────┘                              │                              ▼┌─────────────────────────────────────────────────────────────┐│                        飞书平台                            │└─────────────────────────────────────────────────────────────┘

飞书 CLI 核心能力

覆盖 11 大业务域

三层命令架构

┌─────────────────────────────────────┐│  第一层：快捷命令 (Shortcuts)        │  ← 最友好，带智能默认值│  示例：lark-cli im +messages-send   │├─────────────────────────────────────┤│  第二层：API 命令                    │  ← 精选 100+ 命令│  示例：lark-cli calendar events list │├─────────────────────────────────────┤│  第三层：通用 API 调用               │  ← 覆盖 2500+ API│  示例：lark-cli api GET /open-apis/* │└─────────────────────────────────────┘

19 个 AI Agent Skills

能力总览思维导图

mindmap  root((飞书 CLI))    安装配置      npm install      config init      auth login    快捷命令      im +messages-send      calendar +agenda      docs +create      base +records    API 命令      calendar events      im messages      drive files    Skills      lark-shared      lark-calendar      lark-im      lark-doc      lark-base      lark-task    输出格式      --format json      --format table      --format pretty      --dry-run

安装与配置

环境要求

• Node.js ≥ v22
• npm 或 pnpm
• Git（源码安装需要）

安装飞书 CLI

# 安装 CLInpm install -g @larksuite/cli# 安装 CLI Skill（必需）npx skills add larksuite/cli -y -g

配置应用凭证

# 交互式引导配置lark-cli config init# AI Agent 模式：后台运行lark-cli config init --new

登录授权

# 推荐权限自动审批lark-cli auth login --recommend# 按业务域筛选lark-cli auth login --domain calendar,task# 查看登录状态lark-cli auth status

OpenClaw 接入飞书

安装 OpenClaw

Linux/macOS:bash curl -fsSL https://openclaw.ai/install.sh | bash

Windows (PowerShell 管理员模式):powershell iwr -useb https://openclaw.ai/install.ps1 | iex

安装飞书插件

# 安装飞书插件npx -y @larksuite/openclaw-lark install

配置流程图

flowchart LR    subgraph 安装["安装阶段"]        A1[安装 Node.js v22+]        A2[安装 OpenClaw]        A3[安装飞书插件]    end    subgraph 配置["配置阶段"]        B1[创建飞书应用]        B2[获取 App ID/Secret]        B3[配置权限清单]        B4[安装 lark-cli]    end    subgraph 授权["授权阶段"]        C1[lark-cli config init]        C2[lark-cli auth login]        C3[/feishu auth 授权]    end    subgraph 验证["验证阶段"]        D1[/feishu start]        D2[检查版本信息]        D3[发送测试消息]    end    A1 --> A2 --> A3    B1 --> B2 --> B3 --> B4    C1 --> C2 --> C3    D1 --> D2 --> D3    style 安装 fill:#4CAF50,color:#fff    style 配置 fill:#2196F3,color:#fff    style 授权 fill:#FF9800,color:#fff    style 验证 fill:#9C27B0,color:#fff

┌──────────────────────────────────────────────────────────────┐│                    飞书插件安装流程                           │└──────────────────────────────────────────────────────────────┘  1. 执行安装命令     ▼  ┌─────────────────────────────────────────┐  │ npx -y @larksuite/openclaw-lark install │  └─────────────────────────────────────────┘     ▼  2. 选择配置方式     │     ├─ 创建新机器人 → 扫描 QR Code → 建立机器人     │     └─ 使用现有机器人 → 输入 App ID 和 Secret     ▼  3. 授权权限     │     └─ 发送 /feishu auth 批量授权     ▼  4. 验证安装     │     └─ 发送 /feishu start → 显示版本信息 = 成功 ✓

详细配置步骤

步骤 1：创建飞书应用

1. 登录 飞书开放平台
2. 创建企业自建应用
3. 获取 App ID和 App Secret
4. 配置权限（批量导入）：

{  "im:message",  "im:message:send_as_bot",  "im:message.group_msg",  "calendar:calendar",  "calendar:calendar:readonly",  "task:task",  "docx:document",  "base:base",  "sheets:spreadsheet",  "contact:user.base:readonly",  "mail:mail"}

步骤 2：配置 Webhook

在应用配置中添加： - 请求地址：OpenClaw 网关地址 - 加密密钥：用于验证请求来源

步骤 3：验证连接

在飞书中向机器人发送： /feishu start

成功响应示例： ✓ 飞书插件已连接 版本: v1.0.0 已启用功能: 消息、文档、日历、表格...

飞书 CLI 在 OpenClaw 中的使用

常用命令示例

发送消息

# 快捷命令方式lark-cli im +messages-send --chat-id "oc_xxxxx" --text "Hello from OpenClaw!"# API 命令方式lark-cli im messages create --data '{"receive_id":"oc_xxxxx","msg_type":"text","content":"{\"text\":\"Hello\"}"}'

日历操作

# 查看今日日程lark-cli calendar +agenda# 创建会议lark-cli calendar events create --summary "团队周会" --start_time "2026-03-30T10:00:00+08:00" --end_time "2026-03-30T11:00:00+08:00"

文档管理

# 创建文档lark-cli docs +create --title "OpenClaw 使用笔记" --markdown "# 标题\n内容..."# 搜索文档lark-cli drive files search --query "OpenClaw"

多维表格

# 创建多维表格lark-cli base apps create --name "任务追踪"# 添加记录lark-cli base records create --app-id "bsixxxxx" --fields '{"任务名称":"测试","状态":"进行中"}'

在 OpenClaw 对话中使用

在 OpenClaw 聊天中直接用自然语言描述需求：

用户：帮我给项目组发一条飞书消息，告知本周五下午3点有技术评审会议OpenClaw：我将为你在飞书群中发送会议通知。

输出格式控制

# JSON 格式（默认）lark-cli calendar +agenda --format json# 人性化格式lark-cli calendar +agenda --format pretty# 表格格式lark-cli calendar +agenda --format table# CSV 格式lark-cli im +messages-send --format csv

Dry Run 预览

# 预览命令执行效果，不实际执行lark-cli im +messages-send --chat-id oc_xxxxx --text "Hello" --dry-run

常见问题与诊断

诊断命令

# 在飞书中发送/feishu start     # 检查安装状态/feishu doctor    # 诊断配置问题/feishu auth      # 批量授权权限# 命令行诊断npx @larksuite/openclaw-lark doctornpx @larksuite/openclaw-lark doctor --fix  # 自动修复

常见问题

问题 1：工具配置检查异常

错误信息： ⚠️ 工具配置检查异常 ⚠️ 工具基础允许列表: 当前为 coding，飞书工具可能无法加载

解决方案： bash openclaw config set tools.profile "full" openclaw gateway restart

问题 2：权限不足

解决方案： 1. 在飞书开发者后台添加权限 2. 重新发布应用版本 3. 用户重新授权

问题 3：cannot find module xxx

解决方案： bash cd ~/.openclaw/plugins/lark npm install

高级配置

群内回复模式

# 模式 1：仅 @机器人 才回复（推荐）openclaw config set channels.feishu.requireMention true --jsonopenclaw gateway restart# 模式 2：所有消息都回复（谨慎使用）openclaw config set channels.feishu.requireMention false --json# 模式 3：仅指定群需要 @mentionopenclaw config set channels.feishu.groups.oc_xxxxxxxx.requireMention true --json

启用多线程会话

openclaw config set channels.feishu.threadSession trueopenclaw gateway restart

安全建议

⚠️ 重要提醒：使用 AI Agent 操作飞书存在固有风险，包括模型幻觉、执行不可控、提示词注入等。

安全最佳实践

1. 不要主动修改默认安全配置
2. 建议将飞书机器人作为私人对话助手使用
3. 不要将其拉入群聊或允许其他用户交互
4. 涉及关键操作时使用 Preview 模式确认
5. API 密钥不要写入公开配置文件

权限控制

{  "channels": {    "feishu": {      "requireMention": true,      "groupPolicy": "allowlist",      "groupAllowFrom": ["ou_xxxxx"]  // 只允许特定用户    }  }}

审计日志

建议开启操作日志记录，便于追溯：bash openclaw config set logging.level "debug" openclaw config set logging.file "/path/to/audit.log"

相关资源

文档更新时间：2026年3月30日