OpenClaw 安装文档
来源：互联网 2026-05-05 17:00:16一、问题背景：为什么在小内存ECS部署OpenClaw会失败？ 许多用户在阿里云等平台1.8GB内存的小规格ECS实例上部署OpenClaw时，常遇到编译过程卡死的问题。其核心原因在于，OpenClaw依赖的 `node-llama-cpp` 组件需要从源码编译大型C++ AI库llama.cpp。
一、问题背景：为什么在小内存ECS部署OpenClaw会失败？
许多用户在阿里云等平台1.8GB内存的小规格ECS实例上部署OpenClaw时，常遇到编译过程卡死的问题。其核心原因在于，OpenClaw依赖的 `node-llama-cpp` 组件需要从源码编译大型C++ AI库llama.cpp。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/
# 根据提示输入服务器密码
文件上传成功后，通过SSH连接到阿里云服务器，继续执行后续安装与配置命令。
步骤 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访问令牌
# 设置用于Web UI认证的令牌
export OPENCLAW_GATEWAY_TOKEN="openclaw2026"
# 可选：永久保存该环境变量
echo 'export OPENCLAW_GATEWAY_TOKEN="openclaw2026"' >> ~/.bashrc
source ~/.bashrc
设置好令牌后，即可启动OpenClaw的核心Gateway服务。
2. 启动Gateway服务
openclaw gateway
若启动成功，终端将显示类似以下信息，表明服务已在后台运行：
Web UI: http://127.0.0.1:18789/
Gateway WS: ws://127.0.0.1:18789
四、通过SSH隧道访问Web管理界面
服务运行于服务器本地，需要通过SSH端口转发才能在个人电脑上访问其Web UI。
1. 建立SSH端口转发
在**本地Mac**上开启新的终端窗口，执行：
# 建立隧道，将本地18789端口映射到服务器
ssh -L 18789:127.0.0.1:18789 root@9.9.9.9
# 请保持此连接窗口开启
隧道建立后，即可在本地浏览器中访问OpenClaw的Web管理界面。
2. 本地浏览器访问
打开浏览器，访问：
http://localhost:18789/token=openclaw2026
界面说明： 成功进入后，若页面右上角显示“Health OK”，则表示连接正常。左侧功能菜单包含Chat、Overview、Channels、Sessions等选项。您可以直接在Chat界面开始与AI助手对话。
开始对话前，需先在Web UI中配置模型API Key，具体路径如下：
1. 访问 `http://localhost:18789/token=openclaw2026`
2. 点击左侧“Config”菜单
3. 定位“Models”配置部分
4. 添加您的API Key
5. 保存配置
侠游戏发布此文仅为了传递信息，不代表侠游戏网站认同其观点或证实其描述
