# OpenClaw 接入飞书机器人操作指南

> OpenClaw（原 Clawdbot，昵称龙虾）是开源、本地优先的 AI 代理网关，能让大模型在服务器/本地电脑 7×24 小时运行，支持操作电脑、执行命令、浏览网页等能力。将其接入企业飞书后，可实现智能对话、消息推送、收发文件、审批交互、数据同步等自动化办公场景。

本教程从环境准备到功能测试，手把手完成全流程对接。

---

## 1. 前置准备

在开始配置之前，请确保：

| 准备项 | 说明 |
|-------|------|
| 飞书管理员账号 | 具备自建应用/机器人创建、权限配置、发布权限 |
| Node.js 环境 | 本地/服务器已安装 Node.js 22.x 及以上，npm/pnpm 可用 |
| 网络环境 | 服务器部署保证网络通畅（飞书 WebSocket 长连接无需公网域名） |
| 飞书开放平台 | 账号完成企业认证，客户端为最新版 |

---

## 2. 步骤一：安装 OpenClaw 核心程序

### 2.1 安装命令

```bash
# npm 国内镜像加速安装
npm install -g openclaw@latest --registry=https://registry.npmmirror.com

# 或使用 pnpm 安装
pnpm add -g openclaw@latest
```

### 2.2 验证安装

```bash
openclaw -v
```

执行后终端显示版本号，即为安装成功。

---

## 3. 步骤二：安装并启用飞书官方插件

### 3.1 启用内置插件

```bash
# 启用内置飞书插件
openclaw plugins enable feishu

# 查看插件状态
openclaw plugins list
```

### 3.2 手动安装（若未内置）

```bash
openclaw plugins install @openclaw/feishu
```

### 3.3 验证成功

验证成功会显示：
```
Feishu feishu loaded
```

---

## 4. 步骤三：在飞书开放平台创建企业自建应用

### 4.1 创建应用

