从零开始：在腾讯云服务器上部署 OpenClaw AI 助手（3）—— 飞书频道配置

让 AI 助手走进你的工作流，随时随地用飞书指挥它干活

前言

在前两篇博客中，我们完成了 OpenClaw 的基础部署和浏览器自动化配置。但有一个问题：每次想用 AI 助手，都得 SSH 登录服务器，进入 TUI 界面操作，这也太不方便了。

这篇博客将记录如何为 OpenClaw 配置飞书频道，让你可以直接在飞书 App 中与 AI 助手对话——无论是在电脑前还是在地铁上，随时掏出手机就能指挥 AI 干活。

为什么选择飞书？

OpenClaw 原生支持的频道主要是国际平台（WhatsApp、Telegram、Discord 等），对国内用户不太友好。好消息是，社区已经开发了国内平台的适配插件：

平台	状态	特点
钉钉	✅ 可用	支持 AI Card 流式输出，体验最佳
飞书	✅ 可用	支持 Markdown 卡片，企业用户首选
企业微信	✅ 可用	仅支持被动回复模式
QQ 机器人	🚧 开发中	-

本文选择飞书，原因如下：

• 🏢 企业场景友好：很多公司已经在用飞书办公
• 📱 多端同步：电脑、手机、平板无缝切换
• 🤖 机器人生态成熟：开放平台文档完善，配置相对简单
• 💬 支持群聊：可以把 AI 助手拉进项目群，团队共享

环境说明

接续前两篇博客的环境：

配置项	参数
操作系统	Ubuntu 24.04 LTS
OpenClaw 版本	2026.1.29
Node.js	v22.22.0
AI 模型	阿里云 DashScope qwen-flash
浏览器	Google Chrome（已配置）

配置流程概览

整个配置分为两大部分：

┌─────────────────────────────────────────────────────────────┐
│                      配置流程                                │
├─────────────────────────────────────────────────────────────┤
│                                                             │
│  服务器端                         飞书开放平台               │
│  ┌─────────────┐                 ┌─────────────┐           │
│  │ 安装插件     │                 │ 创建应用     │           │
│  │     ↓       │                 │     ↓       │           │
│  │ 配置凭证     │ ←── 凭证传递 ──→ │ 添加机器人   │           │
│  │     ↓       │                 │     ↓       │           │
│  │ 启动连接     │ ←── WebSocket ─→ │ 配置权限     │           │
│  └─────────────┘                 │     ↓       │           │
│                                  │ 事件订阅     │           │
│                                  │     ↓       │           │
│                                  │ 发布版本     │           │
│                                  └─────────────┘           │
└─────────────────────────────────────────────────────────────┘

第一部分：服务器端配置

1.1 安装国内频道插件

OpenClaw 通过插件系统支持不同的聊天平台。我们需要安装社区开发的 @openclaw-china/channels 插件：

openclaw plugins install @openclaw-china/channels

命令解释：

• openclaw plugins install：OpenClaw 的插件安装命令
• @openclaw-china/channels：统一渠道包，包含钉钉、飞书、企业微信的支持

安装成功后会看到：

Downloading @openclaw-china/channels…
Extracting /tmp/openclaw-npm-pack-xxx/openclaw-china-channels-0.1.24.tgz…
Installing to /home/ubuntu/.openclaw/extensions/channels…
Installing plugin dependencies…
Installed plugin: channels
Restart the gateway to load plugins.

1.2 重启 Gateway 加载插件

openclaw gateway restart

为什么需要重启？

OpenClaw 的 Gateway 是核心服务进程，插件只有在 Gateway 启动时才会被加载。就像安装了新软件后需要重启电脑一样，安装新插件后需要重启 Gateway。

1.3 验证插件安装

openclaw plugins list

在输出中找到类似这样的条目，确认插件已加载：

┌────────┬─────┬──────────┬────────────────────┬───────────┐
│ Name   │ ID  │ Status   │ Source             │ Version   │
├────────┼─────┼──────────┼────────────────────┼───────────┤
│ Moltbo │ cha │ loaded   │ ~/.openclaw/       │ 0.1.0     │
│ t      │ nne │          │ extensions/        │           │
│ China  │ ls  │          │ channels/dist/     │           │
│ Channe │     │          │ index.js           │           │
│ ls     │     │          │ 统一渠道包，支持钉钉、飞书、企业微信 │           │

