5 步成功路径
把第一次成功体验压缩到一页先跑通 install、provider、doctor、单次调用，再决定是否进入 JSON、RPC 或桌面包装。
控制
快速开始快速开始
只保留安装、provider 配置、`pi doctor` 和第一次成功调用。
macOS
首个成功结果
install.sh
当前公开状态
v0.1.13当前公开发布线
安装路径
macOSpi / maoclaw
推荐首批命令
当前适合先展示的表面CLI 是第一入口；JSON、RPC、SDK 与 macOS 桌面包装作为逐层展开的正式表面。
5 步成功路径
把第一次成功体验压缩到一页
- 先通过 `miounet11/maoclaw` 的安装脚本完成安装。
- 确认 `pi --version` 与 `maoclaw --version` 都可正常运行。
- 先配置一个 provider key，再执行 `pi doctor`。
- 进入本地仓库后运行 `pi`，或直接用 `pi -p` 完成第一次单次调用。
- 如果需要结构化自动化或外部接入，再进入 `pi --mode json` 或 `pi --mode rpc`。
- 第一次跑通后，用 `pi --continue` 进入持续工作流。
推荐首批命令
当前适合先展示的表面
这是最快感知 `maoclaw` 终端主路径价值的入口。
pi "请总结这个仓库的结构、核心模块和最重要的入口文件"适合把同一套运行时接入脚本、流水线和自动化包装层。
pi --mode json -p "请返回这个仓库的结构化摘要"直接展示 `maoclaw` 不只是聊天壳，而是可接入的运行时。
pi --mode rpc能快速确认当前环境是否已经具备可运行基础。
pi --list-providers && pi --list-models安装路径
当前公开安装与打包入口已经对齐到 maoclaw
保留安装器交互，适合先看迁移提示与环境检查再继续。
curl -fsSL "https://raw.githubusercontent.com/miounet11/maoclaw/main/install.sh?$(date +%s)" | bash最快把当前公开版本装到本机并写入 PATH。
curl -fsSL "https://raw.githubusercontent.com/miounet11/maoclaw/main/install.sh?$(date +%s)" | bash -s -- --yes --easy-mode团队或演示环境建议固定到 v0.1.13。
curl -fsSL "https://raw.githubusercontent.com/miounet11/maoclaw/main/install.sh?$(date +%s)" | bash -s -- --version v0.1.13 --yes --easy-mode适合贡献、内网、自定义补丁或手动验证发布构建。
git clone https://github.com/miounet11/maoclaw.git
cd maoclaw
cargo build --release
./target/release/pi --version
./target/release/maoclaw --version适合 macOS 演示、桌面分发与品牌化 app/pkg 打包。
cargo build --release --bin pi_desktop --features desktop-iced
bash scripts/build_macos_app.sh --install
bash scripts/build_macos_pkg.sh当前公开状态
先说明 v0.1.13 当前已经公开了什么
- GitHub 仓库:
miounet11/maoclaw - 当前公开版本:
v0.1.13 - 兼容命令 / 品牌命令:
pi/maoclaw - 发布形态: 当前公开发布线
- 当前公开仓库是 `miounet11/maoclaw`。
- 当前公开基线是 v0.1.13，兼容命令仍保留 `pi`，品牌命令是 `maoclaw`。
- 当前对外已明确覆盖 CLI、Print / JSON、基础 RPC、Rust SDK、会话系统、7 个内置工具，以及 macOS 桌面包装。
- GitHub Releases、校验和与多平台分发验证仍在持续补齐，因此公开安装主路径仍以 install.sh 为准。
- 如果目标是先跑通一次成功体验，优先使用安装脚本，再根据需要进入源码构建或桌面包装。