零基础搭建AI助手：保姆级OpenClaw（原Clawdbot）飞书对接全攻略

全方位指导：OpenClaw（前称 Clawdbot）与飞书的无缝对接教程

OpenClaw 是一款开源的本地 AI 助手，能够在您的服务器上进行部署，并支持通过飞书、WhatsApp、Telegram 等多种聊天工具进行互动。与传统的云端 SaaS 服务相比，OpenClaw 让您完全掌控个人数据隐私，能够执行系统命令、浏览网页、管理文件，甚至编写代码。本教程将逐步指导您在 Linux 系统中安装 OpenClaw，并实现飞书机器人的对接，从而创建属于您的智能助手。

温馨提示：本教程适用于 Linux 系统

OpenClaw 的介绍

OpenClaw（最初名为 Clawdbot，后更改为 Moltbot，现在正式称为 OpenClaw）是一款在本地环境中运行的高权限 AI 智能体。它的主要特点包括：

• • 本地运行：在您的服务器或个人电脑上操作，确保数据的完全控制

• • 跨平台兼容：支持飞书、WhatsApp、Telegram、Discord、Slack 等多种主流聊天工具

• • 网页操作：具备浏览网页、填写表单和提取数据的能力

• • 系统权限：可进行文件读写、执行 Shell 命令及运行脚本

• • 记忆功能：能够记住用户的偏好和上下文，实现个性化体验

• • 插件支持：支持社区开发的技能插件，同时用户也可自定义插件

无论是管理邮件、安排日程、查询数据，还是编写代码，OpenClaw 都能成为您得力的助手。

准备工作

首先，您需要准备一台空闲的云服务器或 VPS（建议选择香港或其他海外节点）。由于 OpenClaw 的运行权限较高，为了安全起见，建议不要在本地或工作电脑上安装，而是在一台独立的空服务器上进行部署。准备工作完成后，请登录到服务器。

安装步骤

如果您不愿意手动安装，可以直接选择阿里云的 Openclaw 一键部署 (原 Clawdbot)^[1]，部署完成后可以直接进入 对接飞书 ^[2] 的步骤。

第一步：安装 Git

第二步：安装 Node.js

OpenClaw 的安装过程

如果您的服务器位于国内，安装过程中可能会遇到网络问题，请提前做好准备

详细的安装方法请参阅Openclaw 安装文档 (原 Clawdbot)^[3]，您将看到如下输出

Openclaw (原 Clawdbot) 安装过程 – AI 助手部署初始化
如果是第一次安装，过程可能会较长，请耐心等待。
如果最后输出结果如下所示：

新的脚本对内存的要求有所提高，根据我的使用经验，至少需要 2G 内存，否则可能会出现 OOM 错误。如果遇到问题，建议使用 swap 将硬盘空间作为交互内存。

安装成功后，您将看到如下图示

成功安装 Openclaw (前身为 Clawdbot) – AI 机器人配置指南

在第一步中，选择 yes，该选项会询问您是否了解相关风险。
接下来，进行第二步，选择QuickStart。

Openclaw (前身为 Clawdbot) QuickStart 快速开始选项
在第三步中，需要选择模型服务提供商，推荐选择Qwen，因为它提供的免费额度非常充足，适合初学者使用。

Openclaw (前身为 Clawdbot) 选择 AI 模型服务商 Qwen 千问
选择“千问”模型后，系统会提供一个链接，您只需将其复制并在浏览器中打开，如下图所示。

Openclaw (前身为 Clawdbot) 千问模型授权链接
在浏览器中打开后，您将看到如下界面。由于我已提前登录，因而显示了账户信息；若尚未登录，请按照系统提示完成登录步骤。

Openclaw (前身为 Clawdbot) 千问 AI 账户登录页面
一旦登录成功，您将看到以下选项，系统将提示您选择相应的千问模型，如下图所示。

如何顺利安装并配置 Openclaw（前 Clawdbot）

在进入系统界面时，你会看到登录提示。若已提前完成登录，账户信息将会显示；否则，请根据系统的指引进行登录操作。成功登录后，系统会引导你选择千问模型的版本，如下图所示。

Openclaw（原 Clawdbot）选择千问 AI 模型版本

选择系统提供的默认模型即可。接下来，你将被提示配置渠道部分，这一步可以先跳过，后续可以再进行添加。

Openclaw（原 Clawdbot）channel 渠道配置选项

接下来，继续选择技能部分，依然是选择No，如下图所示：

Openclaw（原 Clawdbot）skills 技能配置选项

然后继续选择 hooks 部分，同样使用 空格 来选择No，如下图所示：

Openclaw（原 Clawdbot）hooks 配置选项

在等待安装完成后，系统将会呈现如下选项，你需要选择TUI：

Openclaw（原 Clawdbot）选择 TUI 终端界面

