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

二、准备工作

部署前请准备好以下材料:

  1. 两台VPS的登录信息:IP地址、root密码(或SSH密钥),建议配置2核2G内存起,推荐4G内存+20G以上磁盘
  2. 本地电脑SSH工具:Windows自带PowerShell即可,Xshell/FinalShell使用更方便
  3. Telegram账号(用于@BotFather创建机器人);接飞书需要可登录飞书开放平台的账号
  4. 大模型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(两台机器分别操作)

  1. 在Telegram中搜索 @BotFather,发送 /newbot,按提示设置机器人名称和用户名,创建完成后会获得机器人Token(格式类似 123456:ABCdefGhIJKlmNoPQRsTUVwxyZ)

  2. 在服务器执行命令添加渠道:

    • 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"

  3. 在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)

  1. 打开飞书开放平台 open.feishu.cn,创建企业自建应用,添加"机器人"能力

  2. 在"凭证与基础信息"页面复制 App ID 和 App Secret

  3. 在"权限管理"页面开通消息收发所需的全部权限

  4. 在"事件订阅"页面选择长连接模式,订阅 im.message.receive_v1 事件

  5. 点击"版本管理与发布",发布应用等待审核通过

  6. 回到服务器执行登录向导,按提示粘贴App ID和App Secret:

    # Ubuntu​openclaw channels login --channel feishu​openclaw gateway restart​​# CentOS​docker compose run --rm openclaw-cli channels login --channel feishu

  7. 在飞书中给机器人发消息,回到服务器批准配对:

    # 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重启网关

七、安全建议与后续配置

安全配置

  1. 绝对不要对公网开放18789端口,始终使用SSH隧道方式访问控制台
  2. SSH登录建议关闭密码认证,仅使用密钥登录
  3. 访问令牌、App ID、App Secret等敏感信息不要泄露,不要提交到公开代码仓库
  4. 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隧道打开即可使用。