OpenClaw Linux 本地化 AI 智能体部署指南

# 国内用户使用 Gitee 镜像源安装 NVM
curl -o- https://gitee.com/RubyMetric/nvm-cn/raw/main/install.sh | bash
# 加载环境变量
source ~/.bashrc
# 安装并使用 Node.js 22
nvm install 22
nvm use 22
# 验证版本
node -v # 应显示 v22.x.x
npm -v

3. 配置虚拟内存 (2GB 内存服务器必做)
防止安装过程中因内存不足 (OOM) 导致失败：

# 创建 2G 交换文件
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
# 验证
free -h

4.2 安装 OpenClaw

执行官方一键安装脚本：

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

注意：首次安装耗时约 5-10 分钟，请勿中断。若提示 npm install failed，请检查虚拟内存是否生效。

4.3 初始化配置向导

安装完成后会自动进入向导 (openclaw onboard)，按以下步骤操作：

1. 安全确认：输入 Yes 确认知晓风险。
2. 模式选择：选择 QuickStart (快速配置)。
3. 模型选择：选择 Qwen (OAuth) (通义千问)。
4. 授权登录：
   • 终端会显示一个 URL 和验证码。
   • 在本地浏览器打开该 URL，登录通义千问账号并授权。
   • 授权成功后，终端会自动继续。
5. 模型确认：选择 Keep current 保持默认模型。
6. 通道配置：选择 Skip for now (稍后单独配置飞书)。
7. 技能配置：选择 No (稍后安装)。
8. 启动方式：选择 Hatch in TUI 进入终端聊天测试。
   • 输入 Hello 测试响应。
   • 按 Ctrl + C 退出终端界面。

4.4 访问 Web 管理面板

OpenClaw 默认监听本地端口 18789，需通过 SSH 隧道访问：

1. 访问：复制输出的链接 (含 token) 到本地浏览器打开。

获取带 Token 的链接 (在服务器终端执行)：

openclaw dashboard

本地终端执行 (替换为您的用户名和 IP)：

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

5. 核心步骤：对接飞书机器人

5.1 飞书开放平台配置

1. 创建应用：
   • 登录飞书开放平台，进入'开发者后台' -> '创建企业自建应用'。
   • 填写名称（如 OpenClaw），上传图标。
2. 获取凭证：
   • 在'凭证与基础信息'中，复制 App ID 和 App Secret。
3. 添加机器人能力：
   • 点击'应用能力' -> 添加'机器人'。
4. 开通权限 (关键)：
   • 进入'权限管理'，搜索并开通以下权限：
     • contact:user.base:readonly (获取用户信息)
     • im:message (发送接收消息，勾选全部子项)
     • im:chat (获取群组信息)
5. 配置事件订阅：
   • 进入'事件与回调' -> '事件配置'。
   • 订阅方式选'使用长连接'。
   • 添加事件：im.message.receive.v1 (接收消息)。
6. 发布应用：
   • 进入'应用发布'，创建版本并发布（个人版自动通过）。

5.2 OpenClaw 配置飞书通道

• 在通道列表中选择 Feishu/Lark (飞书)。
• 选择 Download from npm 安装插件。
• 填入凭证：
  • 粘贴飞书 App ID。
  • 粘贴飞书 App Secret。
• 配置策略：
  • 域名：选择 Feishu (feishu.cn)。
  • 群聊策略：选择 Open (允许在所有群被 @ 响应)。
  • 私聊策略：保持默认 Open。

重启服务：
配置完成后，务必重启网关使配置生效：

openclaw gateway restart

报错处理：若提示 Cannot find module 'zod'，请重新进入配置向导：

openclaw onboard

(依次确认安全风险、QuickStart 模式、模型配置，直到通道选择页)

5.3 验证

在飞书中搜索机器人名称，发送 Hello，若收到回复即表示对接成功。

6. 常用运维命令速查

7. 常见问题排查 (FAQ)

Q1: 安装时提示 npm install failed 或卡住？

• 原因：内存不足。
• 解决：检查是否已配置 2GB 虚拟内存 (free -h 查看 Swap 行)。若未配置，请按 4.1.3 步骤配置后重试。

Q2: 飞书机器人无响应？

• 检查清单：
  1. 飞书应用是否已发布（版本状态为'已上线'）？
  2. im:message 等权限是否已开通？
  3. App ID 和 Secret 是否填写正确？
  4. 是否执行了 openclaw gateway restart？

查看日志：

# 查看技能运行日志
docker exec -it openclaw-2026 tail -f /opt/openclaw/logs/skills/run.log
# 或者查看系统日志
journalctl -u openclaw-gateway -f

Q3: Web 面板无法访问？

• 原因：SSH 隧道断开或 Token 失效。
• 解决：
  1. 确保本地终端的 SSH 隧道命令正在运行。
  2. 在服务器执行 openclaw dashboard 获取最新带 Token 的链接。

Q4: openclaw 命令提示 command not found？

• 解决：执行 source ~/.bashrc 刷新环境变量，或关闭终端重开。