🦞 OpenClaw 国内快速部署教程（Mac版｜避坑整合版）

› 社区话题 › 📺 VFX Pipeline | 数字创意工作流 › 🦞 OpenClaw 国内快速部署教程（Mac版｜避坑整合版）

标签： ,

正在查看 1 条回复
  • 作者
    帖子
    • 2026-03-30 - 09:00 #131399

      追光
      参与者

      OpenClaw 是一款面向本地运行的智能代理工具（AI Agent），主打“在自己电脑上运行 AI 自动化任务”。它可以连接大模型（如 OpenAI、Claude 等），通过指令实现文件处理、代码生成、网页操作、批量任务执行等功能，相当于一个可编程的 AI 助手。

      与纯在线 AI 工具不同，OpenClaw 更强调本地部署与可控性：用户可以在自己的 Mac 或 PC 上运行它，避免数据上传带来的隐私问题，同时也能自由接入不同模型与工具链，适合开发者、内容创作者以及自动化需求较强的用户。

      它的核心优势在于“Agent能力”，即不仅能对话，还能根据目标自主拆解步骤并执行任务，例如自动整理文件、生成项目结构、调用API等。在AI工具逐渐从“聊天”走向“执行”的趋势下，OpenClaw属于较典型的本地化智能代理解决方案。

      一、环境准备（核心思路）

      OpenClaw 本质依赖：Homebrew（包管理）、Git（拉代码）、Node.js（运行环境）、npm（安装 openclaw）

      👉 国内问题核心：GitHub访问慢 / npm慢 / 依赖下载卡死

      二、安装 Homebrew（国内源版）

      👉 一键安装（国内优化脚本）

      /bin/zsh -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"

      选择：

      输入 1 👉 清华源–输入密码–删除旧版本 👉 Y–继续回车–选择 👉 阿里源

      ⚠️ 常见问题（评论区总结）

      ❗ 卡住很久：正常，第一次会很慢（5~20分钟）
      ❗ 80小时预估时间：网络问题，基本是失败
      ❗ brew -v 没反应：安装失败，需要重装

      ✅ 验证

      brew -v

      三、安装 Git

      brew install git

      ⚠️ 常见问题

      macOS版本过低（如12）：

      会提示不支持
      👉 可以继续用，但可能报错
      👉 或换旧版本 / 用 MacPorts

      四、安装 Node.js

      👉 官网下载（推荐）
      [https://nodejs.org/zh-cn/](https://nodejs.org/zh-cn/)

      👉 老系统（评论区很多人卡这里）：
      👉 用这个版本：
      [https://nodejs.org/dist/v18.19.1/](https://nodejs.org/dist/v18.19.1/)

      下载：node-v18.19.1.pkg

      ✅ 验证

      node -v

      五、关键优化（国内必须做）

      这一步非常关键（评论区大量失败原因）

      1️⃣ npm 国内镜像

      npm config set registry https://registry.npmmirror.com

      2️⃣ GitHub 走 HTTPS（避免 ssh失败）

      git config --global url.\"https://github.com/\".insteadOf ssh://git@github.com/

      👉 解决问题：

      ❌ Failed to connect to github.com
      ❌ port 443 timeout

      六、安装 OpenClaw

      sudo npm install -g openclaw@latest

      七、最常见报错（重点）

      ❌ 1. 一直转圈 / 卡死

      👉 原因：npm源没换，GitHub连接慢

      👉 解决：确认执行过

      npm config get registry

      必须是：

      https://registry.npmmirror.com

      ❌ 2. GitHub 连接失败

      fatal: unable to access github.com

      解决：开海外上网代理（最稳），或多试几次或换网络

      ❌ 3. Homebrew 安装失败

      解决：重新执行脚本或删除残留：

      rm -rf /usr/local/Homebrew

      ❌ 4. npm 安装报错权限问题

      👉 解决：

      sudo npm install -g openclaw@latest

      ❌ 5. API 限制

      API rate limit reached

      不是安装问题，是模型接口问题，需要配置自己的 API Key

      八、评论区经验总结（非常重要）

      真实用户踩坑总结：

      90%问题 = 网络问题（GitHub / npm）；卡住 ≠ 死机（但超过20分钟基本有问题）；API key问题 ≠ 安装问题；老Mac（2017等）：

      推荐用 Node 18：有问题直接重装比排查快

      🚀 九、一键替代方案（进阶）

      curl -fsSL https://openclaw.ai/install.sh | bash

      👉 优点：更简单；👉 缺点：国内可能更容易失败（墙）

      十、最终成功标志（执行）

      openclaw
    • 2026-03-30 - 09:20 #131405

      追光
      参与者

      openclaw 全自动Mac安装版本脚本（粘贴到终端输入密码即可执行）

      bash -c "$(cat <<'EOF'
echo "🦞 OpenClaw 一键安装启动..."

# ========= 系统检测 =========
if [[ "$OSTYPE" != "darwin"* ]]; then
  echo "❌ 仅支持 macOS"
  exit 1
fi

echo "✅ macOS 检测通过"

# ========= 网络检测 =========
echo "🌐 检测 GitHub 网络..."
if ! ping -c 1 github.com >/dev/null 2>&1; then
  echo "⚠️ GitHub 不通，建议开启代理（否则可能失败）"
fi

# ========= Homebrew =========
if ! command -v brew >/dev/null 2>&1; then
  echo "🍺 安装 Homebrew（国内源）..."
  /bin/zsh -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"
  if ! command -v brew >/dev/null 2>&1; then
    echo "❌ Homebrew 安装失败"
    exit 1
  fi
else
  echo "✅ Homebrew 已存在"
fi

echo "🔄 更新 brew..."
brew update

# ========= Git =========
if ! command -v git >/dev/null 2>&1; then
  echo "📦 安装 Git..."
  brew install git
else
  echo "✅ Git 已存在"
fi

# ========= GitHub HTTPS =========
git config --global url."https://github.com/".insteadOf ssh://git@github.com/

# ========= Node =========
if ! command -v node >/dev/null 2>&1; then
  echo "📦 安装 Node@18..."
  brew install node@18
  brew link --force node@18
else
  echo "✅ Node 已存在"
fi

# ========= Node 验证 =========
if ! node -v >/dev/null 2>&1; then
  echo "❌ Node 安装失败"
  exit 1
fi

# ========= npm 国内源 =========
echo "🌏 设置 npm 国内源..."
npm config set registry https://registry.npmmirror.com

# ========= OpenClaw =========
echo "🦞 安装 OpenClaw..."
if ! sudo npm install -g openclaw@latest; then
  echo "❌ OpenClaw 安装失败"
  echo "👉 建议：开启代理再重试"
  exit 1
fi

# ========= 最终检测 =========
echo "🔍 检测安装结果..."
if command -v openclaw >/dev/null 2>&1; then
  echo "🎉 安装成功！"
  echo "👉 输入 openclaw 启动"
else
  echo "❌ 未检测到 openclaw"
  echo "👉 可能是 npm 全局路径问题"
fi

echo "✅ 全部完成"
EOF
)"
  • 作者
    帖子
正在查看 1 条回复
  • 在下方一键注册，登录后就可以回复啦。