OpenClaw实战02-接入飞书通道

首先老话重谈说下OpenClaw 是什么，你就知道什么是通道。OpenClaw它是一个完整的 AI Agent 运行平台，他能做什么：是 OpenClaw 这个开源 AI 智能体网关与外部聊天 / 通讯平台之间的，负责把不同平台的消息格式统一、完成认证与消息收发，让你在常用聊天软件里直接使用 AI 助手openclawlab.com。

liaomin416100569

784人浏览 · 2026-03-05 16:39:04

liaomin416100569 · 2026-03-05 16:39:04 发布

什么是通道

首先老话重谈说下OpenClaw 是什么，你就知道什么是通道。
OpenClaw它是一个完整的 AI Agent 运行平台，他能做什么：

多渠道通信：通过 Telegram、WhatsApp、Discord、短信……你用什么聊天工具，它就在那里
工具调用：能执行命令行、读写文件、上网搜索、操作浏览器、调用 API
技能系统（Skills）：像手机装 App 一样，给助手安装新技能——Gmail 技能、日历技能、SEO 技能……
记忆系统：短期记忆（当天对话）、长期记忆（MEMORY.md）、身份记忆（SOUL.md）
心跳机制：不是你找它，是它定期醒来，检查有没有需要处理的事
完全本地部署：所有数据都在你的机器上，不经过任何第三方

换句话说：OpenClaw 让你可以拥有一个 24 小时在线、懂你、能做事、数据私有的 AI 助手。
而通道是openclaw和我们通信的工具，因为我们工作或者私人时间，会长期登录这些聊天工具比如飞书，钉钉等。
openclaw自动任务在完成后可以通过聊天工具机器人通知我们，假设openclaw安装在公司，我们家也可以通过飞书下发任务。

OpenClaw 通道（Channel） 是 OpenClaw 这个开源 AI 智能体网关与外部聊天 / 通讯平台之间的消息适配器与连接桥梁，负责把不同平台的消息格式统一、完成认证与消息收发，让你在常用聊天软件里直接使用 AI 助手openclawlab.com。

1、核心定位与作用

消息翻译官：把 Telegram、Discord、WhatsApp、飞书、企微等平台的消息，转换成 OpenClaw 内部统一格式；再把 AI 回复转成对应平台能识别的格式。
连接入口：是用户与 OpenClaw 交互的唯一外部入口，决定你在哪个 App 里和 AI 聊天。
路由节点：所有消息都通过通道进入 Gateway 网关，再分发给 Agent 处理openclawlab.com。

2、核心架构位置

OpenClaw 采用三层架构，通道是最外层：

plaintext

用户（Telegram/WhatsApp/飞书等）
        ↓
Channels（通道）→ 消息格式转换、认证、收发
        ↓
Gateway（网关）→ 消息路由、会话管理、调度Agent
        ↓
Agent（智能体）→ 执行任务、调用大模型与技能

3、常见通道类型与接入方式

OpenClaw 支持 20 + 主流平台，分为原生内置与插件扩展两类：

表格

通道类型	代表平台	接入方式	特点
即时通讯	Telegram	Bot Token（@BotFather 创建）	稳定、简单、延迟低
	WhatsApp	扫码配对（Baileys 库）	隐私性高、需手机号
	Signal	signal-cli（手机号注册）	端到端加密、隐私优先
社区 / 协作	Discord	Bot Token	适合游戏 / 开发者社区
	Slack	Socket Mode/OAuth	企业协作场景
国内平台	飞书 / 企微 / 钉钉	插件 / Webhook	需额外配置
苹果生态	iMessage	macOS 原生集成（imsg）	仅 macOS 可用
去中心化	Matrix/Nostr	标准协议 / 插件	开源、无中心

4、通道的核心能力

多协议适配：兼容 Bot API、WebSocket、Webhook、扫码登录等多种认证与连接方式。
消息格式处理：支持文本、图片、文件、语音、群聊 @提及、回复等openclawlab.com。
异步与重试：消息队列、失败重试、离线消息缓存openclawlab.com。
独立配置：每个通道可单独设置 AI 行为、权限、触发关键词。
统一体验：跨平台共享记忆与上下文，一个 AI 助手全平台可用。

5、简单示例（添加 Telegram 通道）

bash

运行

# 1. 在@BotFather创建机器人，获取Token
# 2. 执行命令添加通道
openclaw channels add --channel telegram --token 你的BotToken
# 3. 重启Gateway生效
openclaw restart

