OpenClaw 安装文档
一、问题背景
在阿里云等平台1.8GB内存的小规格ECS实例上部署OpenClaw，编译阶段极易因内存不足而失败。核心瓶颈在于其依赖的 `node-llama-cpp` 模块，该模块需要从源码编译llama.cpp这个大型C++ AI基础库。GCC/g++编译器在构建此类项目时，单个进程的内存占用峰值通常超过2GB。在资源受限的环境中，这直接导致编译进程被系统OOM Killer强制终止。
二、安装步骤
核心解决方案是进行交叉编译：在内存充裕的本地开发机完成重负载编译，再将产出的二进制文件及依赖部署至服务器。以下是在MacOS本地终端执行的完整工作流。
步骤 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/# 输入服务器密码
文件传输成功后，通过SSH连接服务器执行解压与系统集成。
步骤 3：在服务器上解压安装# 1. 确认文件已上传ls -lh /tmp/openclaw.tar.gz# 2. 创建安装目录mkdir -p /data/openclaw# 3. 解压到指定目录cd /data/openclawtar -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/binln -sf /data/openclaw/openclaw/openclaw.mjs /usr/local/bin/openclaw# 8. 验证安装openclaw --version# 9. 如果找不到命令，添加到 PATHecho 'export PATH="/usr/local/bin:$PATH"' >> ~/.bashrcsource ~/.bashrc# 10. 清理临时文件rm /tmp/openclaw.tar.gz
三、配置和启动
完成部署后，需进行服务配置与启动。以下操作在服务器终端执行。
1. 设置 Gateway Token# 设置访问令牌（用于 Web UI 认证）export OPENCLAW_GATEWAY_TOKEN="openclaw2026"# 永久保存（可选）echo 'export OPENCLAW_GATEWAY_TOKEN="openclaw2026"' >> ~/.bashrcsource ~/.bashrc
设置认证令牌后，即可启动网关服务。
2. 启动 Gateway 服务openclaw gateway
服务启动成功后，终端将输出服务监听地址，表明Gateway已在后台运行：
Web UI: http://127.0.0.1:18789/Gateway WS: ws://127.0.0.1:18789
四、访问 Web UI
服务运行于服务器本地环回地址，需通过SSH端口转发在本地浏览器安全访问。
1. 建立 SSH 端口转发在**本地 Mac** 上新开一个终端窗口：# 建立 SSH 隧道，将本地 18789 端口转发到服务器ssh -L 18789:127.0.0.1:18789 root@9.9.9.9# 保持这个连接不要关闭
SSH隧道建立后，便可通过本地端口访问远程服务。
2. 浏览器访问在本地浏览器打开：http://localhost:18789/?token=openclaw2026
界面说明： 页面加载后，若右上角状态显示为 “Health OK”，则表明连接与认证成功。左侧导航栏提供Chat、Overview、Channels、Sessions等核心功能入口。可立即进入Chat界面开始交互。
开始对话前，需在Web UI中配置支持的模型与相应API密钥。
1. 访问 `http://localhost:18789/?token=openclaw2026`2. 点击左侧菜单 “Config”3. 找到 “Models” 部分4. 添加你的 API Key5. 保存配置
