OpenClaw 本地 AI 助手部署与飞书对接实战
OpenClaw 是一款开源的本地 AI 智能体，支持在 Linux、macOS 及 Windows (WSL2) 环境下运行。它允许你在自己的服务器上完全掌控数据隐私，不仅能通过飞书、WhatsApp、Telegram 等工具交互，还能执行系统命令、浏览网页、管理文件甚至编写代码。相比云端 SaaS 服务，这种私有化部署方案更适合对数据安全有要求的场景。
注意：本示例基于 Linux 环境进行演示。
核心特性
- 本地部署：数据自主可控，无需依赖第三方云端
- 多平台支持：覆盖飞书、WhatsApp、Telegram、Discord 等主流通讯工具
- 浏览器控制：自动访问网页、填写表单、提取数据
- 系统权限：读写文件、执行 Shell 命令、运行脚本
- 持久化记忆：记录上下文与偏好，越用越懂你
- 插件扩展：支持社区技能插件或自定义开发
环境准备
安装前请确保满足以下基础要求：
| 项目 | 要求 |
|---|---|
| 操作系统 | Linux（推荐）/ macOS / Windows (WSL2) |
| Node.js | ≥ 22.x |
| 内存 | ≥ 2GB（建议 4GB，否则需配置 swap） |
| 网络 | 能访问 GitHub、npm 仓库（国内服务器可能需要代理） |
| AI 模型 | 通义千问、OpenAI、Claude、KIMI 等任一 API Key |
安装依赖环境
首先安装 Git 和 Node.js 环境。如果你不想手动配置，也可以参考官方文档的一键部署脚本。
安装 Git
sudo apt update && sudo apt install git -y
安装 Node.js
推荐使用 NVM 管理 Node 版本。国内用户可使用镜像源加速下载。
# 安装 NVM（国内镜像）
curl -o- https://gitee.com/RubyMetric/nvm-cn/raw/main/install.sh | bash
# 重新加载环境变量
source ~/.bashrc
# 安装 Node.js 22
nvm install 22
# 验证版本
node -v
输出 v22 即表示安装成功。
部署 OpenClaw
使用官方脚本进行安装是最便捷的方式。
curl -fsSL https://openclaw.bot/install.sh | bash
如果服务器在国内且安装失败，通常是因为网络问题，请检查代理设置。
安装过程中会看到类似以下的 ASCII 艺术提示，首次安装耗时较长请耐心等待。
🦞 OpenClaw Installer Siri's competent cousin.
✓ Detected: linux
✓ Node.js v22.22.0 found
✓ Git already installed
→ Installing OpenClaw 2026.2.6-3...
✓ OpenClaw installed
若遇到 npm install failed 错误，通常是服务器内存不足导致 OOM。建议配置 Swap 交换空间，将部分硬盘作为虚拟内存使用。
初始化配置
安装成功后会进入 Onboarding 向导，按以下步骤操作：
- 安全确认：输入
yes确认了解安全风险。OpenClaw 拥有较高权限，需谨慎对待。 - 启动模式：选择
QuickStart快速配置。 - 模型选择：推荐选择
Qwen (OAuth)，免费额度充足，适合入门。 - 授权登录：复制提供的链接到浏览器，完成 OAuth 授权并选择默认模型（如
qwen-portal/coder-model）。 - 通道跳过：初次安装可先选择
Skip for now，后续再单独配置。 - 功能插件：选择
No跳过复杂插件配置。 - 启动方式：选择
Hatch in TUI进入终端聊天界面测试。
此时可在 TUI 界面输入 Hello 进行测试。测试完成后按 Ctrl+C 退出。
服务状态与 Web UI
查看服务状态
openclaw status
若显示 Gateway service ... running，说明服务已正常启动。
访问管理面板
服务默认监听在 http://127.0.0.1:18789/。由于是本地端口，需通过 SSH 隧道映射到本地访问。
ssh -N -L 18789:127.0.0.1:18789 用户名@服务器 IP
隧道建立后，在浏览器打开 http://127.0.0.1:18789/ 即可看到 Dashboard。首次访问可能提示未授权，需在服务器端执行以下命令获取 Token URL：
openclaw dashboard
复制输出的完整链接（包含 token）在浏览器打开，即可查看聊天记录和管理后台。
对接飞书机器人
这是本文的核心部分。回到配置流程，选择添加 Feishu/Lark 通道。
◆ Select a channel
● Feishu/Lark (飞书)
系统会自动尝试安装对应的扩展包。如果遇到模块缺失错误（如 Cannot find module 'zod'），请先全局安装依赖并清理旧扩展：
npm install -g zod
rm -rf ~/.openclaw/extensions/feishu
随后再次选择飞书通道，按提示填入 App ID 和 App Secret。
飞书开放平台配置
- 登录 飞书开放平台，创建企业自建应用。
- 在凭据管理中获取
App ID和App Secret。 - 添加机器人能力，配置名称。
- 在「事件与回调」中开启长连接模式，并订阅「接收消息」事件。
- 开通必要权限：
contact:user.base:readonly和im:message。 - 发布应用版本。
配置 OpenClaw 参数
回到 OpenClaw 配置界面，依次填入：
- App ID：飞书应用凭证
- App Secret：飞书应用密钥
- Domain：选择
Feishu (feishu.cn) - Group Policy：选择
Open以响应所有群组（需提及机器人） - DM Policy：选择
Open允许公开 DM
配置完成后，重启网关使生效：
openclaw gateway restart
重启后回到飞书客户端，点击应用图标，向机器人发送 Hello 即可收到回复。
常用命令速查
| 命令 | 功能 |
|---|---|
openclaw status | 查看运行状态 |
openclaw onboard | 重新进入配置向导 |
openclaw gateway start | 启动服务 |
openclaw gateway stop | 停止服务 |
openclaw gateway restart | 重启服务 |
openclaw update | 更新版本 |
openclaw health | 健康检查 |
openclaw doctor | 诊断问题 |
openclaw security audit --deep | 深度安全审计 |
常见问题 FAQ
为什么安装时提示 npm install failed？
多为服务器内存不足。新版脚本对内存要求提升，2GB 内存容易出现 OOM。建议配置 Swap 交换空间。
如何配置 Swap？
sudo fallocate -l 2G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile
echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab
飞书收不到消息怎么办？
- 确认通道已正确安装。
- 核对 App ID 和 App Secret 无误。
- 检查是否开启了「接收消息」事件权限。
- 确认长连接模式配置成功。
- 确保应用版本已发布。
- 执行
openclaw gateway restart重启服务。
可以在 Windows 或 macOS 上运行吗？
可以。OpenClaw 支持多系统，本文以 Linux 为例，其他系统安装逻辑基本一致。
数据安全吗？
数据存储在本地服务器，不会上传第三方云端。但因其具备系统级权限，建议在独立服务器上部署，避免影响生产环境。
