推荐用官方一键脚本安装openclaw，5分钟内完成，需满足macos 12+、apple silicon/intel i5+、内存≥8gb、磁盘≥10gb、已装xcode命令行工具，并关闭第三方安全软件。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
Mac 上安装 OpenClaw（“小龙虾”）推荐用官方一键脚本，5 分钟内完成，无需手动装依赖、不用懂 Node.js 版本差异，连终端命令都可直接复制粘贴。关键点在于：系统要达标、网络要通畅、权限要给足，三者缺一不可。
系统与环境准备
确保你的 Mac 满足以下硬性条件：
- macOS 12 Monterey 或更高版本（强烈推荐 macOS 14 Sonoma / 15 Sequoia）
- 芯片支持 Apple Silicon（M1/M2/M3/M4）或 Intel i5 及以上
- 内存 ≥8GB（16GB 更稳，尤其开启多技能或视觉理解时）
- 空闲磁盘空间 ≥10GB
- 已安装 Xcode Command Line Tools（终端执行 xcode-select --install，弹窗点「安装」即可）
⚠️ 安装前请关闭火绒、360、Windows Defender（即使 Mac 上也建议关掉第三方安全软件），否则可能拦截 OpenClaw 的系统调用行为。
一键安装（最简方式，新手首选）
打开终端（Command + 空格 → 输入「终端」→ 回车），依次执行以下三条命令：
- 运行官方安装脚本：curl -fsSL https://openclaw.ai/install.sh | bash
- 若国内访问慢，换用加速镜像：curl -fsSL https://open-claw.org.cn/install-cn.sh | bash
- 加载新环境变量：source ~/.zshrc（Mac 默认使用 zsh）
整个过程约 2–4 分钟，会自动检测系统、安装 Node.js v22.10+、下载 OpenClaw、配置 PATH。完成后输入 openclaw --version，显示类似 2026.3.31 即表示成功。
自动备份 OpenClaw 整体配置到远程存储（支持任意 rclone 后端：COS、S3、FTP、SFTP、WebDAV等）。 触发场景： - 创建/配置自动备份任务 - 设置备份周期、保留份数、目标目录 - 手动触发备份 - 查看/恢复备份 - OpenClaw 运行异常时的提醒
初始化与启动
安装完别急着用，必须先完成初始配置：
- 运行 openclaw onboard 启动向导
- 接受风险提示（选 Yes）
- 选择启动模式：QuickStart（适合大多数用户）
- 选择 AI 模型供应商（如 OpenAI、Claude、Ollama 或国内百炼/0011.ai）并填入对应 API Key
- 是否接入通讯工具？本地试用可跳过；如需 Telegram/飞书远程控制，此时勾选并按提示授权
配置完毕后，执行 openclaw gateway start 启动服务。浏览器打开 http://localhost:18789，就能看到 Web 控制台——UI 清晰、操作直观，所有技能、记忆、日志一目了然。
常见问题与避坑提醒
遇到报错别慌，多数卡点集中在以下几个地方：
- “command not found: openclaw” → 没执行 source ~/.zshrc，或安装中途被中断，重装前先运行 npm uninstall -g openclaw
- 启动后打不开网页 / 显示连接被拒绝 → 检查端口 18789 是否被占用，或防火墙是否拦截，临时关闭 macOS 防火墙测试
- 模型调用失败（如 API key error） → 确认所选模型服务商是否开通、Token 是否充足、代理配置是否正确（如用 0011.ai，需在 ~/.openclaw/config.json 中补全 proxy 字段）
- 无法读取备忘录 / 日历 / 文件 → 去「系统设置 → 隐私与安全性 → 自动化」中，为 Terminal 或 OpenClaw 授予完整磁盘访问权限
部署完成只是开始，OpenClaw 的真正价值在于后续的技能扩展和长期记忆训练。它不是一次装好就完事的工具，而是一个持续进化的本地 AI 执行体。
