windows+wsl+OpenClaw 安装指南（六）：飞书集成与企业部署

详解 OpenClaw 与飞书集成全流程，打造团队共享 AI 助手。涵盖飞书开放平台应用创建、机器人能力配置、WebSocket 连接模式设置、权限管理；OpenClaw 飞书配置参数详解（App ID/Secret、连接模式、私信策略）；私聊与群聊双场景实战（个人助手 vs 团队协作）；企业级部署建议（高可用架构、安全配置清单、性能优化）；以及飞书无回复、消息延迟等常见问题排查。支持通过飞书组织

littleM

343人浏览 · 2026-04-09 11:16:30

littleM · 2026-04-09 11:16:30 发布

windows+wsl+OpenClaw 安装指南（六）：飞书集成与企业部署 —— 打造团队AI助手

作者：技术实践派
标签：飞书 | IM集成 | 企业部署 | 团队协作 | 权限管理
难度：⭐⭐⭐☆☆（中级）
阅读时间：15分钟

一、前言

前几篇文章我们已经完成了 OpenClaw 的搭建和大模型配置。但 AI 助手的价值只有在融入日常工作流时才能最大化体现。

飞书（Lark）作为国内领先的企业协作平台，拥有完善的机器人生态和开放的 API 接口。将 OpenClaw 集成到飞书，可以实现：

团队共享 AI：一个机器人服务全团队，无需每人单独配置
场景化协作：在群聊中@机器人咨询问题，或私聊进行私密对话
知识沉淀：飞书聊天记录天然成为问答历史，便于追溯
权限管控：通过飞书组织架构控制访问权限

本文将详细介绍飞书开放平台配置、OpenClaw 集成步骤、企业级部署建议以及常见问题排查。

二、飞书开放平台配置

2.1 创建飞书应用

步骤 1：登录飞书开放平台

访问 https://open.feishu.cn/app ，使用企业管理员账号登录。

步骤 2：创建企业自建应用

点击「创建应用」→「企业自建应用」
填写应用信息：
- 应用名称：OpenClaw AI助手（可自定义）
- 应用描述：团队智能助手，支持问答、代码生成等功能
- 应用图标：上传自定义图标或使用默认图标

步骤 3：记录应用凭证

创建完成后，进入「凭证与基础信息」页面，记录以下关键信息：

App ID:     cli_xxxxxxxxxxxxxxxx      (示例: cli_xxxxxxxxxxxxxxxx)
App Secret: xxxxxxxxxxxxxxxxxxxxxxxx  (点击"查看"获取)

⚠️ 安全提醒：App Secret 相当于应用密码，请勿泄露！

2.2 配置机器人能力

步骤 1：启用机器人功能

进入「添加应用能力」→ 添加「机器人」能力。

步骤 2：配置消息订阅（WebSocket 模式）

OpenClaw 支持两种连接模式：

模式	特点	适用场景
WebSocket	实时双向通信，OpenClaw 主动连接飞书服务器	推荐，部署简单
Webhook	飞书主动推送消息到指定 URL	有公网 IP 或域名时可用

本文以 WebSocket 模式 为例（无需公网访问）。

进入「事件与回调」→「事件配置」：

加密方式：选择 “明文加密”（或根据企业安全要求选择）
订阅方式：选择 “长连接”（WebSocket）
添加事件：
- im.message.receive_v1（接收消息事件）
- im.chat.member.bot.added_v1（机器人被添加到群聊）

步骤 3：配置权限

进入「权限管理」，添加以下权限：

权限	用途
`im:chat:readonly`	读取群组信息
`im:message:send`	发送消息
`im:message.group_msg`	发送群消息
`im:message.p2p_msg`	发送私聊消息

2.3 发布应用

步骤 1：版本创建

进入「版本管理与发布」→「创建版本」：

版本号：1.0.0
更新说明：初始版本，支持智能问答
可用范围：选择「全部成员」或指定部门

步骤 2：申请发布

提交发布后，需要企业管理员审核通过。审核通过后，应用即可在飞书中使用。

三、OpenClaw 飞书配置

3.1 配置参数说明

编辑 config.env 文件，添加飞书配置：

# ============================================
# 飞书配置（可选）
# ============================================

# 是否启用飞书
ENABLE_FEISHU=true

# 飞书应用 App ID
# 获取地址: https://open.feishu.cn/app
FEISHU_APP_ID=cli_xxxxxxxxxxxxxxxx

# 飞书应用 App Secret
FEISHU_APP_SECRET=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

# 连接模式: websocket 或 webhook
FEISHU_CONNECTION_MODE=websocket

# 私信策略: open 或 closed
# - open: 允许用户私聊机器人
# - closed: 仅允许群聊@机器人
FEISHU_DM_POLICY=open

3.2 配置详解

App ID 与 App Secret

