2026 搬瓦工 VPS 一键部署 OpenClaw 教程：从零到 AI 助手上线

OpenClaw 是 2026 年最火的开源 AI Agent 项目。和 ChatGPT 网页版不同，OpenClaw 是一个能动手干活的 AI 助手，执行命令、浏览网页、读写文件、操作电脑，还能通过飞书、微信等平台 7×24 小时随时待命。

本文老唐手把手教你在搬瓦工 VPS 上一键部署 OpenClaw。两种安装方式都讲：一键脚本安装（5 分钟搞定，推荐新手）和 Docker 部署（隔离性好，推荐进阶用户）。跟着做，半小时内你就有一个住在 VPS 上的私人 AI 助手。

一、OpenClaw 是什么，能做什么

OpenClaw（原名 Clawdbot / MoltBot）是一个开源的自主 AI Agent 网关。你可以把它理解为住在服务器上的 AI 助手，它比 ChatGPT 多了三样东西：

1. 手：OpenClaw 可以执行 Shell 命令、用浏览器上网搜索、调用 API、操作文件系统。你让它帮我查一下明天的天气，它真的会打开浏览器去搜索。
2. 长期记忆：通过 Markdown 文件 + SQLite 数据库存储记忆，记住你的偏好、历史对话和项目上下文。上次让它帮你处理的事情，下次它还记得。
3. 多平台接入：部署好之后，可以通过飞书、微信、Telegram、Discord、钉钉等 10+ 平台直接对话——手机上随时指挥它干活。

OpenClaw 能干什么（实际例子）

• 让它帮你监控服务器状态，定时汇报到飞书
• 让它帮你整理文档、总结 PDF、翻译文件
• 让它帮你写代码、调试 Bug、部署项目
• 让它帮你抓取网页数据、做数据分析
• 让它当你的日程助手、待办管理器
• 让它帮你批量处理图片、视频、文本

二、配置要求和 VPS 选购

2.1 配置需求

OpenClaw 本身不吃太多资源——核心 Gateway 进程空闲时内存占用约 200-400MB。

• 关于内存：1GB 内存加 Swap 可以跑起来，但执行复杂任务时会明显变慢。老唐建议 2GB 内存起步。
• 真正的费用大头：OpenClaw 本身开源免费，但它需要调用 AI 模型 API（Claude、GPT-4o、DeepSeek 等）。模型 API 费用才是长期支出——后面第 6 节会详细说。

2.2 VPS 推荐套餐

购买教程参考：《搬瓦工购买教程》

老唐建议：个人使用选 KVM 2GB（$99.99/年 ≈ 60 元/月），性价比最高。如果你在国内频繁通过浏览器或飞书使用，上 CN2 GIA-E 线路体验更好。

3. 系统准备

购买 VPS 后，在搬瓦工 KiwiVM 面板中安装系统：推荐 Ubuntu 24.04 x86_64。

SSH 连接到你的 VPS：

ssh root@你的VPS_IP -p SSH端口

3.1 更新系统

apt update && apt upgrade -y

3.2 配置 Swap（1GB 内存必做，2GB 建议也做）

# 创建 4GB Swap 文件
fallocate -l 4G /swapfile
chmod 600 /swapfile
mkswap /swapfile
swapon /swapfile
​
# 开机自动挂载
echo '/swapfile none swap sw 0 0' >> /etc/fstab
​
# 调整 swappiness（降低不必要的 Swap 使用）
echo 'vm.swappiness=10' >> /etc/sysctl.conf
sysctl -p
​
# 验证
free -h

应该看到 Swap 行显示 4.0G。

3.3 配置防火墙（可选但推荐）

# 安装 ufw
apt install -y ufw
​
# 放行 SSH 端口（改成你的实际端口）
ufw allow 22/tcp
​
# 放行 OpenClaw Dashboard 端口
ufw allow 18789/tcp
​
# 启用防火墙
ufw enable
​
# 确认状态
ufw status

四、方式一：一键脚本安装（推荐新手）

这是官方推荐的安装方式，一条命令搞定。脚本会自动检测系统环境、安装 Node.js、安装 OpenClaw、运行配置向导。

4.1 执行一键安装

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

脚本自动执行以下操作：

1. 检测并安装 Node.js 22+（如果系统没有）
2. 通过 npm 全局安装 OpenClaw
3. 运行 openclaw onboard 配置向导
4. 注册 Gateway 守护进程（systemd 服务）

4.2 配置向导

