OpenClaw部署-openEuler24.03

环境信息#

操作系统：openEuler 24.03 LTS SP3
用户：root
服务器 IP：192.168.0.18

一、基础依赖#

1
# 更新系统
2
sudo dnf update -y
3

4
# 编译工具与常用依赖
5
sudo dnf groupinstall -y "Development Tools"
6
sudo dnf install -y python3 python3-pip make gcc-c++ openssl-devel sqlite-devel screen

二、安装 Node.js#

使用官方预编译二进制包，无需本地编译。

1
cd /usr/local
2
wget https://nodejs.org/dist/v22.14.0/node-v22.14.0-linux-x64.tar.xz
3
tar -xf node-v22.14.0-linux-x64.tar.xz
4
mv node-v22.14.0-linux-x64 node
5

6
# 加入 PATH
7
echo 'export PATH=/usr/local/node/bin:$PATH' >> /etc/profile
8
source /etc/profile
9

10
# 验证
11
node --version   # v22.14.0
12
npm --version    # 10.9.2
13

14
# 切换国内源
15
npm config set registry https://registry.npmmirror.com/

三、安装 OpenClaw#

1
npm i -g openclaw
2
openclaw --version

四、初始化（Onboarding）#

交互式配置助手名称、聊天平台、API 密钥：

1
openclaw onboard

完成后终端会输出 Dashboard 访问链接。

五、启动网关服务#

5.1 前台启动（调试）#

1
openclaw gateway

网关监听 0.0.0.0:18789。

5.2 screen 后台运行#

1
sudo dnf install screen
2
screen -S openclaw
3
openclaw gateway
4
# Ctrl+A, D 脱离会话

5.3 注册为 systemd 服务（推荐）#

创建 /etc/systemd/system/openclaw.service：

1
[Unit]
2
Description=OpenClaw Gateway
3
After=network.target
4

5
[Service]
6
Type=simple
7
User=root
8
WorkingDirectory=/root
9
ExecStart=/usr/local/node/bin/openclaw gateway
10
Restart=on-failure
11
RestartSec=10
12
Environment="PATH=/usr/local/node/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/root/bin"
13

14
[Install]
15
WantedBy=multi-user.target

启用服务：

1
systemctl daemon-reload
2
systemctl enable --now openclaw

六、远程访问 Dashboard#

6.1 问题现象#

从其他设备访问 http://192.168.0.18:18789，日志提示：

1
origin not allowed (open the Control UI from the gateway host or allow it in gateway.controlUi.allowedOrigins)

6.2 配置 allowedOrigins#

编辑 /root/.openclaw/openclaw.json：

1
{
2
  "gateway": {
3
    "controlUi": {
4
      "allowedOrigins": [
5
        "http://192.168.0.18:18789",
6
        "http://localhost:18789"
7
      ]
8
    }
9
  }
10
}

仅测试环境可设为 ["*"]。保存后重启网关。

6.3 SSH 隧道访问（推荐）#

客户端执行：

1
ssh -N -L 18789:127.0.0.1:18789 root@192.168.0.18

浏览器访问 http://localhost:18789 即可。

6.4 启用 SSH 端口转发#

编辑 /etc/ssh/sshd_config：

1
AllowTcpForwarding yes
2
GatewayPorts clientspecified
3
PermitTunnel yes

重启服务：

1
sudo sshd -t
2
sudo systemctl restart sshd

6.5 SSH 客户端简化配置#

编辑 ~/.ssh/config：

1
Host openclaw-server
2
    HostName 192.168.0.18
3
    User root
4
    Port 22
5
    LocalForward 18789 localhost:18789
6
    ServerAliveInterval 60
7
    IdentityFile ~/.ssh/id_ed25519

之后只需 ssh openclaw-server。

七、验证部署#

1
openclaw status     # 服务状态
2
openclaw logs       # 实时日志
3
openclaw doctor     # 健康检查

八、常用命令#

命令	说明
`openclaw gateway`	启动网关（前台）
`openclaw gateway --force`	强制启动，清理占用端口
`openclaw status`	查看服务状态
`openclaw logs`	查看实时日志
`openclaw doctor`	系统健康检查
`openclaw reset`	重置本地配置
`openclaw configure`	重新运行配置向导

九、注意事项#

防火墙需放行 SSH（22）；如需直连 18789，需同时配置 allowedOrigins
生产环境建议通过 SSH 隧道或 VPN 访问控制界面，避免管理端口暴露公网
GatewayPorts 建议用 clientspecified，比 yes 更安全
更多文档：https://docs.openclaw.ai