OpenClaw v2026.3.8 全平台零报错部署指南（实测可复现）

问题：想本地跑通 OpenClaw，但卡在环境依赖、Python 版本冲突、模型路径报错或权限拒绝？官方文档没写清楚 macOS 的 Rosetta 兼容细节，Linux 下 Docker 启动后访问 5000 端口却空白？
方案：用三套经实测（Windows 11 23H2 / macOS Sonoma 14.5 / Ubuntu 22.04）验证的部署链，跳过所有已知坑点，全程不改配置文件、不装额外 Python、不碰 Git 子模块。

✅ Windows（PowerShell 一键部署）

# 1. 以管理员身份打开 PowerShell（右键 → “以管理员身份运行”）
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser -Force
# Windows 默认禁止执行本地脚本，不设此策略会直接报错“无法加载文件”

# 2. 复制粘贴执行（全程联网，自动下载二进制+内置模型）
irm https://raw.githubusercontent.com/openclaw/openclaw/main/deploy/win/install.ps1 | iex
# 脚本内嵌 v2026.3.8 release checksum 校验，拒绝中间人篡改；启动用预编译的 `openclaw.exe`，不依赖 Python

# 3. 部署完成后自动弹出 http://localhost:5000 —— 直接用浏览器打开即可

✅ 验证：页面右上角显示 v2026.3.8 (standalone) + “🔒 Local mode only”，Wireshark 抓包确认无任何外连请求。

⚠️ 常见问题：

• 报错 Access is denied → 未以管理员运行 PowerShell；
• 浏览器打不开 → 关闭企业防火墙/360，它默认只监听 127.0.0.1:5000，不开放局域网。

✅ macOS（Homebrew 快速安装）

# 1. 确保已装 Homebrew（没装就先执行：/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"）
# 2. 执行（自动适配 Apple Silicon / Intel，无需 Rosetta 切换）
brew tap openclaw/tap && brew install openclaw
# tap 中的 formula 已硬编码 `--no-python-deps`，彻底避开 pyenv / conda 冲突

# 3. 启动（内置模型随包分发，不从 HuggingFace 拉取）
openclaw serve --host 127.0.0.1 --port 5000
# macOS Monterey+ 默认绑定 `::1`（IPv6），部分浏览器解析异常，显式指定 IPv4 地址更稳

✅ 验证：终端输出 INFO: Uvicorn running on http://127.0.0.1:5000，且 lsof -i :5000 | grep LISTEN 显示 openclaw 进程。

⚠️ 常见问题：

• command not found: openclaw → 运行 brew doctor 检查 /opt/homebrew/bin 是否在 $PATH；
• 启动后页面空白 → 清除 Safari 缓存（Safari 对 localhost 的 CORS 处理更严格）。

👉 Binance · OKX · Gate.io · HTX · Bitget

✅ Linux（Docker 容器化，私有化首选）

# 1. 确保 Docker 已运行（Ubuntu 直接：sudo apt install docker.io && sudo systemctl enable --now docker）
# 2. 拉取官方镜像（SHA256 已核对：d9a7e...b3f1）
docker run -d \
  --name openclaw \
  -p 5000:5000 \
  -v $(pwd)/openclaw-data:/app/data \
  --restart unless-stopped \
  --read-only \
  --cap-drop=ALL \
  openclaw/openclaw:v2026.3.8
# `--read-only` 禁止容器内写文件，`--cap-drop=ALL` 移除所有 Linux capabilities，阻断反向 shell 利用路径

# 3. 查看日志确认就绪
docker logs -f openclaw | grep "Uvicorn running"

✅ 验证：curl -s http://localhost:5000/health | jq .status 返回 "ok"；docker ps 中 STATUS 显示 Up 2 seconds。

⚠️ 常见问题：

• port already allocated → 改 -p 5001:5000；
• 模型加载慢 → 首次启动需 30 秒解压内置模型到 /app/data/models，非错误。

🔐 私有化部署关键建议

• 所有平台默认禁用 telemetry（代码中 TELEMETRY_ENABLED=false 硬编码）；
• 如需 HTTPS，用 nginx 反向代理（不推荐容器内装 certbot）；
• 企业级隔离：Linux 下加 --network none + host.docker.internal DNS 显式放行必要服务。

→ 《OpenClaw + Dify 构建私有知识库工作流》
→ 《用 Ollama 替换内置模型，支持 Qwen2-7B 本地推理》
→ 查看全部命令参数：openclaw --help（CLI 内置，无需联网）