安装脚本会自动进入交互式配置向导 openclaw onboard，按提示操作：

第一步：确认安装

OpenClaw is a powerful AI agent that can execute commands on your system.
Do you want to proceed? [Yes/No]

选择 Yes。

第二步：配置 AI 模型

Select your AI provider:
1. Anthropic (Claude)
2. OpenAI (GPT)
3. Google (Gemini)
4. DeepSeek
5. Local (Ollama)
6. Custom (OpenAI-compatible)

选择你想用的 AI 模型提供商，然后输入 API Key。老唐建议初次使用选 DeepSeek（最便宜）或 Anthropic Claude（效果最好）。

第三步：配置聊天平台（可跳过）

Connect a messaging channel? [Skip for now]

这里可以先跳过，后面再配置。也可以直接选择飞书、Telegram 等平台，按提示输入 Token。

第四步：安装 Gateway 守护进程

Install gateway daemon? [Yes/No]

选择 Yes。这会注册一个 systemd 服务，让 OpenClaw 开机自启、后台运行。

4.3 验证安装

# 检查 OpenClaw 版本
openclaw --version

# 检查 Gateway 状态
openclaw gateway status

# 运行诊断
openclaw doctor

看到 Gateway is running 说明安装成功。

4.4 快速测试

# 启动终端交互界面（TUI）
openclaw tui

在 TUI 界面中输入”你好，自我介绍一下”，如果收到 AI 回复，说明一切正常。按 Ctrl+C 退出。

五、方式二：Docker 部署（推荐进阶）

Docker 部署的好处：容器隔离（不污染宿主机）、升级方便（换个镜像重启就行）、可以和其他 Docker 服务（Dify、n8n 等）共存。

5.1 安装 Docker

# 安装 Docker
curl -fsSL https://get.docker.com | sh

# 把当前用户加入 docker 组（避免每次都 sudo）
usermod -aG docker $USER

# 启动 Docker
systemctl start docker
systemctl enable docker

# 验证
docker --version
docker compose version

5.2 克隆官方仓库

cd /opt
git clone https://github.com/openclaw/openclaw.git
cd openclaw

5.3 运行 Docker 安装脚本

./scripts/docker/setup.sh

安装脚本会：

1. 构建或拉取 OpenClaw Docker 镜像
2. 生成配置文件和 Gateway Token
3. 启动 openclaw-gateway 容器
4. 输出 Dashboard 访问地址和 Token

使用预构建镜像（更快）：

如果不想本地构建，可以直接用官方预构建镜像：

export OPENCLAW_IMAGE="ghcr.io/openclaw/openclaw:latest"
./scripts/docker/setup.sh

常用镜像标签：

• latest：最新稳定版
• main：主分支最新（可能不稳定）
• 2026.3.13：指定版本号（推荐锁定版本）

5.4 Docker Compose 核心配置

安装脚本会自动生成 docker-compose.yml 和 .env 文件。关键配置项：

端口映射：

• 18789：Gateway 端口（Dashboard + API）
• 18790：Bridge 端口（内部通信）

数据持久化：

• 配置目录：~/.openclaw/ → 容器内 /home/node/.openclaw
• 工作区：~/.openclaw/workspace/ → 容器内 /home/node/.openclaw/workspace

环境变量（.env 文件）：

# Gateway Token（安装时自动生成）
OPENCLAW_GATEWAY_TOKEN=你的Token

# 时区
TZ=Asia/Shanghai

# 镜像版本（可选，锁定版本）
OPENCLAW_IMAGE=ghcr.io/openclaw/openclaw:2026.3.13

5.5 手动启动和停止

# 启动
docker compose up -d openclaw-gateway

# 查看状态
docker compose ps

# 查看日志
docker compose logs -f openclaw-gateway

# 停止
docker compose down

# 重启
docker compose restart openclaw-gateway

5.6 通过 CLI 管理（Docker 模式）

Docker 部署下，通过 openclaw-cli 服务执行管理命令：

# 添加聊天通道
docker compose run --rm openclaw-cli channels add

# 查看配置
docker compose run --rm openclaw-cli config

# 获取 Dashboard Token
docker compose run --rm openclaw-cli dashboard --no-open

六、配置 AI 模型

OpenClaw 本身不带 AI 模型，需要配置外部模型 API 作为”大脑”。

6.1 支持的模型

6.2 配置方法

一键脚本安装（onboard 时已配置，需要修改用以下命令）：

openclaw config

选择 Local → Model，修改 AI 提供商和 API Key。

