如何在云服务器上设置 OpenClaw-余初云

在云服务器上搭建 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

如何在云服务器上设置 OpenClaw