轻松搭建你的 AI 助手：保姆级 OpenClaw（原 Clawdbot）飞书对接全攻略

详尽解析 OpenClaw（前称 Clawdbot）飞书对接指南，教你轻松搭建 AI 助手

OpenClaw 是一款开源的本地 AI 助手，能够在个人服务器上自由部署，并支持通过飞书、WhatsApp、Telegram 等多种聊天工具进行互动。与云端的 SaaS 服务不同，OpenClaw 让用户完全掌握数据隐私，能够执行系统命令、浏览网页、管理文件，甚至进行代码编写。本文将详细指导你在 Linux 系统中安装 OpenClaw，并实现与飞书机器人的对接，打造你专属的智能助理。

温馨提示：本教程将基于 Linux 系统进行操作

OpenClaw 的基本介绍

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

• • 本地运行：能够在个人服务器或计算机上操作，确保数据完全自主可控

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

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

• • 系统访问权限：能够读写文件、执行 Shell 命令和运行脚本

• • 持久化记忆功能：能够记住用户的偏好和上下文，成为真正的个性化 AI

• • 插件扩展能力：支持社区开发的技能插件，甚至允许用户自行编写插件

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

准备工作

首先，你需要准备一台闲置的云服务器或 VPS（建议选择香港或海外节点）。由于 OpenClaw 需要较高的运行权限，因此出于安全考虑，不建议在本地计算机或工作机上进行安装，最好在一台独立的空服务器上部署。准备完成后，请登录到该服务器。

安装步骤

如果你不想手动安装，可以直接使用阿里云的 OpenClaw 一键部署 (原 Clawdbot)^[1]，完成部署后可以直接跳转到 对接飞书^[2]。

第一步，安装 Git

第二步，安装 Node.js

进行 OpenClaw 安装

如果你的服务器位于国内，若安装失败，可能需要处理网络问题

其他平台的安装方法可以参考OpenClaw 安装文档 (原 Clawdbot)^[3]，你将看到如下输出

OpenClaw (原 Clawdbot) 安装过程 – AI 助手部署初始化
若是首次进行安装，所需时间可能会较长，请耐心等待。
若最终输出如下内容：

新的脚本对服务器的内存要求较高，根据我的使用经验，2G 内存将会出现 OOM 的情况。如果发生错误，建议使用 swap 将硬盘空间作为交互内存。

安装成功后，你将看到如下图片

Openclaw (原 Clawdbot) 安装与配置指南

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) 选择千问 AI 模型版本

只需选择默认模型即可。接下来会提示您选择渠道，您可以先跳过此步骤，稍后再进行添加。

Openclaw (原 Clawdbot) channel 渠道配置选项

接着选择技能（skills），同样选择No，如下图所示：

Openclaw (原 Clawdbot) skills 技能配置选项

然后再选择 hooks，依旧选择 空格 并确定No，如下图所示：

Openclaw (原 Clawdbot) hooks 配置选项

之后，请耐心等待安装的完成，最后会出现以下选项，您需要选择TUI。

Openclaw (原 Clawdbot) 选择 TUI 终端界面

若您看到 TUI 聊天界面，表示安装已成功，您可以尝试输入 Hello 进行功能测试。

如何成功访问 Openclaw 服务

首先，您需要使用命令 ctrl+c 来关闭服务，之后我们将进行进一步的设置。

检查服务状态

接下来，您可以通过以下命令查看服务的运行情况。

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

Openclaw (原 Clawdbot) 服务状态检查 – AI 助手运行中

如何访问 Web UI 面板

您可能会问，怎样才能访问面板呢？服务正在 http://127.0.0.1:18789/ 端口上监听，我们将通过 SSH 隧道进行访问。请在终端中输入以下命令。

然后，在浏览器中打开 http://127.0.0.1:18789/，您将能够看到仪表板，如下图所示。

Openclaw (原 Clawdbot) Web UI Dashboard 未授权页面

在该图中，您可以看到未授权的状态。请返回到服务器，并输入以下命令。

执行后，您将看到面板的数据展示。

Openclaw (原 Clawdbot) 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 官方推荐使用 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/