全文向导
01 前言
02 核心架构
03 部署OpenClaw
04 接入飞书机
05 配置OpenClaw
06 总结
01 前言
OpenClaw的核心价值在于将你的电脑变成一个可对话的智能助手。通过IM软件(如飞书、Telegram、Discord等),你可以随时随地向它下达任务,它会在后台默默执行,然后通过IM软件把结果反馈给你。
飞书作为国内最流行的企业协作平台之一,集成了即时通讯、文档、日历等多种功能。将OpenClaw集成到飞书,不仅能让你在办公环境中随时调用AI助手,还能利用飞书的各种插件能力,打造更强大的工作流。
02 核心架构
1、架构图

2、工作原理
OpenClaw Gateway主动连接飞书WebSocket服务器
飞书有新消息时,通过WebSocket实时推送
Gateway接收消息后,路由到AI智能体处理
处理结果通过WebSocket返回飞书
03 部署OpenClaw
1、官方脚本直装(推荐 macOS / Linux)
打开终端,直接跑官方的向导命令。它会自动搞定Node环境等依赖,并引导你完成IM对接。
curl -fsSL https://openclaw.ai/install.sh | bash2、通过 npm 手动安装
如果你自带Node环境,可以直接通过包管理器安装。注意Node版本必须大于22,因为OpenClaw底层是基于TS编写的,Node就是它的运行环境。
# 检查Node版本node --version# 安装npm install -g openclaw@latest# 配置并启动后台守护进程openclaw onboard --install-daemon# 检查OpenClaw版本openclaw --version
3、根据向导配置
执行后进入向导:
openclaw onboard --install-daemon3.1、基础确认
如图,选择Yes,回车

3.2、向导模式
如图,默认QuickStart,回车

3.3、模型配置
新手建议使用千问的模型,OAuth登录授权即可,有免费额度。

有条件的可以用国外模型,免费的时不时限流,也可以购买国内的模型Token,各个云厂商推出的Coding Plan值得一试。
3.4、配置对话渠道
这里先跳过,最后通过框出的命令单独添加

3.5、配置搜索
先跳过,后续可配置

3.6、安装技能
所谓技能:一份扩展Agent能力的可组合、可复用的使用说明。可以选择No先跳过。

3.7、配置钩子
选择session-memory,上下键移动,按空格选中,然后回车。

3.8、启动网关
选择启动,因为我已经装了,这里选择Skip,回车。

3.9、浏览器对话
选择Open the Web UI,可以打开可视化页面。回车后,浏览器会打开:http://127.0.0.1:18789/,就可以通过会话窗口进行对话了。

04 接入飞书
国内四大IM应用,飞书、企微、钉钉、QQ,官方默认支持飞书,其它都可以通过插件的方式接入。下面以飞书为例,如果想接入其它聊天软件,到对应官方都会有详细的教程。
4.1、创建飞书企业自建应用
访问飞书开放平台:https://open.feishu.cn/app,登录飞书账号,创建企业自建应用。

填入应用名称和描述,点击创建。

4.2、复制凭证
创建完成后,进入应用详情页。从「凭证与基础信息」页面复制,后面会用到:

必填凭证:
App ID:应用的唯一标识(格式:`cli_xxx`)
App Secret:应用的密钥(32位字符串,注意保密)
4.3、配置机器人权限
在「权限管理」页面,点击「权限配置」→「批量导入权限」,粘贴以下JSON:
{"scopes": {"tenant": ["aily:file:read","aily:file:write","application:application.app_message_stats.overview:readonly","application:application:self_manage","application:bot.menu:write","cardkit:card:read","cardkit:card:write","contact:user.employee_id:readonly","corehr:file:download","event:ip_list","im:chat.access_event.bot_p2p_chat:read","im:chat.members:bot_access","im:message","im:message.group_at_msg:readonly","im:message.p2p_msg:readonly","im:message:readonly","im:message:send_as_bot","im:resource"],"user": ["aily:file:read", "aily:file:write", "im:chat.access_event.bot_p2p_chat:read"]}}
如下,JSON粘贴后保存。

4.4、启用机器人能力
在「添加应用能力」页面:
a. 点击「机器人」
b. 启用机器人能力
c. 设置机器人名称:如OpenClaw Bot
d. 保存

4.5、配置事件订阅(关键步骤)
配置事件订阅前,确保如下已完成,否则飞书事件配置连接会失败。:
a. 已运行 `openclaw channels add` 添加飞书渠道
b. OpenClaw Gateway正在运行(命令行执行确认`openclaw gateway status`)

然后点击“添加事件”按钮,搜索并添加事件 `im.message.receive_v1`,勾选后点击添加。

4.6、发布应用
在「版本管理与发布」页面:
a. 点击「创建版本」
b. 填写版本信息
c. 点击「提交审核」
d. 等待管理员批准(企业自建应用通常自动批准)

发布完成后,机器人就可以在飞书中使用了,还要把APP ID和APP Secret配置到OpenClaw,才能接入OpenClaw。
05 配置OpenClaw
1、命令行配置
# 添加飞书渠道,命令行执行openclaw channels add# 选择Feishu# 按照提示粘贴App ID和App Secret

2、测试连接
a. 在飞书搜索你的机器人应用名称(OpenClaw Bot)
b. 发送一条测试消息:「你好」
c. 默认情况下,机器人会返回一个配对码
d. 在命令行执行如下命令,批准OpenClaw配对:
# 查看待批准的配对请求openclaw pairing list feishu# 批准配对openclaw pairing approve feishu <CODE>
e、批准后,就可以通过机器人正常聊天了。
06 总结
OpenClaw与飞书的集成非常简单,核心优势是使用WebSocket长连接,无需内网穿透,配置只需要2个凭证。
OpenClaw之所以如此火的原因之一就是接入了我们常用的聊天软件,把一部分或少部分人能体验的Agentic能力推到了大众面前,就像25年年初DeepSeek爆火一样。当然还有OpenClaw的统一入口统一上下文、长期记忆和技能,也使得龙虾爆火并形成了龙虾越养越懂你越聪明的现象。
夜雨聆风