Docker 部署（通过 CLI）：

docker compose run --rm openclaw-cli config

6.3 DeepSeek 配置示例

DeepSeek 是国产 AI，API 价格极低，适合入门：

1. 注册 DeepSeek 开放平台：platform.deepseek.com
2. 创建 API Key
3. 在 OpenClaw 中配置：

openclaw config
# 选择 Provider → DeepSeek
# 输入 API Key
# 选择模型 → deepseek-chat (V3)

配置完成后重启 Gateway：

openclaw gateway restart

6.4 多模型切换

OpenClaw 支持配置多个模型，日常用便宜的，重要任务切到贵的：

{
  models: {
    primary: {
      provider: "deepseek",
      model: "deepseek-chat",
      apiKey: "sk-xxx"
    },
    fallback: [
      {
        provider: "anthropic",
        model: "claude-sonnet-4-20260514",
        apiKey: "sk-ant-xxx"
      }
    ]
  }
}

6.5 费用估算

以”每天和 OpenClaw 对话 20 次”估算：

老唐建议：入门用 DeepSeek V3 或 Gemini 免费额度。确认好用之后再切到 Claude Sonnet，效果天差地别。

七、配置聊天平台通道

部署好 OpenClaw 后，接入聊天平台才能真正”随身带”。

7.1 支持的平台

7.2 添加通道

# 一键脚本安装
openclaw channels add

# Docker 部署
docker compose run --rm openclaw-cli channels add

按交互式提示选择平台并输入对应的 Token / App ID / App Secret。

八、访问 Dashboard 管理面板

OpenClaw 自带一个 Web 管理面板（Dashboard），可以在浏览器里管理配置、查看对话、监控状态。

8.1 访问地址

http://你的VPS_IP:18789

首次访问需要输入 Gateway Token。获取 Token：

# 一键脚本安装
openclaw dashboard --no-open

# Docker 部署
docker compose run --rm openclaw-cli dashboard --no-open

把输出的 Token 粘贴到 Dashboard 的 Settings 中即可。

8.2 通过 SSH 隧道访问（更安全）

如果你不想把 18789 端口暴露到公网，可以用 SSH 隧道：

# 在你的本地电脑执行
ssh -L 18789:127.0.0.1:18789 root@你的VPS_IP -p SSH端口

然后在本地浏览器访问 http://127.0.0.1:18789。

九、设置开机自启和进程守护

9.1 一键脚本安装（已自动配置）

如果你在 openclaw onboard 时选择了安装 daemon，systemd 服务已经自动配置好了。验证：

systemctl status openclaw-gateway

9.2 Docker 部署（已自动配置）

Docker Compose 的 restart: unless-stopped 策略已经确保容器异常退出后自动重启、开机自动启动。验证：

docker compose ps

9.3 手动配置 systemd（如果一键脚本没有自动配置）

cat > /etc/systemd/system/openclaw-gateway.service << 'EOF'
[Unit]
Description=OpenClaw Gateway
After=network.target

[Service]
Type=simple
User=root
ExecStart=/usr/bin/openclaw gateway start --foreground
Restart=always
RestartSec=10
Environment=HOME=/root
Environment=NODE_ENV=production

[Install]
WantedBy=multi-user.target
EOF

systemctl daemon-reload
systemctl enable openclaw-gateway
systemctl start openclaw-gateway

十、升级和日常维护

10.1 升级 OpenClaw

一键脚本安装：

# 升级到最新版
npm update -g openclaw

# 或指定版本
npm install -g openclaw@2026.3.13

# 重启 Gateway
openclaw gateway restart

# 验证版本
openclaw --version

Docker 部署：

cd /opt/openclaw

# 拉取最新代码
git pull

# 使用最新官方镜像
export OPENCLAW_IMAGE="ghcr.io/openclaw/openclaw:latest"

# 重新运行安装脚本
./scripts/docker/setup.sh

10.2 备份配置

# 备份整个配置目录
tar -czf openclaw-backup-$(date +%Y%m%d).tar.gz ~/.openclaw/

# 备份到搬瓦工快照
# 在 KiwiVM 面板中操作：Snapshots → Create new snapshot

10.3 查看日志

# 一键脚本安装
openclaw gateway logs
# 或
journalctl -u openclaw-gateway -f

# Docker 部署
docker compose logs -f openclaw-gateway

10.4 监控资源

# 查看内存和 CPU
htop

# 查看 OpenClaw 进程
ps aux | grep openclaw

