OpenClaw 本地 AI 助手部署及飞书对接指南
OpenClaw（原名 Clawdbot，曾短暂更名 Moltbot）是一款开源的本地 AI 智能体。它支持在自有服务器上部署，通过飞书、WhatsApp、Telegram 等工具交互。与云端 SaaS 不同，OpenClaw 让你完全掌控数据隐私，具备执行系统命令、浏览网页、管理文件甚至编写代码的能力。
本教程将带你一步步在 Linux 环境下安装 OpenClaw，并配置飞书机器人，打造专属的智能助理。
注意：本教程基于 Linux 系统环境。
OpenClaw 核心特性
作为一个运行在你本地环境的高权限 AI 智能体，它的优势在于：
- 本地部署：数据完全自主可控，无需上传至第三方云端
- 多平台支持：兼容飞书、WhatsApp、Telegram、Discord、Slack 等主流通讯工具
- 浏览器控制：可自动浏览网页、填写表单、提取数据
- 系统访问：读写文件、执行 Shell 命令、运行脚本
- 持久化记忆：记住你的偏好和上下文，越用越懂你
- 插件扩展：支持社区技能插件，也可自行开发
无论是邮件管理、日程安排还是代码辅助，它都能成为你的得力助手。
准备工作
首先准备一台闲置的云服务器或 VPS（推荐使用香港或海外节点）。由于 OpenClaw 运行时权限较大，出于安全考虑，不建议直接在本地开发机或生产环境机器上安装，建议在一台独立的空服务器上部署。
安装依赖
1. 安装 Git
sudo apt update && sudo apt install git -y
2. 安装 Node.js
建议使用 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
# 重新加载环境变量
source ~/.bashrc
# 安装 Node.js 22 版本
nvm install 22
# 验证版本
node -v # 输出 v22 即可
安装 OpenClaw
使用官方脚本进行一键安装：
curl -fsSL https://openclaw.bot/install.sh | bash
提示：如果服务器在国内且安装失败，可能需要解决网络连通性问题。
首次安装耗时较长，请耐心等待。如果遇到 npm install failed 错误，通常是因为服务器内存不足导致 OOM（内存溢出）。新版本对内存要求较高，2G 内存容易出错，建议配置 swap 交换空间，将硬盘作为虚拟内存使用。
安装成功后会进入配置向导：
- 选择
yes确认知晓风险 - 选择
QuickStart快速开始 - 模型服务商选择
Qwen（通义千问），免费额度充足，适合入门 - 打开提供的授权链接，登录账号并选择默认模型
- Channel 渠道配置先跳过，后续再添加
- Skills 技能和 Hooks 配置均选
No - 最后选择
TUI终端界面模式
此时应能看到 TUI 聊天界面，输入 Hello 测试是否正常响应。测试无误后，按 Ctrl+C 退出。
服务管理与 Web UI
查看服务状态
clawdbot status
若显示服务已启动，说明后台运行正常。
访问 Web 管理面板
服务默认监听在 http://127.0.0.1:18789/。由于是本地端口，我们需要通过 SSH 隧道映射到本地访问：
ssh -N -L 18789:127.0.0.1:18789 用户名@服务器IP
输入密码后，在本地浏览器打开 http://127.0.0.1:18789/。初次访问可能显示未授权，回到服务器执行以下命令获取 Dashboard URL：
clawdbot dashboard
复制输出的 URL 到浏览器即可正常查看聊天记录和管理面板。首次使用时，可在对话框输入名字设置指令，例如：
Name: Openclaw My Name: Boss
对接飞书
1. 安装飞书插件
clawdbot plugins install @m1heng-clawd/feishu
2. 创建飞书应用
登录飞书开放平台，点击「开发者后台 -> 创建企业自建应用」。
- 创建应用后，前往凭据管理获取
App ID和App Secret，请妥善保存。 - 添加机器人能力，配置机器人名称。
3. 配置 OpenClaw 参数
回到服务器，依次设置飞书相关配置：
clawdbot config set channels.feishu.appId "你的 App ID"
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
配置完成后重启网关：
clawdbot gateway restart
4. 配置回调与权限
回到飞书开发者后台：
- 找到「事件和回调」，选择长连接模式。
- 添加「接收消息」事件。
- 开通必要权限，包括用户信息读取 (
contact:user.base:readonly) 和消息收发 (im:message)。 - 发布应用版本。注意：每次修改配置后都需重新发布版本才能生效。
发布成功后，在飞书客户端打开应用，向机器人发送 Hello，即可收到回复。
常见问题 FAQ
OpenClaw 和 Clawdbot、Moltbot 是什么关系？
三者是同一项目的不同阶段命名。最初叫 Clawdbot，后因商标问题更名为 Moltbot，最终于 2025 年 1 月正式定名为 OpenClaw。
OpenClaw 支持哪些 AI 模型？
支持 Anthropic Claude、OpenAI GPT、通义千问（Qwen）、KIMI、小米 MiMo 等多种服务商。本教程选用 Qwen 因其免费额度友好。
为什么安装时提示 npm install failed？
通常是服务器内存不足。建议配置 swap 交换空间，将硬盘空间作为虚拟内存使用。
OpenClaw 可以在 Windows 或 macOS 上运行吗？
可以。支持 Mac、Windows 和 Linux 系统。本教程以 Linux 为例，其他系统请参考官方文档。
飞书机器人配置后无法收到消息怎么办？
检查以下几点：
- 飞书插件是否安装成功
- App ID 和 App Secret 是否填错
- 是否开通了「接收消息」事件权限
- 长连接模式是否配置成功
- 应用版本是否已发布
OpenClaw 数据安全吗？
数据存储在本地服务器，不会上传第三方云端。但因其拥有系统级权限，建议在独立服务器上部署，避免在生产环境运行。
如何更新 OpenClaw？
使用以下命令更新至最新版本：
openclaw update
OpenClaw 命令和 clawdbot 命令有什么区别？
更名后官方推荐使用 openclaw 命令，但为了兼容性 clawdbot 依然可用，两者功能相同。