状态显示 loaded 表示插件已成功加载。

第二部分：飞书开放平台配置

这部分需要在飞书开放平台（网页端）操作。

2.1 创建飞书应用

为什么要创建应用？

OpenClaw 本身只是运行在服务器上的程序，它不能直接"进入"飞书。我们需要在飞书开放平台注册一个"机器人应用"，这个应用就像是 OpenClaw 在飞书世界里的"身份证"。飞书通过这个应用的凭证来识别和信任你的 OpenClaw。

操作步骤：

1. 访问 飞书开放平台，用飞书账号登录
2. 点击右上角「开发者后台」
3. 点击「创建企业自建应用」
4. 填写应用信息：
   • 应用名称：OpenClaw（或你喜欢的名字）
   • 应用描述：OpenClaw AI 助手
   • 应用图标：上传一个图标（可选）
5. 点击「创建」

创建成功后，你会进入应用管理页面。

2.2 获取应用凭证

在应用管理页面，点击左侧菜单「Credentials & Basic Info」（凭证与基础信息），找到：

• App ID：类似 cli_xxxxxxxxxxxxxx
• App Secret：点击眼睛图标显示

⚠️ 重要：请妥善保管 App Secret，不要泄露给他人！

2.3 添加机器人能力

为什么要添加机器人能力？

飞书应用本身只是一个"空壳"，它可以有很多种能力：网页应用、小程序、机器人等。我们需要给它添加「机器人」能力，这样这个应用才能在飞书聊天中作为一个机器人出现，接收和发送消息。

操作步骤：

1. 点击左侧菜单「Add Features」（添加应用能力）
2. 找到「Bot」（机器人）选项
3. 点击添加

添加成功后，左侧菜单会出现「Bot」选项。

2.4 配置权限

为什么要配置权限？

飞书采用"最小权限原则"——应用默认什么都不能做。我们需要明确告诉飞书：“这个机器人需要读取消息、发送消息的权限”。这是一种安全机制，防止应用越权操作。

操作步骤：

1. 点击左侧菜单「Permissions & Scopes」（权限管理）
2. 搜索并添加以下权限：

权限	说明
im:message:read	读取消息
im:message:write	发送消息
im:message	读写私聊和群聊消息
im:message.group_at_msg:readonly	获取群里 @机器人的消息

3. 确认所有权限状态显示为 Added

2.5 配置服务器凭证

现在回到服务器，把飞书应用的凭证配置到 OpenClaw 中：

openclaw config set channels.feishu '{ "enabled": true, "appId": "你的AppID", "appSecret": "你的AppSecret" }' --json

命令解释：

• openclaw config set：设置 OpenClaw 配置项
• channels.feishu：飞书频道的配置路径
• --json：表示值是 JSON 格式

配置成功后会显示：

Updated channels.feishu. Restart the gateway to apply.

2.6 重启 Gateway 建立连接

openclaw gateway restart

重启后，OpenClaw 会使用你配置的凭证，通过 WebSocket 长连接到飞书服务器。

验证连接状态：

openclaw status --deep

在输出中找到 Channels 部分：

Channels
┌──────────┬─────────┬────────┬────────────────────────────┐
│ Channel  │ Enabled │ State  │ Detail                     │
├──────────┼─────────┼────────┼────────────────────────────┤
│ Feishu   │ ON      │ OK     │ configured                 │
└──────────┴─────────┴────────┴────────────────────────────┘

状态显示 ON 和 OK 表示飞书频道已正常启用。

2.7 配置事件订阅

为什么要配置事件订阅？

现在 OpenClaw 已经连接到飞书了，但飞书还不知道"当有人给机器人发消息时，应该通知谁"。事件订阅就是告诉飞书：当有消息发来时，请通过 WebSocket 连接通知我的服务器。

操作步骤：

1. 回到飞书开放平台，点击左侧菜单「Events & Callbacks」
2. 在「Subscription mode」中选择「Receive events through persistent connection」（通过长连接接收事件）
   • 这个选项标注了 Recommended，是推荐的方式
