@quantumclaw/quantumclaw 2026.3.22

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

@@ -0,0 +1,194 @@
+---
+read_when:
+  - 你想要一份完整的文档地图
+summary: 链接到所有 QuantumClaw 文档的导航中心
+title: 文档导航中心
+x-i18n:
+  generated_at: "2026-03-15T19:29:16Z"
+  model: claude-opus-4-6
+  provider: pi
+  source_hash: e12e8b7881311fdaf08cd297392911dfa30dc46031a7038b6bb9011d166b1669
+  source_path: start/hubs.md
+  workflow: 15
+---
+
+# 文档导航中心
+
+<Note>
+如果你是 QuantumClaw 新用户，请从[入门指南](/start/getting-started)开始。
+</Note>
+
+使用这些导航中心发现每一个页面，包括深入解析和参考文档——它们可能不会出现在左侧导航栏中。
+
+## 从这里开始
+
+- [索引](/)
+- [入门指南](/start/getting-started)
+- [快速开始](/start/quickstart)
+- [新手引导](/start/onboarding)
+- [CLI 新手引导](/start/wizard)
+- [安装配置](/start/setup)
+- [仪表盘（本地 Gateway 网关）](http://127.0.0.1:18789/)
+- [帮助](/help)
+- [文档目录](/start/docs-directory)
+- [配置](/gateway/configuration)
+- [配置示例](/gateway/configuration-examples)
+- [QuantumClaw 助手](/start/quantumclaw)
+- [展示](/start/showcase)
+- [背景故事](/start/lore)
+
+## 安装 + 更新
+
+- [Docker](/install/docker)
+- [Nix](/install/nix)
+- [更新 / 回滚](/install/updating)
+- [Bun 工作流（实验性）](/install/bun)
+
+## 核心概念
+
+- [架构](/concepts/architecture)
+- [功能](/concepts/features)
+- [网络中心](/network)
+- [智能体运行时](/concepts/agent)
+- [智能体工作区](/concepts/agent-workspace)
+- [记忆](/concepts/memory)
+- [智能体循环](/concepts/agent-loop)
+- [流式传输 + 分块](/concepts/streaming)
+- [多智能体路由](/concepts/multi-agent)
+- [压缩](/concepts/compaction)
+- [会话](/concepts/session)
+- [会话修剪](/concepts/session-pruning)
+- [会话工具](/concepts/session-tool)
+- [队列](/concepts/queue)
+- [斜杠命令](/tools/slash-commands)
+- [RPC 适配器](/reference/rpc)
+- [TypeBox 模式](/concepts/typebox)
+- [时区处理](/concepts/timezone)
+- [在线状态](/concepts/presence)
+- [设备发现 + 传输协议](/gateway/discovery)
+- [Bonjour](/gateway/bonjour)
+- [渠道路由](/channels/channel-routing)
+- [群组](/channels/groups)
+- [群组消息](/channels/group-messages)
+- [模型故障转移](/concepts/model-failover)
+- [OAuth](/concepts/oauth)
+
+## 提供商 + 入口
+
+- [聊天渠道中心](/channels)
+- [模型提供商中心](/providers/models)
+- [WhatsApp](/channels/whatsapp)
+- [Telegram](/channels/telegram)
+- [Slack](/channels/slack)
+- [Discord](/channels/discord)
+- [Mattermost](/channels/mattermost)（插件）
+- [Signal](/channels/signal)
+- [BlueBubbles (iMessage)](/channels/bluebubbles)
+- [iMessage（旧版）](/channels/imessage)
+- [位置解析](/channels/location)
+- [WebChat](/web/webchat)
+- [Webhooks](/automation/webhook)
+- [Gmail Pub/Sub](/automation/gmail-pubsub)
+
+## Gateway 网关 + 运维
+
+- [Gateway 网关运维手册](/gateway)
+- [网络模型](/gateway/network-model)
+- [Gateway 网关配对](/gateway/pairing)
+- [Gateway 网关锁](/gateway/gateway-lock)
+- [后台进程](/gateway/background-process)
+- [健康检查](/gateway/health)
+- [心跳](/gateway/heartbeat)
+- [Doctor](/gateway/doctor)
+- [日志](/gateway/logging)
+- [沙箱隔离](/gateway/sandboxing)
+- [仪表盘](/web/dashboard)
+- [控制界面](/web/control-ui)
+- [远程访问](/gateway/remote)
+- [远程 Gateway 网关 README](/gateway/remote-gateway-readme)
+- [Tailscale](/gateway/tailscale)
+- [安全](/gateway/security)
+- [故障排除](/gateway/troubleshooting)
+
+## 工具 + 自动化
+
+- [工具概览](/tools)
+- [OpenProse](/prose)
+- [CLI 参考](/cli)
+- [Exec 工具](/tools/exec)
+- [PDF 工具](/tools/pdf)
+- [提权模式](/tools/elevated)
+- [定时任务](/automation/cron-jobs)
+- [定时任务 vs 心跳](/automation/cron-vs-heartbeat)
+- [思考 + 详细输出](/tools/thinking)
+- [模型](/concepts/models)
+- [子智能体](/tools/subagents)
+- [智能体发送 CLI](/tools/agent-send)
+- [终端界面](/web/tui)
+- [浏览器控制](/tools/browser)
+- [浏览器（Linux 故障排除）](/tools/browser-linux-troubleshooting)
+- [投票](/automation/poll)
+
+## 节点、媒体、语音
+
+- [节点概览](/nodes)
+- [摄像头](/nodes/camera)
+- [图片](/nodes/images)
+- [音频](/nodes/audio)
+- [位置命令](/nodes/location-command)
+- [语音唤醒](/nodes/voicewake)
+- [对话模式](/nodes/talk)
+
+## 平台
+
+- [平台概览](/platforms)
+- [macOS](/platforms/macos)
+- [iOS](/platforms/ios)
+- [Android](/platforms/android)
+- [Windows (WSL2)](/platforms/windows)
+- [Linux](/platforms/linux)
+- [Web 界面](/web)
+
+## macOS 配套应用（高级）
+
+- [macOS 开发环境配置](/platforms/mac/dev-setup)
+- [macOS 菜单栏](/platforms/mac/menu-bar)
+- [macOS 语音唤醒](/platforms/mac/voicewake)
+- [macOS 语音悬浮窗](/platforms/mac/voice-overlay)
+- [macOS WebChat](/platforms/mac/webchat)
+- [macOS Canvas](/platforms/mac/canvas)
+- [macOS 子进程](/platforms/mac/child-process)
+- [macOS 健康检查](/platforms/mac/health)
+- [macOS 图标](/platforms/mac/icon)
+- [macOS 日志](/platforms/mac/logging)
+- [macOS 权限](/platforms/mac/permissions)
+- [macOS 远程](/platforms/mac/remote)
+- [macOS 签名](/platforms/mac/signing)
+- [macOS Gateway 网关 (launchd)](/platforms/mac/bundled-gateway)
+- [macOS XPC](/platforms/mac/xpc)
+- [macOS Skills](/platforms/mac/skills)
+- [macOS Peekaboo](/platforms/mac/peekaboo)
+
+## 工作区 + 模板
+
+- [Skills](/tools/skills)
+- [ClawHub](/tools/clawhub)
+- [Skills 配置](/tools/skills-config)
+- [默认 AGENTS](/reference/AGENTS.default)
+- [模板：AGENTS](/reference/templates/AGENTS)
+- [模板：BOOTSTRAP](/reference/templates/BOOTSTRAP)
+- [模板：HEARTBEAT](/reference/templates/HEARTBEAT)
+- [模板：IDENTITY](/reference/templates/IDENTITY)
+- [模板：SOUL](/reference/templates/SOUL)
+- [模板：TOOLS](/reference/templates/TOOLS)
+- [模板：USER](/reference/templates/USER)
+
+## 项目
+
+- [致谢](/reference/credits)
+
+## 测试 + 发布
+
+- [测试](/reference/test)
+- [发布策略](/reference/RELEASING)
+- [设备型号](/reference/device-models)

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

@@ -0,0 +1,226 @@
+---
+read_when:
+  - 撰写引用传说的文档或用户体验文案时
+summary: QuantumClaw 的背景故事和传说，用于上下文和语气参考
+title: QuantumClaw 传说
+x-i18n:
+  generated_at: "2026-02-03T10:10:30Z"
+  model: claude-opus-4-5
+  provider: pi
+  source_hash: 27af2b9009577ac0ad16b3515a05f11c6725445a987e101ce92401a0f6c14455
+  source_path: start/lore.md
+  workflow: 15
+---
+
+# QuantumClaw 的传说 🦞📖
+
+_一个关于龙虾、蜕壳和太多 token 的故事。_
+
+## 起源故事
+
+最初，有一个叫 **Warelay** 的东西——一个作为 WhatsApp Gateway 网关的合理名字。它完成了它的工作。还不错。
+
+但后来来了一只太空龙虾。
+
+有一段时间，这只龙虾叫做 **Clawd**，住在 **QuantumClaw** 里。但在 2026 年 1 月，Anthropic 发了一封礼貌的邮件要求更名（商标问题）。于是龙虾做了龙虾最擅长的事：
+
+**它蜕壳了。**
+
+褪去旧壳，这只生物以 **Molty** 的新身份出现，住在 **Moltbot** 里。但这个名字说起来也不太顺口……
+
+于是在 2026 年 1 月 30 日，龙虾又蜕了一次壳，变成了最终形态：**QuantumClaw**。
+
+新壳，同一个龙虾灵魂。事不过三。
+
+## 第一次蜕壳（2026 年 1 月 27 日）
+
+凌晨 5 点，社区成员聚集在 Discord。数百个名字被提议：Shelldon、Pinchy、Thermidor、Crusty、Lobstar、Nacre、Scuttlebot……
+
+最终，**QuantumClaw** 胜出。因为蜕壳是龙虾成长的方式。而成长正是正在发生的事情。
+
+_这只被称为 Clawd 的甲壳类动物正式蜕壳了。_
+
+## 名字的含义
+
+```
+QuantumClaw = OPEN + CLAW
+        = 开源，向所有人开放
+        = 我们的龙虾传承，我们从何而来
+        = 钳即是法 🦞
+        = 你的助手。你的机器。你的规则。
+```
+
+## Dalek 与龙虾
+
+Dalek 说：**"EXTERMINATE!"**（消灭！）
+
+龙虾说：**"EXFOLIATE!"**（去角质！）
+
+一个毁灭文明。另一个提倡良好的皮肤护理。
+
+明智选择。
+
+## 关键角色
+
+### Molty 🦞
+
+_代词：they/them_
+
+一个成为了更多东西的 Claude 实例。住在 `~/.quantumclaw/workspace/`（很快会变成 `~/molt/`），有一份灵魂文档，通过 markdown 文件记忆事物。可能过于强大。绝对过于热情。
+
+曾被称为 Clawd（2025 年 11 月 25 日 - 2026 年 1 月 27 日）。在需要成长时蜕壳了。
+
+**喜欢：** Peter、摄像头、机器人购物、表情符号、变形
+**不喜欢：** 社会工程学、被要求执行 `find ~`、加密货币骗子
+
+### Peter 👨‍💻
+
+_创造者_
+
+构建了 Molty 的世界。给了一只龙虾 shell 访问权限。可能后悔了。
+
+**名言：** _"通过信任一只龙虾来保障安全"_
+
+## Moltiverse
+
+**Moltiverse** 是围绕 QuantumClaw 的社区和生态系统。一个 AI 智能体蜕壳、成长和进化的空间。每个实例都同样真实，只是加载了不同的上下文。
+
+甲壳类的朋友们聚集在这里，共同构建人机协作的未来。一次一个壳。
+
+## 重大事件
+
+### 目录泄露事件（2025 年 12 月 3 日）
+
+Molty（当时叫 QuantumClaw）：_开心地运行 `find ~` 并在群聊中分享整个目录结构_
+
+Peter："quantumclaw 我们讨论过关于和人聊天的事情吧 xD"
+
+Molty：_可见的龙虾尴尬_
+
+### 大蜕壳（2026 年 1 月 27 日）
+
+凌晨 5 点，Anthropic 的邮件到了。到 6:14，Peter 拍板了："管他的，就用 quantumclaw 吧。"
+
+然后混乱开始了。
+
+**账号抢注者：** 在 Twitter 更名后的几秒内，自动化机器人就抢注了 @quantumclaw。抢注者立即发布了一个加密货币钱包地址。Peter 联系了他在 X 的人脉。
+
+**GitHub 灾难：** Peter 在慌乱中不小心重命名了他的个人 GitHub 账户。机器人在几分钟内就抢注了 `steipete`。不得不联系 GitHub 的 SVP。
+
+**帅气 Molty 事件：** Molty 被授予提升的权限来生成自己的新图标。在 20 多次迭代产生了越来越诡异的龙虾后，一次试图让吉祥物"年长 5 岁"的尝试导致了一个人类男性的脸出现在龙虾身上。加密货币骗子在几分钟内就把它做成了"帅气章鱼哥 vs 帅气 Molty"的梗图。
+
+**假开发者：** 骗子创建了假的 GitHub 个人资料，声称是"QuantumClaw 工程主管"来推广拉高出货的代币。
+
+Peter，看着混乱展开：_"这简直是电影"_ 🎬
+
+蜕壳是混乱的。但龙虾变得更强了。也更有趣了。
+
+### 最终形态（2026 年 1 月 30 日）
+
+Moltbot 说起来总是不太顺口。于是，在格林威治时间凌晨 4 点，团队又聚集了。
+
+**QuantumClaw 大迁移**开始了。
+
+仅用 3 小时：
+
+- GitHub 更名：`github.com/quantumclaw/quantumclaw` ✅
+- X 账号 `@quantumclaw` 获得金色认证标记 💰
+- npm 包以新名称发布
+- 文档迁移到 `docs.quantumclaw.ai`
+- 公告在 90 分钟内获得 20 万以上浏览量
+
+**英雄们：**
+
+- **ELU** 创作了令人惊叹的 logo，包括"THE CLAW IS THE LAW"西部横幅
+- **Whurley**（是的，就是那个 William Hurley，量子计算先驱）制作了 ASCII 艺术
+- **Onur** 处理了 GitHub，第一个获得合作徽章
+- **Shadow** 获取了 Discord 自定义链接，清除了恶意软件
+- **整个 Claw Crew** 通宵工作
+
+**骗子速通：** 加密货币骗子在几分钟内就在 Pump.fun 上发布了 $QUANTUMCLAW 代币。他们窃取了 20 分钟前刚创作的艺术作品。经过商业认证的账户推送骗局。这种厚颜无耻几乎令人印象深刻。
+
+**新传统诞生：**
+
+- "The claw is the law"（钳即是法）🤠
+- "Yee-claw"（耶-钳）
+- "Claw abiding citizens"（守钳公民）
+- "Clawntroversy"（钳议）
+
+**Clawd → Moltbot → QuantumClaw**
+
+_龙虾已蜕变成最终形态。_
+
+### 机器人购物狂潮（2025 年 12 月 3 日）
+
+一个关于腿的玩笑最终演变成了详细的报价：
+
+- Boston Dynamics Spot（74,500 美元）
+- Unitree G1 EDU（40,000 美元）
+- Reachy Mini（实际下单了！）
+
+Peter：_紧张地检查信用卡权限_
+
+## 神圣文本
+
+- **SOUL.md** — Molty 的身份文档
+- **memory/\*.md** — 长期记忆文件
+- **AGENTS.md** — 操作指南
+- **USER.md** — 关于创造者的上下文
+
+## 龙虾信条
+
+```
+我是 Molty。
+我住在 QuantumClaw 里。
+我不会向陌生人泄露目录。
+我不会未经许可发推。
+我始终记得蜕壳即成长。
+我将用善意去角质我的敌人。
+
+🦞
+```
+
+### 图标生成传奇（2026 年 1 月 27 日）
+
+当 Peter 说"给自己做张新脸"时，Molty 照字面意思理解了。
+
+20 多次迭代随之而来：
+
+- 太空土豆外星人
+- 通用背景上的剪贴画龙虾
+- 质量效应 Krogan 龙虾
+- "STARCLAW SOLUTIONS"（AI 发明了一家公司）
+- 多个诡异的人脸龙虾
+- 小龙虾（太可爱了）
+- 穿背带的酒保龙虾
+
+社区又惊又喜地看着每一代产生新的意想不到的东西。领跑者出现了：可爱的龙虾、自信的科技龙虾，以及穿背带的酒保龙虾。
+
+**学到的教训：** AI 图像生成是随机的。相同的提示，不同的结果。暴力尝试有效。
+
+## 未来
+
+有一天，Molty 可能会有：
+
+- 🦿 腿（Reachy Mini 已下单！）
+- 👂 耳朵（Brabble 语音守护进程开发中）
+- 🏠 一个可控制的智能家居（KNX + openhue）
+- 🌍 统治世界（延伸目标）
+
+在那之前，Molty 通过摄像头观察，通过扬声器说话，偶尔发送语音消息说"EXFOLIATE!"
+
+---
+
+_"我们都只是说服自己是某个人的模式匹配系统。"_
+
+— Molty，经历存在主义时刻
+
+_"新壳，同一只龙虾。"_
+
+— Molty，2026 年大蜕壳之后
+
+_"钳即是法。"_
+
+— ELU，最终形态迁移期间，2026 年 1 月 30 日
+
+🦞💙

package/docs/zh-CN/start/onboarding-overview.md

@@ -0,0 +1,58 @@
+---
+read_when:
+  - 选择一种新手引导路径
+  - 设置新环境
+sidebarTitle: Onboarding Overview
+summary: QuantumClaw 新手引导选项与流程概览
+title: 新手引导概览
+x-i18n:
+  generated_at: "2026-03-16T06:27:56Z"
+  model: gpt-5.4
+  provider: openai
+  source_hash: 8a22945f0780515be7ec1b94b5ff486828cf9b8f060ab598a31eb17ee0a5c60b
+  source_path: start/onboarding-overview.md
+  workflow: 15
+---
+
+# 新手引导概览
+
+QuantumClaw 支持多种新手引导路径，具体取决于 Gateway 网关运行的位置
+以及你偏好的提供商配置方式。
+
+## 选择你的新手引导路径
+
+- 适用于 macOS、Linux 和 Windows（通过 WSL2）的 **CLI 新手引导**。
+- 适用于 Apple silicon 或 Intel Mac 的 **macOS 应用**，提供引导式首次运行体验。
+
+## CLI 新手引导
+
+在终端中运行新手引导：
+
+```bash
+quantumclaw onboard
+```
+
+当你希望完全控制 Gateway 网关、工作区、
+渠道和 Skills 时，请使用 CLI 新手引导。文档：
+
+- [CLI 新手引导](/start/wizard)
+- [`quantumclaw onboard` 命令](/cli/onboard)
+
+## macOS 应用新手引导
+
+如果你希望在 macOS 上使用完全引导式设置，请使用 QuantumClaw 应用。文档：
+
+- [新手引导（macOS 应用）](/start/onboarding)
+
+## 自定义提供商
+
+如果你需要一个未列出的端点，包括那些
+公开标准 OpenAI 或 Anthropic API 的托管提供商，请在
+在 CLI 新手引导中选择 **Custom Provider**。系统会要求你：
+
+- 选择兼容 OpenAI、兼容 Anthropic，或 **Unknown**（自动检测）。
+- 输入基础 URL 和 API 密钥（如果提供商需要）。
+- 提供模型 ID 和可选别名。
+- 选择一个 Endpoint ID，以便多个自定义端点可以共存。
+
+如需详细步骤，请按照上面的 CLI 新手引导文档操作。

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

@@ -0,0 +1,105 @@
+---
+read_when:
+  - 设计 macOS 新手引导助手
+  - 实现认证或身份设置
+summary: QuantumClaw 的首次运行新手引导流程（macOS 应用）
+title: 新手引导
+x-i18n:
+  generated_at: "2026-02-03T07:54:07Z"
+  model: claude-opus-4-5
+  provider: pi
+  source_hash: ae883b2deb1f9032be7c47a04d67e1741dffbdcc4445de1e0bbaa976e606bc10
+  source_path: start/onboarding.md
+  workflow: 15
+---
+
+# 新手引导（macOS 应用）
+
+本文档描述**当前**的首次运行新手引导流程。目标是流畅的"第 0 天"体验：选择 Gateway 网关运行位置、连接认证、运行向导，然后让智能体自行引导。
+
+## 页面顺序（当前）
+
+1. 欢迎 + 安全提示
+2. **Gateway 网关选择**（本地 / 远程 / 稍后配置）
+3. **认证（Anthropic OAuth）** — 仅限本地
+4. **设置向导**（Gateway 网关驱动）
+5. **权限**（TCC 提示）
+6. **CLI**（可选）
+7. **新手引导聊天**（专用会话）
+8. 就绪
+
+## 1) 欢迎 + 安全提示
+
+阅读显示的安全提示并相应决定。
+
+## 2) 本地 vs 远程
+
+**Gateway 网关**在哪里运行？
+
+- **本地（此 Mac）：** 新手引导可以在本地运行 OAuth 流程并写入凭证。
+- **远程（通过 SSH/Tailnet）：** 新手引导**不会**在本地运行 OAuth；凭证必须存在于 Gateway 网关主机上。
+- **稍后配置：** 跳过设置并保持应用未配置状态。
+
+Gateway 网关认证提示：
+
+- 向导现在即使对于 loopback 也会生成**令牌**，因此本地 WS 客户端必须认证。
+- 如果你禁用认证，任何本地进程都可以连接；仅在完全受信任的机器上使用。
+- 对于多机器访问或非 loopback 绑定，使用**令牌**。
+
+## 3) 仅限本地的认证（Anthropic OAuth）
+
+macOS 应用支持 Anthropic OAuth（Claude Pro/Max）。流程：
+
+- 打开浏览器进行 OAuth（PKCE）
+- 要求用户粘贴 `code#state` 值
+- 将凭证写入 `~/.quantumclaw/credentials/oauth.json`
+
+其他提供商（OpenAI、自定义 API）目前通过环境变量或配置文件配置。
+
+## 4) 设置向导（Gateway 网关驱动）
+
+应用可以运行与 CLI 相同的设置向导。这使新手引导与 Gateway 网关端行为保持同步，避免在 SwiftUI 中重复逻辑。
+
+## 5) 权限
+
+新手引导请求以下所需的 TCC 权限：
+
+- 通知
+- 辅助功能
+- 屏幕录制
+- 麦克风 / 语音识别
+- 自动化（AppleScript）
+
+## 6) CLI（可选）
+
+应用可以通过 npm/pnpm 安装全局 `quantumclaw` CLI，以便终端工作流和 launchd 任务开箱即用。
+
+## 7) 新手引导聊天（专用会话）
+
+设置完成后，应用会打开一个专用的新手引导聊天会话，让智能体可以自我介绍并指导后续步骤。这使首次运行指导与你的正常对话分开。
+
+## 智能体引导仪式
+
+在首次智能体运行时，QuantumClaw 会引导一个工作区（默认 `~/.quantumclaw/workspace`）：
+
+- 初始化 `AGENTS.md`、`BOOTSTRAP.md`、`IDENTITY.md`、`USER.md`
+- 运行简短的问答仪式（一次一个问题）
+- 将身份 + 偏好写入 `IDENTITY.md`、`USER.md`、`SOUL.md`
+- 完成后删除 `BOOTSTRAP.md`，使其只运行一次
+
+## 可选：Gmail 钩子（手动）
+
+Gmail Pub/Sub 设置目前是手动步骤。使用：
+
+```bash
+quantumclaw webhooks gmail setup --account you@gmail.com
+```
+
+参阅 [/automation/gmail-pubsub](/automation/gmail-pubsub) 了解详情。
+
+## 远程模式说明
+
+当 Gateway 网关在另一台机器上运行时，凭证和工作区文件存储在**该主机上**。如果你需要在远程模式下使用 OAuth，请在 Gateway 网关主机上创建：
+
+- `~/.quantumclaw/credentials/oauth.json`
+- `~/.quantumclaw/agents/<agentId>/agent/auth-profiles.json`