🦞 OpenClaw 国内快速部署教程(Mac版|避坑整合版)

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

标签: ,

  • 该话题包含 2 个回复、1 个参与人,并且最后由 追光27 分 前 更新。
正在查看 2 条回复
  • 作者
    帖子
    • #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

      OpenClaw 部署到Mac中的完整命令以及OpenClaw卸载命令

    • #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
      )"
    • #131410

      追光
      参与者

      完整、干净的 OpenClaw 卸载命令(Terminal 一键版),会同时删除:全局 npm 安装,本地配置(~/.openclaw),缓存与残留。

      🦞 OpenClaw 完整卸载(Mac / Linux)

      直接复制整段执行:

      
      echo "🧹 开始卸载 OpenClaw..."
      
      # ========= 1. 卸载全局 npm 包 =========
      if command -v openclaw >/dev/null 2>&1; then
      echo "📦 卸载 openclaw..."
      sudo npm uninstall -g openclaw
      else
      echo "⚠️ 未检测到 openclaw(可能已卸载)"
      fi
      
      # ========= 2. 删除用户配置 =========
      if [ -d "$HOME/.openclaw" ]; then
      echo "🗑 删除 ~/.openclaw 配置目录..."
      rm -rf "$HOME/.openclaw"
      else
      echo "⚠️ 未找到 ~/.openclaw"
      fi
      
      # ========= 3. 清理 npm 缓存 =========
      echo "🧽 清理 npm 缓存..."
      npm cache clean --force
      
      # ========= 4. 清理 PATH 残留 =========
      echo "🔍 检查残留..."
      which openclaw && echo "⚠️ 仍存在残留,请检查 PATH" || echo "✅ 已无残留"
      
      echo "🎉 OpenClaw 已彻底卸载完成"
      

      🔍 可选(更彻底清理)

      如果你想极限干净(开发环境),可以再执行:

      bash
      删除 npm 全局缓存目录(可选)

      rm -rf ~/.npm

      删除 nodemodules 全局目录(谨慎)

      rm -rf $(npm root -g)

      ⚠️ 注意:
      这一步会影响你所有全局 npm 包,不只是 OpenClaw

      🎯 卸载成功判断

      运行:

      openclaw

      如果显示:command not found,👉 说明已经彻底卸载 ✅。

正在查看 2 条回复
  • 在下方一键注册,登录后就可以回复啦。