OpenClaw VPS 安装配置教程：从部署到 Telegram 接入与模型自动兜底

2026年5月28日 免费资源 网络工具

OpenClaw 是一个可以长期运行在 VPS、家用服务器或本地电脑上的 AI 助手框架。它可以接入 Telegram、WhatsApp、Discord 等聊天渠道，也可以配置多个模型，在主模型不可用、超时或额度不足时自动切换到备用模型，等主模型恢复后再自动切回来。

这篇文章记录一次在 VPS 上部署 OpenClaw 的完整流程，适合想把 AI 助手长期挂在服务器上的用户。
开源地址与OpenClaw官网

一、准备 VPS 环境

推荐配置：

  • 系统：Ubuntu 22.04 / Ubuntu 24.04 / Debian 12
  • 内存：建议 2GB 以上，4GB 更舒服
  • 磁盘：10GB 以上
  • 网络：能访问 GitHub、npm、模型 API、Telegram API
  • 权限：拥有 sudo 权限

先更新系统：

sudo apt update
sudo apt upgrade -y

安装常用工具：

sudo apt install -y curl wget git ca-certificates build-essential

二、安装 OpenClaw

OpenClaw 推荐使用官方安装脚本。它会自动检测系统环境，安装所需依赖，并启动初始化流程。

curl -fsSL https://openclaw.ai/install.sh | bash

如果只想安装，不马上进入引导流程，可以使用：

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard

如果你已经有 Node.js 环境，也可以手动安装：

npm install -g openclaw@latest
openclaw onboard --install-daemon

OpenClaw 推荐 Node.js 24，最低需要 Node.js 22.19+。

检查 Node 版本：

node -v

如果版本太低，可以在 Debian/Ubuntu 上安装 Node.js 24：

curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash -
sudo apt-get install -y nodejs

三、初始化 OpenClaw

安装完成后执行：

openclaw onboard --install-daemon

这个命令会完成：

  • 创建 OpenClaw 配置目录
  • 创建默认工作区
  • 配置模型服务
  • 配置 Gateway
  • 安装系统服务，让 OpenClaw 后台常驻运行

常用配置文件位置：

~/.openclaw/openclaw.json

默认工作区一般是：

~/.openclaw/workspace

查看当前状态：

openclaw status
openclaw gateway status

修改配置后可以重启 Gateway：

openclaw gateway restart

四、配置模型与自动兜底

OpenClaw 支持主模型加 fallback 模型链。主模型报错、超时、限流或额度不足时，会自动切换到备用模型；主模型恢复后，会自动探测并切回来。

示例配置：

{
  "agents": {
    "defaults": {
      "workspace": "~/.openclaw/workspace",
      "model": {
        "primary": "cpamc/gpt-5.5",
        "fallbacks": [
          "cpamc/claude-opus-4-6-thinking",
          "cpamc/gemini-3-pro-high",
          "cpamc/claude-sonnet-4-6",
          "cpamc/gpt-5.4"
        ]
      }
    }
  }
}

完整顺序是：

cpamc/gpt-5.5
→ cpamc/claude-opus-4-6-thinking
→ cpamc/gemini-3-pro-high
→ cpamc/claude-sonnet-4-6
→ cpamc/gpt-5.4

这个机制很适合 VPS 长期在线使用。即使某个模型临时不可用，助手也不会直接失联。

查看模型状态：

openclaw models status

查看可用模型：

openclaw models list

注意：如果你在会话里手动使用 `/model 某个模型` 固定模型，这种手动指定通常是严格模式，可能不会走全局 fallback。想让自动兜底生效，保持默认模型即可。

可以搭建CLIProxyAPI获取自定义API密钥阅读文章

五、配置 Telegram 机器人

如果你希望通过 Telegram 使用 OpenClaw，需要先创建 Telegram Bot。

1. 打开 Telegram，搜索 `@BotFather` 2. 发送：

/newbot

