从零开始：在腾讯云服务器上部署 OpenClaw AI 助手（3）—— 飞书频道配置
从零开始：在腾讯云服务器上部署 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。
操作步骤：
- 访问 飞书开放平台，用飞书账号登录
- 点击右上角「开发者后台」
- 点击「创建企业自建应用」
- 填写应用信息：
- 应用名称：
OpenClaw（或你喜欢的名字） - 应用描述：
OpenClaw AI 助手 - 应用图标：上传一个图标（可选）
- 应用名称：
- 点击「创建」
创建成功后，你会进入应用管理页面。
2.2 获取应用凭证
在应用管理页面，点击左侧菜单「Credentials & Basic Info」（凭证与基础信息），找到：
- App ID：类似
cli_xxxxxxxxxxxxxx - App Secret：点击眼睛图标显示
⚠️ 重要：请妥善保管 App Secret，不要泄露给他人！
2.3 添加机器人能力
为什么要添加机器人能力？
飞书应用本身只是一个"空壳"，它可以有很多种能力：网页应用、小程序、机器人等。我们需要给它添加「机器人」能力，这样这个应用才能在飞书聊天中作为一个机器人出现，接收和发送消息。
操作步骤：
- 点击左侧菜单「Add Features」（添加应用能力）
- 找到「Bot」（机器人）选项
- 点击添加
添加成功后，左侧菜单会出现「Bot」选项。
2.4 配置权限
为什么要配置权限？
飞书采用"最小权限原则"——应用默认什么都不能做。我们需要明确告诉飞书：“这个机器人需要读取消息、发送消息的权限”。这是一种安全机制，防止应用越权操作。
操作步骤：
- 点击左侧菜单「Permissions & Scopes」（权限管理）
- 搜索并添加以下权限：
| 权限 | 说明 |
|---|---|
im:message:read | 读取消息 |
im:message:write | 发送消息 |
im:message | 读写私聊和群聊消息 |
im:message.group_at_msg:readonly | 获取群里 @机器人的消息 |
- 确认所有权限状态显示为
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 连接通知我的服务器。
操作步骤：
- 回到飞书开放平台，点击左侧菜单「Events & Callbacks」
- 在「Subscription mode」中选择「Receive events through persistent connection」（通过长连接接收事件）
- 这个选项标注了
Recommended，是推荐的方式
- 这个选项标注了
- 点击「Save」保存
为什么选长连接模式？
飞书支持两种消息通知方式：
| 模式 | 原理 | 优缺点 |
|---|---|---|
| Webhook | 飞书主动调用你服务器的 HTTPS 接口 | 需要公网域名、SSL 证书，配置复杂 |
| WebSocket 长连接 | 你的服务器主动连接飞书，保持长连接 | 不需要公网暴露，配置简单 ✅ |
2.8 添加消息接收事件
操作步骤：
- 在「Events & Callbacks」页面下方，找到「Events added」区域
- 点击「Add Events」按钮
- 在搜索框中输入
im.message - 找到并勾选「Message received」（
im.message.receive_v1） - 点击「Confirm」确认
这个事件的作用是：当有人给机器人发消息时，飞书会通过 WebSocket 推送消息内容给 OpenClaw。
2.9 发布应用版本
为什么要发布版本？
飞书应用有"开发版"和"正式版"的概念。我们之前做的所有配置都还在"开发版"中，需要发布一个版本才能正式生效。就像写代码一样，改完代码要"部署上线"才能让用户使用。
操作步骤：
- 点击左侧菜单「Version Management & Release」
- 点击「Create Version」
- 填写版本号（如
1.0.0）和更新说明（如"首次发布"） - 点击「Save」保存
- 点击「Publish」发布
如果提示「No approval is required」，说明不需要审批，发布后立即生效。
2.10 最终验证
回到服务器，重启 Gateway 并检查状态：
openclaw gateway restart
openclaw status --deep
确认 Feishu 频道状态为 ON 和 OK。
第三部分：测试机器人
现在是最激动人心的时刻——测试机器人是否正常工作！
3.1 在飞书中找到机器人
- 打开飞书 App（手机或电脑）
- 在搜索框中搜索你的应用名称（如「OpenClaw」）
- 点击进入和机器人的对话
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：机器人不回复消息
可能原因：
- 应用未发布：检查是否已发布版本
- 事件未订阅：检查是否添加了
im.message.receive_v1事件 - 权限不足：检查是否添加了消息读写权限
- 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 技能探索（计划中）
如果这篇文章对你有帮助，欢迎点赞、收藏、关注！有问题可以在评论区交流。
