
OpenClaw 全平台安装指南
从 Mac/Windows 到云端部署 · 一篇文章彻底搞定
📋 阅读指南
👤 本文适合谁看?
✅ 想用 AI 助手提升效率的职场人✅ 想搭建个人 AI 工作流的创作者✅ 在 Mac/Windows/Linux 之间纠结的用户✅ 考虑本地 vs 云端部署的技术玩家
🎯 什么是 OpenClaw?
OpenClaw(原 Clawdbot)是 2026 年最热门的开源 AI Agent 平台
它能让你拥有 24 小时在线的智能助手:
💬 多平台消息 Telegram / Discord / 微信 / 飞书 | 🛠️ 自动化任务 写代码 / 查资料 / 管理日程 | 🔗 工具链集成 GitHub / 浏览器 / 文件系统 | 🌐 永不离线 云端部署 / 随时响应 |
🌟 核心优势:一次配置,多端可用;本地隐私可控,云端随时在线
💻 系统要求一览
| 内存 | |||
| 存储 | |||
| 系统 | |||
| Node.js |
⚠️ 低于 2GB:UI 可能崩溃✅ 4GB:日常使用流畅🚀 8GB+:24/7 稳定运行
🍎 方案一:Mac 本地安装(新手首选)
💡 推荐理由:最友好的入门平台 · 开发环境开箱即用 · 生态最完善
步骤 1:安装 Node.js
# 使用 Homebrew 安装(macOS 最佳实践)brew install node@22# 验证版本(需显示 v22.x.x)node -v步骤 2:一键安装 OpenClaw
curl -fsSL https://openclaw.ai/install.sh | bash✅ 安装器会自动完成:检测平台 · 安装依赖 · 配置环境变量 · 设置快捷方式
步骤 3:验证安装
openclaw status[OK] Node.js v22.11.0 (minimum: v22.0.0) [OK] OpenClaw v2026.2.6 [OK] Configuration file found at ~/.openclaw/.env [OK] Anthropic API key valid 🖥️ Mac 硬件推荐
| Mac mini M2 | |||
| Mac mini M3 | |||
| MacBook Pro M3 |
🪟 方案二:Windows 安装(WSL2 方案)
💡 方案说明:Windows 原生安装问题较多,WSL2(Windows Subsystem for Linux)是更稳定的选择
步骤 1:启用 WSL2
# 管理员权限 PowerShell 运行wsl --install# 重启后安装 Ubuntuwsl --install-d Ubuntu-22.04步骤 2:在 WSL2 中安装 OpenClaw
# 进入 WSL2 Ubuntu 环境wsl# 安装 Node.jscurl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -sudo apt-get install -y nodejs# 一键安装 OpenClawcurl -fsSL https://openclaw.ai/install.sh | bash🖥️ Windows 硬件配置建议
⚠️ 重要提示:Windows 原生安装目前兼容性问题较多,强烈建议使用 WSL2 方案
🐧 方案三:Linux 服务器部署(云端 24/7)
🚀 适合场景:需要 AI 助手 24 小时在线 · 团队协作 · 远程访问
☁️ 云服务器 VPS 推荐
| 🇨🇳 腾讯云 Lighthouse | |||
| 🇩🇪 Hetzner | |||
| 🇺🇸 DigitalOcean | |||
| 🇨🇳 阿里云 ECS |
🐳 Docker 一键部署(推荐方案)
# 安装 Dockercurl -fsSL https://get.docker.com | sh# 拉取 OpenClaw 官方镜像docker pull openclaw/openclaw:latest# 运行容器docker run -d \ --name openclaw \ -p 18789:18789 \ -v ~/.openclaw:/root/.openclaw \ openclaw/openclaw:latest✅ Docker 三大优势: 环境隔离,不影响主机 · 一键启停,方便管理 · 跨平台一致,迁移方便
🐳 方案四:Docker 本地部署(跨平台通用)
Docker 是最灵活的方案,Mac / Windows / Linux 通用。
Docker Compose 配置示例
version:'3.8'services:openclaw:image:openclaw/openclaw:latestcontainer_name:openclawrestart:unless-stoppedports:-"18789:18789"volumes:-./data:/root/.openclawenvironment:-ANTHROPIC_API_KEY=${ANTHROPIC_API_KEY}-TELEGRAM_BOT_TOKEN=${TELEGRAM_BOT_TOKEN}启动命令:
docker-compose up -d📊 硬件方案深度对比
🏠 场景一:个人日常使用
| Mac mini M2 | 强烈推荐 | |||
🌐 场景二:24/7 在线服务
| Hetzner VPS | 性价比之王 | |||
⚙️ 配置优化建议
1️⃣ API Key 管理
# 方式一:临时环境变量export ANTHROPIC_API_KEY=sk-xxxexport OPENAI_API_KEY=sk-xxx# 方式二:持久化配置(推荐)# 写入 ~/.openclaw/.env 文件2️⃣ 消息平台接入指南
| 💬 Telegram | 🎮 Discord | 📱 微信 | 📋 飞书 |
3️⃣ 性能调优
# 限制内存使用(防止 OOM 崩溃)docker run -m 2g --memory-swap 2g openclaw/openclaw# 启用系统服务自动重启sudo systemctl enable openclawsudo systemctl start openclaw❓ 常见问题排雷
ip not in whitelist | ||
api unauthorized | ||
command not found | ||
🗺️ 选型决策树
🚀 开始部署 OpenClaw │ ├─ 有 Mac? │ ├─ ✅ 是 → Mac 本地安装 │ └─ 否 → 继续 │ ├─ 需要 24/7 在线? │ ├─ ✅ 是 → Linux VPS / Docker │ └─ 否 → 继续 │ ├─ 用 Windows? │ ├─ ✅ 是 → WSL2 方案 │ └─ 否 → 继续 │ └─ ✅ Docker 通用方案
🎯 总结与选购建议
💡 最后建议
1️⃣ 先本地跑通 — 用 Mac 或 WSL2 熟悉操作,再考虑上云2️⃣ 渐进式升级 — 确认真实需求后再迁移到 VPS,避免资源浪费3️⃣ API 成本别忽略 — Claude/GPT 调用按量计费,高频使用成本会累积4️⃣ 安全第一 — 生产环境务必配置防火墙、定期备份、启用自动更新
📚 延伸阅读
📖 OpenClaw 官方文档[1] 🔧 Node.js 安装指南[2] 🐳 Docker 部署教程[3] 💬 OpenClaw 社区 Discord[4]
本文首发于公众号「上海尖括号网络科技有限公司」转载请注明出处 · 更新日期:2026年3月27日
👇 觉得有用?分享给需要的朋友
引用链接
[1]OpenClaw 官方文档: https://docs.openclaw.ai
[2]Node.js 安装指南: https://docs.openclaw.ai/install/node
[3]Docker 部署教程: https://docs.openclaw.ai/install/docker
[4]OpenClaw 社区 Discord: https://discord.gg/clawd
夜雨聆风