xmlns="http://www.w3.org/2000/svg"style="display:服务器上的完整部署指南概述本文档详细记录了在无图形界面的Linux服务器(OpenCloudOS/CentOS)上部署ClawX配置、以及常见问题的解决方案。mkdir-p~/.vnc#启动脚本cat>~/.vnc/xstartup<<'EOF'#!/bin/shEOFchmod+xVNC配置防火墙(如果有)firewall-cmd--permanent--add-port=5901/tcp2>/dev/null||truefirewall-cmd--reload2>/dev/null||true步骤4:配置云服务器安全组如果使用云服务器(阿里云、腾讯云、华为云等),需要在控制台开放端口:登录云服务商控制台找到服务器实例的安全组设置添加入站规则:协议:TCP端口:5901来源:0.0.0.0/0(或限制为你的IP)步骤5:连接ClawX在本地电脑:下载VNCViewer官方:https://www.realvnc.com/en/connect/download/viewer/或使用TightVNC:https://www.tightvnc.com/连接到服务器地址:服务器IP:5901输入VNC密码在VNC桌面中打开终端右键点击桌面ApplicationsTerminal运行ClawX#DISPLAY环境变量exportDISPLAY=:1#ClawX(需要--no-sandboxrootsupported原因:Electron(Chromium)出于安全考虑,不允许以root身份运行。解决方案:#A:添加参数(快速但不推荐生产环境)clawx--no-sandbox#B:创建普通用户运行(推荐)useradd-m/bin/bashclawuserpasswdclawusersu-clawuser$DISPLAY原因:未设置DISPLAY未运行。解决方案:#VNC环境变量exportDISPLAY=:1#连接xdpyinfo|head#xdpyinfo不存在,安装yuminstall-yxorg-x11-utils问题3:VNC连接后黑屏原因:桌面环境未正确启动。解决方案:#VNCvncserver-y"Xfce"--skip-broken#重新配置启动脚本(见步骤日志排查问题tail-50~/.vnc/*.log#-depth24问题4:VNC端口无法连接原因:防火墙或安全组未开放端口。解决方案:#检查端口监听netstat-tlnp|grep5901#status开放端口(如果有防火墙)firewall-cmd--permanent--add-port=5901/tcpfirewall-cmd云服务器:在控制台配置安全组问题5:LightDM启动失败原因:缺少Server或相关组件。解决方案:#WindowSystemyuminstall-yxorg-x11-server-XorgGreeteryuminstall-yrestartlightdm.serviceSSH端口ssh-L5901:localhost:5901VNC--add-rich-rule='rulesourceaccept'2.VNC--max-old-space-size=5123.VNC开机自启cat>/etc/systemd/system/vncserver@.service<<'EOF'[Unit]ExecStart=/usr/bin/vncserver-geometryExecStop=/usr/bin/vncserver-killsystemctlenablevncserver@:1.servicesystemctlvncserver@:1.service4.生产环境替代方案对于生产环境,强烈建议使用OpenClawClawX:#OpenClawCLInpminstall-gopenclaw#configsetprovider.openai.apiKey"sk-xxx"openclawconfigsetgateway.modelocal#systemd管理cat>/etc/systemd/system/openclaw.service<<'EOF'[Unit]ExecStart=/usr/bin/openclawgatewaysystemctlenableopenclawsystemctl界面或进行其他操作。方法一:使用官方RPM包(推荐)#Chrome包cd/tmpwgethttps://dl.google.com/linux/direct/google-chrome-stable_current_x86_64.rpm#Chromeyuminstall-y./google-chrome-stable_current_x86_64.rpm#--version#桌面中运行exportDISPLAY=:1google-chrome--no-sandbox&方法二:添加Google仓库cat>/etc/yum.repos.d/google-chrome.repo<<'EOF'[google-chrome]baseurl=http://dl.google.com/linux/chrome/rpm/stable/x86_64enabled=1gpgkey=https://dl.google.com/linux/linux_signing_key.pubEOF#Chromeyuminstall-y--version方法三:安装Chromium(开源版本)#Chromiumyuminstall-ychromium#--no-sandbox&在VNC后,有两种方式启动:方式一:通过应用菜单点击桌面左上角的应用菜单找到“Internet”Chrome”方式二:通过终端exportDISPLAY=:1google-chrome--no-sandbox&Chrome常见问题问题:依赖缺失#安装必要的依赖yuminstall-yliberation-fontsvulkan问题:中文显示乱码#安装中文字体yuminstall-ywqy-microhei-fontswqy-zenhei-fonts问题:DBus警告ERROR:dbus/object_proxy.cc:572]Failedorg.freedesktop.DBus.Properties.GetAll这是关于电源管理的警告,可以忽略,不影响Chrome/>一键启动脚本为了方便使用,可以创建一个启动脚本来一次性启动所有服务。创建启动脚本#创建启动脚本cat>/usr/local/bin/start-clawx-desktop<<'EOF'#!/bin/bashYELLOW='\033[1;33m'Color"----------------------------------------"echo"----------------------------------------"echo"${GREEN}所有服务已启动!${NC}"echo添加执行权限chmod+x/usr/local/bin/start-clawx-desktop#创建停止脚本cat>/usr/local/bin/stop-clawx-desktop<<'EOF'#!/bin/bashEOFchmod+x/usr/local/bin/stop-clawx-desktop使用启动脚本#启动所有服务start-clawx-desktop#停止所有服务stop-clawx-desktop#-listpsaux|grep-E"clawx|chrome"配置开机自启#systemd服务cat>/etc/systemd/system/clawx-desktop.service<<'EOF'[Unit]ExecStart=/usr/local/bin/start-clawx-desktopExecStop=/usr/local/bin/stop-clawx-desktopRestartSec=10systemctlenableclawx-desktop.servicesystemctlclawx-desktop.serviceVNCvncserver:1&&vncserver-geometry-depth24应用管理#ClawXexportDISPLAY=:1clawx--no-sandbox&#ChromeexportDISPLAY=:1google-chrome--no-sandbox&#查看运行中的应用psaux|grep-E"clawx|chrome|vnc"#停止应用pkill-fgoogle-chrome系统管理#查看端口监听netstat-tlnp|grep5901ss-tlnp|grep5901#查看系统资源tophtopfree-hdf-h#/var/log/messages防火墙管理#VNC--add-port=5901/tcpfirewall-cmd--add-rich-rule='rulesourceaccept'VNC使用较低的分辨率和色深以提高性能vncserver-geometry-depth162.限制应用内存使用#ClawX--max-old-space-size=512&#Chrome--max-old-space-size=512&3.已经是较轻量的选择,如果需要更轻量:#TWM(最轻量)cat>~/.vnc/xstartup<<'EOF'#!/bin/sh-s0/tmp/chrome.log#--vacuum-time=7d/>故障排查清单问题诊断流程#VNC-listpsaux|grepXvnc#检查端口是否监听netstat-tlnp|grep5901#--list-ports-n|grep5901#检查应用进程psaux|grep-E"clawx|chrome"#查看日志tail-50~/.vnc/*.logtail-50/tmp/clawx.logtail-50/tmp/chrome.log-xe|tail-50#连接exportDISPLAY=:1xdpyinfo|head快速修复命令#-killgoogle-chromesleep2vncserver-geometry-depth24exportDISPLAY=:1clawx--no-sandbox&google-chrome--no-sandbox&Linux的完整方案。关键要点:ClawX是桌面应用,需要图形环境,不适合无头服务器生产环境推荐使用OpenClawCLI,更轻量、更稳定VNC方案适合开发测试,便于调试和学习注意安全配置,不要直接暴露VNC端口到公网使用启动脚本,简化日常管理操作定期维护,清理日志和监控资源使用参考资源ClawXGitHub:https://github.com/ValueCell-ai/ClawXOpenClaw文档:https://docs.openclaw.aiTigerVNC官网:https://tigervnc.orgXFCE桌面:https://www.xfce.orgGoogleChrome:https://www.google.com/chrome//>文档版本:v1.1/>最后更新:2026-02-18/>适用版本:ClawX0.1.13+/>贡献者:OpenClawCommunity