你买好了云服务器，照着教程一步步装完OpenClaw，最后浏览器打开却是一片白屏，这种挫败感实在太熟悉了。别着急，今天这篇文章就是帮你把安装、配置到访问验证这一整条线彻底打通，让你在Ubuntu 22.04上稳稳跑起自己的AI Agent。
环境准备从SSH登录开始
第一步是登录你的云服务器。打开Windows的PowerShell，输入ssh ubuntu@你的服务器公网IP，比如ssh ubuntu@47.100.XX.XX。绝大多数云厂商的Ubuntu 22.04系统默认用户名就是ubuntu，如果你用的是密钥登录，按云平台给的账号来就行。登录成功后，你会看到Welcome to Ubuntu 22.04.4 LTS的提示，这说明已经连上了。
如果你的需求只是使用最新模型，而不是自己折腾部署环境，也可以直接使用api.
接着更新系统并安装基础工具。依次执行sudo apt update和sudo apt upgrade -y，把系统软件包刷到最新状态。然后安装curl、wget、git这些必备依赖，命令是sudo apt install -y curl wget git build-essential。这一步是为了保证后续下载、解压和编译过程不出错，特别是HTTPS相关的依赖一定要装全。
Node js 22 x的正确安装方式
OpenClaw依赖Node.js环境，版本要求是22.x。先添加NodeSource官方仓库，执行curl -fsSL
很多新手卡在这一步是因为网络问题导致仓库添加失败。如果报错，可以尝试更换镜像源或者检查服务器网络。安装npm也会一起装好，但主要用node来运行OpenClaw。确认版本正确后，顺便更新npm到最新版：sudo npm install -g npm@latest。这些准备工作做完，Node环境就算稳了。
创建目录和安装主程序
把程序文件和工作目录分开存放，以后排查问题方便很多。执行mkdir -p /opt/openclaw /var/log/openclaw，创建两个目录：一个放程序主体，一个放日志。然后进入程序目录cd /opt/openclaw，用官方安装脚本拉取主程序：curl -fsSL
安装完成后，检查openclaw命令是否可用。输入which openclaw，如果返回/usr/local/bin/openclaw或类似路径，说明成功了。再执行openclaw --version，能看到版本号。如果which命令没有输出，说明脚本执行有问题，重新跑一次安装脚本。这时候基本框架已经搭好，下一步就是改配置让它能被外部访问。
修改配置文件允许外部访问
默认配置文件路径是/home/ubuntu/.openclaw/config.json，用nano编辑器打开：nano /home/ubuntu/.openclaw/config.json。找到host这一项，默认可能是127.0.0.1，把它改成0.0.0.0。这个修改至关重要，因为127.0.0.1只允许本机访问，你的浏览器从外部根本连不上。确认port那一项是3000，不需要改动。
保存退出后，还要放行端口。Ubuntu自带的ufw防火墙执行sudo ufw allow 3000/tcp。但这只是系统层面的，云厂商还有个安全组。去阿里云、腾讯云或AWS的控制台，找到你的实例，在安全组规则里添加入方向规则：TCP协议，端口3000，源地址0.0.0.0/0。两个防火墙都放行，外部访问才会通。很多用户只做了一步，结果浏览器还是打不开。
启动验证和开机自启配置
先在终端直接运行openclaw启动服务，看有没有报错。启动成功后，打开本地浏览器，输入http://你的服务器公网IP:3000。如果能看到OpenClaw的界面，说明部署已经跑通。如果打不开，回到上一步检查host配置和安全组。确认没问题后，按Ctrl+C停止当前进程，我们来配置开机自启。
创建systemd服务文件：sudo nano /etc/systemd/system/openclaw.service。写入以下内容：服务描述、User=ubuntu、WorkingDirectory=/opt/openclaw、ExecStart=/usr/bin/openclaw、Restart=always。保存后执行sudo systemctl daemon-reload，然后sudo systemctl enable openclaw，最后sudo systemctl start openclaw。用sudo systemctl status openclaw查看状态，看到active (running)就说明后台运行和开机自启都成功了。
常见报错和快速排错方法
报错1：openclaw命令找不到。这通常是PATH没包含可执行文件目录，或者安装没成功。先用which openclaw检查，没输出就重新跑安装脚本。报错2：浏览器打不开IP:3000。八成是配置文件里host写成了127.0.0.1，或者云安全组没放行3000端口。登录云控制台仔细检查安全组规则。
报错3：systemctl start openclaw启动失败。检查三个地方：service文件里的User=ubuntu是否和当前登录账号一致；/usr/bin/openclaw这个文件是否存在；/opt/openclaw/workspace目录是否真实创建。用journalctl -u openclaw -n 50查看详细错误日志，根据提示逐条修正。排错的核心就是对照日志和配置文件，一步步缩小问题范围。
看到这里的你，有没有在自己部署OpenClaw时遇到过特别奇怪的报错，最后是怎么解决的？欢迎在评论区分享你的踩坑经历，帮助更多刚接触云服务器的新手少走弯路。如果这篇文章帮你成功跑通了服务，点个赞让更多人看到吧。