接入飞书

申请飞书应用

我们需要先到飞书平台创建自己的机器人来接入OpenClaw：

一）来到飞书开发者后台

飞书开放平台地址：https://open.feishu.cn

没有飞书账号的，需要自己注册账号

点击右上角进入 开发者后台：

在这里插入图片描述

二）创建应用

进入后点击创建应用
在这里插入图片描述

三）填写应用信息

输入应用名称和描述
在这里插入图片描述

四）获取自己的应用凭证

点击凭证和基础信息
在这里插入图片描述
appid和appsecrect就是你的凭证

五）给应用添加机器人

点击添加企业能力
在这里插入图片描述
点击机器人添加

添加机器人后，左侧菜单会出现机器人菜单。

六）给应用配置权限

点击权限管理
在这里插入图片描述
点击开通权限

搜索im:将应用身份权和用户身份权限的全部勾选。

七）创建版本并发布

点击创建版本。
在这里插入图片描述
设置版本后，添加更新说明，其他默认，点击保存。

点击确认发布

此时pc版本的飞书收到了消息

我个人版本的自动审批了，如果没有自动审批pc版本上消息点击同意即可

查看状态已发布

此时可以保存下你的APP_ID和App Secrect即可用于在openclaw上添加。

OpenClaw接入

安装插件

查看openclaw已安装的所有插件

D:\code\dify-main\docker>openclaw plugins list --enabled

🦞 OpenClaw 2026.2.23 (b817600) — I read logs so you can keep pretending you don't have to.

Plugins (4/4 loaded)
Source roots:
  stock: C:\ProgramData\nvm\v22.14.0\node_modules\openclaw\extensions

┌──────────────────────────────────┬─────────────────────────────────┬──────────┬──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┬───────────┐
│ Name                             │ ID                              │ Status   │ Source                                                                                                                                       │ Version   │
├──────────────────────────────────┼─────────────────────────────────┼──────────┼──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┼───────────┤
│ Device Pairing                   │ device-pair                     │ loaded   │ stock:device-pair/index.ts                                                                                                                   │           │
│                                  │                                 │          │ Generate setup codes and approve device pairing requests.                                                                                    │           │
│ Memory (Core)                    │ memory-core                     │ loaded   │ stock:memory-core/index.ts                                                                                                                   │ 2026.2.23 │
│                                  │                                 │          │ File-backed memory search tools and CLI                                                                                                      │           │
│ Phone Control                    │ phone-control                   │ loaded   │ stock:phone-control/index.ts                                                                                                                 │           │
│                                  │                                 │          │ Arm/disarm high-risk phone node commands (camera/screen/writes) with an optional auto-expiry.                                                │           │
│ Talk Voice                       │ talk-voice                      │ loaded   │ stock:talk-voice/index.ts                                                                                                                    │           │
│                                  │                                 │          │ Manage Talk voice selection (list/set).                                                                                                      │           │
└──────────────────────────────────┴─────────────────────────────────┴──────────┴──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┴───────────┘

查看插件名称
在这里插入图片描述

安装插件

openclaw plugins install @openclaw/feishu

安装报错

D:\code\dify-main\docker>openclaw plugins install @openclaw/feishu

🦞 OpenClaw 2026.2.23 (b817600) — Turning "I'll reply later" into "my bot replied instantly".

