@quantumclaw/quantumclaw 2026.3.22

package/docs/zh-CN/start/showcase.md

@@ -0,0 +1,423 @@
+---
+description: Real-world QuantumClaw projects from the community
+summary: 社区构建的基于 QuantumClaw 的项目和集成
+title: 案例展示
+x-i18n:
+  generated_at: "2026-02-03T10:11:36Z"
+  model: claude-opus-4-5
+  provider: pi
+  source_hash: b3460f6a7b9948799a6082fee90fa8e5ac1d43e34872aea51ba431813dcead7a
+  source_path: start/showcase.md
+  workflow: 15
+---
+
+# 案例展示
+
+来自社区的真实项目。看看大家正在用 QuantumClaw 构建什么。
+
+<Info>
+**想要展示你的项目？** 在 [Discord 的 #showcase 频道](https://discord.gg/clawd) 分享或在 [X 上 @quantumclaw](https://x.com/quantumclaw)。
+</Info>
+
+## 🎥 QuantumClaw 实战演示
+
+VelvetShark 的完整设置演练（28 分钟）。
+
+<div
+  style={{
+    position: "relative",
+    paddingBottom: "56.25%",
+    height: 0,
+    overflow: "hidden",
+    borderRadius: 16,
+  }}
+>
+  <iframe
+    src="https://www.youtube-nocookie.com/embed/SaWSPZoPX34"
+    title="QuantumClaw: The self-hosted AI that Siri should have been (Full setup)"
+    style={{ position: "absolute", top: 0, left: 0, width: "100%", height: "100%" }}
+    frameBorder="0"
+    loading="lazy"
+    allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share"
+    allowFullScreen
+  />
+</div>
+
+[在 YouTube 上观看](https://www.youtube.com/watch?v=SaWSPZoPX34)
+
+<div
+  style={{
+    position: "relative",
+    paddingBottom: "56.25%",
+    height: 0,
+    overflow: "hidden",
+    borderRadius: 16,
+  }}
+>
+  <iframe
+    src="https://www.youtube-nocookie.com/embed/mMSKQvlmFuQ"
+    title="QuantumClaw showcase video"
+    style={{ position: "absolute", top: 0, left: 0, width: "100%", height: "100%" }}
+    frameBorder="0"
+    loading="lazy"
+    allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share"
+    allowFullScreen
+  />
+</div>
+
+[在 YouTube 上观看](https://www.youtube.com/watch?v=mMSKQvlmFuQ)
+
+<div
+  style={{
+    position: "relative",
+    paddingBottom: "56.25%",
+    height: 0,
+    overflow: "hidden",
+    borderRadius: 16,
+  }}
+>
+  <iframe
+    src="https://www.youtube-nocookie.com/embed/5kkIJNUGFho"
+    title="QuantumClaw community showcase"
+    style={{ position: "absolute", top: 0, left: 0, width: "100%", height: "100%" }}
+    frameBorder="0"
+    loading="lazy"
+    allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share"
+    allowFullScreen
+  />
+</div>
+
+[在 YouTube 上观看](https://www.youtube.com/watch?v=5kkIJNUGFho)
+
+## 🆕 Discord 最新分享
+
+<CardGroup cols={2}>
+
+<Card title="PR 审查 → Telegram 反馈" icon="code-pull-request" href="https://x.com/i/status/2010878524543131691">
+  **@bangnokia** • `review` `github` `telegram`
+
+OpenCode 完成更改 → 打开 PR → QuantumClaw 审查差异并在 Telegram 中回复"小建议"加上明确的合并决定（包括需要先应用的关键修复）。
+
+  <img src="/assets/showcase/pr-review-telegram.jpg" alt="QuantumClaw PR review feedback delivered in Telegram" />
+</Card>
+
+<Card title="几分钟内创建酒窖 Skill" icon="wine-glass" href="https://x.com/i/status/2010916352454791216">
+  **@prades_maxime** • `skills` `local` `csv`
+
+向"Robby"（@quantumclaw）请求一个本地酒窖 skill。它请求一个示例 CSV 导出 + 存储位置，然后快速构建/测试该 skill（示例中有 962 瓶酒）。
+
+  <img src="/assets/showcase/wine-cellar-skill.jpg" alt="QuantumClaw building a local wine cellar skill from CSV" />
+</Card>
+
+<Card title="Tesco 购物自动驾驶" icon="cart-shopping" href="https://x.com/i/status/2009724862470689131">
+  **@marchattonhere** • `automation` `browser` `shopping`
+
+每周餐饮计划 → 常购商品 → 预订配送时段 → 确认订单。无需 API，仅使用浏览器控制。
+
+  <img src="/assets/showcase/tesco-shop.jpg" alt="Tesco shop automation via chat" />
+</Card>
+
+<Card title="SNAG 截图转 Markdown" icon="scissors" href="https://github.com/am-will/snag">
+  **@am-will** • `devtools` `screenshots` `markdown`
+
+快捷键选择屏幕区域 → Gemini 视觉 → 即时 Markdown 到剪贴板。
+
+  <img src="/assets/showcase/snag.png" alt="SNAG screenshot-to-markdown tool" />
+</Card>
+
+<Card title="Agents UI" icon="window-maximize" href="https://releaseflow.net/kitze/agents-ui">
+  **@kitze** • `ui` `skills` `sync`
+
+跨 Agents、Claude、Codex 和 QuantumClaw 管理 skills/命令的桌面应用。
+
+  <img src="/assets/showcase/agents-ui.jpg" alt="Agents UI app" />
+</Card>
+
+<Card title="Telegram 语音备忘录 (papla.media)" icon="microphone" href="https://papla.media/docs">
+  **社区** • `voice` `tts` `telegram`
+
+封装 papla.media TTS 并将结果作为 Telegram 语音备忘录发送（无烦人的自动播放）。
+
+  <img src="/assets/showcase/papla-tts.jpg" alt="Telegram voice note output from TTS" />
+</Card>
+
+<Card title="CodexMonitor" icon="eye" href="https://clawhub.com/odrobnik/codexmonitor">
+  **@odrobnik** • `devtools` `codex` `brew`
+
+Homebrew 安装的助手工具，用于列出/检查/监视本地 OpenAI Codex 会话（CLI + VS Code）。
+
+  <img src="/assets/showcase/codexmonitor.png" alt="CodexMonitor on ClawHub" />
+</Card>
+
+<Card title="Bambu 3D 打印机控制" icon="print" href="https://clawhub.com/tobiasbischoff/bambu-cli">
+  **@tobiasbischoff** • `hardware` `3d-printing` `skill`
+
+控制和排查 BambuLab 打印机：状态、任务、摄像头、AMS、校准等。
+
+  <img src="/assets/showcase/bambu-cli.png" alt="Bambu CLI skill on ClawHub" />
+</Card>
+
+<Card title="维也纳交通 (Wiener Linien)" icon="train" href="https://clawhub.com/hjanuschka/wienerlinien">
+  **@hjanuschka** • `travel` `transport` `skill`
+
+维也纳公共交通的实时发车时间、中断信息、电梯状态和路线规划。
+
+  <img src="/assets/showcase/wienerlinien.png" alt="Wiener Linien skill on ClawHub" />
+</Card>
+
+<Card title="ParentPay 学校餐食" icon="utensils" href="#">
+  **@George5562** • `automation` `browser` `parenting`
+
+通过 ParentPay 自动预订英国学校餐食。使用鼠标坐标实现可靠的表格单元格点击。
+</Card>
+
+<Card title="R2 上传 (Send Me My Files)" icon="cloud-arrow-up" href="https://clawhub.com/skills/r2-upload">
+  **@julianengel** • `files` `r2` `presigned-urls`
+
+上传到 Cloudflare R2/S3 并生成安全的预签名下载链接。非常适合远程 QuantumClaw 实例。
+</Card>
+
+<Card title="通过 Telegram 开发 iOS 应用" icon="mobile" href="#">
+  **@coard** • `ios` `xcode` `testflight`
+
+构建了一个完整的带有地图和语音录制功能的 iOS 应用，完全通过 Telegram 聊天部署到 TestFlight。
+
+  <img src="/assets/showcase/ios-testflight.jpg" alt="iOS app on TestFlight" />
+</Card>
+
+<Card title="Oura 戒指健康助手" icon="heart-pulse" href="#">
+  **@AS** • `health` `oura` `calendar`
+
+个人 AI 健康助手，将 Oura 戒指数据与日历、预约和健身房计划集成。
+
+  <img src="/assets/showcase/oura-health.png" alt="Oura ring health assistant" />
+</Card>
+<Card title="Kev 的梦之队 (14+ 智能体)" icon="robot" href="https://github.com/adam91holt/orchestrated-ai-articles">
+  **@adam91holt** • `multi-agent` `orchestration` `architecture` `manifesto`
+
+一个 Gateway 网关下的 14+ 智能体，Opus 4.5 编排器将任务委派给 Codex 工作者。全面的[技术文章](https://github.com/adam91holt/orchestrated-ai-articles)涵盖梦之队阵容、模型选择、沙箱隔离、webhook、心跳和委派流程。用于智能体沙箱隔离的 [Clawdspace](https://github.com/adam91holt/clawdspace)。[博客文章](https://adams-ai-journey.ghost.io/2026-the-year-of-the-orchestrator/)。
+</Card>
+
+<Card title="Linear CLI" icon="terminal" href="https://github.com/Finesssee/linear-cli">
+  **@NessZerra** • `devtools` `linear` `cli` `issues`
+
+与智能体工作流（Claude Code、QuantumClaw）集成的 Linear CLI。从终端管理问题、项目和工作流。首个外部 PR 已合并！
+</Card>
+
+<Card title="Beeper CLI" icon="message" href="https://github.com/blqke/beepcli">
+  **@jules** • `messaging` `beeper` `cli` `automation`
+
+通过 Beeper Desktop 读取、发送和归档消息。使用 Beeper 本地 MCP API，让智能体可以在一个地方管理你的所有聊天（iMessage、WhatsApp 等）。
+</Card>
+
+</CardGroup>
+
+## 🤖 自动化与工作流
+
+<CardGroup cols={2}>
+
+<Card title="Winix 空气净化器控制" icon="wind" href="https://x.com/antonplex/status/2010518442471006253">
+  **@antonplex** • `automation` `hardware` `air-quality`
+
+Claude Code 发现并确认了净化器控制，然后 QuantumClaw 接管来管理房间空气质量。
+
+  <img src="/assets/showcase/winix-air-purifier.jpg" alt="Winix air purifier control via QuantumClaw" />
+</Card>
+
+<Card title="美丽天空相机拍摄" icon="camera" href="https://x.com/signalgaining/status/2010523120604746151">
+  **@signalgaining** • `automation` `camera` `skill` `images`
+
+由屋顶摄像头触发：让 QuantumClaw 在天空看起来很美的时候拍一张照片——它设计了一个 skill 并拍摄了照片。
+
+  <img src="/assets/showcase/roof-camera-sky.jpg" alt="Roof camera sky snapshot captured by QuantumClaw" />
+</Card>
+
+<Card title="可视化晨间简报场景" icon="robot" href="https://x.com/buddyhadry/status/2010005331925954739">
+  **@buddyhadry** • `automation` `briefing` `images` `telegram`
+
+定时提示每天早上通过 QuantumClaw 角色生成一张"场景"图片（天气、任务、日期、喜欢的帖子/引言）。
+</Card>
+
+<Card title="板式网球场地预订" icon="calendar-check" href="https://github.com/joshp123/padel-cli">
+  **@joshp123** • `automation` `booking` `cli`
+  
+  Playtomic 可用性检查器 + 预订 CLI。再也不会错过空闲场地。
+  
+  <img src="/assets/showcase/padel-screenshot.jpg" alt="padel-cli screenshot" />
+</Card>
+
+<Card title="会计收件" icon="file-invoice-dollar">
+  **社区** • `automation` `email` `pdf`
+  
+  从邮件收集 PDF，为税务顾问准备文档。月度会计自动运行。
+</Card>
+
+<Card title="沙发土豆开发模式" icon="couch" href="https://davekiss.com">
+  **@davekiss** • `telegram` `website` `migration` `astro`
+
+一边看 Netflix 一边通过 Telegram 重建整个个人网站——Notion → Astro，迁移了 18 篇文章，DNS 转到 Cloudflare。从未打开笔记本电脑。
+</Card>
+
+<Card title="求职智能体" icon="briefcase">
+  **@attol8** • `automation` `api` `skill`
+
+搜索职位列表，与简历关键词匹配，返回带链接的相关机会。使用 JSearch API 在 30 分钟内构建。
+</Card>
+
+<Card title="Jira Skill 构建器" icon="diagram-project" href="https://x.com/jdrhyne/status/2008336434827002232">
+  **@jdrhyne** • `automation` `jira` `skill` `devtools`
+
+QuantumClaw 连接到 Jira，然后即时生成一个新的 skill（在它出现在 ClawHub 之前）。
+</Card>
+
+<Card title="通过 Telegram 创建 Todoist Skill" icon="list-check" href="https://x.com/iamsubhrajyoti/status/2009949389884920153">
+  **@iamsubhrajyoti** • `automation` `todoist` `skill` `telegram`
+
+自动化 Todoist 任务，并让 QuantumClaw 直接在 Telegram 聊天中生成 skill。
+</Card>
+
+<Card title="TradingView 分析" icon="chart-line">
+  **@bheem1798** • `finance` `browser` `automation`
+
+通过浏览器自动化登录 TradingView，截取图表屏幕截图，并按需执行技术分析。无需 API——只需浏览器控制。
+</Card>
+
+<Card title="Slack 自动支持" icon="slack">
+  **@henrymascot** • `slack` `automation` `support`
+
+监视公司 Slack 频道，提供有用的回复，并将通知转发到 Telegram。在没有被要求的情况下自主修复了已部署应用中的生产 bug。
+</Card>
+
+</CardGroup>
+
+## 🧠 知识与记忆
+
+<CardGroup cols={2}>
+
+<Card title="xuezh 中文学习" icon="language" href="https://github.com/joshp123/xuezh">
+  **@joshp123** • `learning` `voice` `skill`
+  
+  通过 QuantumClaw 实现带有发音反馈和学习流程的中文学习引擎。
+  
+  <img src="/assets/showcase/xuezh-pronunciation.jpeg" alt="xuezh pronunciation feedback" />
+</Card>
+
+<Card title="WhatsApp 记忆库" icon="vault">
+  **社区** • `memory` `transcription` `indexing`
+  
+  导入完整的 WhatsApp 导出，转录 1k+ 条语音备忘录，与 git 日志交叉检查，输出链接的 markdown 报告。
+</Card>
+
+<Card title="Karakeep 语义搜索" icon="magnifying-glass" href="https://github.com/jamesbrooksco/karakeep-semantic-search">
+  **@jamesbrooksco** • `search` `vector` `bookmarks`
+  
+  使用 Qdrant + OpenAI/Ollama embeddings 为 Karakeep 书签添加向量搜索。
+</Card>
+
+<Card title="Inside-Out-2 记忆" icon="brain">
+  **社区** • `memory` `beliefs` `self-model`
+  
+  独立的记忆管理器，将会话文件转化为记忆 → 信念 → 演化的自我模型。
+</Card>
+
+</CardGroup>
+
+## 🎙️ 语音与电话
+
+<CardGroup cols={2}>
+
+<Card title="Clawdia 电话桥接" icon="phone" href="https://github.com/alejandroOPI/clawdia-bridge">
+  **@alejandroOPI** • `voice` `vapi` `bridge`
+  
+  Vapi 语音助手 ↔ QuantumClaw HTTP 桥接。与你的智能体进行近实时电话通话。
+</Card>
+
+<Card title="OpenRouter 转录" icon="microphone" href="https://clawhub.com/obviyus/openrouter-transcribe">
+  **@obviyus** • `transcription` `multilingual` `skill`
+
+通过 OpenRouter（Gemini 等）进行多语言音频转录。可在 ClawHub 获取。
+</Card>
+
+</CardGroup>
+
+## 🏗️ 基础设施与部署
+
+<CardGroup cols={2}>
+
+<Card title="Home Assistant 插件" icon="home" href="https://github.com/ngutman/quantumclaw-ha-addon">
+  **@ngutman** • `homeassistant` `docker` `raspberry-pi`
+  
+  在 Home Assistant OS 上运行的 QuantumClaw Gateway 网关，支持 SSH 隧道和持久状态。
+</Card>
+
+<Card title="Home Assistant Skill" icon="toggle-on" href="https://clawhub.com/skills/homeassistant">
+  **ClawHub** • `homeassistant` `skill` `automation`
+  
+  通过自然语言控制和自动化 Home Assistant 设备。
+</Card>
+
+<Card title="Nix 打包" icon="snowflake" href="https://github.com/quantumclaw/nix-quantumclaw">
+  **@quantumclaw** • `nix` `packaging` `deployment`
+  
+  开箱即用的 nixified QuantumClaw 配置，用于可复现的部署。
+</Card>
+
+<Card title="CalDAV 日历" icon="calendar" href="https://clawhub.com/skills/caldav-calendar">
+  **ClawHub** • `calendar` `caldav` `skill`
+  
+  使用 khal/vdirsyncer 的日历 skill。自托管日历集成。
+</Card>
+
+</CardGroup>
+
+## 🏠 家居与硬件
+
+<CardGroup cols={2}>
+
+<Card title="GoHome 自动化" icon="house-signal" href="https://github.com/joshp123/gohome">
+  **@joshp123** • `home` `nix` `grafana`
+  
+  Nix 原生家庭自动化，以 QuantumClaw 作为界面，加上漂亮的 Grafana 仪表板。
+  
+  <img src="/assets/showcase/gohome-grafana.png" alt="GoHome Grafana dashboard" />
+</Card>
+
+<Card title="Roborock 扫地机器人" icon="robot" href="https://github.com/joshp123/gohome/tree/main/plugins/roborock">
+  **@joshp123** • `vacuum` `iot` `plugin`
+  
+  通过自然对话控制你的 Roborock 扫地机器人。
+  
+  <img src="/assets/showcase/roborock-screenshot.jpg" alt="Roborock status" />
+</Card>
+
+</CardGroup>
+
+## 🌟 社区项目
+
+<CardGroup cols={2}>
+
+<Card title="StarSwap 市场" icon="star" href="https://star-swap.com/">
+  **社区** • `marketplace` `astronomy` `webapp`
+  
+  完整的天文设备市场。围绕 QuantumClaw 生态系统构建。
+</Card>
+
+</CardGroup>
+
+---
+
+## 提交你的项目
+
+有想分享的东西？我们很乐意展示它！
+
+<Steps>
+  <Step title="分享它">
+    在 [Discord 的 #showcase 频道](https://discord.gg/clawd) 发布或在 [Twitter 上 @quantumclaw](https://x.com/quantumclaw)
+  </Step>
+  <Step title="包含详细信息">
+    告诉我们它做什么，链接到仓库/演示，如果有的话分享截图
+  </Step>
+  <Step title="获得展示">
+    我们会将优秀项目添加到此页面
+  </Step>
+</Steps>

package/docs/zh-CN/start/wizard-cli-automation.md

@@ -0,0 +1,222 @@
+---
+read_when:
+  - 你正在脚本或 CI 中自动化新手引导
+  - 你需要特定提供商的非交互式示例
+sidebarTitle: CLI automation
+summary: 用于 QuantumClaw CLI 的脚本化新手引导和智能体设置
+title: CLI 自动化
+x-i18n:
+  generated_at: "2026-03-16T06:28:19Z"
+  model: gpt-5.4
+  provider: openai
+  source_hash: 2a82c491616e8c1c2aa6ef5e19bde80b8cccd1e5f7684838b9ce704c33e41b0e
+  source_path: start/wizard-cli-automation.md
+  workflow: 15
+---
+
+# CLI 自动化
+
+使用 `--non-interactive` 自动化 `quantumclaw onboard`。
+
+<Note>
+`--json` 并不意味着非交互模式。对于脚本，请使用 `--non-interactive`（以及 `--workspace`）。
+</Note>
+
+## 基础非交互式示例
+
+```bash
+quantumclaw onboard --non-interactive \
+  --mode local \
+  --auth-choice apiKey \
+  --anthropic-api-key "$ANTHROPIC_API_KEY" \
+  --secret-input-mode plaintext \
+  --gateway-port 18789 \
+  --gateway-bind loopback \
+  --install-daemon \
+  --daemon-runtime node \
+  --skip-skills
+```
+
+添加 `--json` 可获得机器可读的摘要。
+
+使用 `--secret-input-mode ref` 可在认证配置文件中存储基于环境变量的引用，而不是明文值。
+在设置向导流程中，支持在环境变量引用与已配置的提供商引用（`file` 或 `exec`）之间进行交互式选择。
+
+在非交互式 `ref` 模式下，必须在进程环境中设置提供商环境变量。
+如果传入了内联密钥标志，但缺少匹配的环境变量，现在会快速失败。
+
+示例：
+
+```bash
+quantumclaw onboard --non-interactive \
+  --mode local \
+  --auth-choice openai-api-key \
+  --secret-input-mode ref \
+  --accept-risk
+```
+
+## 提供商专用示例
+
+<AccordionGroup>
+  <Accordion title="Gemini 示例">
+    ```bash
+    quantumclaw onboard --non-interactive \
+      --mode local \
+      --auth-choice gemini-api-key \
+      --gemini-api-key "$GEMINI_API_KEY" \
+      --gateway-port 18789 \
+      --gateway-bind loopback
+    ```
+  </Accordion>
+  <Accordion title="Z.AI 示例">
+    ```bash
+    quantumclaw onboard --non-interactive \
+      --mode local \
+      --auth-choice zai-api-key \
+      --zai-api-key "$ZAI_API_KEY" \
+      --gateway-port 18789 \
+      --gateway-bind loopback
+    ```
+  </Accordion>
+  <Accordion title="Vercel AI Gateway 示例">
+    ```bash
+    quantumclaw onboard --non-interactive \
+      --mode local \
+      --auth-choice ai-gateway-api-key \
+      --ai-gateway-api-key "$AI_GATEWAY_API_KEY" \
+      --gateway-port 18789 \
+      --gateway-bind loopback
+    ```
+  </Accordion>
+  <Accordion title="Cloudflare AI Gateway 示例">
+    ```bash
+    quantumclaw onboard --non-interactive \
+      --mode local \
+      --auth-choice cloudflare-ai-gateway-api-key \
+      --cloudflare-ai-gateway-account-id "your-account-id" \
+      --cloudflare-ai-gateway-gateway-id "your-gateway-id" \
+      --cloudflare-ai-gateway-api-key "$CLOUDFLARE_AI_GATEWAY_API_KEY" \
+      --gateway-port 18789 \
+      --gateway-bind loopback
+    ```
+  </Accordion>
+  <Accordion title="Moonshot 示例">
+    ```bash
+    quantumclaw onboard --non-interactive \
+      --mode local \
+      --auth-choice moonshot-api-key \
+      --moonshot-api-key "$MOONSHOT_API_KEY" \
+      --gateway-port 18789 \
+      --gateway-bind loopback
+    ```
+  </Accordion>
+  <Accordion title="Mistral 示例">
+    ```bash
+    quantumclaw onboard --non-interactive \
+      --mode local \
+      --auth-choice mistral-api-key \
+      --mistral-api-key "$MISTRAL_API_KEY" \
+      --gateway-port 18789 \
+      --gateway-bind loopback
+    ```
+  </Accordion>
+  <Accordion title="Synthetic 示例">
+    ```bash
+    quantumclaw onboard --non-interactive \
+      --mode local \
+      --auth-choice synthetic-api-key \
+      --synthetic-api-key "$SYNTHETIC_API_KEY" \
+      --gateway-port 18789 \
+      --gateway-bind loopback
+    ```
+  </Accordion>
+  <Accordion title="OpenCode 示例">
+    ```bash
+    quantumclaw onboard --non-interactive \
+      --mode local \
+      --auth-choice opencode-zen \
+      --opencode-zen-api-key "$OPENCODE_API_KEY" \
+      --gateway-port 18789 \
+      --gateway-bind loopback
+    ```
+    对 Go 目录，可改用 `--auth-choice opencode-go --opencode-go-api-key "$OPENCODE_API_KEY"`。
+  </Accordion>
+  <Accordion title="Ollama 示例">
+    ```bash
+    quantumclaw onboard --non-interactive \
+      --mode local \
+      --auth-choice ollama \
+      --custom-model-id "qwen3.5:27b" \
+      --accept-risk \
+      --gateway-port 18789 \
+      --gateway-bind loopback
+    ```
+  </Accordion>
+  <Accordion title="自定义提供商示例">
+    ```bash
+    quantumclaw onboard --non-interactive \
+      --mode local \
+      --auth-choice custom-api-key \
+      --custom-base-url "https://llm.example.com/v1" \
+      --custom-model-id "foo-large" \
+      --custom-api-key "$CUSTOM_API_KEY" \
+      --custom-provider-id "my-custom" \
+      --custom-compatibility anthropic \
+      --gateway-port 18789 \
+      --gateway-bind loopback
+    ```
+
+    `--custom-api-key` 是可选的。如果省略，新手引导会检查 `CUSTOM_API_KEY`。
+
+    `ref` 模式变体：
+
+    ```bash
+    export CUSTOM_API_KEY="your-key"
+    quantumclaw onboard --non-interactive \
+      --mode local \
+      --auth-choice custom-api-key \
+      --custom-base-url "https://llm.example.com/v1" \
+      --custom-model-id "foo-large" \
+      --secret-input-mode ref \
+      --custom-provider-id "my-custom" \
+      --custom-compatibility anthropic \
+      --gateway-port 18789 \
+      --gateway-bind loopback
+    ```
+
+    在此模式下，新手引导会将 `apiKey` 存储为 `{ source: "env", provider: "default", id: "CUSTOM_API_KEY" }`。
+
+  </Accordion>
+</AccordionGroup>
+
+## 添加另一个智能体
+
+使用 `quantumclaw agents add <name>` 创建一个单独的智能体，它拥有自己的工作区、
+会话和认证配置文件。不带 `--workspace` 运行会启动向导。
+
+```bash
+quantumclaw agents add work \
+  --workspace ~/.quantumclaw/workspace-work \
+  --model openai/gpt-5.2 \
+  --bind whatsapp:biz \
+  --non-interactive \
+  --json
+```
+
+它会设置：
+
+- `agents.list[].name`
+- `agents.list[].workspace`
+- `agents.list[].agentDir`
+
+说明：
+
+- 默认工作区遵循 `~/.quantumclaw/workspace-<agentId>`。
+- 添加 `bindings` 以路由入站消息（向导可以完成这项操作）。
+- 非交互式标志：`--model`、`--agent-dir`、`--bind`、`--non-interactive`。
+
+## 相关文档
+
+- 新手引导中心：[设置向导（CLI）](/start/wizard)
+- 完整参考：[CLI 设置参考](/start/wizard-cli-reference)
+- 命令参考：[`quantumclaw onboard`](/cli/onboard)