3. 按提示设置机器人名称和用户名 4. BotFather 会返回一个 Bot Token

然后在 OpenClaw 中配置 Telegram：

openclaw channels add --channel telegram --token "你的 Telegram Bot Token"

也可以手动在配置文件中添加：

{
  "channels": {
    "telegram": {
      "enabled": true,
      "botToken": "你的 Telegram Bot Token"
    }
  }
}

为了安全，建议限制允许访问机器人的用户：

{
  "channels": {
    "telegram": {
      "enabled": true,
      "botToken": "你的 Telegram Bot Token",
      "allowFrom": ["telegram:你的用户ID"]
    }
  }
}

配置完成后重启 Gateway：

openclaw gateway restart

然后给 Telegram Bot 发消息测试。

六、后台常驻运行

如果通过下面命令安装：

openclaw onboard --install-daemon

OpenClaw 会自动配置后台服务。

常用命令：

openclaw gateway status
openclaw gateway restart

查看日志：

openclaw logs

也可以查看 systemd 用户服务：

systemctl --user list-units | grep openclaw
journalctl --user -u openclaw-gateway -f

七、VPS 安全建议

1. 不要把 Gateway 直接暴露到公网。默认使用本地绑定或通过 Tailscale 访问更安全。 2. 使用防火墙：

sudo ufw allow OpenSSH
sudo ufw enable
sudo ufw status

3. Telegram Bot 设置访问白名单，不要让陌生人随便调用。 4. 不要把 API Key、Bot Token、`.env`、配置文件提交到公开仓库。 5. 定期更新 OpenClaw：

openclaw update

如果是 npm 安装，也可以：

npm install -g openclaw@latest
openclaw gateway restart

八、可选：使用 Tailscale 远程访问

如果你想在本地电脑安全访问 VPS 上的 OpenClaw Gateway，可以使用 Tailscale。

在 VPS 上安装：

curl -fsSL https://tailscale.com/install.sh | sh
sudo tailscale up

本地电脑也安装 Tailscale，并登录同一个账号。

这样可以通过 Tailscale 内网地址访问 VPS，而不需要把 OpenClaw Gateway 暴露到公网。

如果需要通过 Tailscale 暴露控制 UI，可以使用：

openclaw gateway --tailscale serve

这种方式比直接开放公网端口更安全。

九、常见问题

1. openclaw 命令找不到怎么办？

可能是 npm 全局路径没有加入 PATH。

查看 npm 全局路径：

npm prefix -g

把对应的 bin 目录加入 PATH：

export PATH="$(npm prefix -g)/bin:$PATH"

然后写入 `~/.bashrc` 或 `~/.zshrc`。

2. Telegram Bot 没反应怎么办？

检查：

openclaw gateway status
openclaw logs

确认：

  • Bot Token 是否正确
  • VPS 是否能访问 `api.telegram.org`
  • Telegram 配置是否启用
  • 用户是否在 allowlist 内
  • Gateway 是否正在运行

3. 模型突然不可用怎么办？

如果配置了 fallback，OpenClaw 会自动切换到备用模型。

查看状态：

openclaw models status

主模型恢复后，OpenClaw 会自动探测并切回主模型。

4. VPS 上推荐 Docker 还是直接安装？

一般用户推荐直接安装，最简单。

Docker 适合：

  • 想隔离运行环境
  • 想快速重建实例
  • 熟悉 Docker Compose
  • 有多实例部署需求

直接安装适合：

  • 单 VPS 长期运行
  • 想少折腾
  • 想直接使用 systemd 后台服务

十、总结

OpenClaw 很适合部署在 VPS 上作为长期在线的个人 AI 助手。基础流程是：

curl -fsSL https://openclaw.ai/install.sh | bash
openclaw onboard --install-daemon
openclaw models status
openclaw gateway status

部署完成后，可以接入 Telegram，用手机随时对话；也可以配置多个模型 fallback，让助手在主模型不可用时自动切换，等主模型恢复后再自动回来。

归档