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

全方位解析 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 (原 Clawdbot) 的详细步骤

在整个安装过程中，首先需要选择第一个选项，即yes，这个选项会询问你是否了解相关的风险。

接下来，继续进行第二步，选择QuickStart。

随后，进入第三步，选择模型服务提供商。此处推荐选择Qwen，因为其免费额度非常充足，特别适合新手入门。

当你选择千问模型后，会生成一个授权链接。请将该链接复制，并在浏览器中粘贴打开，具体如下图所示。

在浏览器页面中，你将看到一个界面。如果你已经登录过账户，将直接显示你的账户信息；如果你尚未登录，请根据页面提示完成登录步骤。

一旦登录成功，你将看到一系列选项，提示你选择相应的千问模型，界面如图所示。

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

您可以直接选择默认模型。接下来会提示您选择频道，但我们可以先跳过这一步，稍后再进行添加。

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

接着，请继续选择技能选项，也就是选择No，如下图所示。

Openclaw (原 Clawdbot) skills 技能配置选项
紧接着，选择 hooks，依然使用 空格，并选择No，如下图所示。

Openclaw (原 Clawdbot) hooks 配置选项
然后请耐心等待安装过程完成，最后会出现下方选项，在此选择TUI。

Openclaw (原 Clawdbot) 选择 TUI 终端界面
当您看到 TUI 聊天界面时，表示安装成功，您可以尝试输入 Hello 进行功能测试。

轻松访问 Openclaw 的 Web UI 面板

首先，我们可以通过输入相应的命令来关闭当前的服务设置，之后再进行其他配置。

验证服务状态

请使用以下命令来检查服务的状态：

若显示出图中所示的结果，便意味着服务已成功启动。

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 操作指南

Openclaw (前身为 Clawdbot) 网络界面管理面板 – AI 助手聊天记录

至此，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 机器人

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

常见问题解答

OpenClaw 与 Clawdbot、Moltbot 之间的关系是什么？

OpenClaw 是该项目的正式名称，最初该项目称为 Clawdbot。由于商标问题，后更名为 Moltbot，最终在 2025 年 1 月确定为 OpenClaw。实际上，这三者代表的是同一项目的不同发展阶段。

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

OpenClaw 兼容多种人工智能模型服务，包括 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/