热门开源 AI Agent:OpenClaw 自动化部署与硬件避坑指南
近期,开源社区备受关注的 AI Agent 项目 OpenClaw 热度持续攀升。它支持高度自定义的本地工作流,可以直接挂载服务器目录作为其工作空间,并且能够无缝接入 Telegram 进行远程指令控制。
但需要注意的是,跑这类挂载了长期记忆(Memory)和复杂环境交互插件(MCP Skills)的 AI 代理,对服务器的硬件配置有硬性门槛。官方给出的推荐起步配置是 2核 4G 内存。如果内存过小,在处理复杂逻辑或并发 API 请求时,极其容易触发 OOM(内存溢出)导致 Docker 容器意外崩溃。
在正式动手部署前,我们需要先准备一台网络连通性良好(能够顺畅调用 OpenAI/Claude 等大模型 API)且内存达标的海外 VPS。
一、 运行环境与 VPS 推荐
结合 OpenClaw 需要高频请求海外大模型接口以及 Telegram 服务的特性,海外 VPS + 顶级模型 API 是目前的最佳实践组合。
如果手头没有合适的闲置机器,这里推荐两款完美契合 OpenClaw 性能需求的 4GB 内存高配主机:
- CPU:4 核 (4.5GHz Ryzen 7950X)
- 内存:4096 MB DDR5 (极速响应)
- 硬盘:100 GB NVMe SSD
- 网络:AS9929-CMIN2 高端优化线路
- 价格:$24.00 美元 / 月
- CPU:4 核 Intel Xeon
- 内存:4096 MB
- 硬盘:80 GB RAID-10
- 流量:3 TB / 月
- 特点:极速的 API 互联网络
- 价格:$19.99 美元 / 月
机器开通后,建议重装为干净的 Debian 12 或 Ubuntu 22.04 系统,通过 SSH 登录并提前安装好 Docker 与 Docker Compose 环境。
二、 核心部署与初始化
OpenClaw 官方提供了非常完善的 Docker 部署脚本,只需执行以下命令即可克隆项目并完成初始化:
git clone https://github.com/openclaw/openclaw.git
cd openclaw
./docker-setup.sh
运行脚本后,系统会在宿主机的用户目录下自动创建两个核心文件夹,并安全挂载到 Docker 容器中:
~/.openclaw:核心配置目录,用于存储 AI 的记忆数据、各类配置文件以及你绑定的第三方 API 密钥。~/openclaw/workspace:工作空间目录,Agent 可以直接访问、读写及保存文件的隔离沙箱区域。
三、 Telegram 渠道接入与配对
Docker 容器启动后,默认会在 18789 端口开放配置引导的 Web 界面。你可以先选择 Skip for now 跳过网页配置,直接在终端进行更高效的命令行配对。
1. 准备 Telegram Bot
- 在 Telegram 搜索
@userinfobot获取你个人的 User ID。 - 搜索
@BotFather创建一个新的机器人,并保存好生成的 Bot API Token。 - 将 Token 填入 OpenClaw 配置中的
Telegram (Bot API)字段,Hooks 模式建议选择session-memory。
2. 激活设备配对
当你在 Telegram 端向刚创建的机器人发送 /start 后,它会返回一个配对码(例如 YKEY9974,有效期为 1 小时)。此时返回宿主机服务器终端,执行以下命令完成配对授权:
# Docker 环境下的设备批准命令
docker compose run --rm openclaw-cli pairing approve telegram YKEY9974
四、 常见问题排查 (FAQ)
在实际部署过程中,初学者最容易在目录权限和网络安全配置上遇到阻碍。
1. 启动报错 Error: EACCES: permission denied
原因:Docker 容器内部的默认运行用户(uid=1000)没有权限写入由 root 用户创建的宿主机挂载目录。
解决方案:手动修正目录的归属权,并重新执行初始化流程。
chown -R 1000:1000 "$HOME/.openclaw"
docker compose run --rm openclaw-cli onboard
2. 网页端报错 control ui requires HTTPS or localhost
原因:出于安全限制,OpenClaw 的 Web UI 拒绝在非本地局域网的纯 HTTP 环境下运行。
解决方案:请勿直接通过 http://公网IP:18789 访问。建议使用 Caddy 或 Nginx 配置反向代理,并绑定一个域名自动申请 SSL 证书,全程通过 HTTPS 访问控制面板。
3. 如何修改 AI 的“性格”去除机器味?
进入你的工作空间目录 ~/.openclaw/workspace,找到以下核心调教文件直接修改:
SOUL.md:定义性格与底层逻辑(重点修改此处,可以让它的回复更具拟人化)。AGENTS.md:定义它的行为准则。MEMORY.md:它的长期记忆库。
进阶提示:如果需要为你的 Agent 扩展更多的能力插件,推荐访问 ClawHub 社区下载。例如
Agent Browser(联网能力)和DevTools MCP(开发辅助)都是极度推荐的必装神器。