1. 首页 > 技术教程 > 正文

OpenClaw 是什么?适合部署在 VPS 上的开源 AI Agent 介绍

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

zhujixuan TASK 084

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