安装教程
系统要求
| 平台 | 要求 |
|---|---|
| Windows | Windows 10 64位 或更高版本 |
| macOS | macOS 12 (Monterey) 或更高版本（Intel 和 Apple Silicon） |
| 磁盘空间 | 至少 500 MB 可用空间 |
无需预装 Node.js 或任何其他依赖——所有运行环境已内置在安装包中。
Windows 安装
下载安装包
前往下载页面获取最新版 .exe 安装包（v0.2.0）。
安装步骤
- 双击运行
.exe安装包 - 如果 Windows Defender 弹出安全提示，点击「更多信息」→「仍要运行」
- 按照 5 步安装向导操作（见下方说明）
macOS 安装
下载安装包
前往下载页面获取最新版 .dmg 安装包（v0.2.0）。Intel 和 Apple Silicon 均支持同一安装包。
安装步骤
- 打开下载的
.dmg文件 - 将 GetClaw 拖入「应用程序」文件夹
- 首次打开时右键选择「打开」以通过 Gatekeeper 检查
- 在弹出的对话框中点击「打开」确认
5 步安装向导
安装程序启动后，会引导你完成以下步骤：
| 步骤 | 内容 | 说明 |
|---|---|---|
| 1. 欢迎 | 选择语言，确认系统要求 | 自动检测系统兼容性 |
| 2. 选目录 | 选择安装文件夹 | 自动检查磁盘空间，建议保留默认路径 |
| 3. 环境释放 | 自动解压全部组件 | Node.js / OpenClaw / OpenCode 进度条显示，约 1–3 分钟 |
| 4. 配置 AI | 选 AI 提供商，填 API Key，测试连通 | 可跳过，稍后在设置中配置 |
| 5. 完成 | 点击「启动 OpenClaw」 | 绿灯亮起表示运行成功 |
整个过程通常 2–5 分钟完成，无需任何命令行操作。
安装验证
安装完成后，运行面板应显示：
- 服务状态：绿灯（运行中）
- 已检测到安装目录
- 版本号正确显示（v0.2.0）
常见安装问题
Windows 安装包无法运行
- 右键安装包，选择「以管理员身份运行」
- 检查是否被防病毒软件拦截（将安装包加入白名单后重试）
- 确认系统版本为 Windows 10 64位 或更高
macOS 提示「无法验证开发者」
- 右键应用，选择「打开」
- 或前往「系统设置」→「隐私与安全性」，点击「仍要打开」
安装过程中卡住
- 等待进度条完成，环境释放步骤可能需要 2–3 分钟
- 如超过 10 分钟无响应，重新运行安装程序
安装后无法启动
- 检查是否被防病毒软件拦截
- 检查磁盘剩余空间是否充足（至少 500 MB）
- 尝试重新安装