OpenClaw 安装文档

一、问题：小内存服务器部署OpenClaw为何会编译失败？

许多开发者在阿里云1.8GB内存等低配置ECS实例上尝试部署OpenClaw时，经常会遭遇编译过程突然卡死或中断的困境。这个问题的根源在于OpenClaw的核心依赖组件`node-llama-cpp`。该组件在安装时，需要从源码编译一个庞大的C++人工智能基础库——llama.cpp。而GCC/G++编译器在编译此类大型项目时，单个进程的内存占用量极易超过2-3GB。在内存资源本就紧张的小规格服务器环境下，编译进程往往因内存耗尽而被系统内核的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

完成本地编译和打包后，接下来需要将生成的压缩包传输到远程的阿里云ECS服务器。

步骤 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

三、服务配置与启动指南

安装完成后，需进行必要的环境配置以启动OpenClaw网关服务。请在服务器终端中继续执行以下操作。

1. 设置 Gateway Token# 设置访问令牌（用于 Web UI 认证）export OPENCLAW_GATEWAY_TOKEN="openclaw2026"# 永久保存（可选）echo 'export OPENCLAW_GATEWAY_TOKEN="openclaw2026"' >> ~/.bashrcsource ~/.bashrc

配置好访问令牌后，即可启动OpenClaw的核心网关服务。

2. 启动 Gateway 服务openclaw gateway

若启动成功，终端将显示如下信息，表明服务已在后台运行并监听指定端口：

Web UI: http://127.0.0.1:18789/Gateway WS: ws://127.0.0.1:18789

四、通过SSH隧道安全访问Web管理界面

服务运行于服务器本地端口，无法直接通过公网访问。此时，SSH端口转发（隧道）技术提供了安全便捷的访问通道。

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”状态，则表明与Gateway服务连接正常。左侧导航栏提供了Chat（对话）、Overview（概览）、Channels（通道）、Sessions（会话）等核心功能入口。你可以直接进入Chat界面开始与AI模型交互。

开始对话前，需先配置AI模型。在OpenClaw的Web UI中按以下路径添加：

1. 访问 `http://localhost:18789/?token=openclaw2026`2. 点击左侧菜单 “Config”3. 找到 “Models” 部分4. 添加你的 API Key5. 保存配置