作者：CSDN博客
通过飞书接入 OpenClaw：实现移动端 AI 智能体对话
背景介绍
在上一篇文章中，我们介绍了如何接入自定义模型（参考：接入自定义模型实现智能工作），并通过 WebUI 完成智能任务处理。这种方式虽然功能强大，但需要在电脑端操作，不够便捷。
本文将介绍如何通过接入即时通讯工具飞书，让用户能够通过手机对话的方式远程使用 OpenClaw 智能体。无论你身在何处，只需在飞书中通过机器人对话，即可随时随地调用 AI 能力，实现移动办公智能化。
关键概念
在正式配置之前，我们需要理解 OpenClaw 中的两个核心概念：Channel 和 Plugin。
什么是 Channel？
根据 OpenClaw 官方文档，**Channel（通道）**是 OpenClaw 与外部通信平台集成的桥梁。它定义了智能体如何接收来自不同平台的消息，以及如何将回复发送回去。
简单来说，Channel 让 OpenClaw 能够：
接收消息：从飞书、Telegram、Slack 等平台获取用户输入发送回复：将 AI 生成的响应返回到对应平台管理会话：维护不同平台的对话上下文
OpenClaw 支持多种 Channel 类型，包括飞书/Lark、WhatsApp、Telegram、Discord、Slack 等，用户可以根据团队的使用习惯灵活选择。
什么是 Plugin？
根据 OpenClaw 官方文档，**Plugin（插件）**是扩展 OpenClaw 功能的模块化组件。每个插件封装了特定平台的集成逻辑，使得核心系统保持轻量的同时，能够灵活对接各种外部服务。
插件的主要作用包括：
平台适配：处理特定平台的认证、消息格式转换等功能扩展：为智能体添加特定能力（如飞书消息收发）独立维护：插件可以独立更新，不影响核心系统
对于飞书集成，我们需要安装 feishu-openclaw 插件（或官方 @openclaw/feishu 插件），它负责处理飞书的 WebSocket 长连接、事件订阅和消息转发。
接入配置说明
一、OpenClaw 配置与状态检测
根据 feishu-openclaw npm 文档，我们使用社区版插件来实现飞书接入。
1. 安装插件
- # OpenClaw 用户
- openclaw plugins install feishu-openclaw
openclaw config set channels.feishu.enabled true --json
openclaw config set channels.feishu.appId “cli_你的AppID”
openclaw config set channels.feishu.appSecret “你的AppSecret”
3.重启
openclaw gateway restart
4. 检测安装状态
安装完成后，可以通过以下命令检测插件状态：- # 查看网关状态
- openclaw gateway status
│ Feishu │ ON │ OK │ configured │
二、飞书 App 创建说明
根据 OpenClaw 飞书通道文档，创建飞书机器人应用需要以下步骤：
1. 访问飞书开放平台
打开 飞书开放平台 并登录。如果是国际版 Lark 用户，请访问 https://open.larksuite.com/app。
2. 创建企业自建应用
点击"创建企业应用"填写应用名称和描述选择合适的应用图标
3. 获取凭证信息
在"凭证与基础信息"页面，复制以下关键信息：
App ID（格式：cli_xxx）App Secret
⚠️ 重要提示：App Secret 是敏感信息，请妥善保管，不要泄露到公开仓库。
4. 配置权限
进入"权限管理"页面，按需添加权限"
这些权限允许机器人：
im:message：发送消息im:message.group_at_msg：接收群聊@消息im:message.p2p_msg：接收私聊消息
5. 启用机器人能力
在"应用能力"页面，添加"机器人"能力。
6. 配置事件订阅
⚠️ 关键步骤：必须先完成 OpenClaw 的 App ID/Secret 配置并启动 Gateway，才能配置事件订阅。
在"事件订阅"页面：
选择"使用长连接接收事件"（WebSocket 方式）添加事件：im.message.receive_v1
注意：如果 Gateway 未启动，长连接配置可能无法保存成功。
7. 发布应用
在"版本管理与发布"页面：
创建版本提交审核并发布等待管理员审批（企业内部应用通常自动通过）
三、Channel 与 Plugin 配置详解
以下是一份完整的 ~/.openclaw/openclaw.json 配置示例，我们重点解析与 Channel 和 Plugin 相关的配置项：- {"meta":{"lastTouchedVersion":"2026.2.17","lastTouchedAt":"2026-02-24T13:44:58.291Z"},"models":{"mode":"merge","providers":{"longCat":{"baseUrl":"https://api.longcat.chat/openai","apiKey":"your_key","api":"openai-completions","authHeader":true,"models":[{"id":"LongCat-Flash-Chat","name":"LongCat-Flash-Chat","contextWindow":200000,"maxTokens":8192}]}}},"agents":{"defaults":{"model":{"primary":"longCat/LongCat-Flash-Chat"},"workspace":"/Users/your/.openclaw/workspace","maxConcurrent":4}},"channels":{"feishu":{"enabled":true,"dmPolicy":"pairing","domain":"channels.feishu.domain","accounts":{"main":{"appId":"your_id","appSecret":"your_secret","botName":"My AI assistant"}}}},"gateway":{"port":18789,"mode":"local","bind":"loopback","auth":{"mode":"token","token":"1e3f5f388bb171fb3cc0bdf3189c1bad657d66c35a4a059b"}},"plugins":{"load":{"paths":["/Users/your/.openclaw/extensions/"]},"entries":{"feishu":{"enabled":true},"feishu-openclaw":{"enabled":true}},"installs":{"feishu-openclaw":{"source":"npm","spec":"feishu-openclaw","installPath":"/Users/your/.openclaw/extensions/feishu-openclaw","version":"0.3.1","installedAt":"2026-02-24T13:44:58.116Z"}}}}
| 参数 | 值 | 说明 | | enabled | true | 启用飞书通道 | | dmPolicy | "pairing" | 私信配对策略。pairing 表示未知用户需先配对验证；open 表示允许所有私信 | | domain | "channels.feishu.domain" | 飞书域名配置，国内版飞书可保持默认 | | accounts.main.appId | "cli_xxx" | 飞书应用的 App ID | | accounts.main.appSecret | "xxx" | 飞书应用的 App Secret | | accounts.main.botName | "My AI assistant" | 机器人显示名称 |
Plugin 配置解析（plugins）
| 参数 | 说明 | | load.paths | 插件加载路径，默认 ~/.openclaw/extensions/ | | entries.feishu.enabled | 启用官方飞书插件 | | entries.feishu-openclaw.enabled | 启用社区版飞书插件 | | installs.feishu-openclaw | 记录插件安装信息，包括来源、版本、安装路径等 |
配置方式选择
除了直接编辑配置文件，你还可以通过以下方式配置：
方式一：使用向导（推荐）- openclaw onboard
- # 或
- openclaw channels add
- exportOPENCLAW_CHANNELS_FEISHU_ACCOUNTS_MAIN_APPID="cli_xxx"exportOPENCLAW_CHANNELS_FEISHU_ACCOUNTS_MAIN_APPSECRET="xxx"
1. 启动 Gateway
或使用后台模式：2. 发送测试消息
在飞书中找到你的机器人（可通过搜索机器人名称），发送一条测试消息。
配对成功后，即可正常对话。
效果演示
对话
执行命令
注意事项
1. 插件安装失败问题
根据 GitHub Issue #14042，部分用户在安装飞书插件时可能遇到以下错误：- Failed to install @openclaw/feishu: npm install failed
- npm error code EUNSUPPORTEDPROTOCOL
- npm error Unsupported URL Type "workspace:": workspace:*
插件的 package.json 中 devDependencies 包含 "openclaw": "workspace:*"，而 npm pack 不会自动替换 workspace:* 协议，导致 npm install --omit=dev 失败。
解决方案：
删除本地插件，使用全局插件- rm -rf ~/.openclaw/extensions/feishu
参考
本文引用的页面地址列表：
接入自定义模型实现智能工作 - CSDNOpenClaw Channels 文档OpenClaw Plugins 文档feishu-openclaw - npmOpenClaw 飞书通道文档GitHub Issue #14042 - 插件安装失败问题飞书开放平台Lark 国际版开放平台
通过以上配置，你就可以在手机上通过飞书与 OpenClaw 智能体进行对话了。无论是在通勤路上还是外出办公，都能随时调用 AI 能力，大大提升工作效率。如果在配置过程中遇到问题，可以参考官方文档或在 GitHub Issues 中寻求帮助。
原文地址：https://blog.csdn.net/Revivedsun/article/details/158365717 |
广告