3. 点击「Save」保存

为什么选长连接模式？

飞书支持两种消息通知方式：

模式	原理	优缺点
Webhook	飞书主动调用你服务器的 HTTPS 接口	需要公网域名、SSL 证书，配置复杂
WebSocket 长连接	你的服务器主动连接飞书，保持长连接	不需要公网暴露，配置简单 ✅

2.8 添加消息接收事件

操作步骤：

1. 在「Events & Callbacks」页面下方，找到「Events added」区域
2. 点击「Add Events」按钮
3. 在搜索框中输入 im.message
4. 找到并勾选「Message received」（im.message.receive_v1）
5. 点击「Confirm」确认

这个事件的作用是：当有人给机器人发消息时，飞书会通过 WebSocket 推送消息内容给 OpenClaw。

2.9 发布应用版本

为什么要发布版本？

飞书应用有"开发版"和"正式版"的概念。我们之前做的所有配置都还在"开发版"中，需要发布一个版本才能正式生效。就像写代码一样，改完代码要"部署上线"才能让用户使用。

操作步骤：

1. 点击左侧菜单「Version Management & Release」
2. 点击「Create Version」
3. 填写版本号（如 1.0.0）和更新说明（如"首次发布"）
4. 点击「Save」保存
5. 点击「Publish」发布

如果提示「No approval is required」，说明不需要审批，发布后立即生效。

2.10 最终验证

回到服务器，重启 Gateway 并检查状态：

openclaw gateway restart
openclaw status --deep

确认 Feishu 频道状态为 ON 和 OK。

第三部分：测试机器人

现在是最激动人心的时刻——测试机器人是否正常工作！

3.1 在飞书中找到机器人

1. 打开飞书 App（手机或电脑）
2. 在搜索框中搜索你的应用名称（如「OpenClaw」）
3. 点击进入和机器人的对话

3.2 发送测试消息

发送一条消息试试：

你好

如果配置正确，机器人会在几秒内回复：

Hey! I'm OpenClaw — your personal assistant, here to help with whatever you need. What's on your mind? 😊

3.3 测试更多功能

尝试一些更复杂的对话：

你是基于什么大模型的？

机器人回复：

I'm based on Qwen, specifically the qwen-flash model from DashScope. It's optimized for fast, efficient reasoning...

🎉 恭喜！飞书机器人配置成功！

配置文件参考

以下是包含飞书配置的完整 ~/.openclaw/openclaw.json 示例：