Downloading @openclaw/feishu…
[openclaw] Failed to start CLI: Error: spawn EINVAL
    at ChildProcess.spawn (node:internal/child_process:420:11)
    at spawn (node:child_process:753:9)
    at runCommandWithTimeout (file:///C:/ProgramData/nvm/v22.14.0/node_modules/openclaw/dist/exec-G9-WTRVN.js:195:16)
    at packNpmSpecToArchive (file:///C:/ProgramData/nvm/v22.14.0/node_modules/openclaw/dist/npm-registry-spec-DpVyCYaN.js:92:20)
    at file:///C:/ProgramData/nvm/v22.14.0/node_modules/openclaw/dist/npm-registry-spec-DpVyCYaN.js:351:30
    at withTempDir (file:///C:/ProgramData/nvm/v22.14.0/node_modules/openclaw/dist/npm-registry-spec-DpVyCYaN.js:12:16)
    at async installFromNpmSpecArchive (file:///C:/ProgramData/nvm/v22.14.0/node_modules/openclaw/dist/npm-registry-spec-DpVyCYaN.js:350:9)
    at async installFromNpmSpecArchiveWithInstaller (file:///C:/ProgramData/nvm/v22.14.0/node_modules/openclaw/dist/npm-registry-spec-DpVyCYaN.js:323:9)
    at async installPluginFromNpmSpec (file:///C:/ProgramData/nvm/v22.14.0/node_modules/openclaw/dist/installs-BhLHWyCZ.js:244:39)
    at async Command.<anonymous> (file:///C:/ProgramData/nvm/v22.14.0/node_modules/openclaw/dist/plugins-cli-CMxMTwV9.js:665:18)

报错代码
C:/ProgramData/nvm/v22.14.0/node_modules/openclaw/dist/exec-G9-WTRVN.js:195:16
找到这个文件，找到195行替换

const child = spawn(resolvedCommand, argv.slice(1), {
		stdio,
		cwd,
		env: resolvedEnv,
		windowsVerbatimArguments,
		...shouldSpawnWithShell({
			resolvedCommand,
			platform: process.platform
		}) ? { shell: true } : {}
	});

替换

       	const isWindows = process.platform === "win32";
        const child = spawn(resolvedCommand, argv.slice(1), {
		stdio,
		cwd,
		env: resolvedEnv,
		shell: isWindows,
		windowsVerbatimArguments: isWindows ? false : windowsVerbatimArguments,
	});

改完成功
在这里插入图片描述
重启网关

07:01:13 [gateway] [plugins] feishu failed to load from C:\Users\admin\.openclaw\extensions\feishu\index.ts: TypeError: (0 , _pluginSdk.createFixedWindowRateLimiter) is not a function

我这里因为是之前安装的openclaw 但是现在查询都是最新的插件，估计市场没做版本控制，建议升级下openclaw，我使用openclaw update也是失败，实在不行了直接卸载重装最新版
直接 npm uninstall openclaw && npm install -g openclaw@latest

配置插件

安装成功后，再打开一个新的命令窗口，开始配置飞书插件：
输入命令：

openclaw config

在这里插入图片描述
选择渠道:

选择配置链接:

是否安装如果之前已经安装插件会直接跳过（必须吐槽）先的回去删除删除在来配置。。。

openclaw plugins uninstall @openclaw/feishu
卸载后点击安装后安装appserect

输入appserect和appid（去open.feishu.cn应用中复制）

飞书测试选择websocket，选在Feishu(feishu.cn) - China

接受群组聊天：

在这里插入图片描述
选择完成：

在这里插入图片描述
选择yes：

选择open：

选择继续，完成配置：

重新启动gateway(openclaw gateway start)

在这里插入图片描述

飞书设置事件回调

回到飞书后台设置事件回调
在这里插入图片描述
选择使用长连接接收事件：

可以看到添加事件按钮由原来的灰色不可点击变为可点击：

添加接收消息事件：

给应用开通获取通讯录基本信息的权限：

重新发布版本：

跟前面的步骤一样，发布为在线应用即可。
现在可以在飞书中与 AI 助手对话了！

飞书对话

搜索机器人

来到飞书客户端或者手机飞书app上：
在这里插入图片描述

测试聊天

我在d盘有个aaa.txt
在这里插入图片描述
我在飞书上询问

帮我看下d:\aaa.txt是什么内容

结果：

在这里插入图片描述
我在gateway控制台发现错误

把这个权限加上即可

测试下查看天气

才安装我是没有安装任何技能的我尝试问他如何获取天气的

他是自动调用了默认安装的weather技能

正确的做法 — 我应该使用 weather 技能（位于 C:\ProgramData\nvm\v22.14.0\node_modules\openclaw\skills\weather\SKILL.md），这个技能通过 wttr.in 或 Open-Meteo 获取天气，不需要 API Key

在这里插入图片描述

查看会话

我们可以回到dashboard查看会话
在这里插入图片描述
点击会话进入可以看到聊天记录

2048 AI社区

有“AI”的1024 = 2048，欢迎大家加入2048 AI社区

更多推荐

OPENCLAW快速免费使用GLM5.1：硅基流动新手完全指南

2048 AI社区

大模型微调实战：从入门到精通，小白也能学会的收藏必备教程！

2048 AI社区

AI写教材必备！专业技巧大公开，低查重教材不是梦

2048 AI社区

所有评论(0)

查看更多评论

liaomin416100569

@liaomin416100569

已为社区贡献16条内容