保姆级教程：OpenClaw（原Clawdbot）Linux系统部署飞书：搭建专属AI助手

OpenClaw（原Clawdbot，曾用名Moltbot）是一款开源本地AI智能体，支持在自有服务器部署，通过飞书、WhatsApp、Telegram等聊天工具交互。与云端SaaS服务不同，它能让用户完全掌控数据隐私，可执行系统命令、浏览网页、管理文件、编写代码等操作。本教程将手把手指导在Linux系统下安装OpenClaw并对接飞书机器人，全程操作详细，无技术基础也能顺利完成。

OpenClaw 是什么？

OpenClaw(原名 Clawdbot,后更名为 Moltbot,现正式命名为 OpenClaw)是一个运行在你本地环境的高权限 AI 智能体。它的核心特性包括：

本地部署：运行在你的服务器或电脑上,数据完全自主可控
多平台支持：支持飞书、WhatsApp、Telegram、Discord、Slack 等主流聊天工具
浏览器控制：可以浏览网页、填写表单、提取数据
系统访问：读写文件、执行 Shell 命令、运行脚本
持久化记忆：记住你的偏好和上下文,成为真正属于你的 AI
插件扩展：支持社区技能插件,甚至可以自己编写插件

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

一、OpenClaw核心特性

1. 本地部署：运行在自有服务器或电脑上，数据完全自主可控，无需担心隐私泄露；
2. 多平台支持：兼容飞书、WhatsApp、Telegram等主流聊天工具，适配多样化交互场景；
3. 强大功能：支持浏览器控制（网页浏览、表单填写、数据提取）、系统访问（文件读写、Shell命令执行、脚本运行）、持久化记忆（记录用户偏好与上下文）、插件扩展（支持社区技能插件及自定义编写）；
4. 实用场景：覆盖邮件管理、日程安排、数据查询、代码编写等多种需求，成为高效辅助工具。
5. 如果您嫌弃这个安装教程太麻烦，阿里云上线了轻量应用服务器Openclaw 一键部署功能，可以直接打开 阿里云轻量应用服务器Openclaw 一键部署 (原 Clawdbot)教程页 部署，部署之后可以直接跳到对接飞书。

二、准备工作

1. 部署载体：准备一台闲置云服务器或VPS（推荐香港或海外节点）；
2. 安全提示：由于OpenClaw运行权限较大，不建议在本地或工作机安装，推荐使用独立空服务器部署，降低安全风险；
3. 前置操作：登录服务器，确保网络通畅，后续操作将通过终端命令行完成。

三、第一阶段：安装OpenClaw（Linux系统）

3.1 安装Git

执行以下命令更新系统并安装Git：

sudo apt update
sudo apt install git -y

3.2 安装Node.js（版本≥22）

1. 安装NVM（Node版本管理工具）：
   • 国内服务器（使用Gitee镜像源）：

     curl -o- https://gitee.com/RubyMetric/nvm-cn/raw/main/install.sh | bash
     

   • 海外服务器（使用官方源）：

     curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.1/install.sh | bash
     

2. 重新加载环境变量：

   source ~/.bashrc
   

3. 安装Node.js 22版本：

   nvm install 22
   

4. 验证版本：执行node -v，输出“v22.x.x”即符合要求。

3.3 安装OpenClaw主程序

执行官方一键安装脚本：

curl -fsSL https://openclaw.bot/install.sh | bash

• 注意事项：国内服务器若安装失败，需先解决网络问题；2G内存服务器可能出现OOM（内存溢出），建议配置swap交换空间（将硬盘空间作为虚拟内存）；安装过程耗时较长，需耐心等待。

3.4 初始化配置（Onboarding）

安装成功后自动进入初始化向导，按以下步骤选择配置：

1. 安全提示确认：提示“OpenClaw is a hobby project and still in beta...”，输入“Yes”继续（需知晓其权限风险）；
2. 选择部署模式：选择“QuickStart”（后续可通过clawdbot configure补充配置）；
3. 选择模型服务商：选择“Qwen（OAuth）”（免费额度充足，适合入门），系统会生成授权链接；
4. 模型授权：复制链接在浏览器打开，登录Qwen账号完成授权，返回终端选择默认模型“qwen-portal/coder-model”；
5. 跳过通信通道配置：选择“Skip for now”（后续专门配置飞书）；
6. 技能配置：选择“No”（暂不配置，后续可按需扩展）；
7. Hooks配置：选择“Skip for now”（暂不启用）；
8. 启动方式选择：选择“TUI”（终端聊天界面），出现聊天界面后输入“Hello”测试，确认安装成功；
9. 关闭TUI界面：按ctrl+c退出，后续通过Web UI或飞书交互。

3.5 验证服务状态

执行命令查看服务是否正常运行：

clawdbot status

若输出包含“Gateway service: running”“Node service: running”等信息，说明服务启动成功。

3.6 访问Web UI面板

1. 建立SSH隧道（本地电脑终端执行）：

   ssh -N -L 18789:127.0.0.1:18789 用户名@服务器IP
   

   输入服务器密码完成连接；
