乐于分享
好东西不私藏

【全网最全】OpenClaw 全平台安装指南:从 Mac/Windows 到云端部署,一篇搞定!

【全网最全】OpenClaw 全平台安装指南:从 Mac/Windows 到云端部署,一篇搞定!

OpenClaw 全平台安装指南

从 Mac/Windows 到云端部署 · 一篇文章彻底搞定


📋 阅读指南

👤 本文适合谁看?

✅ 想用 AI 助手提升效率的职场人✅ 想搭建个人 AI 工作流的创作者✅ 在 Mac/Windows/Linux 之间纠结的用户✅ 考虑本地 vs 云端部署的技术玩家


🎯 什么是 OpenClaw?

OpenClaw(原 Clawdbot)是 2026 年最热门的开源 AI Agent 平台 

它能让你拥有 24 小时在线的智能助手

💬 多平台消息 Telegram / Discord / 微信 / 飞书

🛠️ 自动化任务 写代码 / 查资料 / 管理日程

🔗 工具链集成 GitHub / 浏览器 / 文件系统

🌐 永不离线 云端部署 / 随时响应

🌟 核心优势:一次配置,多端可用;本地隐私可控,云端随时在线


💻 系统要求一览

配置项
最低要求
推荐配置
生产环境
内存
2 GB
4 GB
8-16 GB
存储
10 GB SSD
20 GB SSD
50 GB+ SSD
系统
macOS 12+ / Windows 10+ / Linux
Node.js
v22.0.0+(推荐 v22 LTS)

⚠️ 低于 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
8GB
个人入门首选 ⭐
¥3,000+
Mac mini M3
16GB
多任务 / 专业开发
¥5,000+
MacBook Pro M3
16GB
移动办公 / 全能型
¥15,000+

🪟 方案二: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 硬件配置建议

配置等级
CPU
内存
适用场景
🟢 入门
i5-12400
16GB
轻度使用 / 尝鲜
🔵 推荐
i7-13700
32GB
开发 / 多 Agent 并行
🟣 高端
i9-13900K
64GB
24/7 生产环境

 ⚠️ 重要提示:Windows 原生安装目前兼容性问题较多,强烈建议使用 WSL2 方案 


🐧 方案三:Linux 服务器部署(云端 24/7)

🚀 适合场景:需要 AI 助手 24 小时在线 · 团队协作 · 远程访问 

☁️ 云服务器 VPS 推荐

服务商
配置
月费
特点
🇨🇳 腾讯云 Lighthouse
2核4G
¥50+
国内访问快 · 一键部署
🇩🇪 Hetzner
2核4G
€4.5
欧洲性价比之王 · 官方推荐 ⭐
🇺🇸 DigitalOcean
2核4G
$6
文档丰富 · 适合学习
🇨🇳 阿里云 ECS
2核4G
¥60+
生态完善 · 企业首选

🐳 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
¥3,000
⭐⭐⭐⭐
⭐⭐⭐⭐⭐
强烈推荐
Windows + WSL2
¥4,000+
⭐⭐⭐
⭐⭐⭐⭐
⭐⭐⭐
云 VPS
¥50/月
⭐⭐⭐⭐⭐
⭐⭐⭐
⭐⭐⭐⭐

🌐 场景二:24/7 在线服务

方案
年成本
维护难度
扩展性
推荐指数
Hetzner VPS
€54/年
⭐⭐
⭐⭐⭐⭐⭐
性价比之王
树莓派 5(8GB)
¥600
⭐⭐⭐
⭐⭐
⭐⭐⭐⭐
腾讯云轻量
¥600/年
⭐⭐
⭐⭐⭐⭐
⭐⭐⭐⭐

⚙️ 配置优化建议

1️⃣ API Key 管理

# 方式一:临时环境变量export ANTHROPIC_API_KEY=sk-xxxexport OPENAI_API_KEY=sk-xxx# 方式二:持久化配置(推荐)# 写入 ~/.openclaw/.env 文件

2️⃣ 消息平台接入指南

💬 Telegram
 创建 Bot → 获取 Token → 配置 webhook 
🎮 Discord
 创建应用 → 获取 Bot Token → 邀请进群 
📱 微信
 配置企业微信 / 公众号 API 
📋 飞书
 创建应用 → 获取 AppID/AppSecret 

3️⃣ 性能调优

# 限制内存使用(防止 OOM 崩溃)docker run -m 2g --memory-swap 2g openclaw/openclaw# 启用系统服务自动重启sudo systemctl enable openclawsudo systemctl start openclaw

❓ 常见问题排雷

问题现象
原因
解决方案
ip not in whitelist
服务器 IP 未添加到白名单
公众号后台添加服务器 IP
api unauthorized
AppSecret 错误或权限不足
检查密钥 / 确认公众号认证状态
command not found
Node.js 未安装或 PATH 未配置
重装 Node.js v22+
内存不足崩溃
RAM < 2GB 或并发过高
升级内存或限制并发数
Docker 启动失败
端口冲突或权限不足
检查 18789 端口 / 使用 sudo

🗺️ 选型决策树

🚀 开始部署 OpenClaw     │     ├─ 有 Mac?     │  ├─ ✅ 是 → Mac 本地安装     │  └─ 否 → 继续     │     ├─ 需要 24/7 在线?     │  ├─ ✅ 是 → Linux VPS / Docker     │  └─ 否 → 继续     │     ├─ 用 Windows?     │  ├─ ✅ 是 → WSL2 方案     │  └─ 否 → 继续     │     └─ ✅ Docker 通用方案


🎯 总结与选购建议

用户类型
推荐方案
预算参考
🌱 新手尝鲜
Mac 本地安装
¥3,000(设备)
💪 重度使用
Mac mini M3 16GB
¥5,000(设备)
🌐 随时在线
Hetzner VPS
€54/年(≈¥420)
👥 团队协作
xCloud Managed
$24/月(≈¥170)
🔧 极客玩家
自组 NAS + Docker
¥2,000+

💡 最后建议

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