如果你在找一款能在 VPS 上跑起来、又不用烧显卡的 AI Agent,OpenClaw 值得看一眼。它是个开源项目,主打轻量级任务编排,支持 MCP 协议、API 调用,适合部署在低配服务器上做自动化工作流。本文直接说清楚 OpenClaw 是什么,怎么在 VPS 上用 Docker 部署,以及哪些坑能提前避开。

OpenClaw 是什么?为什么适合 VPS 部署 AI Agent
OpenClaw 是一个基于 Python 构建的开源 AI Agent 框架,核心思路是用自然语言拆解任务,然后通过插件机制调用外部工具(比如搜索、数据库、API)。它不像本地模型那样吃 GPU,所有推理都走 LLM API(OpenAI、Claude、DeepSeek 都支持),所以 1 核 1G 的 VPS 就能跑起来。对于想在服务器上挂一个 7×24 小时待命的 Agent 的人来说,这种架构很务实。
核心特性:轻量、插件化、MCP 支持
OpenClaw 的插件系统叫“ClawPack”,每个插件对应一个工具(比如 Webhook、文件操作、n8n 集成)。它原生支持 MCP(Model Context Protocol),这意味着你可以把它和 Claude Code、Codex 之类的工具混搭,构建更复杂的自动化链路。部署方式首选 Docker,官方提供了 Compose 文件,省去手动装依赖的麻烦。
VPS 部署 OpenClaw 的完整步骤
以下步骤基于 Ubuntu 22.04 + Docker,假设你已经有 VPS 的 root 权限。不写死版本号,具体以官方仓库为准。
1. 环境准备:Docker 和端口检查
先确认 Docker 已安装,没装的话走官方脚本:
curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh
OpenClaw 默认监听 8080 端口,记得在 VPS 防火墙放行:
sudo ufw allow 8080/tcp
老鸟叮嘱:别把 8080 直接暴露公网。后面用 Nginx 反代加 HTTPS 才是正经做法。
2. 拉取镜像并配置 API Key
从官方仓库下载 docker-compose.yml:
git clone https://github.com/openclaw/openclaw-docker.git
cd openclaw-docker
编辑 `docker-compose.yml`,在环境变量里填入你的 LLM API Key。以 OpenAI 为例:
yaml
environment:
– LLM_PROVIDER=openai
– OPENAI_API_KEY=sk-xxxx
– OPENAI_MODEL=gpt-4o
注意:API Key 不要写死在代码里,生产环境建议用 Docker Secret 或环境变量文件(`.env`)。这个坑很多人踩过,被扫了 Key 就等着账单爆炸。
3. 启动服务并验证
docker-compose up -d
docker logs -f openclaw # 看启动日志,确认无报错
访问 `http://你的VPS_IP:8080`,如果看到 OpenClaw 的 Web 界面,说明部署成功。首次登录需要注册管理员账号,走一遍流程就好。
4. 配置反向代理(非必须但推荐)
不配反代也能用,但为了安全,用 Nginx 套一层:
nginx
server {
listen 443 ssl;
server_name your-domain.com;
ssl_certificate /path/to/cert.pem;
ssl_certificate_key /path/to/key.pem;
location / {
proxy_pass http://127.0.0.1:8080;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
}
}
然后关掉防火墙对 8080 的公网访问,只留 443。这一步能防大量扫描脚本。
老鸟叮嘱:部署 OpenClaw 的 3 个避坑点
1.API Key 泄露是最大风险。不要在日志里打明文 Key,不要在 Git 里提交。用 Docker 的 `env_file` 或者 Vault 管理。
2.别用 root 跑容器。默认 Docker 容器是 root 用户,但建议在 compose 里指定普通用户 UID,避免容器被提权后控制宿主机。
3.内存不足时先看插件数量。OpenClaw 本身占用不到 200MB,但如果启用了太多 ClawPack(比如同时挂浏览器自动化、数据库查询),每个插件都会消耗额外内存。用 `docker stats` 监控,别等到 OOM 才想起来。
FAQ
Q1:OpenClaw 和 Claude Code 有什么区别?
A:Claude Code 是 Anthropic 的闭源 CLI 工具,主要面向代码生成;OpenClaw 是开源框架,更强调任务编排和工具链集成,适合做自动化工作流而非单纯写代码。
Q2:1 核 1G 的 VPS 能跑 OpenClaw 吗?
A:能。只要 LLM 走 API 调用,不跑本地模型,1G 内存足够。但如果你同时开 5 个以上的 Agent 会话,建议升到 2G。
Q3:部署后怎么接入 n8n?
A:OpenClaw 提供 Webhook 插件,你可以在 n8n 里用 HTTP Request 节点调用 OpenClaw 的 API,传递任务参数。具体端口和路径看官方文档。
Q4:API Key 被扫了怎么办?
A:立刻去 LLM 平台撤销 Key,然后更换。同时检查 VPS 日志,看有没有异常请求。建议开启 API 用量告警。
Q5:支持哪些 LLM 提供商?
A:官方支持 OpenAI、Claude、DeepSeek、Ollama(本地 API 模式)。如果你用 Ollama,注意需要额外配置模型加载,VPS 内存至少 8G。
Q6:容器日志一直报“Connection refused”怎么办?
A:先检查 LLM API 地址是否可达。如果用的是 OpenAI,确认网络能通 api.openai.com。部分 VPS 厂商默认屏蔽外网,需要提工单开通。
总结:OpenClaw 是个轻量、开源、适合 VPS 的 AI Agent 方案,核心价值在于用 API 调用换低配运行,同时通过插件和 MCP 协议保持扩展性。部署时重点管好 API Key 和端口暴露,别让方便变成风险。
—
**相关阅读:**
– [VPS部署AI工具100讲:AI Agent、Codex、Claude Code、Hermes Agent、Ollama与自动化工作流实战教程](https://www.zhujixuan.com/jishujiaocheng/9606.html)
– [n8n VPS 部署教程:搭建自己的自动化工作流平台](https://www.zhujixuan.com/jishujiaocheng/9892.html)
– [Codex、Claude Code、OpenClaw、Hermes Agent、Ollama、n8n 分别适合什么场景](https://www.zhujixuan.com/jishujiaocheng/9759.html)
转载请注明出处:https://www.zhujixuan.com/jishujiaocheng/9757.html 商家投稿邮箱:zhujixuanblog@qq.com
