1. 系统环境准备与初始化
在Ubuntu 25.10上安装OpenClaw前,我们需要先做好系统环境的准备工作。我选择使用Ubuntu 25.10(代号"questing")作为基础系统,这是一个相对较新的LTS版本,对现代AI工具链有更好的支持。
1.1 基础服务配置
首先确保系统能够正常进行远程管理和维护。我习惯先安装SSH服务,这样后续操作都可以通过远程连接完成:
bash复制sudo apt update
sudo apt install openssh-server -y
sudo systemctl enable ssh --now
这里有几个细节需要注意:
sudo apt update命令会更新软件源列表,确保后续安装的是最新版本-y参数自动确认安装,避免交互式提示中断自动化流程enable --now参数同时设置开机自启和立即启动服务
检查DNS配置也很重要,特别是后续需要从GitHub等平台下载资源时:
bash复制resolvectl status
在我的测试环境中,DNS服务器设置为223.5.5.5(阿里云公共DNS),这在国内网络环境下通常能提供稳定的解析服务。
1.2 图形化环境准备
虽然OpenClaw主要通过命令行操作,但安装图形化环境可以方便后续调试和监控:
bash复制sudo apt install xfce4 xfce4-goodies xrdp
sudo adduser xrdp ssl-cert
echo "xfce4-session" > ~/.xsession
sudo systemctl enable --now xrdp
这里有几个关键点:
- XFCE是一个轻量级桌面环境,相比GNOME或KDE更适合服务器环境
- 将xrdp用户加入ssl-cert组是为了解决远程桌面连接时的证书权限问题
- 设置.xsession文件指定默认会话可以避免远程连接时出现空白桌面
1.3 网络与防火墙配置
为了方便调试,我通常会临时关闭防火墙,但在生产环境中建议精确配置规则:
bash复制sudo ufw allow 3389 # 允许RDP端口
sudo ufw allow 22 # 允许SSH端口
sudo ufw enable
注意:如果只是本地测试,可以直接禁用防火墙(
sudo ufw disable),但在公网环境一定要保持防火墙开启并严格限制访问IP。
2. Node.js环境搭建
OpenClaw需要Node.js 22或更高版本,这里我推荐使用nvm(Node Version Manager)来管理Node.js版本。
2.1 安装nvm
首先下载并安装nvm:
bash复制curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
source ~/.bashrc
安装完成后,验证nvm是否可用:
bash复制nvm --version
2.2 安装Node.js 22
使用nvm安装特定版本的Node.js:
bash复制nvm install 22
nvm use 22
验证安装:
bash复制node -v # 应该显示v22.x.x
npm -v # 应该显示对应版本
常见问题:如果遇到命令找不到的情况,可能是shell配置没有自动加载。可以手动执行
source ~/.bashrc或重新打开终端。
3. OpenClaw安装与配置
3.1 全局安装OpenClaw
使用npm全局安装OpenClaw:
bash复制npm install -g openclaw@latest --registry=https://registry.npmmirror.com
这里使用了国内的npm镜像源(npmmirror.com)来加速下载。安装完成后验证:
bash复制openclaw --version
npm list -g --depth=0
应该能看到类似这样的输出:
code复制/home/user/.nvm/versions/node/v22.22.1/lib
├── corepack@0.34.6
├── npm@10.9.4
└── openclaw@2026.3.13
3.2 初始化配置
运行初始化向导:
bash复制openclaw onboard --install-daemon
这个命令会:
- 创建默认配置文件(通常在~/.openclaw/config.json)
- 安装系统服务(通过systemd或launchd)
- 设置必要的环境变量
4. 访问与管理OpenClaw
4.1 通过远程桌面访问
如果安装了xrdp,可以使用Windows自带的远程桌面连接(mstsc)访问Ubuntu的图形界面:
- 在Windows上按Win+R,输入"mstsc"
- 输入Ubuntu服务器的IP地址
- 使用系统用户名密码登录
4.2 通过SSH隧道访问API
对于命令行操作,可以建立SSH隧道:
bash复制ssh -fN -L 18789:127.0.0.1:18789 username@server-ip
这样本地的18789端口就会转发到服务器的OpenClaw服务端口。
5. OpenClaw常用命令参考
5.1 服务管理
| 命令 | 说明 |
|---|---|
openclaw gateway start |
启动网关守护进程 |
openclaw gateway stop |
停止网关 |
openclaw gateway status |
查看网关状态 |
5.2 配置管理
bash复制openclaw config set api.key "your-api-key"
openclaw config set log.level debug
5.3 诊断与监控
bash复制openclaw doctor # 系统诊断
openclaw logs --follow # 实时日志
openclaw status --all # 详细状态
6. 常见问题排查
-
安装失败:
- 确保Node.js版本≥22
- 尝试清理npm缓存:
npm cache clean -f - 使用sudo权限安装:
sudo npm install -g openclaw
-
服务无法启动:
- 检查端口冲突:
sudo lsof -i :18789 - 查看详细日志:
journalctl -u openclaw -f
- 检查端口冲突:
-
网络连接问题:
- 确保防火墙放行相关端口
- 测试网络连通性:
curl -v http://localhost:18789/health
7. 性能优化建议
-
内存管理:
bash复制
openclaw memory optimize --max-old-space=4096这会将Node.js内存限制提高到4GB
-
持久化配置:
编辑~/.openclaw/config.json可以手动调整高级参数:json复制{ "cache": { "enabled": true, "maxSize": "1GB" } } -
定期维护:
bash复制
openclaw maintenance --cleanup这会清理临时文件和过期缓存
在实际使用中,我发现OpenClaw对系统资源的需求会随着使用时间增长而增加。建议每周至少重启一次服务,或者设置定时任务自动维护。对于生产环境,可以考虑使用PM2等进程管理器来增强稳定性。