一、问题背景

在阿里云 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. 保存配置