1. 打开 [飞书开放平台](https://open.feishu.cn/app)
2. 使用管理员账号登录
3. 点击**创建企业自建应用**

![飞书开放平台](https://developer.qcloudimg.com/http-save/yehe-6649301/fb268b311ee121c4175a53fec8ff4a15.png)

### 4.2 填写应用信息

- **名称**：如 `OpenClaw AI 助手`
- **描述**：应用功能说明
- **图标**：上传应用图标

### 4.3 获取凭证

进入应用详情页，在**凭证与基础信息**中复制：
- **App ID**
- **App Secret**

> **重要**：务必保存 App ID 和 App Secret，这是后续配置的核心凭证。

### 4.4 添加机器人能力

1. 左侧导航：**应用能力** > **添加应用能力**
2. 选择**机器人**
3. 点击**添加**，开启机器人核心功能

![添加机器人能力](https://developer.qcloudimg.com/http-save/yehe-6649301/4c6fcdcdedb51dd77719be1a76d3077b.png)

---

## 5. 步骤四：配置 OpenClaw 飞书通道

### 5.1 交互式命令行配置

执行通道添加命令进入交互配置：

```bash
openclaw channels add
```

按提示依次配置：

| 配置项 | 选择/输入 |
|-------|----------|
| 通道类型 | Feishu/Lark (飞书) |
| 认证方式 | Enter App Secret |
| App Secret | 粘贴飞书应用凭证 |
| App ID | 粘贴飞书应用凭证 |
| 连接模式 | WebSocket (default) |
| 域名 | Feishu (feishu.cn) - China |
| 群聊策略 | Open - respond in all groups (requires mention) |
| 完成 | Finished |
| 绑定代理 | Yes，绑定到默认代理 main |

### 5.2 配置文件方式（批量部署）

创建配置文件：

```yaml
channels:
  feishu:
    enabled: true
    appId: "你的App ID"
    appSecret: "你的App Secret"
    connectionMode: "websocket"
    domain: "feishu.cn"
    groupChatPolicy: "open"
```

保存后执行：

```bash
openclaw gateway restart
```

---

## 6. 步骤五：飞书自建应用配置（权限 + 事件订阅）

### 6.1 配置权限管理

1. 左侧导航：**开发配置** > **权限管理**
2. 点击**开通权限**

![权限管理入口](https://developer.qcloudimg.com/http-save/yehe-6649301/20341c776c1da6aab3c61cad63e1d1a5.png)

### 6.2 开通即时通信权限

1. 选择**应用身份权限（tenant_access_token）**
2. 在分类中选择**消息与群组**
3. 勾选以下核心权限：

![权限选择](https://developer.qcloudimg.com/http-save/yehe-6649301/33083f7d18c4ec9031870b034c564fce.png)

| 权限名称 | 权限标识 | 说明 |
|---------|---------|------|
| 获取与更新群组信息 | `im:chat` | 获取群组基本信息 |
| 创建群 | `im:chat:create` | 创建新的群组 |
| 解散群 | `im:chat:delete` | 解散已有群组 |
| 操作群发言权限 | `im:chat:moderation:write_only` | 管理群发言权限 |

4. 点击**确认开通权限**

> **提示**：企业内部应用免审直接开通。

### 6.3 配置 WebSocket 长连接事件订阅

1. 左侧导航：**事件与回调** > **事件配置**
2. 订阅方式选择：**使用长连接接收事件（WebSocket）**
3. 点击**保存**
4. 点击**添加事件**，依次添加：

| 事件 | 说明 |
|-----|------|
| `im.message.receive_v1` | 接收消息 |
| `im.message.message_read_v1` | 已读回执 |
| `im.chat.member.bot.added_v1` | 机器人进群 |
| `im.chat.member.bot.deleted_v1` | 机器人被移出群 |

5. 所有事件选择**应用身份订阅**

---

## 7. 步骤六：发布飞书企业自建应用

### 7.1 创建版本

1. 左侧导航：**版本管理与发布** > **创建版本**

![创建版本](https://developer.qcloudimg.com/http-save/yehe-6649301/4145bccd0b769169047df3b357d7bc91.png)

### 7.2 填写版本信息

![版本配置](https://developer.qcloudimg.com/http-save/yehe-6649301/6c253b52e36d1dc0aed950332dd5c202.png)

| 配置项 | 示例值 |
|-------|-------|
| 应用版本号 | `1.0.0` |
| 移动端默认能力 | 机器人 |
| 桌面端默认能力 | 机器人 |
| 更新说明 | 即时通信机器人创建 |

### 7.3 配置发布范围

![发布配置](https://developer.qcloudimg.com/http-save/yehe-6649301/b94f97cbc158953a3d4a9d21716e6a46.png)

1. **可用范围**：选择全部成员或部分成员
2. **对外共享**：按需勾选外部群权限
3. **申请理由**：填写开通原因

### 7.4 提交发布

![申请发布](https://developer.qcloudimg.com/http-save/yehe-6649301/171a546ebd5298ca470702622aa15503.png)

1. 点击**申请线上发布**
2. 企业内部应用免审核，立即生效
3. 应用状态从「待上线」变为「已启用」

---

## 8. 步骤七：启动 OpenClaw 网关服务

### 8.1 启动命令

```bash
# 默认端口启动
openclaw gateway

# 自定义端口（避免冲突）
openclaw gateway --port 8888

# 服务器后台运行（pm2）
pm2 start openclaw -- gateway
```

### 8.2 验证启动成功

启动成功终端显示：
```
Gateway running on http://0.0.0.0:端口号
```

飞书通道状态为 `Running/Connected`。

---

## 9. 步骤八：飞书端添加机器人并配对测试

### 9.1 添加机器人

1. 飞书客户端搜索机器人名称（如 `OpenClaw AI 助手`）
2. 进入单聊

### 9.2 完成配对

1. 发送消息，获取**配对码**
2. 终端执行配对命令：

```bash
openclaw pairing approve feishu 配对码
```

### 9.3 功能测试

**单聊测试**：
- 发送「你好」，机器人回复即成功

**群聊测试**：
- @机器人 发送「介绍下自己」
- 机器人回复即成功

**文件收发测试**：
- 发送一张图片/文档给机器人
- 确认能接收并回复

---

## 10. 常见问题排查

### 问题1：机器人无响应

**排查步骤**：
1. 检查网关状态：`openclaw gateway status`
2. 核对飞书 App ID/Secret 与配置是否一致
3. 确认飞书应用已发布（状态显示「已启用」）

### 问题2：长连接失败

**排查步骤**：
1. 检查飞书事件配置页
2. 确认选中「WebSocket 长连接」而非 HTTP 回调

### 问题3：插件启用失败

**解决方案**：
```bash
# 升级 OpenClaw
npm update -g openclaw@latest

# 删除旧插件后重装
rm -rf ~/.openclaw/extensions/feishu
openclaw plugins install @openclaw/feishu
```

### 问题4：无法收发文件

**排查步骤**：
1. 检查飞书权限配置
2. 确认已开通 `aily:file:read` 和 `aily:file:write` 权限

---

## 11. 企业级拓展与优化

### 多机器人配置

```bash
# 添加多个飞书通道，绑定不同 AI 代理
openclaw channels add
```

### 权限精细化

将群聊策略改为 `Allowlist`，仅开放核心业务群：

```yaml
channels:
  feishu:
    groupChatPolicy: "allowlist"
    allowedGroups:
      - "群ID1"
      - "群ID2"
```

### 高可用部署

```bash
# pm2 守护 + 监控告警
pm2 start openclaw --name "openclaw-gateway" -- gateway
pm2 save
pm2 startup
```

### 飞书生态整合

可进一步对接：
- **飞书文档**：自动生成会议纪要
- **多维表格**：任务同步
- **日历**：日程管理

---

## 配置流程总结

```
环境准备
    ↓
安装 OpenClaw
    ↓
启用飞书插件
    ↓
创建飞书自建应用
    ↓
配置 OpenClaw 飞书通道
    ↓
配置飞书权限 + 事件订阅
    ↓
发布飞书应用
    ↓
启动 OpenClaw 网关
    ↓
飞书端配对测试
    ↓
    成功！
```

---

![logo.jpg](https://developer.qcloudimg.com/http-save/yehe-6649301/080f96a103c88f07f9a9c3d80769fe68.jpg)

OpenClaw（原 Clawdbot，昵称龙虾）是开源、本地优先的 AI 代理网关，能让大模型在服务器/本地电脑 7×24 小时运行，支持操作电脑、执行命令、浏览网页等能力。将其接入企业飞书后，可实现智能对话、消息推送、收发文件、审批交互、数据同步等自动化办公场景。

OpenClaw 接入飞书机器人

人工智能

OpenClaw接入飞书机器人教程：详细讲解从环境准备到功能测试的全流程对接，包括安装OpenClaw核心程序、配置飞书自建应用、设置WebSocket长连接、权限管理等关键步骤，帮助企业实现智能对话、消息推送、审批交互等自动化办公场景。

数据同步

服务器

4核4G3M云服务器 新用户低至38元/年！

2026新春采购季

domain

腾讯云 IM，全球通信，1折起


datainlong

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云AI代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

功能1上新10个字符

功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符。

功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符。

功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符

功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符

功能4上新

文章&问答评论现已支持表情

全新交互，全新视觉，新增快捷键、悬浮工具栏、高亮块等功能并同时优化现有功能，全面提升创作效率和体验

社区富文本编辑器全新改版！诚邀体验～ 

精选全网热门MCP server，让你的AI更好用 🚀

💥开发者 MCP广场重磅上线！

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

OpenClaw 接入飞书机器人-腾讯云开发者社区-腾讯云

OpenClaw 接入飞书机器人

OpenClaw 接入飞书机器人

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