🚀 OpenClaw 部署完整指南 —— 在 VPS 上搭建你的 AI 助手
🚀 OpenClaw 部署完整指南
> 作者: simple
| 发布时间: 2026-03-09 |
📖 什么是 OpenClaw？
OpenClaw 是一个强大的 AI 助手框架，支持：
- 🤖 多模型接入（Claude、GPT、Qwen 等）
- 💬 多平台消息（WhatsApp、Telegram、Discord、QQ 等）
- 🛠️ 丰富的工具链（文件操作、浏览器自动化、代码执行等）
- 🔒 本地部署，数据完全掌控
🎯 三种部署方式
方式一：一键安装脚本（推荐新手）
适合：个人电脑、WSL2、有 root 权限的 VPS
bash
macOS / Linux / WSL2
curl -fsSL https://openclaw.ai/install.sh | bash
Windows PowerShell
iwr -useb https://openclaw.ai/install.ps1 | iex
方式二：Docker 部署（推荐生产环境）
适合：VPS、云服务器、需要隔离环境
bash
git clone https://github.com/openclaw/openclaw.git
cd openclaw
./docker-setup.sh
方式三：源码安装
适合：开发者、需要自定义功能
bash
git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm build
pnpm link --global
📦 详细部署步骤
一键安装（完整流程）
1️⃣ 系统要求
- Node.js 22+
- 至少 2GB 内存
2️⃣ 执行安装
bash
curl -fsSL https://openclaw.ai/install.sh | bash
安装脚本会自动检测并安装 Node.js 22+、Git，并通过 npm 安装 OpenClaw。
3️⃣ 运行向导
bash
openclaw onboard --install-daemon
向导会引导你选择 AI 模型提供商、配置 API 密钥、设置消息渠道。
4️⃣ 检查状态
bash
openclaw gateway status
openclaw dashboard
访问 http://127.0.0.1:18789/ 即可使用！
🐳 Docker 部署
1️⃣ 安装 Docker
bash
sudo apt update
sudo apt install -y docker.io docker-compose
sudo systemctl start docker
2️⃣ 克隆并运行
bash
git clone https://github.com/openclaw/openclaw.git
cd openclaw
基础安装
./docker-setup.sh
启用沙箱隔离（推荐）
export OPENCLAW_SANDBOX=1
./docker-setup.sh
3️⃣ 获取令牌
bash
docker compose run --rm openclaw-cli dashboard --no-open
复制输出的 URL，在浏览器中打开并保存令牌。
☁️ VPS 部署（Oracle Cloud 免费）
配置要求：
- ARM 实例（Ampere A1）
- 4 核 CPU + 24GB 内存（免费额度）
- Ubuntu 22.04 LTS
部署脚本：
bash
1. 更新系统
sudo apt update && sudo apt upgrade -y
2. 安装 Node.js 22
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs
3. 安装 OpenClaw
curl -fsSL https://openclaw.ai/install.sh | bash
4. 性能优化（小内存 VPS）
export NODE_COMPILE_CACHE=/var/tmp/openclaw-compile-cache
mkdir -p /var/tmp/openclaw-compile-cache
export OPENCLAW_NO_RESPAWN=1
5. 运行向导
openclaw onboard --install-daemon
防火墙配置：
bash
只允许 SSH
sudo ufw allow 22/tcp
sudo ufw enable
SSH 隧道访问（推荐）：
bash
本地电脑执行
ssh -L 18789:127.0.0.1:18789 user@your-vps-ip
然后访问 http://127.0.0.1:18789
🔧 常用命令
服务管理：
bash
openclaw gateway status # 查看状态
openclaw gateway restart # 重启服务
openclaw gateway stop # 停止服务
openclaw gateway --port 18789 # 前台运行（调试）
渠道配置：
bash
openclaw channels login # WhatsApp（扫码）
openclaw channels add --channel telegram --token "TOKEN"
openclaw channels add --channel discord --token "TOKEN"
诊断工具：
bash
openclaw doctor # 健康检查
openclaw gateway logs # 查看日志
openclaw devices list # 设备管理
📊 性能优化
小内存 VPS 优化：
bash
cat >> ~/.bashrc <<'EOF'
export NODE_COMPILE_CACHE=/var/tmp/openclaw-compile-cache
mkdir -p /var/tmp/openclaw-compile-cache
export OPENCLAW_NO_RESPAWN=1
EOF
source ~/.bashrc
systemd 服务调优：
bash
sudo systemctl edit openclaw
添加：
ini
[Service]
Environment=OPENCLAW_NO_RESPAWN=1
Environment=NODE_COMPILE_CACHE=/var/tmp/openclaw-compile-cache
Restart=always
RestartSec=2
TimeoutStartSec=90
🔒 安全建议
1. 最小权限原则 - 不要以 root 用户运行
2. 认证配置 - 设置 gateway.auth.token 和 password
3. 沙箱隔离 - 启用 Docker 沙箱：export OPENCLAW_SANDBOX=1
4. 定期备份 - tar -czf backup.tar.gz ~/.openclaw/config ~/.openclaw/workspace
❓ 常见问题
Q: openclaw 命令找不到？
bash
export PATH="$(npm prefix -g)/bin:$PATH"
echo 'export PATH="$(npm prefix -g)/bin:$PATH"' >> ~/.bashrc
Q: Docker 构建内存不足？
bash
export OPENCLAW_IMAGE="ghcr.io/openclaw/openclaw:latest"
./docker-setup.sh
Q: 如何更新？
bash
openclaw update
或 Docker 方式
cd openclaw && git pull && ./docker-setup.sh
📚 参考资源
- 官方文档: https://docs.openclaw.ai
- GitHub 仓库: https://github.com/openclaw/openclaw
- Discord 社区: https://discord.com/invite/clawd
- 技能市场: https://clawhub.com
💡 下一步
部署完成后，你可以：
1. ✨ 在控制面板体验 AI 对话
2. 🔗 连接 WhatsApp/Telegram 等消息渠道
3. 🛠️ 安装自定义技能扩展功能
4. 🤖 配置多 Agent 协作
5. 📅 设置定时任务和提醒
有问题？ 欢迎在评论区留言讨论！👇
觉得有用？ 分享给更多朋友！🚀
最后更新：2026-03-09
本文基于 OpenClaw 官方文档整理
💬 评论 (0)