本指南提供在 macOS 系统上安装 OpenClaw 的完整详细步骤，每一步都包含具体的命令和预期结果。
- 安装前准备
- 安装必要软件
- 配置环境
- 安装 OpenClaw
- 配置 OpenClaw
- 启动服务
- 配置认证
- 验证安装
- 配置开机自启动
- 常见问题解决
在终端中执行：
预期结果：
要求：macOS 12.0 或更高版本
方法 1：使用聚焦搜索
- 按 打开聚焦搜索
- 输入”终端”
- 按 Enter 打开终端
方法 2：使用 Launchpad
- 点击 Dock 中的 Launchpad 图标
- 搜索”终端”
- 点击打开
预期结果：
如果是 ，建议升级到 zsh（macOS Catalina 及更高版本默认使用 zsh）
预期结果：
如果提示未安装：
会弹出安装窗口，点击”安装”并等待完成
官方安装方式（推荐） ：
安装过程：
- 按 Enter 继续
- 输入 macOS 密码（输入时不会显示字符）
- 等待安装完成（可能需要 5-10 分钟）
安装完成后：
预期结果：
如果官方安装卡住，使用国内镜像源：
验证安装：
预期结果：
验证配置：
预期结果：显示包含 user.name 和 user.email 的配置列表
验证安装：
预期结果：
要求：Node.js 16.0 或更高版本
验证配置：
预期结果：
验证配置：
预期结果：
预期结果：
编辑 文件：
在文件末尾添加以下内容：
保存并退出：
- 按
- 按
- 按
重新加载配置：
预期结果：显示所有可用版本的列表
方法 A：使用 npm 安装（推荐）
预期结果：
方法 B：如果方法 A 失败，使用 legacy peer deps
方法 C：如果 npm 安装失败，使用 pnpm
预期结果：
如果提示找不到命令：
永久添加到 PATH：
向导会询问以下问题：
问题 1：Gateway 运行位置
- 输入：
- 按 Enter
问题 2：认证方式
- 输入：（推荐）或
- 按 Enter
问题 3：工作区路径
- 直接按 Enter 使用默认值（）
问题 4：端口配置
- 直接按 Enter 使用默认值（）
预期结果：
预期内容：
验证目录创建：
预期结果：
预期结果：
预期结果：
预期结果：显示实时日志输出
按 停止查看日志（不会停止服务）
预期结果：显示最近 50 行日志
预期结果：
浏览器会自动打开，执行以下操作：
- 登录你的 Anthropic 账户（Claude Pro/Max）
- 授权 OpenClaw 访问
- 复制显示的 值
在终端中粘贴并验证：
预期结果：
预期结果：
备选方案：使用 API Key
如果你有 Anthropic API Key：
预期结果：
预期结果：
预期结果：
预期结果：
创建 ：
添加以下内容：
保存并退出：
- 按
- 按
- 按
赋予执行权限：
创建 ：
添加以下内容：
注意：将 替换为你的实际用户名
保存并退出：
- 按
- 按
- 按
预期结果：
- 重启 Mac
- 打开终端
- 执行：
预期结果：显示服务正在运行
症状：Homebrew 安装过程中长时间无响应
解决方案：
症状：
解决方案：
症状：
解决方案：
症状：
解决方案：
症状：
解决方案：
症状：
解决方案：
症状：
解决方案：
症状：
解决方案：
在完成所有步骤后，确认以下项目：
| openclaw skills 教程 快捷键 | 功能 |
|——–|——|
| | 复制选中的文本 |
| | 粘贴文本 |
| | 清屏（清除历史记录） |
| | 中断当前运行的命令 |
| | 清屏（保留历史记录） |
| | 移动到行首 |
| | 移动到行尾 |
| | 删除到行首 |
| | 删除到行尾 |
| / | 浏览历史命令 |
| | 自动补全命令或文件名 |
- OpenClaw 官方文档: docs.openclaw.ai
- OpenClaw GitHub: github.com/openclaw/op…
- 问题反馈: github.com/openclaw/op…
- 新手引导: docs.openclaw.ai/zh-CN/start…
- Homebrew 官方网站: brew.sh/zh-cn/
- Homebrew 中科大镜像: mirrors.ustc.edu.cn/brew.git
- Node.js 官方网站: nodejs.org/
- Git 官方网站: git-scm.com/
- OpenClaw 配置:
- npm 缓存:
- npm 日志:
- Launch Agent 日志:
编辑 ：
添加以下内容：
重新加载配置：
编辑 ：
添加以下内容：
重新加载配置：
创建 ：
添加以下内容：
赋予执行权限：
使用：
发布者：Ai探索者，转载请注明出处：https://javaforall.net/285526.html原文链接：https://javaforall.net
