AI创想

标题: OpenClaw接入飞书远程控制机器完成任务 [打印本页]

---

作者: 米落枫    时间: 3 天前
标题: OpenClaw接入飞书远程控制机器完成任务
作者：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. 安装插件

1. # OpenClaw 用户
2. openclaw plugins install feishu-openclaw

复制代码

2. 启用

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. 检测安装状态

安装完成后，可以通过以下命令检测插件状态：

1. # 查看网关状态
2. 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 相关的配置项：

1. {"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"}}}}

复制代码

Channel 配置解析（channels.feishu）

参数	值	说明
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	记录插件安装信息，包括来源、版本、安装路径等

配置方式选择

除了直接编辑配置文件，你还可以通过以下方式配置：
方式一：使用向导（推荐）

1. openclaw onboard
2. # 或
3. openclaw channels add

复制代码

方式二：环境变量

1. exportOPENCLAW_CHANNELS_FEISHU_ACCOUNTS_MAIN_APPID="cli_xxx"exportOPENCLAW_CHANNELS_FEISHU_ACCOUNTS_MAIN_APPSECRET="xxx"

复制代码

四、启动与测试

1. 启动 Gateway

1. openclaw gateway

复制代码

或使用后台模式：

1. openclaw gateway start

复制代码

2. 发送测试消息

在飞书中找到你的机器人（可通过搜索机器人名称），发送一条测试消息。
配对成功后，即可正常对话。

---

效果演示

对话

(, 下载次数: 0)

上传

点击文件名下载附件

执行命令

(, 下载次数: 0)

上传

点击文件名下载附件

注意事项

1. 插件安装失败问题

根据 GitHub Issue #14042，部分用户在安装飞书插件时可能遇到以下错误：

1. Failed to install @openclaw/feishu: npm install failed
2. npm error code EUNSUPPORTEDPROTOCOL
3. npm error Unsupported URL Type "workspace:": workspace:*

复制代码

问题原因：
插件的 package.json 中 devDependencies 包含 "openclaw": "workspace:*"，而 npm pack 不会自动替换 workspace:* 协议，导致 npm install --omit=dev 失败。
解决方案：
删除本地插件，使用全局插件

1. rm -rf ~/.openclaw/extensions/feishu

复制代码

然后在 ~/.openclaw/openclaw.json 中配置 appId 和 appSecret，并设置 plugins.entries.feishu.enabled: true。

---

参考

本文引用的页面地址列表：

接入自定义模型实现智能工作 - CSDNOpenClaw Channels 文档OpenClaw Plugins 文档feishu-openclaw - npmOpenClaw 飞书通道文档GitHub Issue #14042 - 插件安装失败问题飞书开放平台Lark 国际版开放平台

---

通过以上配置，你就可以在手机上通过飞书与 OpenClaw 智能体进行对话了。无论是在通勤路上还是外出办公，都能随时调用 AI 能力，大大提升工作效率。如果在配置过程中遇到问题，可以参考官方文档或在 GitHub Issues 中寻求帮助。

原文地址：https://blog.csdn.net/Revivedsun/article/details/158365717

---

欢迎光临 AI创想 (https://llms-ai.com/)

Powered by Discuz! X3.4