NOTE // 24

🍺 Homebrew —— macOS/Linux 的「软件应用商店」（命令行版）

🔍 一句话定义

Homebrew（简称 brew）是 macOS 和 Linux 上最流行的开源包管理器，用一行命令即可安装/更新/卸载开发工具、系统库、命令行软件（如 Git、Python、FFmpeg 等），无需手动编译或处理依赖。

💡 为什么您会遇到它？

场景	原因
之前 openclaw.ai 安装脚本提示 "Installing Homebrew..."	该脚本试图用 Homebrew 安装游戏引擎依赖（与 Clawdbot 无关）
macOS 开发环境常见需求	安装 Node.js、Python、FFmpeg 等工具时，Homebrew 是最便捷方式
Clawdbot 官方安装不需要 Homebrew	但若系统缺少基础编译工具（如 make），Homebrew 可快速补全

🌟 核心特点

特性	说明
用户级安装	默认装在 /opt/homebrew (Apple Silicon) 或 /usr/local (Intel)，无需 sudo
依赖自动解析	安装 A 时自动装好 B、C 依赖
沙箱安全	所有软件隔离安装，卸载干净无残留
开源透明	所有安装脚本（Formulae）公开在 GitHub
跨平台	macOS + Linux（WSL 也支持）

🚀 常用命令速查

# 安装 Homebrew（官方唯一安全命令）
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 安装软件（示例）
brew install git node python ffmpeg  # 开发常用
brew install --cask visual-studio-code telegram  # GUI 应用（--cask）

# 管理软件
brew update          # 更新软件源
brew upgrade         # 升级所有已安装软件
brew uninstall node  # 卸载
brew list            # 查看已安装列表
brew doctor          # 诊断环境问题（强烈推荐！）

🔒 与您之前问题的关联

您遇到的问题	Homebrew 的角色
npm EACCES 权限错误	Homebrew 安装的 Node.js 自带用户权限，可彻底避免此问题
Xcode license 错误	brew install 会自动触发 Xcode 命令行工具安装（含 license 接受）
openclaw.ai 脚本卡在 Homebrew	该脚本试图用 Homebrew 装游戏依赖（非 Clawdbot 所需）

✅ 关键结论：

Clawdbot 安装不需要 Homebrew（直接 git clone + npm install 即可）

但若您常做开发，强烈建议安装 Homebrew —— 它是 macOS 开发环境的“基石工具”

安装后运行 brew doctor 可自动修复环境问题（包括 npm 权限隐患）

⚠️ 安全提醒

只运行官方安装命令（见上文），拒绝不明脚本中的 curl | bash
首次安装需输入密码（仅用于创建 /opt/homebrew 目录），后续操作无需 sudo
安装后自动配置 PATH，终端重启后生效

💡 行动建议

# 如果您需要（推荐开发用户）：
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
brew doctor  # 检查环境

# 如果只为安装 Clawdbot（无需 Homebrew）：
cd ~/AI/clawdbot && npm install  # 直接继续之前正确流程

🌐 官网：https://brew.sh （有中文说明）
📚 公式仓库：https://formulae.brew.sh

记住：Homebrew 是工具，不是目的。您的目标是 Clawdbot —— 装好 Homebrew 后，仍请回到 Clawdbot 官方安装流程。