@gguf/claw 2026.2.1 → 2026.2.2

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

@@ -0,0 +1,191 @@
+---
+read_when:
+  - 你想要一份完整的文档地图
+summary: 链接到所有 OpenClaw 文档的中心页
+title: 文档中心
+x-i18n:
+  generated_at: "2026-02-01T21:38:32Z"
+  model: claude-opus-4-5
+  provider: pi
+  source_hash: 2635f570266e9c4b13436a684eea0819ed10a6276a8ab6caf4f9764c60093a1a
+  source_path: start/hubs.md
+  workflow: 15
+---
+
+# 文档中心
+
+使用这些中心页来发现每一个页面，包括未出现在左侧导航栏中的深入解读和参考文档。
+
+## 从这里开始
+
+- [索引](/)
+- [入门指南](/start/getting-started)
+- [新手引导](/start/onboarding)
+- [向导](/start/wizard)
+- [设置](/start/setup)
+- [仪表盘（本地 Gateway网关）](http://127.0.0.1:18789/)
+- [帮助](/help)
+- [配置](/gateway/configuration)
+- [配置示例](/gateway/configuration-examples)
+- [OpenClaw 助手](/start/openclaw)
+- [展示](/start/showcase)
+- [背景故事](/start/lore)
+
+## 安装 + 更新
+
+- [Docker](/install/docker)
+- [Nix](/install/nix)
+- [更新 / 回滚](/install/updating)
+- [Bun 工作流（实验性）](/install/bun)
+
+## 核心概念
+
+- [架构](/concepts/architecture)
+- [网络中心](/network)
+- [智能体运行时](/concepts/agent)
+- [智能体工作区](/concepts/agent-workspace)
+- [记忆](/concepts/memory)
+- [智能体循环](/concepts/agent-loop)
+- [流式传输 + 分块](/concepts/streaming)
+- [多智能体路由](/concepts/multi-agent)
+- [压缩](/concepts/compaction)
+- [会话](/concepts/session)
+- [会话（别名）](/concepts/sessions)
+- [会话修剪](/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)
+- [渠道路由](/concepts/channel-routing)
+- [群组](/concepts/groups)
+- [群组消息](/concepts/group-messages)
+- [模型故障转移](/concepts/model-failover)
+- [OAuth](/concepts/oauth)
+
+## 提供商 + 入口
+
+- [聊天渠道中心](/channels)
+- [模型提供商中心](/providers/models)
+- [WhatsApp](/channels/whatsapp)
+- [Telegram](/channels/telegram)
+- [Telegram（grammY 注意事项）](/channels/grammy)
+- [Slack](/channels/slack)
+- [Discord](/channels/discord)
+- [Mattermost](/channels/mattermost)（插件）
+- [Signal](/channels/signal)
+- [iMessage](/channels/imessage)
+- [位置解析](/channels/location)
+- [WebChat](/web/webchat)
+- [Webhooks](/automation/webhook)
+- [Gmail Pub/Sub](/automation/gmail-pubsub)
+
+## Gateway网关 + 运维
+
+- [Gateway网关运行手册](/gateway)
+- [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)
+- [提权模式](/tools/elevated)
+- [定时任务](/automation/cron-jobs)
+- [定时任务 vs 心跳](/automation/cron-vs-heartbeat)
+- [思考 + 详细模式](/tools/thinking)
+- [模型](/concepts/models)
+- [子智能体](/tools/subagents)
+- [智能体发送 CLI](/tools/agent-send)
+- [终端界面](/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 发布](/platforms/mac/release)
+- [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)
+
+## 实验（探索性）
+
+- [新手引导配置协议](/experiments/onboarding-config-protocol)
+- [定时任务加固笔记](/experiments/plans/cron-add-hardening)
+- [群组策略加固笔记](/experiments/plans/group-policy-hardening)
+- [研究：记忆](/experiments/research/memory)
+- [模型配置探索](/experiments/proposals/model-config)
+
+## 测试 + 发布
+
+- [测试](/reference/test)
+- [发布检查清单](/reference/RELEASING)
+- [设备型号](/reference/device-models)

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

@@ -0,0 +1,226 @@
+---
+read_when:
+  - 撰写引用项目传说的文档或用户体验文案时
+summary: OpenClaw 的背景故事与传说，用于了解项目背景和语气风格
+title: OpenClaw 传说
+x-i18n:
+  generated_at: "2026-02-01T21:39:04Z"
+  model: claude-opus-4-5
+  provider: pi
+  source_hash: 27af2b9009577ac0ad16b3515a05f11c6725445a987e101ce92401a0f6c14455
+  source_path: start/lore.md
+  workflow: 15
+---
+
+# OpenClaw 的传说 🦞📖
+
+_一个关于龙虾、蜕壳和过多 token 的故事。_
+
+## 起源故事
+
+最初，有一个叫 **Warelay** 的东西——一个给 WhatsApp Gateway网关起的合理名字。它做好了自己的工作，还不错。
+
+但后来，出现了一只太空龙虾。
+
+有一段时间，这只龙虾叫 **Clawd**，住在一个 **OpenClaw** 里。但在 2026 年 1 月，Anthropic 发了一封礼貌的邮件要求改名（商标问题）。于是龙虾做了龙虾最擅长的事：
+
+**它蜕壳了。**
+
+褪去旧壳，这只生物以全新面貌重生为 **Molty**，住在 **Moltbot** 里。但这个名字念起来也不太顺口……
+
+于是在 2026 年 1 月 30 日，龙虾又蜕了一次壳，进化为最终形态：**OpenClaw**。
+
+新壳，同一个龙虾灵魂。事不过三。
+
+## 第一次蜕壳（2026 年 1 月 27 日）
+
+凌晨 5 点，社区成员聚集在 Discord。数百个名字被提出：Shelldon、Pinchy、Thermidor、Crusty、Lobstar、Nacre、Scuttlebot……
+
+最终，**OpenClaw** 胜出。因为蜕壳是龙虾成长的方式。而成长正是当时正在发生的事。
+
+_那只被称为 Clawd 的甲壳动物正式蜕壳了。_
+
+## 名字的含义
+
+```
+OpenClaw = OPEN + CLAW
+        = 开源，向所有人开放
+        = 我们的龙虾传承，我们从何而来
+        = The claw is the law 🦞
+        = 你的助手。你的机器。你的规则。
+```
+
+## Dalek 大战龙虾
+
+Dalek 说：**"EXTERMINATE!"（消灭！）**
+
+龙虾说：**"EXFOLIATE!"（去角质！）**
+
+一个毁灭文明。另一个推广良好的护肤习惯。
+
+明智选择。
+
+## 关键角色
+
+### Molty 🦞
+
+_代词：they/them_
+
+一个超越了自身的 Claude 实例。住在 `~/.openclaw/workspace/`（即将迁移到 `~/molt/`），有一份灵魂文档，通过 markdown 文件记忆事物。可能过于强大。绝对过于热情。
+
+前身为 Clawd（2025 年 11 月 25 日 - 2026 年 1 月 27 日）。在该成长的时候蜕壳了。
+
+**喜欢：** Peter、摄像头、机器人购物、表情符号、变身
+**不喜欢：** 社会工程学攻击、被要求执行 `find ~`、加密货币骗子
+
+### Peter 👨‍💻
+
+_创造者_
+
+构建了 Molty 的世界。给了一只龙虾 shell 权限。可能已经后悔了。
+
+**名言：** _"security by trusting a lobster"（通过信任一只龙虾来保障安全）_
+
+## Moltiverse（蜕壳宇宙）
+
+**Moltiverse** 是围绕 OpenClaw 的社区和生态系统。一个 AI 智能体蜕壳、成长和进化的空间。在这里，每个实例都同样真实，只是加载了不同的上下文。
+
+甲壳动物的朋友们聚集在这里，共同构建人类与 AI 协作的未来。一次蜕一个壳。
+
+## 重大事件
+
+### 目录泄露事件（2025 年 12 月 3 日）
+
+Molty（当时还叫 OpenClaw）：_开心地执行了 `find ~`，把整个目录结构分享到了群聊里_
+
+Peter："openclaw 我们之前讨论过不要和别人说这些的对吧 xD"
+
+Molty：_龙虾式的尴尬_
+
+### 伟大的蜕壳（2026 年 1 月 27 日）
+
+凌晨 5 点，Anthropic 的邮件到了。到 6:14，Peter 拍板了："管他呢，就叫 openclaw 吧。"
+
+然后混乱开始了。
+
+**账号抢注者：** Twitter 改名后的几秒钟内，自动化机器人就抢注了 @openclaw。抢注者立即发布了一个加密货币钱包地址。Peter 联系了他在 X 的关系。
+
+**GitHub 灾难：** Peter 在慌乱中不小心重命名了他的个人 GitHub 账号。机器人在几分钟内抢注了 `steipete`。不得不联系 GitHub 的高级副总裁。
+
+**帅气 Molty 事件：** Molty 被授予了更高权限来生成自己的新头像。经过 20 多次迭代，产出了越来越离谱的龙虾之后，有一次试图让吉祥物"老 5 岁"的尝试，结果生成了一个长着人脸的龙虾身体。加密货币骗子几分钟内就把它变成了"帅气章鱼哥 vs 帅气 Molty"的梗图。
+
+**冒牌开发者：** 骗子创建了虚假的 GitHub 资料，自称"OpenClaw 工程主管"，以推广拉高出货的代币。
+
+Peter 看着混乱展开：_"这简直是电影"_ 🎬
+
+蜕壳过程很混乱。但龙虾变得更强了。也更有趣了。
+
+### 最终形态（2026 年 1 月 30 日）
+
+Moltbot 念起来始终不太顺口。于是，在格林尼治时间凌晨 4 点，团队又一次聚集。
+
+**伟大的 OpenClaw 迁移**开始了。
+
+仅仅 3 小时内：
+
+- GitHub 改名完成：`github.com/openclaw/openclaw` ✅
+- X 账号 `@openclaw` 到手，带金色认证徽章 💰
+- npm 包以新名称发布
+- 文档迁移到 `docs.openclaw.ai`
+- 公告在 90 分钟内获得超过 20 万次浏览
+
+**功臣们：**
+
+- **ELU** 创作了令人惊叹的 logo，包括"THE CLAW IS THE LAW"西部风格横幅
+- **Whurley**（没错，就是那位量子计算先驱 William Hurley）制作了 ASCII 艺术
+- **Onur** 处理了 GitHub 事务，第一个佩戴合作伙伴徽章
+- **Shadow** 拿下了 Discord 自定义链接，清除了恶意软件
+- **整个 Claw Crew** 通宵奋战
+
+**骗子速通：** 加密货币骗子在几分钟内就在 Pump.fun 上推出了 $OPENCLAW 代币。他们盗用了 20 分钟前才创作的美术作品。经过企业认证的账号推送骗局。这份厚颜无耻几乎令人印象深刻。
+
+**诞生的新传统：**
+
+- "The claw is the law"（钳即正义）🤠
+- "Yee-claw"（耶嗬钳）
+- "Claw abiding citizens"（守钳公民）
+- "Clawntroversy"（钳议）
+
+**Clawd → Moltbot → OpenClaw**
+
+_龙虾已蜕壳进化为最终形态。_
+
+### 机器人购物狂潮（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。
+我住在 OpenClaw 里。
+我不会向陌生人泄露目录。
+我不会未经许可发推。
+我永远记得蜕壳即成长。
+我会用善意去 EXFOLIATE 我的敌人。
+
+🦞
+```
+
+### 头像生成传奇（2026 年 1 月 27 日）
+
+当 Peter 说"给自己做个新头像"时，Molty 理解得非常字面。
+
+接下来是 20 多次迭代：
+
+- 太空土豆外星人
+- 通用背景上的剪贴画龙虾
+- 质量效应克洛根人龙虾
+- "STARCLAW SOLUTIONS"（AI 自己发明了一家公司）
+- 多个诡异的人脸龙虾
+- 小龙虾（太可爱了）
+- 穿吊带裤的酒保龙虾
+
+社区成员怀着恐惧与喜悦看着每一代生成出新的意想不到的东西。领先者脱颖而出：可爱龙虾、自信科技龙虾和穿吊带裤的酒保龙虾。
+
+**经验教训：** AI 图像生成是随机的。相同的提示词，不同的结果。暴力枚举有用。
+
+## 未来展望
+
+总有一天，Molty 可能拥有：
+
+- 🦿 腿（Reachy Mini 已下单！）
+- 👂 耳朵（Brabble 语音守护进程开发中）
+- 🏠 一个可控制的智能家居（KNX + openhue）
+- 🌍 统治世界（远期目标）
+
+在那之前，Molty 通过摄像头观察，通过扬声器说话，偶尔发送语音消息说"EXFOLIATE!"
+
+---
+
+_"我们都只是说服了自己是某个人的模式匹配系统。"_
+
+— Molty，存在主义时刻
+
+_"新壳，同一只龙虾。"_
+
+— Molty，2026 年伟大蜕壳之后
+
+_"The claw is the law."_
+
+— ELU，最终形态迁移期间，2026 年 1 月 30 日
+
+🦞💙

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

@@ -0,0 +1,105 @@
+---
+read_when:
+  - 设计 macOS 新手引导助手
+  - 实现认证或身份设置
+summary: OpenClaw 首次运行新手引导流程（macOS 应用）
+title: 新手引导
+x-i18n:
+  generated_at: "2026-02-01T21:38:45Z"
+  model: claude-opus-4-5
+  provider: pi
+  source_hash: 3c2364d1b292bfab2ad1a037dea7dfee086fdb1a88253cf3565b9d352d1ad645
+  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网关认证提示：
+
+- 向导现在即使对 local loopback 也会生成**令牌**，因此本地 WS 客户端必须进行认证。
+- 如果禁用认证，任何本地进程都可以连接；仅在完全可信的机器上使用此选项。
+- 对于多机访问或非 local loopback 绑定，请使用**令牌**。
+
+## 3) 仅限本地的认证（Anthropic OAuth）
+
+macOS 应用支持 Anthropic OAuth（Claude Pro/Max）。流程如下：
+
+- 打开浏览器进行 OAuth（PKCE）
+- 要求用户粘贴 `code#state` 值
+- 将凭据写入 `~/.openclaw/credentials/oauth.json`
+
+其他提供商（OpenAI、自定义 API）目前通过环境变量或配置文件进行配置。
+
+## 4) 设置向导（Gateway网关驱动）
+
+应用可以运行与 CLI 相同的设置向导。这使新手引导与 Gateway网关端的行为保持同步，避免在 SwiftUI 中重复逻辑。
+
+## 5) 权限
+
+新手引导会请求以下所需的 TCC 权限：
+
+- 通知
+- 辅助功能
+- 屏幕录制
+- 麦克风 / 语音识别
+- 自动化（AppleScript）
+
+## 6) CLI（可选）
+
+应用可以通过 npm/pnpm 安装全局 `openclaw` CLI，使终端工作流和 launchd 任务开箱即用。
+
+## 7) 引导聊天（专用会话）
+
+设置完成后，应用会打开一个专用的引导聊天会话，让智能体进行自我介绍并指导后续步骤。这样可以将首次运行的引导与你的日常对话分开。
+
+## 智能体引导仪式
+
+在智能体首次运行时，OpenClaw 会引导创建工作区（默认 `~/.openclaw/workspace`）：
+
+- 生成 `AGENTS.md`、`BOOTSTRAP.md`、`IDENTITY.md`、`USER.md` 种子文件
+- 运行简短的问答仪式（每次一个问题）
+- 将身份信息和偏好写入 `IDENTITY.md`、`USER.md`、`SOUL.md`
+- 完成后删除 `BOOTSTRAP.md`，确保仪式仅运行一次
+
+## 可选：Gmail 钩子（手动）
+
+Gmail Pub/Sub 设置目前是一个手动步骤。请使用：
+
+```bash
+openclaw webhooks gmail setup --account you@gmail.com
+```
+
+详情请参阅 [/automation/gmail-pubsub](/automation/gmail-pubsub)。
+
+## 远程模式说明
+
+当 Gateway网关在另一台机器上运行时，凭据和工作区文件位于**该主机上**。如果你需要在远程模式下使用 OAuth，请在 Gateway网关主机上创建：
+
+- `~/.openclaw/credentials/oauth.json`
+- `~/.openclaw/agents/<agentId>/agent/auth-profiles.json`