从飞书开放平台「凭证与基础信息」页面获取，用于身份认证。

Connection Mode（连接模式）

# WebSocket 模式（推荐）
FEISHU_CONNECTION_MODE=websocket
# 优点：无需公网 IP，OpenClaw 主动连接飞书服务器
# 缺点：依赖长连接稳定性

# Webhook 模式
FEISHU_CONNECTION_MODE=webhook
# 优点：飞书主动推送，实时性好
# 缺点：需要公网可访问的 URL，配置防火墙规则

DM Policy（私信策略）

# 开放私聊
FEISHU_DM_POLICY=open
# 用户可以直接私信机器人进行 1 对 1 对话
# 适合：个人助手场景

# 关闭私聊
FEISHU_DM_POLICY=closed
# 只能在群聊中@机器人
# 适合：团队协作场景，避免私聊滥用

3.3 配置生效

方式一：重新运行安装脚本

如果尚未安装，直接运行自动化安装脚本：

.\auto-install.bat

方式二：手动更新配置

如果已安装，手动修改 OpenClaw 配置：

# 进入 WSL
wsl -d Ubuntu-24.04

# 使用 Python 脚本更新配置
python3 << EOF
import json

config_path = "$HOME/.openclaw/openclaw.json"
with open(config_path, 'r') as f:
    config = json.load(f)

# 添加飞书配置
config['channels'] = {
    'feishu': {
        'appId': 'cli_xxxxxxxxxxxxxxxx',
        'appSecret': 'xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx',
        'connectionMode': 'websocket',
        'dmPolicy': 'open'
    }
}

# 允许局域网绑定（飞书 WebSocket 需要）
config['gateway']['bind'] = 'lan'

with open(config_path, 'w') as f:
    json.dump(config, f, indent=2)

print('飞书配置完成')
EOF

# 重启 Gateway 生效
systemctl --user restart openclaw-gateway.service

3.4 验证连接

查看日志确认连接状态：

wsl -d Ubuntu-24.04 -e journalctl --user -u openclaw-gateway.service -f

成功标志：

[Feishu] WebSocket connecting...
[Feishu] WebSocket connected successfully
[Feishu] Bot initialized: OpenClaw AI助手

四、使用场景实战

4.1 私聊场景（个人助手）

当 FEISHU_DM_POLICY=open 时，用户可以直接在飞书搜索机器人名称，发起私聊。

适用场景：

程序员询问代码问题
撰写邮件、文档辅助
快速查询知识点

使用示例：

用户：写一个 Python 函数，计算斐波那契数列

机器人：以下是计算斐波那契数列的 Python 函数：

```python
def fibonacci(n):
    """计算斐波那契数列前 n 项"""
    if n <= 0:
        return []
    elif n == 1:
        return [0]
    
    fib = [0, 1]
    for i in range(2, n):
        fib.append(fib[i-1] + fib[i-2])
    return fib

# 使用示例
print(fibonacci(10))  # [0, 1, 1, 2, 3, 5, 8, 13, 21, 34]

这个实现使用了迭代方法，时间复杂度为 O(n)，空间复杂度为 O(n)。
如果需要优化空间复杂度，可以只保存前两个值…


### 4.2 群聊场景（团队协作）

将机器人添加到群组后，群成员可以@机器人提问。

**适用场景**：
- 技术讨论时快速查询文档
- 新人问题统一入口
- 会议纪要的实时补充

**使用示例**：

张三：@OpenClaw AI助手解释一下什么是 RESTful API

机器人：@张三 RESTful API 是一种基于 REST 架构风格的 Web API 设计规范…

李四：@OpenClaw AI助手帮我检查一下这段 SQL 有没有问题
SELECT * FROM users WHERE name = “$name”

机器人：@李四这段 SQL 存在 SQL 注入风险！应该使用参数化查询…


### 4.3 企业级权限管理

**通过飞书组织架构控制访问**：

1. **部门隔离**：在飞书后台设置应用的「可见范围」，仅特定部门可见
2. **审批流程**：敏感操作可配置审批流程
3. **审计日志**：飞书开放平台提供完整的操作日志

**OpenClaw 层面的权限控制**：

```json
// openclaw.json 中可配置更细粒度的控制
{
  "channels": {
    "feishu": {
      "appId": "cli_xxx",
      "appSecret": "xxx",
      "connectionMode": "websocket",
      "dmPolicy": "open",
      "allowedGroups": ["group_id_1", "group_id_2"],
      "blockedUsers": ["user_id_xxx"]
    }
  }
}

五、企业级部署建议

5.1 高可用架构

对于企业级部署，建议采用以下架构：

┌─────────────────────────────────────────────────────────────────┐
│                        飞书服务器                                │
│                     (Lark/Feishu Cloud)                         │
└─────────────┬───────────────────────────────────────────────────┘
              │ WebSocket/Webhook
              ▼
