Ubuntu 24 云主机安装 OpenClaw 操作指南与常见问题解决
一、环境准备
注意:内存至少需要 4GB,建议增加不低于 2GB 的 swap 空间。2GB 内存可能在配置环节导致内存溢出。
二、安装步骤
1. 连接服务器
使用 SSH 连接服务器时,建议延长自动断开时间,防止安装过程中断。
ssh -o ServerAliveInterval=60 -o ServerAliveCountMax=60 root@你的 IP
建议登录后先新建专用账号并赋予 root 权限,再运行后续指令。
2. 执行安装
curl -fsSL https://openclaw.ai/install.sh | bash
3. 配置向导
安装结束后会自动启动配置。如需重新配置,可运行:
openclaw onboard
根据提示选择大模型提供商及集成通道。Skills 安装环节建议仅选择管理相关组件,防止依赖不足。Hooks 建议全部启用。
三、常见问题解决
启动 gateway 服务时可能遇到 systemd not installed 或 systemctl --user is-enabled unavailable 错误。这通常与 root 用户直接运行有关。
可通过创建 systemd 用户服务文件解决:
OPENCLAW_BIN="$(command -v openclaw)"
mkdir -p /run/user/0
chmod 700 /run/user/0
export XDG_RUNTIME_DIR=/run/user/0
mkdir -p /root/.config/systemd/user
cat >/root/.config/systemd/user/openclaw-gateway.service <<EOF
[Unit]
Description=OpenClaw Gateway (user)
After=network.target
[Service]
Type=simple
Environment=XDG_RUNTIME_DIR=/run/user/0
Environment=OPENCLAW_HOME=/root/.openclaw
WorkingDirectory=/root/.openclaw
ExecStart=$OPENCLAW_BIN gateway start
Restart=always
RestartSec=2
[Install]
WantedBy=default.target
EOF
systemctl --user daemon-reload
systemctl --user enable --now openclaw-gateway.service
执行完成后,检查端口是否监听正常。
四、本地访问
由于服务器无 GUI,需建立 SSH 隧道进行本地访问。
ssh -L 18789:127.0.0.1:18789 -L 18792:127.0.0.1:18792 root@你的服务器公网 IP
在本地浏览器输入地址,并在 URL 中添加 token 参数:
http://127.0.0.1:18789/#token=YOUR_TOKEN
Token 可通过查看配置文件 ~/.openclaw/openclaw.json 获取。
五、总结
手动安装 OpenClaw 需注意系统资源及服务配置问题。若追求便捷,也可考虑使用预装该服务的云主机方案。

