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

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

安装 OpenClaw

执行官方一键安装脚本：

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

注意：首次安装通常需要 5-10 分钟，期间请保持连接稳定。若提示 npm install failed，请检查虚拟内存是否生效。

初始化配置向导

安装完成后会自动进入向导 (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 退出终端界面。

访问 Web 管理面板

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

1. 获取链接：在服务器终端执行 openclaw dashboard 复制输出链接。
2. 建立隧道：在本地终端执行（替换为您的用户名和 IP）：

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

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

飞书开放平台配置

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

OpenClaw 配置飞书通道

• 在通道列表中选择 Feishu/Lark (飞书)。
• 选择 Download from npm 安装插件。
• 填入凭证：粘贴飞书 App ID 和 App Secret。
• 配置策略：域名选择 Feishu (feishu.cn)，群聊/私聊策略均设为 Open。

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

openclaw gateway restart

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

openclaw onboard

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

验证

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

常用运维命令速查

常见问题排查 (FAQ)

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

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

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 刷新环境变量，或关闭终端重开。