更新时间：2026-03-11

适配版本：OpenClaw的新网云主机应用镜像

一、概述

本文主要介绍在新网云主机中部署完成 OpenClaw 后，如何配置并接入飞书机器人；

二、前置准备工作

正式为 OpenClaw (Clawdbot) 配置接入飞书机器人前，需完成以下两项准备：

1.  已拥有有效的飞书账号；

2.  已购买新网云主机，且主机预装 OpenClaw 镜像。

三、接入飞书

3.1 创建飞书企业自建应用

1.  使用飞书账号登录飞书开放平台（开发者后台 - 飞书开放平台），登录后点击创建企业自建应用；

2.  按要求填写应用信息，完成后点击创建进入应用管理页面：

● 应用名称：建议填写如 “OpenClaw 助手”，字符数限制 8/32；

● 应用描述：按需填写，字符数限制 8/120；

● 应用图标：支持 JPEG/PNG/SVG/BMP 格式，大小 2MB 以内，分辨率大于 240*240px，无圆角。

3.2 添加机器人应用能力

1.  在已创建应用的管理页面左侧导航栏，点击添加应用能力；

2.  在弹出的能力列表中选择机器人，点击添加；

提示：添加机器人后可暂不发布，待后续所有配置完成后一并发布。

3.3 查询并保存 App ID 和 App Secret

1.  在应用管理页面左侧导航栏，点击凭据与基础信息；

2.  在页面中找到App ID和App Secret，分别点击右侧复制按钮，将两个参数妥善保存至记事本 / 备忘录（注意数据安全，切勿泄露），后续配置步骤需使用。

四、为 OpenClaw 配置模型和通道

4.1 进入claw设置页面

通过http://IP:18789/ 打开openclaw管理界面，点击右上角设置-claw设置；

4.2 模型配置

1.  已获取有效的 API Key（从对应大模型平台申请，如 OpenAI 官网、UCloud UModelVerse 控制台）

2.  OpenClaw 网关已启动（openclaw gateway status 确认状态为 running）

3.  通过终端命令引导配置，无需手动改文件，步骤如下：：

执行模型配置命令：openclaw models add

按终端提示逐步填写（以 OpenAI 兼容接口为例）

配置完成后，终端会提示 Model [名称] added successfully，执行以下命令生效：openclaw gateway restart

4.3 通道配置（飞书机器人）

4.  通道类型选择飞书，在输入框中填写前文保存的飞书机器人App ID和App Secret；

5.  点击确定并确认操作，等待数十秒完成配置；

6.  配置完成后查看通道状态，确保飞书通道显示运行中。

五、飞书机器人相关配置

5.1 事件配置

1.  返回飞书开放平台的应用管理页，左侧导航栏点击事件与回调，进入事件配置页签；

2.  订阅方式选择长连接接收事件，点击保存；

⚠️ 注意：若点击保存时报错未建立长连接，先检查飞书机器人的 App ID 和 App Secret 是否配置正确；

3.  点击添加事件，在弹出列表中搜索并添加接收消息（im.message.receive_v1），按页面指引确认开通对应权限；

4.  若需将机器人添加至群聊使用，可按上述步骤额外添加消息已读、机器人进群、机器人被移出群等群组相关事件。

5.2 回调配置

1.  在事件与回调页面，切换至回调配置页签；

2.  订阅方式选择使用长连接接收回调，直接点击保存，无需填写其他地址，配置将自动生效。

5.3 权限配置

1.  在飞书应用管理页左侧导航栏，点击权限管理进入配置页面；

2.  可按需单独开启权限，也可点击批量导入权限按钮，通过弹窗快速导入所需权限；

3.  基础权限（确保机器人基础功能运行，建议全部开通）：

4.  可选全功能权限（按需开启，部分为敏感权限）：|

提示：需确保消息、机器人、事件订阅等相关权限均已开启，后续使用中可根据需求随时调整权限设置。

六、创建版本并发布

1.  在飞书应用管理页左侧导航栏，点击版本管理与发布；

2.  点击页面右上角创建版本，按要求填写信息：

● 应用版本号：对用户展示的正式版本号，为必填项；

● 更新说明：内容将显示在应用的更新日志中，为必填项，字符数限制 0/500；

● 移动端 / 桌面端的默认能力：均选择机器人；

3.  填写完成后点击保存并确认发布；

等待飞书管理员审核，审核通过后，可在版本管理与发布页面查看已发布的版本号和状态（飞书个人版通常免审核，提交发布后可直接上线）。

七、配对操作

首次与飞书机器人对话时，若机器人返回配对请求消息（含 Feishu user id、Pairing code 及配对命令）

按以下步骤完成配对：

1.  复制机器人回复的最后一行命令行：openclaw pairing approve feishu [配对码]；

2.  登录新网控制台，通过SSH/VNC远程登录部署 OpenClaw 的轻量应用云主机（SSH 登录用户：root，端口：22）；

3.  在云主机的远程终端中粘贴上述复制的命令，按回车执行；

4.  命令执行成功后，终端将提示Approved feishu sender [用户 ID]，即表示配对完成。

八、与飞书机器人进行交互

完成上述所有配置和配对操作后，即可正常使用飞书机器人，支持两种交互方式：

1.  单聊交互：直接在飞书向 OpenClaw 机器人发送消息，已支持天气查询、新闻获取、诗词查询、图片 OCR 识别等功能；

2.  群聊交互：将 OpenClaw 机器人添加至飞书群聊，通过 **@机器人 ** 的方式发送指令，即可触发机器人交互；

更多功能场景可自行探索和解锁。