┌─────────────────────────────────────────────────────────────────┐
│                    企业网络 / DMZ 区域                           │
│  ┌─────────────────────────────────────────────────────────┐   │
│  │              OpenClaw Gateway (WSL)                    │   │
│  │  ┌────────────┐  ┌────────────┐  ┌─────────────────┐   │   │
│  │  │  Feishu   │  │  Web UI    │  │  API 服务       │   │   │
│  │  │ Connector │  │  Server    │  │                 │   │   │
│  │  └─────┬──────┘  └────────────┘  └─────────────────┘   │   │
│  │        │                                               │   │
│  │  ┌─────▼──────────────────────────────────────────┐   │   │
│  │  │              双模型配置                         │   │   │
│  │  │  主: 腾讯混元 (hunyuan-turbos)                  │   │   │
│  │  │  备: Ollama 本地模型                           │   │   │
│  │  └────────────────────────────────────────────────┘   │   │
│  └─────────────────────────────────────────────────────────┘   │
└─────────────────────────────────────────────────────────────────┘

5.2 安全配置清单

检查项	建议配置	说明
网关绑定	`lan` 模式	不直接暴露到公网
Token 认证	启用强 Token	防止未授权访问
飞书 App Secret	定期轮换	建议每 90 天更换一次
日志审计	开启详细日志	便于问题追溯
模型访问	配置 fallback	主模型不可用时自动切换

5.3 性能优化

并发处理能力：

OpenClaw Gateway 默认单实例运行，对于企业级并发需求：

# 查看当前并发连接数
wsl -d Ubuntu-24.04 -e openclaw status

# 如需更高并发，考虑多实例部署 + 负载均衡
# 或使用更高配置的 WSL 环境

模型响应优化：

# 优先使用响应快的模型处理简单问题
openclaw config set agents.defaults.model.primary "tencent-coding-plan/hunyuan-turbos"

# 复杂任务切换到更强模型
openclaw config set agents.defaults.model.primary "tencent-coding-plan/hunyuan-2.0-thinking"

六、故障排查

6.1 飞书无回复

症状：在飞书@机器人或私聊，没有收到回复。

排查步骤：

# 1. 检查 Gateway 是否运行
wsl -d Ubuntu-24.04 -e systemctl --user status openclaw-gateway.service

# 2. 查看飞书连接日志
wsl -d Ubuntu-24.04 -e journalctl --user -u openclaw-gateway.service -f

# 3. 检查配置是否正确
wsl -d Ubuntu-24.04 -e openclaw config get channels.feishu

# 4. 确认飞书应用已发布
# 登录开放平台检查应用状态是否为"已发布"

常见原因：

原因	现象	解决
App Secret 错误	日志显示认证失败	重新复制正确的 Secret
应用未发布	飞书端看不到机器人	提交版本发布申请
权限不足	日志显示 403 错误	检查权限管理设置
WebSocket 断开	间歇性无响应	检查网络稳定性，考虑重连机制

6.2 消息延迟

症状：机器人回复有明显延迟。

排查：

# 检查模型响应时间
wsl -d Ubuntu-24.04 -e journalctl --user -u openclaw-gateway.service | grep "response_time"

# 测试网络延迟
wsl -d Ubuntu-24.04 -e ping open.feishu.cn

优化建议：

切换到响应更快的模型（如 hunyuan-turbos）
检查本地网络到飞书服务器的延迟
如果是本地 Ollama 模型，检查 GPU 利用率

6.3 群聊中无法@机器人

排查：

确认机器人已被添加到群聊
检查群聊权限设置（某些企业群禁止外部应用）
查看飞书开放平台的「事件订阅」是否正常

七、高级配置

7.1 自定义回复前缀

可在 OpenClaw 配置中添加回复前缀，区分机器人消息：

{
  "channels": {
    "feishu": {
      "replyPrefix": "🤖 [AI助手] "
    }
  }
}

7.2 消息长度限制

飞书单条消息有长度限制，可配置自动截断：

{
  "channels": {
    "feishu": {
      "maxMessageLength": 4000,
      "truncateMessage": true
    }
  }
}

7.3 多端同步

如果同时配置了 Web Dashboard 和飞书，消息可以互通：

{
  "agents": {
    "defaults": {
      "syncConversations": true
    }
  }
}

八、总结

通过本文，我们完成了 OpenClaw 与飞书的集成：

步骤	关键操作	验证方式
1	创建飞书应用	获取 App ID 和 Secret
2	配置机器人能力	启用消息订阅和权限
3	发布应用	企业管理员审核通过
4	配置 OpenClaw	修改 config.env 或 JSON
5	重启 Gateway	查看日志确认连接
6	测试使用	飞书@机器人