下载 ClawStart 一键包

先选平台，再按快速开始跑通第一次安装。Windows 和 macOS 优先，Linux 当前主推荐路径是 Beta 安装脚本。

选择平台

先判断你属于哪条路径

🍎

macOS

适合想最快跑通的 Mac 用户。
支持 Apple Silicon 和 Intel，推荐 macOS 12 及以上。

macOS 一键包与说明 →
🪟

Windows

适合绝大多数小白用户。
支持 Windows 10 / 11，推荐 64 位系统。

Windows 一键包与说明 →
🐧

Linux

当前主推荐路径是 Linux Beta 安装脚本。
更适合熟悉终端、愿意自己排错的用户。

Linux Beta 路径 →
🧾

当前 Beta 下载统一在 GitHub Releases

如果你已经确定平台，可以直接下载对应 Beta 包。
推荐先看平台页，再回到这里拿到最合适的文件。

Windows

文件名：ClawStart-Windows-latest.zip

直接下载 Windows Beta →

macOS Apple Silicon

文件名：ClawStart-macOS-Apple-Silicon-latest.tar.gz

下载 Apple Silicon Beta →

macOS Intel

文件名：ClawStart-macOS-Intel-latest.tar.gz

下载 Intel Beta →
查看完整 Release 说明 →

下载后如果卡住，先按这个顺序分流

1. 先确认是不是下错平台

Windows 和 macOS 用户优先走一键包；Linux 用户优先走 Beta 安装脚本，不建议纯小白直接上手动 CLI 路径。

2. 启动失败先看权限和杀软

Windows 先看 SmartScreen，macOS 先看 Gatekeeper；别先删目录，先排权限。

3. 连接失败先看模型和网络

API Key、代理、证书、国内网络是高频问题，排障页里已经有对应规则。

按问题去排障 → 回到快速开始 →

系统要求

下载前先看这几项

系统 Windows 10/11、macOS 12+，Linux 当前主推荐路径为 Beta 安装脚本
内存 ≥ 4GB RAM
磁盘 ≥ 500MB 可用空间
网络 如果使用在线模型，需要能访问对应 API；国内用户优先选择国内模型提供商

下载后这样做

不要下载完就停住

Step 1

解压或打开安装包

Windows 推荐解压后双击 `launch.bat`，macOS 推荐右键打开 `launch.command`。

Step 2

按引导配置模型

选择模型服务商，填入 API Key，先确保能完成第一次连接。

Step 3

卡住就去排障

不要反复乱试，直接按排障页现象分类排查，效率更高。

查看快速开始 → 遇到问题？去排障 →

装好后先别急着折腾高级功能

先按快速开始跑通第一轮，再去教程页做第一件有成就感的事。

查看快速开始 → 查看教程 →