# 查看磁盘使用
df -h

十一、安全加固

OpenClaw 拥有较高的系统权限（可以执行命令、读写文件），安全配置非常重要。

11.1 修改 SSH 端口和禁用密码登录

# 修改 SSH 配置
nano /etc/ssh/sshd_config

修改以下行：

Port 2222               # 改成你喜欢的端口
PermitRootLogin prohibit-password   # 禁止密码登录 root
PasswordAuthentication no           # 禁用密码登录（需先配置 SSH Key）

# 重启 SSH
systemctl restart sshd

11.2 限制 OpenClaw 操作权限

在 OpenClaw 配置中收紧权限：

{
  permissions: {
    deny_commands: ["rm -rf /", "shutdown", "reboot", "dd", "mkfs", "fdisk"],
    allowed_directories: ["/home/openclaw/workspace", "/tmp"],
    max_file_size: "10MB"
  },
  limits: {
    daily_token_limit: 200000,
    per_message_token_limit: 8000
  }
}

11.3 Docker 沙箱模式（Docker 部署专属）

Docker 部署支持沙箱隔离，AI Agent 的操作被限制在容器内：

export OPENCLAW_SANDBOX=1
./scripts/docker/setup.sh

沙箱模式下，AI 无法访问宿主机文件系统，安全性大幅提升。

十二、常见问题

安装脚本报错 “Node.js version too old”

OpenClaw 要求 Node.js ≥ 22.16。如果系统自带的 Node.js 版本太低：

# 手动安装 Node.js 24
curl -fsSL https://deb.nodesource.com/setup_24.x | bash -
apt install -y nodejs
node --version

然后重新运行安装脚本。

内存不足，报错 “heap out of memory”

两个解决方案：

1. 加 Swap（见本文第 3.2 节）
2. 升级 VPS 内存。如果你用的搬瓦工 KVM 1GB，考虑升到 KVM 2GB

Docker 部署后，Dashboard 打不开

检查以下几点：

1. 防火墙是否放行 18789 端口：ufw status
2. 容器是否在运行：docker compose ps
3. 是否绑定了正确的地址：默认绑定 127.0.0.1，需要改成 0.0.0.0 才能从外网访问

修改 .env：

OPENCLAW_GATEWAY_HOST=0.0.0.0

然后重启容器。

Gateway Token 丢失了怎么办？

# 一键脚本安装
openclaw dashboard --no-open

# Docker 部署
docker compose run --rm openclaw-cli dashboard --no-open

会输出当前的 Token。

搬瓦工 KiwiVM 面板重装系统后 OpenClaw 会丢失吗？

会。重装系统会清空所有数据。老唐建议：

1. 定期在 KiwiVM 面板创建 Snapshot（快照）
2. 备份 ~/.openclaw/ 目录到本地

OpenClaw 和 Dify / n8n 能同时跑吗？

可以。都用 Docker 部署，资源互不影响。2GB 内存可以跑 OpenClaw + Open WebUI，4GB 可以跑 OpenClaw + Dify + n8n。关键是配好 Swap。

一键脚本安装和 Docker 部署选哪个？

老唐建议：只跑 OpenClaw 一个服务 → 一键脚本。VPS 上还跑了 Dify/n8n 等 Docker 服务 → Docker 部署。

13. 总结和系列文章

在搬瓦工 VPS 上部署 OpenClaw 的关键信息：

• 安装方式：一键脚本（curl -fsSL https://openclaw.ai/install.sh | bash）或 Docker 部署
• 配置要求：2 核 / 2GB 内存起步，1GB 需加 Swap
• VPS 推荐：搬瓦工 KVM 2GB（$99.99/年 ≈ 60 元/月）
• AI 模型：入门用 DeepSeek V3（月费约 3-5 元），进阶用 Claude Sonnet
• 年费总计：VPS $99.99 + DeepSeek API 约 50 元/年 = 总共不到 800 元/年
• Dashboard：http://VPS_IP:18789
• 当前版本：v2026.3.13（2026 年 3 月）

购买建议：预算有限选 KVM 套餐（$49.99/年起），追求速度和稳定选 CN2 GIA-E 套餐（$169.99/年起，支持季付），极致延迟选香港 CN2 GIA 套餐（$89.99/月起）。

搬瓦工官网：bwh81.net

套餐推荐：

• 搬瓦工购买教程：《2026 最新搬瓦工购买教程：新用户注册账户、选择套餐、支付宝付款》