OpenClaw接入飞书远程控制机器完成任务

通过飞书接入 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. 安装插件

bash 复制代码

# OpenClaw 用户
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. 检测安装状态

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

bash 复制代码

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

json 复制代码

{
  "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`	记录插件安装信息，包括来源、版本、安装路径等

配置方式选择

除了直接编辑配置文件，你还可以通过以下方式配置：

方式一：使用向导（推荐）

bash 复制代码

openclaw onboard
# 或
openclaw channels add

方式二：环境变量

bash 复制代码

export OPENCLAW_CHANNELS_FEISHU_ACCOUNTS_MAIN_APPID="cli_xxx"
export OPENCLAW_CHANNELS_FEISHU_ACCOUNTS_MAIN_APPSECRET="xxx"

四、启动与测试

1. 启动 Gateway

bash 复制代码

openclaw gateway

或使用后台模式：

bash 复制代码

openclaw gateway start

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 失败。

解决方案：

删除本地插件，使用全局插件

bash 复制代码

rm -rf ~/.openclaw/extensions/feishu

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

参考

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

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

OpenClaw接入飞书远程控制机器完成任务

通过飞书接入 OpenClaw：实现移动端 AI 智能体对话

背景介绍

关键概念

什么是 Channel？

什么是 Plugin？

接入配置说明

一、OpenClaw 配置与状态检测

1. 安装插件

2. 启用

3.重启

4. 检测安装状态

二、飞书 App 创建说明

1. 访问飞书开放平台

2. 创建企业自建应用

3. 获取凭证信息

4. 配置权限

5. 启用机器人能力

6. 配置事件订阅

7. 发布应用

三、Channel 与 Plugin 配置详解

Channel 配置解析（channels.feishu）

Plugin 配置解析（plugins）

配置方式选择

四、启动与测试

1. 启动 Gateway

2. 发送测试消息

效果演示

对话

注意事项

1. 插件安装失败问题

参考

Channel 配置解析（`channels.feishu`）

Plugin 配置解析（`plugins`）