零基础搭建你的 AI 助手：保姆级 OpenClaw 飞书对接全攻略

轻松掌握 OpenClaw（前身为 Clawdbot）飞书对接指南，打造专属 AI 助手

OpenClaw 是一款开源的本地 AI 助手，用户能够在自己的服务器上进行部署，并通过飞书、WhatsApp、Telegram 等聊天工具进行交互。与传统的云服务相比，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 安装与配置指南

在安装过程中，首先你需要选择第一个选项，yes，这是用来确认您是否意识到风险的。

接下来的步骤是选择QuickStart。

在第三步中，您将需要选择一个模型服务提供商。在这里，我们推荐选择Qwen，它的免费使用额度非常充足，适合初学者进行尝试。

选择千问模型后，系统会生成一个链接，请将其复制并在浏览器中粘贴打开，界面如下所示。

当您打开浏览器时，将会看到一个界面。如果您已经登录过，界面上会显示您的账户信息；若未登录，请按照提示完成登录流程。

完成登录后，系统将展示相关选项，您可以在这里选择适合的千问模型，如下图所示。

Openclaw (原 Clawdbot) 选择千问 AI 模型版本

直接选择默认模型即可。随后会出现选择渠道的提示，暂时可以跳过，稍后再进行添加。

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

接下来需选择技能（skills），同样选择No，具体如下图所示

Openclaw (原 Clawdbot) skills 技能配置选项
然后继续选择 hooks，同样适用 空格，并选择No，如下图所示

Openclaw (原 Clawdbot) hooks 配置选项
接下来请耐心等待安装的完成，最终会出现如下选项，选择 TUI 即可。

Openclaw (原 Clawdbot) 选择 TUI 终端界面
如果您看到 TUI 聊天界面，便说明安装已成功，可以尝试输入 Hello 进行测试。

Openclaw (原 Clawdbot) TUI 聊天界面 – AI 助手对话测试
接下来，请使用 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 长连接模式

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

飞书添加接收消息事件 – Openclaw AI 助手

完成事件添加后，您还需启用相关权限，确保所有所需权限均已勾选。

如下图所示：

飞书权限配置 – Openclaw 用户信息权限

飞书消息权限配置 – Openclaw AI 机器人

在完成以上所有步骤后，您就可以开始与机器人进行对话了。不过，在此之前，还需创建一个版本。

飞书应用版本发布 – Openclaw AI 助手上线

温馨提示：每次进行配置修改后，务必重新发布版本。为确保顺利，建议在所有配置完成后再进行统一发布操作。

版本发布完成后，返回飞书客户端，即可看到应用已成功上线，点击即可打开。

飞书应用发布成功 – Openclaw AI 机器人
发送 Hello 到机器人，您将收到 Moltbot 的回复

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

常见问题 FAQ

OpenClaw 与 Clawdbot、Moltbot 有何关系？

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

OpenClaw 支持哪些人工智能模型？

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/