OpenClaw 飞书对接教程：本地部署 AI 助手

如果首次安装，时间会很长，需要耐心等待。 如果最后输出如下内容：

→ npm install failed; cleaning up and retrying...

新的脚本服务器内存要求变高了，据我使用下来 2G 内存，肯定会 OOM，如果出错的话，建议使用 swap 把硬盘空间当作交互内存使用。

成功之后会输出如下图片

第一个选项选择 yes，就是询问你是否知道风险的。 第二步选择 QuickStart

第三步选择模型服务商，这里选择 Qwen，免费额度充足，适合入门使用

选择千问模型后，会提供一个链接，复制并在浏览器中打开，如下图

打开浏览器后，会看到如下界面。由于我已登录过，所以显示账户信息；如果尚未登录，按照提示完成登录即可。

登录完成后，会出现以下选项，提示选择对应的千问模型，如下图

选择默认模型即可。接下来会提示选择 channel，这里先跳过，后续再添加

继续下面选择 skills，也是选择 No，如下图

继续下面选择 hooks，也是使用 空格 选择 No，如下图

然后等待安装完成，最后会出现以下选项，这里选择 TUI

如果看到 TUI 聊天界面，说明安装成功，可以尝试输入 Hello 进行测试。

然后直接使用 ctrl+c 先关闭，后面我们再来设置

查看服务

可以使用下面的命令来查看

clawdbot status

会看到如下图的结果就说明服务启动了

访问 Web UI 面板

如何访问面板？服务监听在 http://127.0.0.1:18789/ 端口上，我们现在通过 ssh 隧道来访问，输入下面的命令

ssh -N -L 18789:127.0.0.1:18789 用户名@服务器IP
# 回车之后 用户名@服务器 IP's password:
# 输入密码

然后在浏览器打开 http://127.0.0.1:18789/，你会看到 Dashboard 了，如下图

图中显示的是未授权状态，回到服务器，输入以下命令

clawdbot dashboard

会看到下面的面板数据

复制对应的 Dashboard URL 到浏览器打开，即可正常查看聊天记录。

至此 Openclaw 已安装完成，可以正常访问了。然后聊天框里面首次输入 Hello，OpenClaw 会询问你他应该叫什么，应该叫你什么。就是你需要给它设置个名字，还有 bot 改叫你什么。你可以在聊天框这么输入

Name: Openclaw My Name: Boss 

对接飞书

首先安装飞书插件，输入以下命令

clawdbot plugins install @m1heng-clawd/feishu

登录飞书开放平台 https://open.feishu.cn，点击「开发者后台 -> 创建企业自建应用」，如下图

然后点击创建应用，如下

创建完成后，首先到凭据管理中获取 App ID 和 App Secret，注意保存，后续配置需要使用。

然后添加机器人，如下操作

首先配置个名字

飞书的其他配置先暂停，回到服务器配置 Openclaw 的飞书参数

添加飞书配置

clawdbot config set channels.feishu.appId "飞书 app id"
clawdbot config set channels.feishu.appSecret "飞书 app secret"
clawdbot config set channels.feishu.enabled true
# 推荐使用 websocket
clawdbot config set channels.feishu.connectionMode websocket
clawdbot config set channels.feishu.dmPolicy pairing
clawdbot config set channels.feishu.groupPolicy allowlist
clawdbot config set channels.feishu.requireMention true

配置完成之后，重启

clawdbot gateway restart

重启完成后回到飞书，找到「事件和回调」，选择长连接模式，如下图

如果配置成功，说明连接已建立。继续下面的配置，添加事件，选择「接收消息」事件

事件添加完成之后，还需要开通权限，有以下权限全部勾选

如下图

以上步骤全部完成后，即可与机器人对话。但在此之前需要先创建一个版本

注意：每次修改配置后都需要重新发布版本，建议全部配置完成后再统一发布。

发布完成后，回到飞书客户端，可以看到应用已上线，点击打开应用

向机器人发送 Hello，即可收到 OpenClaw 的回复

常见问题 FAQ

OpenClaw 和 Clawdbot、Moltbot 是什么关系？

OpenClaw 是该项目的最新正式名称。项目最初叫 Clawdbot，后因商标问题更名为 Moltbot，最终在 2025 年 1 月正式定名为 OpenClaw。三者是同一个项目的不同阶段命名。

OpenClaw 支持哪些 AI 模型？

OpenClaw 支持多种 AI 模型服务商，包括 Anthropic Claude、OpenAI GPT、通义千问（Qwen）、KIMI、小米 MiMo 等。本教程使用通义千问是因为其免费额度充足，适合入门学习。

为什么安装时提示 npm install failed？

这通常是服务器内存不足导致的。新版本脚本对内存要求较高，2G 内存可能会出现 OOM（内存溢出）。建议配置 swap 交换空间，将硬盘空间作为虚拟内存使用。

OpenClaw 可以在 Windows 或 macOS 上运行吗？

可以。OpenClaw 支持 Mac、Windows 和 Linux 系统。本教程以 Linux 为例，其他系统的安装方式可参考 官方文档。

飞书机器人配置后无法收到消息怎么办？

请检查以下几点：

1. 确认飞书插件已正确安装（clawdbot plugins install @m1heng-clawd/feishu）
2. 检查 App ID 和 App Secret 配置是否正确
3. 确认已开通「接收消息」事件权限
4. 检查长连接模式是否配置成功
5. 确保应用版本已发布

OpenClaw 数据安全吗？

OpenClaw 运行在你自己的服务器上，所有数据都在本地存储，不会上传到第三方云端。但由于它具有系统级权限，建议在独立的服务器上部署，避免在生产环境或重要数据的机器上运行。

除了飞书，OpenClaw 还支持哪些平台？

OpenClaw 支持多个聊天平台，包括 WhatsApp、Telegram、Discord、Slack、Microsoft Teams、Signal、iMessage、Google Chat、Twitch 等。每个平台需要安装对应的插件。

OpenClaw 可以做什么？

OpenClaw 可以执行多种任务：

• 邮件管理和自动回复
• 日程安排和提醒
• 浏览网页和数据提取
• 文件读写和管理
• 执行 Shell 命令
• 编写和运行代码
• 数据查询和分析

如何更新 OpenClaw 到最新版本？

使用以下命令更新：

openclaw update

OpenClaw 命令和 clawdbot 命令有什么区别？

OpenClaw 更名后，官方推荐使用 openclaw 命令，但为了兼容性，clawdbot 命令仍然可用。两者功能完全相同，建议新用户直接使用 openclaw 命令。