PVE安装OPENCLAW的简明教程

引言

**openclaw**流行的安装方法是Mac Mini,本文介绍我摸索的PVE安装OpenClaw的实践心得

注意事项

  • 安装英文原版

虽然**openclaw现在有不少汉化或者中文的教程,不过由于这个网关是国外弄的我还是建议使用英文安装**,不要选中文OS或者中文的版本(我昨天编译安卓的OpenClaw Node apk就发现没有100%适配中文)不然就只能徒增烦恼

  • 使用VM安装

**openclaw**由于破坏性强,因此需要独立安装,我选用的是独立VMubuntu-24.04.1-live-server-amd64.iso

安装ubuntu没什么好说的,使用默认配置即可;

安装成功后记下它的IP192.168.xx.xx;同时在安装时我选择导入了我github账号的ssh key

  • 安装前配置代理

安装Open Claw也可以直接用官方文档;使用命令一键安装即可;根据提示选择或输入

就是安装前应该要先配置代理

1
2
3
export https_proxy=http://192.168.XX.XX:7890;
export http_proxy=http://192.168.XX.XX:7890;
curl google.com

最后用google测一下连通性

  • ssh穿透访问

安装Open Claw成功后执行openclaw onboard命令配置基本的联网方式和模型;默认连接方法是loopback

安装成功后执行openclaw命令查看支持的命令及当前服务信息

根据提示,在你的电脑上执行ssh命令

1
ssh -N -i C:\Users\[user]\.ssh\ssh_key -L 18789:127.0.0.1:18789 [user]@192.168.xx.xx

这里会把pve虚拟机的18789端口映射到本地;这样你就能在浏览器中使用http://localhost:18789/打开它的网页了(在配置外网访问之前,每次在本机访问Open Claw之前都需要创建ssh隧道映射)

ssh_key是我github上的ssh私钥

  • 配置GatewayBind方式

外网访问配置在ConfigGatewayBind

image-20260223014536304

我把它改为了lan;

实际这里假如你的Agentsmodel用的在线模型,可以直接在Chat中让AI帮你改配置

这里就体现了它强大的地方;可以自己改自己的设置;

当然,在改的过程中有好几次都让后台挂了;

除了修改Bind还需要添加Control Ui,将https的域名配置上

以及,我用的nginx代理,要允许websocket连接

1
2
3
4
5
6
7
8
9
10
11
12
13
14
  location / {
proxy_pass http://192.168.xxx.xx:18789/;

#支持websockcet连接
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_cache_bypass $http_upgrade;
proxy_connect_timeout 10s;
proxy_set_header Connection $http_connection;

# Tinyauth auth request
auth_request /tinyauth;
error_page 401 = @tinyauth_login;
}

同时,为了保护Open Claw后台,我使用了Tinyauth,详情可查看文章:自托管部署 Pocket ID 与 Tinyauth 完全指南

配置成功后,最后还需要后台授权同意:

1
2
3
4
#查看当前授权列表
openclaw devices list
#同意页面
openclaw devices approve XXX
  • 后台挂了后重启Gui方法

假如localhost:18789访问不到网页,在后台中执行

1
openclaw gateway --force

命令可以重置网关绑定状态让你可以重新访问

  • 重置设置方法

Open Claw的配置位于:~/.openclaw/openclaw.json

在AI自己修改自己的配置过程中,有很多次它都让服务挂了;或者有什么配置不对的地方导致服务出现问题

此时根据后台提示,可以先尝试命令修复

1
openclaw doctor --fix

这是这个网关自带的修复;假如修复后还是有问题

1
2
cd ~/.openclaw
ls

此时你能看到它自动备份了设置,找到最新的一个备份openclaw.json.bak.x将当前的设置覆盖后即可恢复

image-20260223020117835


PVE安装OPENCLAW的简明教程
http://blog.wangshuai.app/2026-02-23-pve安装openclaw及一些注意事项/
作者
王帅
发布于
2026年2月23日
许可协议