{
  "gateway": {
    "mode": "local",
    "auth": {
      "mode": "token",
      "token": "your-gateway-token"
    },
    "port": 18789,
    "bind": "loopback"
  },
  "browser": {
    "enabled": true,
    "executablePath": "/usr/bin/google-chrome-stable",
    "headless": true,
    "noSandbox": true,
    "defaultProfile": "openclaw"
  },
  "channels": {
    "feishu": {
      "enabled": true,
      "appId": "cli_xxxxxxxxxxxxxx",
      "appSecret": "your-app-secret"
    }
  },
  "models": {
    "providers": {
      "dashscope": {
        "baseUrl": "https://dashscope.aliyuncs.com/compatible-mode/v1",
        "apiKey": "your-api-key",
        "api": "openai-completions",
        "models": [
          {
            "id": "qwen-flash",
            "name": "Qwen Flash",
            "reasoning": false,
            "input": ["text"],
            "cost": {
              "input": 0.15,
              "output": 1.5
            },
            "contextWindow": 1000000,
            "maxTokens": 32768
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "dashscope/qwen-flash"
      }
    }
  }
}

常用命令速查

命令	作用
openclaw plugins install @openclaw-china/channels	安装国内频道插件
openclaw plugins list	查看已安装的插件
openclaw config set channels.feishu '...' --json	配置飞书凭证
openclaw gateway restart	重启 Gateway
openclaw status --deep	查看完整状态（含频道状态）
openclaw logs --follow	实时查看日志
openclaw sessions reset main	重置会话

进阶配置

群聊中使用机器人

飞书机器人支持在群聊中使用。把机器人拉进群后，需要 @机器人 才能触发回复：

@OpenClaw 帮我总结一下今天的会议纪要

配置私聊/群聊策略

可以在配置中设置更细粒度的访问控制：

{
  "channels": {
    "feishu": {
      "enabled": true,
      "appId": "cli_xxx",
      "appSecret": "xxx",
      "dmPolicy": "open",
      "groupPolicy": "open",
      "requireMention": true
    }
  }
}

配置项	说明
dmPolicy	私聊策略：open（开放）/ allowlist（白名单）
groupPolicy	群聊策略：open / allowlist / disabled
requireMention	群聊中是否需要 @机器人 才回复

踩坑记录

坑 1：「Add Events」按钮是灰色的

现象：在飞书开放平台的「Events & Callbacks」页面，「Add Events」按钮无法点击。

原因：飞书要求先建立一次 WebSocket 连接，才允许添加事件订阅。

解决：先在服务器配置好飞书凭证并重启 Gateway，等 OpenClaw 连接到飞书后，刷新页面，按钮就可以点击了。

坑 2：提示 app did not establish a websocket connection

现象：选择长连接模式后，顶部弹出红色警告。

原因：这是正常的——你选择了长连接模式，但还没有程序连接过来。

解决：忽略这个警告，继续配置。等服务器端配置好并启动后，连接会自动建立。

坑 3：插件报错 plugin not found: feishu

现象：运行 openclaw doctor --fix 时报错。

原因：这是一个已知的小 bug，不影响实际功能。插件 ID 是 channels，不是 feishu。

解决：忽略这个错误。只要 openclaw status --deep 显示 Feishu 状态为 ON 和 OK，就说明配置成功了。

坑 4：机器人不回复消息

可能原因：

1. 应用未发布：检查是否已发布版本
2. 事件未订阅：检查是否添加了 im.message.receive_v1 事件
3. 权限不足：检查是否添加了消息读写权限
4. Gateway 未运行：检查 openclaw status --deep

排查方法：

# 查看实时日志
openclaw logs --follow

发送消息后观察日志，看是否有 feishu 相关的日志输出。

应用场景

配置好飞书频道后，你可以这样使用 AI 助手：

1. 随时随地提问

在地铁上、会议间隙、任何有网络的地方：

帮我解释一下 Transformer 的 self-attention 机制

2. 让 AI 帮你干活

结合浏览器自动化功能：

打开 arXiv，搜索最新的 LLM 论文，把前 5 篇的标题和摘要整理成表格

3. 团队协作

把机器人拉进项目群：

@OpenClaw 帮我们 review 一下这段代码有什么问题

4. 定时任务提醒

结合 OpenClaw 的 cron 功能，让机器人定时推送消息：

每天早上 9 点给我发送今日的日程安排

总结

通过这篇博客，我们完成了 OpenClaw 飞书频道的配置：

完成项	说明
✅ 安装国内频道插件	@openclaw-china/channels
✅ 创建飞书应用	获取 App ID 和 App Secret
✅ 配置机器人能力	添加 Bot 功能
✅ 配置消息权限	读写消息权限
✅ 配置 WebSocket 长连接	不需要公网域名
✅ 订阅消息事件	im.message.receive_v1
✅ 发布应用版本	使配置生效

现在，你可以在飞书中随时随地与 AI 助手对话了！🎉

关键收获：

• 理解了飞书开放平台的应用创建流程
• 掌握了 WebSocket 长连接模式的配置方法
• 学会了 OpenClaw 插件系统的使用
• 体验了"聊天即指令"的 AI 交互方式

---

本文记录于 2026 年 2 月 9 日，基于 OpenClaw v2026.1.29 版本

系列文章

• 从零开始：在腾讯云服务器上部署 OpenClaw AI 助手（1） —— 基础安装与模型配置
• 从零开始：在腾讯云服务器上部署 OpenClaw AI 助手（2） —— 浏览器自动化功能配置
• 从零开始：在腾讯云服务器上部署 OpenClaw AI 助手（3）—— 飞书频道配置（本文）
• 从零开始：在腾讯云服务器上部署 OpenClaw AI 助手（4）—— Skills 技能探索（计划中）

---

如果这篇文章对你有帮助，欢迎点赞、收藏、关注！有问题可以在评论区交流。