OpenClaw 两台VPS 0基础部署上线完整方案
适用环境:CentOS 7 amd64(Docker部署) + Ubuntu 22.04 LTS amd64(原生部署) 最终效果:两台机器均可通过网页控制台管理,同时接入Telegram/飞书聊天机器人 预计耗时:Ubuntu约15分钟,CentOS约40分钟,全程无需开放公网端口
一、部署前必读说明
OpenClaw(俗称"龙虾")是开源AI智能体平台,装好后可通过聊天软件指挥它完成各类自动化任务。它本身是调度中枢,不含大模型,需要额外接入大模型API(可以最后再填,先跑通框架)。
两台机器采用不同部署路线的原因:
- OpenClaw硬性要求Node.js 22.22.3+ / 24.15+ / 25.9+,默认使用Node 24
- Ubuntu 22.04底层glibc版本2.35足够新,直接使用官方一键脚本原生安装
- CentOS 7已于2024年停止维护,底层glibc停留在2.17,新版Node无法直接运行,必须使用Docker容器绕开系统限制
- 两台部署完成后使用方式完全一致:网页控制台 + Telegram/飞书聊天,默认端口均为18789
二、准备工作
部署前请准备好以下材料:
- 两台VPS的登录信息:IP地址、root密码(或SSH密钥),建议配置2核2G内存起,推荐4G内存+20G以上磁盘
- 本地电脑SSH工具:Windows自带PowerShell即可,Xshell/FinalShell使用更方便
- Telegram账号(用于@BotFather创建机器人);接飞书需要可登录飞书开放平台的账号
- 大模型API Key:国内服务器推荐Kimi或DeepSeek,直连稳定价格低,此项可留到部署完成后再配置
三、Ubuntu 22.04 原生部署步骤(约15分钟)
步骤1:更新系统
登录服务器后首先更新系统软件包:
sudo apt update && sudo apt upgrade -y
步骤2:执行官方一键安装脚本
脚本会自动检测环境、安装对应版本Node.js,并进入配置向导:
curl -fsSL https://openclaw.ai/install.sh | bash
步骤3:配置向导选项
按提示依次选择:
- 风险确认:选择 Yes
- 安装模式:选择 QuickStart
- 大模型配置:暂无Key则选择 Skip for now
- 渠道接入:先选择跳过,部署完成后再配置
- 技能和钩子配置:全部跳过
向导执行完成后会自动生成控制台访问令牌,请注意保存,令牌默认存放路径为
~/.openclaw/openclaw.json
步骤4:安装后台常驻服务
配置程序随系统自动启动:
openclaw onboard --install-daemon
openclaw gateway start
sudo loginctl enable-linger root
步骤5:验证安装
执行以下三条命令,全部正常返回即表示安装成功:
openclaw --version # 查看版本号
openclaw doctor # 环境健康检查
openclaw gateway status # 查看网关运行状态
步骤6:本地访问控制台
无需开放公网端口,在你自己的本地电脑上打开终端,执行SSH隧道映射:
ssh -N -L 18789:127.0.0.1:18789 root@你的Ubuntu服务器IP
保持这条命令运行,浏览器打开 http://127.0.0.1:18789,输入之前保存的访问令牌即可进入控制台。
四、CentOS 7 Docker部署步骤(约40分钟)
⚠️ 注意:CentOS 7官方软件源已下线,必须先替换国内镜像源,否则所有yum命令都会报错。
步骤1:替换系统软件源
sudo mv /etc/yum.repos.d /etc/yum.repos.d.bak
sudo mkdir -p /etc/yum.repos.d
sudo curl -o /etc/yum.repos.d/CentOS-Base.repo https://mirrors.aliyun.com/repo/Centos-7.repo
sudo yum clean all && sudo yum makecache
步骤2:安装基础工具并添加Docker源
sudo yum install -y yum-utils device-mapper-persistent-data lvm2 git
sudo yum-config-manager --add-repo http://mirrors.aliyun.com/docker-ce/linux/centos/docker-ce.repo
步骤3:安装稳定版Docker
CentOS 7上请勿安装最新版Docker,锁定24.0.7版本兼容性最好:
sudo yum install -y docker-ce-24.0.7-1.el7 docker-ce-cli-24.0.7-1.el7 containerd.io docker-compose-plugin
sudo systemctl enable --now docker
sudo usermod -aG docker $USER
步骤4:重新登录验证Docker权限
执行完上一步后,退出SSH并重新连接服务器,使用户组权限生效,然后验证安装:
docker version
docker compose version
步骤5:配置Docker镜像加速(可选但推荐)
如果拉取镜像超时,先配置国内镜像加速(可从阿里云容器镜像服务免费获取专属加速地址):
sudo mkdir -p /etc/docker
sudo tee /etc/docker/daemon.json >/dev/null <<'EOF'
{ "registry-mirrors": ["你的镜像加速地址"] }
EOF
sudo systemctl restart docker
步骤6:拉取项目并启动容器
cd /opt && sudo git clone https://github.com/openclaw/openclaw.git
sudo chown -R $USER /opt/openclaw && cd /opt/openclaw
export OPENCLAW_IMAGE="openclaw/openclaw:latest"
./scripts/docker/setup.sh
执行后会自动启动配置向导,选项同Ubuntu部署步骤3。
步骤7:本地访问控制台
同样使用SSH隧道方式访问,无需开放公网端口:
ssh -N -L 18789:127.0.0.1:18789 root@你的CentOS服务器IP
浏览器打开 http://127.0.0.1:18789,输入令牌即可。如果忘记访问地址,执行以下命令重新获取:
docker compose run --rm openclaw-cli dashboard --no-open
五、接入聊天机器人
⚠️ 重要提醒:两台机器必须分别创建两个不同的机器人,同一个Token同时在两台机器使用会报409冲突,导致双方都收不到消息。
5.1 接入Telegram(两台机器分别操作)
-
在Telegram中搜索 @BotFather,发送
/newbot,按提示设置机器人名称和用户名,创建完成后会获得机器人Token(格式类似123456:ABCdefGhIJKlmNoPQRsTUVwxyZ) -
在服务器执行命令添加渠道:
-
Ubuntu原生部署:
openclaw channels add --channel telegram --token "你的Telegram机器人Token"openclaw gateway restart -
CentOS Docker部署(命令前加docker compose前缀):
docker compose run --rm openclaw-cli channels add --channel telegram --token "你的Telegram机器人Token"
-
-
在Telegram中给你的机器人发送任意一条消息,然后回到服务器批准配对:
# Ubuntu
openclaw pairing list telegram
openclaw pairing approve telegram 显示的配对码# CentOS
docker compose run --rm openclaw-cli pairing list telegram
docker compose run --rm openclaw-cli pairing approve telegram 显示的配对码
5.2 接入飞书(自带WebSocket长连接,无需公网域名和HTTPS)
-
打开飞书开放平台
open.feishu.cn,创建企业自建应用,添加"机器人"能力 -
在"凭证与基础信息"页面复制 App ID 和 App Secret
-
在"权限管理"页面开通消息收发所需的全部权限
-
在"事件订阅"页面选择长连接模式,订阅
im.message.receive_v1事件 -
点击"版本管理与发布",发布应用等待审核通过
-
回到服务器执行登录向导,按提示粘贴App ID和App Secret:
# Ubuntuopenclaw channels login --channel feishuopenclaw gateway restart# CentOSdocker compose run --rm openclaw-cli channels login --channel feishu -
在飞书中给机器人发消息,回到服务器批准配对:
# Ubuntu
openclaw pairing list feishu
openclaw pairing approve feishu 显示的配对码# CentOS
docker compose run --rm openclaw-cli pairing list feishu
docker compose run --rm openclaw-cli pairing approve feishu 显示的配对码
注意:飞书接入要求OpenClaw版本在2026.5.29以上,版本不足请先执行
openclaw update更新(CentOS重新拉取最新镜像即可)。
六、上线自检与常见问题排查
6.1 健康检查
服务启动后执行以下命令,返回 ok即表示网关正常运行:
curl -fsS http://127.0.0.1:18789/healthz
curl -fsS http://127.0.0.1:18789/readyz
6.2 常见问题对照表
| 故障现象 | 产生原因 | 解决方法 |
|---|---|---|
输入 openclaw提示command not found |
全局命令目录未加入PATH | 执行 source ~/.bashrc或重新登录SSH |
报错 GLIBC_2.28 not found |
在CentOS 7上直接安装了原生Node版本 | 改用Docker部署方案,不要原生安装 |
| Docker拉取镜像超时/卡住 | 国内网络访问ghcr.io/Docker Hub受限 | 配置Docker镜像加速地址,或给服务器设置代理 |
| 网关启动失败、容器反复重启 | CentOS 7默认内核版本(3.10)过旧不兼容新镜像 | 升级系统内核,或直接更换为Ubuntu 22.04系统 |
| Telegram机器人不回复消息 | 未批准配对,或服务器无法连接Telegram API | 先执行 pairing approve;国内服务器请为终端配置代理 |
| Telegram报409冲突错误 | 两台机器使用了同一个机器人Token | 每台机器单独创建一个独立的机器人 |
| 飞书机器人无响应 | 权限未开全、事件订阅未选长连接、应用未发布 | 逐项检查配置后执行 openclaw gateway restart重启网关 |
七、安全建议与后续配置
安全配置
- 绝对不要对公网开放18789端口,始终使用SSH隧道方式访问控制台
- SSH登录建议关闭密码认证,仅使用密钥登录
- 访问令牌、App ID、App Secret等敏感信息不要泄露,不要提交到公开代码仓库
- OpenClaw拥有文件读写和命令执行权限,请勿将机器人拉入公开群聊
后续添加大模型
部署完成后随时可以重新运行配置向导添加大模型,无需重装:
# Ubuntu原生部署
openclaw onboard
# CentOS Docker部署
docker compose run --rm openclaw-cli onboard
日常维护命令
# 查看网关状态
openclaw gateway status # Ubuntu
docker compose ps # CentOS
# 重启网关
openclaw gateway restart # Ubuntu
docker compose restart openclaw # CentOS
# 查看运行日志
openclaw logs # Ubuntu
docker compose logs -f openclaw # CentOS
# 更新版本
openclaw update # Ubuntu
docker compose pull && docker compose up -d # CentOS
部署完成后,你就可以直接在Telegram/飞书中给机器人发送指令,控制台仅在需要修改配置时通过SSH隧道打开即可使用。
评论区