OpenClaw 部署笔记（openEuler 24.03 SP3）#

1.1 系统信息#

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

1.2 安装基础依赖#

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

5.1 直接前台启动（调试用）#

1
openclaw gateway

此时网关监听 0.0.0.0:18789，终端会持续输出日志。按 Ctrl+C 可停止。

5.2 使用 screen 后台运行（推荐）#

1
# 安装 screen（如未安装）
2
sudo dnf install screen
3

4
# 创建新会话
5
screen -S openclaw
6
openclaw gateway
7
# 按 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 openclaw
3
systemctl start openclaw

6.1 问题：局域网内其他设备无法连接 WebSocket#

启动网关后，从另一台设备（192.168.0.2）访问 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)

这是因为安全策略限制了 origin。

6.2 解决方法：配置 allowedOrigins#

编辑 OpenClaw 配置文件 /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 隧道安全访问（推荐）#

若不想开放端口到局域网，可通过 SSH 隧道将远程端口映射到本地。

在客户端机器（例如 Windows 电脑）上执行：

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

输入服务器密码后，保持终端运行。然后在浏览器中访问 http://localhost:18789 即可打开 Dashboard。

7.1 检查网关状态#

1
openclaw status

7.2 查看日志#

1
openclaw logs

7.3 运行诊断工具#

1
openclaw doctor