第一次看到OpenClaw的时候,我以为又是那种“宣传很美好,装完就吃灰”的开源项目。但用了两周之后,我收回这句话。这玩意儿是真的能干活。它能接微信、钉钉、Telegram,能定时执行任务,能联网搜索,能跑代码,能读文件……而且最关键的是——部署在一台香港VPS上之后,它就能7x24小时在线,你关掉电脑它也在跑。
这篇文章就是把我在香港VPS上部署OpenClaw的完整过程记录下来,包括踩过的坑、填坑的方法、以及最终跑起来的配置。
注:OpenClaw曾用名包括Clawdbot、Moltbot,你在一些老教程里看到这些名字,指的都是同一个东西。
一、为什么要用香港VPS?
在选择部署位置这件事上,我吃过亏。
最开始我贪便宜,买了一台美国VPS。装完OpenClaw之后发现,调用国内的大模型API延迟高得离谱,动不动超时。而且美国IP访问一些国内服务时经常被限制。后来换到香港VPS,问题基本解决了。香港的优势很明显:
- 免备案:不用走国内那套ICP备案流程,买到手就能用
- 延迟低:香港到大陆的延迟一般在30-60ms,调用国内API很顺畅
- 网络自由:访问GitHub、Docker Hub这些海外资源没问题,同时也能很好地连接国内服务
- 配置建议:根据官方要求和实际测试,2核4GB内存是起步配置,4核8GB会更舒服。系统选Ubuntu 22.04或24.04 LTS,兼容性最好。
我测试用的配置是:香港VPS、4核8G、10M带宽、Ubuntu 24.04。
二、部署前的准备工作
1. 连接服务器
用SSH工具连上你的VPS。我习惯用终端直接连:
ssh root@你的服务器IP
如果是第一次连接,会提示确认指纹,输入yes就行。
2. 更新系统
刚拿到手的服务器,第一件事永远是更新系统:
sudo apt update && sudo apt upgrade -y
这一步可能会花一两分钟,取决于网速。
3. 安装基础工具
有些精简版的系统连curl和git都没装,先补上:
sudo apt install -y curl wget git vim
4. 开放端口
OpenClaw的Web控制台默认跑在18789端口。如果不开防火墙,外网访问不了。
用ufw的话:
sudo ufw allow 22/tcp # SSH端口
sudo ufw allow 18789/tcp # OpenClaw控制台端口
sudo ufw enable
sudo ufw status
有的云服务商还得去网页控制台的安全组里手动放行18789端口。这步容易忘,记得检查。
三、安装Node.js(核心依赖)
OpenClaw官方明确要求Node.js版本≥22.0.0。服务器自带的Node.js版本通常很老,所以不能用apt直接装。
推荐用nvm(Node Version Manager)来装,以后换版本也方便。
1. 安装nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
安装完执行下面命令让nvm生效:
export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
2. 安装Node.js 22
nvm install 22
nvm use 22
验证一下:
node --version
# 应该输出 v22.x.x
npm --version
# 应该输出 10.x.x 或更高
四、安装OpenClaw
1. 配置npm国内镜像(可选但推荐)
香港网络连GitHub和npm官方源虽然比大陆好,但偶尔也会慢。配置国内镜像能提速:
npm config set registry https://registry.npmmirror.com
2. 执行一键安装
官方提供了一键安装脚本,会自动处理依赖和配置:
npm install -g openclaw@latest
如果遇到Git下载错误,执行下面命令再重新安装:
git config --global url."https://github.com/".insteadOf ssh://git@github.com/
sudo npm install -g openclaw@latest
3. 验证安装
openclaw --version
能看到版本号(比如2026.3.2)就说明装好了。
五、初始化配置(最关键的一步)
1. 运行配置向导
openclaw onboard --install-daemon
--install-daemon这个参数很重要——它会把OpenClaw安装成系统服务,这样服务器重启后它会自动启动,不用你每次手动去开。
2. 配置模型API Key
配置命令:
openclaw config set models.providers.bailian.apiKey "你的API Key"
如果用的是其他模型,把bailian换成对应的provider名称就行。
3. 生成访问Token
初始化完成后,生成一个Token用于登录Web控制台:
openclaw token generate --expire 365d
这个Token一定要保存好,丢了的话要重新生成。
六、开放公网访问(大坑预警!)
这是最容易踩坑的地方,我必须单独拿出来说。
默认情况下,OpenClaw的网关只监听127.0.0.1:18789,也就是只有服务器本机才能访问。你直接用http://服务器IP:18789是打不开的。
1. 检查当前绑定状态
openclaw gateway status
如果看到"bind": "loopback",就说明是这个问题。
2. 修改为公网可访问
openclaw config set gateway.bind "lan"
3. 重启网关
openclaw gateway restart
4. 确认服务状态
openclaw gateway status
确保状态是running,绑定模式是lan。
现在在浏览器输入http://你的服务器IP:18789,应该能看到登录界面了。输入之前生成的Token,就能进入Web控制台。
七、技能安装(让OpenClaw真正干活)
OpenClaw本身是个框架,各种能力靠“技能”来实现。安装技能的命令:
openclaw skills install 技能名称
常用技能推荐:
code-executor:执行代码
web-browser:浏览器控制
email:邮件管理
file-manager:文件管理
安装完技能记得重启网关:
openclaw gateway restart
常见问答:
问:OpenClaw对服务器配置的最低要求是什么?
答:官方要求2核2GB以上,但我实测1核2GB能跑但经常卡。4GB内存会更稳妥,能同时跑多个技能不崩。
问:为什么连接不上Web控制台?
答:三个原因最常见:
- 没改
gateway.bind配置,默认是loopback模式,改成lan就行 - 防火墙没放行18789端口
- 云服务商的安全组没配
问:OpenClaw支持哪些聊天渠道?
答:目前支持飞书、QQ、企业微信、钉钉、Discord、Telegram。配置渠道时需要在对应平台的开发者后台创建应用,获取Token。
问:API Key配置后模型调用失败怎么办?
答:先检查API Key有没有复制完整(不要有空格),然后确认对应的模型服务已经开通。可以用openclaw config get models.providers查看当前配置。
总结:从买VPS到跑通OpenClaw,熟练的话大概半小时就能搞定。最容易出问题的地方其实就是两个:Node.js版本够不够22、以及公网访问的绑定配置。装完之后建议先去Web控制台熟悉一下界面,随便发句话试试。如果模型配置正确,它应该能正常回复你。
推荐文章
