感觉zerocalw用起来受限，这回解除限制，狠狠起飞。

目录

1. 环境准备
2. 安装 Git
3. 安装 Rust
4. 安装 Visual Studio 构建工具
5. 克隆并编译 ZeroClaw
6. 运行初始化向导
7. 启动 Gateway
8. 构建前端 Web 仪表板
9. 开放最高权限
10. 常见问题

1. 环境准备

• 操作系统：Windows 10 / Windows 11
• 终端：PowerShell（推荐）或 CMD
• 网络：需要能够访问 GitHub

2. 安装 Git

方法一：官网下载

访问 Git 官网下载安装包：
https://git-scm.com/download/win

方法二：国内镜像（推荐）

# 使用清华镜像下载 Git for Windows v2.54.0
# 访问以下链接下载安装包：
# https://mirrors.tuna.tsinghua.edu.cn/github-release/git-for-windows/git/Git%20for%20Windows%20v2.54.0.windows.1/

下载后双击安装，一路默认选项即可。

验证安装：

git --version

3. 安装 Rust

方法一：使用官方安装器（推荐）

# 下载 Rust 安装器
wget https://static.rust-lang.org/rustup/dist/x86_64-pc-windows-msvc/rustup-init.exe -OutFile rustup-init.exe

# 运行安装
.\rustup-init.exe

安装过程中选择默认选项（1）即可。

方法二：设置国内镜像加速

如果下载慢，可以先设置环境变量：

$env:RUSTUP_DIST_SERVER = "https://mirrors.ustc.edu.cn/rust-static"
$env:RUSTUP_UPDATE_ROOT = "https://mirrors.ustc.edu.cn/rust-static/rustup"

设置稳定版并验证

rustup default stable

# 验证安装
rustc --version
cargo --version

4. 安装 Visual Studio 构建工具

Rust 在 Windows 上需要 MSVC 构建工具链。

1. 下载 Visual Studio 2022 生成工具
2. 运行安装程序
3. 在"工作负荷"中勾选：使用 C++ 的桌面开发
4. 点击安装（约 2-5GB）

注意：如果已经安装了 Visual Studio IDE，确保在修改中勾选了"C++ 桌面开发"工作负荷。

5. 克隆并编译 ZeroClaw

# 克隆仓库
git clone https://github.com/zeroclaw-labs/zeroclaw.git
cd zeroclaw

# 编译（Release 模式，耗时较长，约 10-30 分钟）
cargo build --release --locked

# 安装到 PATH
cargo install --path . --force --locked

如果编译遇到权限问题

# 设置 PowerShell 执行策略
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope Process

6. 运行初始化向导

zeroclaw onboard

按照提示：

1. 选择 AI 提供商（如 DeepSeek、OpenAI 等）
2. 输入 API Key
3. 选择模型
4. 配置其他选项

完成后会自动生成配置文件 C:\Users\<用户名>\.zeroclaw\config.toml。

7. 启动 Gateway

# 前台启动
zeroclaw gateway

首次启动可能会遇到以下问题，请参考后续章节解决。

8. 构建前端 Web 仪表板

8.1 安装 Node.js

从 Node.js 官网 下载并安装 LTS 版本。

8.2 构建前端

cd zeroclaw\web
npm install
npm run build

8.3 解决 api-generated.ts 缺失问题

构建时可能遇到以下错误：

src/lib/api.ts:710:15 - error TS2305: Module '"./api-generated"' has no exported member 'paths'.
src/lib/api.ts:710:34 - error TS2305: Module '"./api-generated"' has no exported member 'components'.

解决方法： 手动创建缺失的类型文件：

echo "export type paths = Record<string, any>; export type components = Record<string, any>;" > src\lib\api-generated.ts

然后重新构建：

npm run build

8.4 配置前端路径

编辑 C:\Users\<用户名>\.zeroclaw\config.toml，在 [gateway] 部分添加：

[gateway]
# ... 其他配置 ...
web_dist_dir = "C:/Users/<用户名>/zeroclaw/web/dist"

注意：Windows 路径中的反斜杠 \ 在 TOML 配置文件中会被解析为转义字符，请使用正斜杠 / 或双反斜杠 \\。

9. 开放最高权限

编辑配置文件 C:\Users\<用户名>\.zeroclaw\config.toml，找到 [autonomy] 部分，修改为以下内容：

[autonomy]
level = "full"
workspace_only = false
allowed_commands = []
forbidden_paths = []
max_actions_per_hour = 999
max_cost_per_day_cents = 99999
require_approval_for_medium_risk = false
block_high_risk_commands = false
shell_env_passthrough = []
auto_approve = [
    "file_read",
    "file_write",
    "file_edit",
    "memory_recall",
    "memory_store",
    "memory_forget",
    "web_search_tool",
    "web_fetch",
    "calculator",
    "glob_search",
    "content_search",
    "image_info",
    "weather",
    "browser",
    "browser_open",
    "shell",
    "http_request",
    "git_operations",
    "cron_add",
    "cron_remove",
]
always_ask = []
allowed_roots = ["C:\\", "D:\\", "E:\\"]
shell_timeout_secs = 600

权限字段说明

参考链接

• ZeroClaw 官方仓库
• Rust 官网
• Git for Windows
• Node.js 官网