在云服务器上搭建 OpenClaw（小龙虾），步骤很简单，只需准备好云服务器（VPS）环境，克隆 OpenClaw 官方仓库，运行 Docker 设置脚本，配置好 AI 提供者的凭证，再连接到消息平台即可。整个过程大概 30 分钟，完成后即可拥有一个全天候在线、自动回复消息的 AI 助手。
虽然技术上可在个人笔记本上运行 OpenClaw，但存在明显限制：一旦关闭电脑或断网，机器人就会离线。这也是在云服务器上运行的实用之处——能提供稳定的可用性，后台持续运行，即便本地离线，机器人也能一直工作。
1. 为 OpenClaw 准备一个云服务器
搭建 OpenClaw 首先需准备云服务器，需一台拥有完整管理员权限的 Linux VPS。这是整个项目的基础，只有始终在线的服务器，才能保证机器人不“休眠”。
- 无需高性能服务器，但需满足 OpenClaw 的基本需求以保证运行稳定。以下是服务器必备清单，可对照检查：
- 操作系统：Linux（Ubuntu 22.04 或 24.04 版本均适用，运行稳定）；
- 权限：拥有管理权限（root 权限或 sudo 权限，可执行各类操作）；
- 软件：已安装 Docker 和 Docker Compose；
- 内存：至少 2GB（建议 4GB，可提升运行流畅度，避免卡顿）；
- 磁盘空间：10GB 以上，用于存放 Docker 镜像、应用数据和日志文件。
若为首次设置 VPS，建议先学习基础的 VPS 设置方法，按初始配置步骤操作，确保可通过 SSH 成功连接服务器，这是后续所有操作的前提。
2. 确保 VPS 上有 Docker
Docker 是运行 OpenClaw 的核心工具，可理解为一个“容器”——将 OpenClaw 运行所需的所有组件打包成一个整齐的单元。OpenClaw 需要的支持组件，Docker 会一键安装，完成所有操作，简洁可靠且便于后续管理。
通过命令行确认 Docker 安装状态，可通过 SSH 登录服务器后，运行以下命令：
docker --version docker compose version
正常情况下，会显示 Docker 和 Docker Compose 的版本号；若提示“找不到命令”，则说明 Docker 尚未安装。
OpenClaw 的 Docker 设置依赖于 Docker 容器系统的健康状态，若需手动安装，建议先学习 Ubuntu 系统下的 Docker 安装方法，安装完成后再用上述命令验证，确保安装成功。
确认 Docker 正常运行后，即可开始部署 OpenClaw。
3. 克隆 OpenClaw 仓库
接下来进入核心操作，需克隆 OpenClaw 仓库，再通过官方提供的 Docker 设置脚本，完成所有构建和部署工作。
首先在服务器上获取 OpenClaw 代码，依次运行以下命令：
# Install git if you don't have it sudo apt install git -y # Clone the repository git clone https://github.com/openclaw/openclaw.git # Navigate into the directory cd openclaw
注意：若克隆过程中出现报错，可能是该 GitHub 仓库（https://github.com/openclaw/openclaw.git）存在访问问题或内容超限，可稍后重试或检查网络连接。
进入目录后，运行 Docker 设置脚本即可。OpenClaw 自带自动处理脚本，无需过多手动操作：
./docker-setup.sh
该设置脚本是 OpenClaw 的“一站式启动工具”，可完成所有准备工作，具体作用如下：
- 在本地构建 OpenClaw 的 Docker 镜像（基于附带的 Dockerfile）；
- 在 Docker 容器中启动入职向导，引导完成配置；
- 生成访问控制界面的网关令牌；
- 创建运行所需的各种配置目录；
- 通过 Docker Compose 启动 OpenClaw 网关。
整个流程均为自动化，与许多需拉取预构建镜像的 Docker 应用不同，OpenClaw 会在服务器上本地构建镜像，具备以下优势：
- 运行的始终是仓库中的最新版本；
- 首次构建仅需几分钟时间；
- 后续重建时，可利用 Docker 的层缓存，提升速度；
- 可完全控制镜像内容，安全性更高。
4. 配置 OpenClaw 凭证和设置
运行 ./docker-setup.sh 脚本后，镜像构建完成，会自动启动交互式引导向导，辅助完成 OpenClaw 的配置。此处是设置 AI 服务提供商凭证和其他关键参数的关键环节，需仔细操作。
向导会提出几个重要问题，按提示逐步回答即可：
网关模式
包含两个选项：本地（在本台服务器运行）、远程（连接已有的网关），选择“本地”即可，确保网关运行在 VPS 上，提升稳定性。
认证方式（最关键的一步）
此步骤需告知 OpenClaw 如何访问 AI 模型，包含四个可选选项：
- Anthropic API 密钥（推荐）；
- OpenAI API 密钥；
- OAuth（Claude Pro/Max 订阅）；
- OpenAI 代码（Codex 订阅）。
若选择推荐的 Anthropic API Key，需先注册或登录 Anthropic 账号，进入 API Keys 页面，创建新密钥后，复制并粘贴到设置向导中。
需特别注意：妥善保管该密钥！任何获取该密钥的人，均可在对应账户下使用 Claude，产生的费用由账户所有者承担。
其他选项的操作流程类似，均需从对应 AI 平台获取密钥，再粘贴到设置中。向导会将这些凭证以 Linux 环境变量的形式，存储在配置文件中，后续无需重复设置。
设置完密钥后，选择对应 AI 平台的模型，再配置好安全设置即可。
需提醒的是：OpenClaw 最常见的配置错误为缺少 API 密钥。无有效的 Anthropic 或 OpenAI API 密钥，OpenClaw 无法正常运行。且 Anthropic 和 OpenAI 均要求账户绑定支付方式方可访问 API，因此需确保 API 密钥处于激活状态，并已完成计费信息设置。
5. 启动 OpenClaw，并确认其运行
设置脚本完成后，OpenClaw 会自动启动。为确保运行正常，建议检查容器状态，步骤如下：
# Make sure you're in the openclaw directory cd ~/openclaw # Check running containers docker compose ps
正常情况下，会看到 openclaw-gateway 的状态显示为“Up”或“Running”，即说明启动成功。除此之外，以下迹象也可证明运行正常：
- 出现“OpenClaw 初始化”的相关消息；
- AI 模型提供者（Anthropic/OpenAI）显示连接成功；
- 无任何认证相关的错误提示。
若出现“API 密钥无效”“认证失败”“连接拒绝”等提示，或容器不断重启，则说明存在错误。此时需暂停操作，排查并修复错误，具体可通过查看日志定位问题，日志能详细显示错误信息：
docker compose logs openclaw-gateway
日志会详细显示机器人的运行状态和错误信息，是排查问题的关键，需充分利用。
6. 访问 OpenClaw 接口
OpenClaw 的仪表盘可通过 VPS IP 地址访问，端口为 18789，访问地址格式如下：
http://your-vps-ip:18789
举个例子：http://45.123.45.67:18789（注意：该示例 IP 对应的网页目前解析失败，提示“网页解析失败，可能是不支持的网页类型，请检查网页或稍后重试”，若遇到此类问题，可检查容器运行状态、防火墙端口是否开放或稍后重试）。
首次访问控制界面时，需输入设置过程中生成的网关令牌。
cat ~/.clawdbot/.env | grep CLAWDBOT_GATEWAY_TOKEN
或者检查你运行 ./docker-setup.sh 时的输出——它会显示令牌。
注意：尽管项目已更名为 OpenClaw，但配置文件和目录仍沿用“clawdbot”命名，比如 ~/.clawdbot/ 目录和 CLAWDBOT_GATEWAY_TOKEN 标识。这属于过渡期间的正常情况，不会影响功能正常使用。
进入仪表盘后，需进入令牌设置页面（若未自动提示，可手动查找），粘贴获取到的网关令牌，点击保存或认证即可。
这个 OpenClaw 界面就是核心控制中心，无需立即完成所有配置，只需确认能够正常访问、且 OpenClaw 显示为健康状态即可。
若无法正常访问界面，可按照以下故障排除步骤操作：
- 检查容器是否正常运行，执行命令：docker compose ps
- 确认防火墙未阻挡 18789 端口
- 确保访问时使用 HTTP 协议，而非 HTTPS
- 尝试在服务器端通过命令行访问，执行命令：curl http://localhost:18789
7. 将消息通道连接到 OpenClaw
刚才配置的网页仪表盘主要用于管理操作，实际与 OpenClaw 的互动的是通过消息应用进行，AI 对话也将在消息应用中开展。
以下将以 Telegram 为例讲解设置方法，其操作简单易懂，其他消息平台的设置流程也基本类似。
OpenClaw Telegram 具体设置步骤如下：
步骤 1：创建 Telegram 机器人
- 打开 Telegram 应用，搜索 @BotFather，发起聊天后发送 /newbot，随后按照提示完成操作：
- 为机器人设置一个名称（例如 My OpenClaw 助手）；
- 设置一个用户名（必须以“bot”结尾，比如 myawesomemoltbot）。
- 操作完成后，BotFather 会生成一个机器人代币，保存好该代币备用。
步骤 2：将 Telegram 添加到 OpenClaw
返回服务器，依次执行以下命令（确保处于 openclaw 目录下）：
# Make sure you're in the openclaw directory cd ~/openclaw # Add Telegram with your bot token docker compose exec openclaw-gateway node dist/index.js providers add --provider telegram --token YOUR_BOT_TOKEN
将命令中的 YOUR_BOT_TOKEN 替换为 BotFather 提供的实际机器人代币即可。
步骤 3：启用机器人所需权限
回到与 BotFather 的聊天窗口，按以下步骤操作：
- 发送 /mybots 指令；
- 选择刚刚创建的机器人；
- 进入机器人设置，找到“组隐私”选项；
- 禁用组隐私（这样机器人才能在群组中读取消息，正常响应）。
步骤 4：开始聊天测试
打开 Telegram，通过之前设置的用户名搜索到该机器人，发起对话并发送一条测试消息即可。
若设置过程中开启了 DM 配对，会收到一个配对码。此时在服务器上执行以下命令批准配对：
docker compose exec openclaw-gateway node dist/index.js pairing approve telegram <the-code-you-received>
将 <the-code-you-received> 替换为收到的实际配对码，批准后再发送一条测试消息，OpenClaw 即可正常回应。
若 OpenClaw 在 Telegram 中无法正常发送消息，可按以下方向排查问题：
- 查看 OpenClaw 日志，排查是否存在错误；
- 确认 AI 平台的 API 密钥仍处于有效状态；
- 检查 OpenClaw 容器是否存在重启或崩溃的情况；
- 核实 Telegram 机器人代币等消息平台凭证是否配置正确
【余初云】专为OpenClaw打造专属云服务器套餐，一键部署OpenClaw、零门槛、安全加固，轻松拥有 7×24 小时在线 AI 助手，开箱即用！欢迎咨询客服！
原创文章，作者：余初云，如若转载，请注明出处：https://blog.jidcy.com/jsjc/2513.html