如果你能够看到 TUI 聊天界面，那么恭喜你，安装已成功。此时，你可以尝试输入 Hello 来进行功能测试。

如何成功访问 Openclaw TUI 聊天界面和管理面板

Openclaw TUI 聊天界面 – AI 助手对话测试

接下来，请使用 ctrl+c 指令关闭当前设置，稍后我们将进行更详细的配置。

检查服务状态

可以通过以下命令来确认服务是否正常运行：

如果你看到下图所示的结果，说明服务已经成功启动了。

Openclaw 服务状态检查 – AI 助手运行中

访问 Web UI 控制面板

那么如何进入控制面板呢？服务正在 http://127.0.0.1:18789/ 端口上监听，我们可以通过 SSH 隧道来实现访问，输入以下命令：

接着在浏览器中打开 http://127.0.0.1:18789/，你将看到 Dashboard 页面，如下图所示。

Openclaw Web UI Dashboard 未授权页面
如图所示，目前处于未授权状态。返回到服务器，输入以下命令：

你将看到下方的面板数据。

Openclaw Dashboard URL 获取命令
将相应的 Dashboard URL 复制到浏览器中打开，你便可以顺利查看聊天记录。

至此，Openclaw（原名 Clawdbot）的安装已经顺利完成，用户可以正常访问了。首次在聊天框输入 Hello 和 Clawdbot 时，系统将询问你希望它叫你什么，以及它该如何称呼你。这意味着你需要为它设置一个名字，同时也要指定它对你的称呼。你可以在聊天框中输入相关内容。

连接飞书

首先，需要安装飞书插件，输入下列命令进行操作。

接着，访问飞书开放平台 https://open.feishu.cn，点击“开发者后台 -> 创建企业自建应用”，如图所示。

飞书开放平台创建企业自建应用 – Openclaw 对接
然后，点击“创建应用”，如下图所示。

飞书创建应用 – Openclaw AI 机器人
在应用创建完成后，首先需要在凭据管理中获取到 App ID 和 App Secret，并务必妥善保存，以便后续配置使用。

飞书 App ID 和 App Secret 凭据管理
接下来，添加机器人，操作如下。

飞书添加机器人能力 – Openclaw AI 助手
首先为机器人设置一个名称。

飞书机器人名称配置 – Openclaw

目前可以先暂停飞书的其他设置，返回服务器进行 Openclaw 的飞书参数配置。

添加飞书参数配置

完成配置后，务必重启系统。

完成重启后，返回飞书平台，接着找到“事件和回调”选项，并选择长连接模式，如下所示：

若配置无误，表明连接成功建立。接下来，继续进行后续配置，添加“接收消息”事件：

在事件添加完成后，还需开启相应权限，确保所有相关权限均被勾选：

如下图所示：

完成以上步骤后，您便可以与机器人进行互动。不过在此之前，必须先创建一个应用版本：

请注意：每次对配置进行修改后，务必重新发布版本，建议在所有配置完成后再集中发布。

当发布成功后，您可以返回飞书客户端查看应用是否已成功上线，并点击以打开该应用。

飞书应用发布成功 – Openclaw AI 机器人

通过发送 Hello 给机器人，您将能收到 Moltbot 的回复。

飞书 Openclaw AI 助手回复测试成功

常见问题 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 为例，其他系统的安装方法可参考 官方文档^[4]。

如果飞书机器人配置后无法接收消息，该怎么办？

请确认以下几个方面：

1. 1. 确保飞书插件已顺利安装（clawdbot plugins install @m1heng-clawd/feishu）

2. 2. 核实 App ID 和 App Secret 的配置是否正确

3. 3. 确保已启用「接收消息」事件权限

4. 4. 检查长连接模式的配置是否成功

5. 5. 确保应用版本已成功发布

OpenClaw 的数据安全吗？

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

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

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

OpenClaw 能够执行哪些功能？

OpenClaw 可以完成各种任务：

• • 管理邮件和自动回复

• • 进行日程安排和提醒

• • 浏览网页并提取数据

• • 文件的读取与管理

• • 执行 Shell 命令

• • 编写及执行代码

• • 数据的查询与分析

如何将 OpenClaw 更新到最新版本？

请使用以下命令进行更新：

OpenClaw 命令与 clawdbot 命令有何区别？

在更名之后，官方推荐使用 openclaw 命令，然而为了保持兼容性，clawdbot 命令依旧可以使用。两者的功能完全一致，建议新用户直接使用 openclaw 命令。

引用链接

[1] Openclaw 一键部署 (原 Clawdbot): https://www.aliyun.com/activity/ecs/clawdbot?userCode=oq2t54oi
[2] 对接飞书: # 对接飞书
[3] Openclaw 安装文档 (原 Clawdbot): https://docs.openclaw.bot/install/installer
[4] 官方文档: https://docs.openclaw.ai/