共计 4606 个字符,预计需要花费 12 分钟才能阅读完成。
手把手教你如何搭建保姆级 OpenClaw(前身为 Clawdbot)飞书对接
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) 安装成功 – AI 机器人配置向导
首先,在第一个选项中选择 yes,这是一个询问是否了解风险的提示。
接下来,第二步选择QuickStart。

Openclaw (原 Clawdbot) QuickStart 快速开始选项
在第三步时,选择模型服务提供商,推荐选择Qwen,因为其免费额度相当充足,非常适合初学者使用。

Openclaw (原 Clawdbot) 选择 AI 模型服务商 Qwen 千问
选择千问模型之后,将会生成一个链接,复制该链接并在浏览器中打开,如下所示。

Openclaw (原 Clawdbot) 千问模型授权链接
一旦打开浏览器,您将看到如下界面。由于我之前已经登录,因此显示了账户信息;如果您尚未登录,请按照界面提示进行登录。

Openclaw (原 Clawdbot) 千问 AI 账户登录页面
完成登录后,您会看到以下选项,提示您选择相应的千问模型,如下图所示。
如何顺利安装 Openclaw (原 Clawdbot) 并选择 AI 模型

Openclaw (原 Clawdbot) 选择千问 AI 模型版本
在此步骤中,您只需选择默认的模型。随后会提示您进行频道选择,此步骤可以暂时跳过,等后面再进行添加。

Openclaw (原 Clawdbot) channel 渠道配置选项
继续进行技能选择,依然选择No,如下所示:

Openclaw (原 Clawdbot) skills 技能配置选项
接下来,您需要选择 hooks,这里同样使用 空格 选择No,具体如下图所示:

Openclaw (原 Clawdbot) hooks 配置选项
最后,耐心等待安装过程完成,最终会出现如下选项,这里选择TUI。

Openclaw (原 Clawdbot) 选择 TUI 终端界面
若能看到 TUI 聊天界面,则表示安装成功,您可以尝试输入 Hello 来进行功能测试。
如何轻松访问 Openclaw 的 TUI 聊天界面和管理面板

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 的飞书参数
添加飞书配置
配置完成后,请重启系统
标题:飞书机器人配置全攻略:从设置到上线一步到位HTML 正文:
重启系统后,返回飞书界面,定位到“事件和回调”选项,接着选择长连接模式,如下图所示。

飞书事件和回调配置 – Openclaw 长连接模式
若一切配置顺利,表示连接成功。接下来继续进行其它设置,添加“接收消息”事件。

飞书添加接收消息事件 – Openclaw AI 助手
事件添加完毕后,务必开启相应权限,确保下列所有权限均已勾选。

请参考下图。

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

飞书消息权限配置 – Openclaw AI 机器人 完成上述步骤后,您就可以开始与机器人互动了。不过,首先需要创建一个新的版本。

飞书应用版本发布 – Openclaw AI 助手上线
版本发布完成后,返回飞书客户端,您将能看到该应用已成功上线,点击即可打开。
提示:每次进行配置调整后,都需要重新发布版本,建议在完成所有配置后再进行一次性发布。
飞书应用发布成功 – Openclaw AI 助手上线
若您向机器人发送Hello,将会收到 Moltbot 的响应。
常见问题 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. 确保飞书插件已正确安装(
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 命令与 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/

