OpenClaw 安装文档
一、问题背景
在阿里云 ECS 服务器（1.8GB 内存）上直接安装 OpenClaw 时，由于 OpenClaw 依赖 `node-llama-cpp`，需要从源码编译 llama.cpp（大型 C++ AI 库）。编译过程中 g++ 编译器会消耗大量内存（单个进程需要 2-3GB），导致进程被系统 OOM Killer 杀死。
二、安装步骤
在本地 Mac 终端执行：
步骤 1：在本地电脑编译安装 # 安装 OpenClaw（会自动编译依赖） npm install -g openclaw@2026.2.1 # 查看全局 node_modules 路径 npm root -g # 输出示例：/usr/local/lib/node_modules # 进入该目录 cd $(npm root -g) # 确认 openclaw 文件夹存在 ls -lh openclaw # 打包整个 openclaw 目录 tar -czf openclaw.tar.gz openclaw # 确认打包成功 ls -lh openclaw.tar.gz 步骤 2：上传到阿里云服务器 # 上传到服务器的 /tmp 目录 scp $(npm root -g)/openclaw.tar.gz root@9.9.9.9:/tmp/ # 输入服务器密码 步骤 3：在服务器上解压安装 # 1. 确认文件已上传 ls -lh /tmp/openclaw.tar.gz # 2. 创建安装目录 mkdir -p /data/openclaw # 3. 解压到指定目录 cd /data/openclaw tar -xzf /tmp/openclaw.tar.gz # 4. 确认解压成功 ls -lh /data/openclaw/openclaw # 5. 查看主程序文件 cat /data/openclaw/openclaw/package.json | grep -A 5 '"bin"' # 输出：主程序是 openclaw.mjs # 6. 添加执行权限 chmod +x /data/openclaw/openclaw/openclaw.mjs # 7. 创建全局命令软链接 mkdir -p /usr/local/bin ln -sf /data/openclaw/openclaw/openclaw.mjs /usr/local/bin/openclaw # 8. 验证安装 openclaw --version # 9. 如果找不到命令，添加到 PATH echo 'export PATH="/usr/local/bin:$PATH"' >> ~/.bashrc source ~/.bashrc # 10. 清理临时文件 rm /tmp/openclaw.tar.gz三、配置和启动
1. 设置 Gateway Token # 设置访问令牌（用于 Web UI 认证） export OPENCLAW_GATEWAY_TOKEN="openclaw2026" # 永久保存（可选） echo 'export OPENCLAW_GATEWAY_TOKEN="openclaw2026"' >> ~/.bashrc source ~/.bashrc 2. 启动 Gateway 服务 openclaw gateway 启动成功后会显示： Web UI: http://127.0.0.1:18789/ Gateway WS: ws://127.0.0.1:18789四、访问 Web UI
1. 建立 SSH 端口转发 在**本地 Mac** 上新开一个终端窗口： # 建立 SSH 隧道，将本地 18789 端口转发到服务器 ssh -L 18789:127.0.0.1:18789 root@9.9.9.9 # 保持这个连接不要关闭 2. 浏览器访问 在本地浏览器打开： http://localhost:18789/?token=openclaw2026 **界面说明：** - 右上角显示 "Health OK" 表示连接正常 - 左侧菜单包含：Chat、Overview、Channels、Sessions 等 - 可以直接在 Chat 界面与 AI 助手对话 3. 添加模型 启动 OpenClaw 后，在 Web UI 中配置： 1. 访问 `http://localhost:18789/?token=openclaw2026` 2. 点击左侧菜单 "Config" 3. 找到 "Models" 部分 4. 添加你的 API Key 5. 保存配置