2. 获取授权链接：服务器终端执行clawdbot dashboard，复制输出的“Dashboard URL”；
3. 访问面板：本地浏览器打开复制的URL，即可进入OpenClaw Web UI，首次使用可设置AI助手名称与自身称呼（如输入“Name: Openclaw”“My Name: Boss”）。

四、第二阶段：对接飞书机器人

4.1 安装飞书插件

服务器终端执行命令安装飞书对接插件：

clawdbot plugins install @m1heng-clawd/feishu

4.2 飞书开放平台配置（创建应用与机器人）

1. 登录飞书开放平台（https://open.feishu.cn），进入“开发者后台”，点击“创建企业自建应用”；
2. 填写应用信息：输入应用名称（如“clawdbot”）、应用描述（如“clawdbot个人AI助手”），上传应用图标（格式支持JPEG/PNG/SVG/BMP，2MB以内，尺寸≥240×240px），点击“创建”；
3. 获取应用凭证：进入应用“凭证与基础信息”页面，复制“App ID”与“App Secret”（后续配置需使用，妥善保存）；
4. 添加机器人能力：进入“应用能力”页面，点击“添加应用能力”，选择“机器人”，设置机器人名称，点击“保存”；
5. 订阅事件：进入“事件与回调”页面，选择“事件配置”，点击“添加事件”，选择“接收消息”事件（im.message.receive_v1），点击“确认添加”；
6. 开通权限：进入“权限管理”页面，勾选以下权限并申请开通：
   • contact:user.base:readonly（获取基础用户信息）；
   • im.message相关全量权限（发送和接收单聊、群组消息等）；
7. 选择事件接收方式：在“事件与回调”页面，选择“使用长连接接收事件”（推荐），点击“保存”。

4.3 服务器配置飞书参数

在服务器终端执行以下命令，替换占位符为飞书应用的App ID与App Secret：

# 设置App ID
clawdbot config set channels.feishu.appId "飞书App ID"
# 设置App Secret
clawdbot config set channels.feishu.appSecret "飞书App Secret"
# 启用飞书通道
clawdbot config set channels.feishu.enabled true
# 使用websocket连接模式
clawdbot config set channels.feishu.connectionMode websocket
# 单聊策略：需配对
clawdbot config set channels.feishu.dmPolicy pairing
# 群聊策略：白名单
clawdbot config set channels.feishu.groupPolicy allowlist
# 需@机器人才能触发响应
clawdbot config set channels.feishu.requireMention true

4.4 重启服务使配置生效

clawdbot gateway restart

4.5 发布飞书应用

1. 飞书开放平台进入应用“版本管理与发布”页面，点击“创建新版本”；
2. 填写版本信息（如版本号“1.0.0”、版本描述“初始版本，对接OpenClaw”），选择应用可见范围，点击“保存”；
3. 点击“直接发布”，等待审核通过（企业自建应用通常自动审核）。

4.6 测试飞书机器人

1. 飞书客户端搜索创建的机器人名称（如“clawdbot”），打开单聊窗口；
2. 发送“Hello”，机器人会回复配对提示（因配置了dmPolicy为pairing），按提示完成配对后即可正常交互；
3. 测试功能：发送指令（如“介绍下自己”“帮我写一段Python简单代码”），验证机器人是否能正常响应。

五、常见问题FAQ

1. OpenClaw与Clawdbot、Moltbot是什么关系？
   三者是同一项目的不同阶段命名，OpenClaw是最新正式名称，功能与核心逻辑一致，命令兼容（clawdbot与openclaw命令均可使用）。

2. 安装时提示“npm install failed”怎么办？
   通常是服务器内存不足导致，2G内存易出现OOM，建议配置swap交换空间，将硬盘空间作为虚拟内存。

3. 飞书机器人配置后无法收到消息？
   检查以下几点：飞书插件是否安装成功、App ID与App Secret配置是否正确、“接收消息”事件是否订阅、相关权限是否开通、长连接模式是否配置、应用是否已发布。

4. OpenClaw数据是否安全？
   数据存储在自有服务器，不上传第三方云端，相对安全，但因具备系统级权限，需在独立服务器部署，避免与生产环境或重要数据共用设备。

5. 如何更新OpenClaw到最新版本？
   执行命令openclaw update，按提示完成更新即可。

6. 除了飞书，还支持哪些平台？
   支持WhatsApp、Telegram、Discord、Slack等多个平台，需安装对应插件并配置。

六、核心操作总结

1. 服务管理命令：
   • 查看状态：clawdbot status；
   • 重启网关：clawdbot gateway restart；
   • 进入Web UI：clawdbot dashboard；
   • 更新版本：openclaw update。
2. 飞书配置关键步骤：安装插件→创建飞书应用→获取凭证→服务器配置参数→重启服务→发布应用→配对测试；
3. 安全建议：定期备份服务器数据、避免泄露应用凭证与服务器密码、限制机器人可见范围与权限。