Docs: add zh-CN translations

2026-04-30 14:01:44 +00:00 · 2026-02-01 22:47:44 +01:00
parent e70984745b
commit 149dc7c4e7
298 changed files with 53861 additions and 0 deletions
--- a/docs/zh-CN/start/hubs.md
+++ b/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 技能](/platforms/mac/skills)
+- [macOS Peekaboo](/platforms/mac/peekaboo)
+
+## 工作区 + 模板
+
+- [技能](/tools/skills)
+- [ClawHub](/tools/clawhub)
+- [技能配置](/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)
--- a/docs/zh-CN/start/lore.md
+++ b/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 日
+
+🦞💙
--- a/docs/zh-CN/start/onboarding.md
+++ b/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 认证提示：
+
+- 向导现在即使对回环地址也会生成**令牌**，因此本地 WS 客户端必须进行认证。
+- 如果禁用认证，任何本地进程都可以连接；仅在完全可信的机器上使用此选项。
+- 对于多机访问或非回环地址绑定，请使用**令牌**。
+
+## 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`
--- a/docs/zh-CN/start/openclaw.md
+++ b/docs/zh-CN/start/openclaw.md
@@ -0,0 +1,248 @@
+---
+read_when:
+  - 上手引导新的助手实例
+  - 审查安全/权限影响
+summary: 将 OpenClaw 作为个人助手运行的端到端指南，包含安全注意事项
+title: 个人助手设置
+x-i18n:
+  generated_at: "2026-02-01T21:39:04Z"
+  model: claude-opus-4-5
+  provider: pi
+  source_hash: 2763668c053abe34ea72c40d1306d3d1143099c58b1e3ef91c2e5a20cb2769e0
+  source_path: start/openclaw.md
+  workflow: 15
+---
+
+# 使用 OpenClaw 构建个人助手
+
+OpenClaw 是一个面向 **Pi** 智能体的 WhatsApp + Telegram + Discord + iMessage Gateway。插件可添加 Mattermost 支持。本指南介绍"个人助手"设置：一个专用的 WhatsApp 号码，作为你始终在线的智能体。
+
+## ⚠️ 安全第一
+
+你正在让一个智能体拥有以下能力：
+
+- 在你的机器上运行命令（取决于你的 Pi 工具设置）
+- 读写你工作区中的文件
+- 通过 WhatsApp/Telegram/Discord/Mattermost（插件）发送消息
+
+请从保守配置开始：
+
+- 始终设置 `channels.whatsapp.allowFrom`（切勿在你的个人 Mac 上以对全网开放的方式运行）。
+- 为助手使用专用的 WhatsApp 号码。
+- 心跳现在默认每 30 分钟一次。在你信任该设置之前，通过设置 `agents.defaults.heartbeat.every: "0m"` 来禁用。
+
+## 前提条件
+
+- Node **22+**
+- OpenClaw 在 PATH 中可用（推荐：全局安装）
+- 为助手准备一个第二个电话号码（SIM/eSIM/预付费卡）
+
+```bash
+npm install -g openclaw@latest
+# or: pnpm add -g openclaw@latest
+```
+
+从源码安装（开发模式）：
+
+```bash
+git clone https://github.com/openclaw/openclaw.git
+cd openclaw
+pnpm install
+pnpm ui:build # auto-installs UI deps on first run
+pnpm build
+pnpm link --global
+```
+
+## 双手机设置（推荐）
+
+你需要的配置如下：
+
+```
+你的手机（个人）                第二部手机（助手）
+┌─────────────────┐           ┌─────────────────┐
+│  你的 WhatsApp  │  ──────▶  │  助手 WA        │
+│  +1-555-YOU     │  消息     │  +1-555-ASSIST  │
+└─────────────────┘           └────────┬────────┘
+                                       │ 通过二维码关联
+                                       ▼
+                              ┌─────────────────┐
+                              │  你的 Mac       │
+                              │  (openclaw)      │
+                              │    Pi 智能体    │
+                              └─────────────────┘
+```
+
+如果你将个人 WhatsApp 关联到 OpenClaw，发给你的每条消息都会变成"智能体输入"。这通常不是你想要的。
+
+## 5 分钟快速上手
+
+1. 配对 WhatsApp Web（显示二维码；用助手手机扫描）：
+
+```bash
+openclaw channels login
+```
+
+2. 启动 Gateway（保持运行）：
+
+```bash
+openclaw gateway --port 18789
+```
+
+3. 在 `~/.openclaw/openclaw.json` 中放置一个最小配置：
+
+```json5
+{
+  channels: { whatsapp: { allowFrom: ["+15555550123"] } },
+}
+```
+
+现在从你的允许列表手机给助手号码发消息。
+
+上手引导完成后，我们会自动打开带有 Gateway 令牌的仪表盘并打印令牌化链接。以后重新打开：`openclaw dashboard`。
+
+## 给智能体一个工作区（AGENTS）
+
+OpenClaw 从其工作区目录读取操作指令和"记忆"。
+
+默认情况下，OpenClaw 使用 `~/.openclaw/workspace` 作为智能体工作区，并会在设置/首次智能体运行时自动创建它（以及初始的 `AGENTS.md`、`SOUL.md`、`TOOLS.md`、`IDENTITY.md`、`USER.md`）。`BOOTSTRAP.md` 仅在工作区全新创建时生成（删除后不会再次出现）。
+
+提示：将此文件夹视为 OpenClaw 的"记忆"，并将其设为 git 仓库（最好是私有的），以便你的 `AGENTS.md` + 记忆文件得到备份。如果安装了 git，全新工作区会自动初始化。
+
+```bash
+openclaw setup
+```
+
+完整工作区布局 + 备份指南：[智能体工作区](/concepts/agent-workspace)
+记忆工作流：[记忆](/concepts/memory)
+
+可选：使用 `agents.defaults.workspace` 选择不同的工作区（支持 `~`）。
+
+```json5
+{
+  agent: {
+    workspace: "~/.openclaw/workspace",
+  },
+}
+```
+
+如果你已经从仓库中提供了自己的工作区文件，可以完全禁用引导文件创建：
+
+```json5
+{
+  agent: {
+    skipBootstrap: true,
+  },
+}
+```
+
+## 将其变成"助手"的配置
+
+OpenClaw 默认提供了良好的助手设置，但你通常会想要调整：
+
+- `SOUL.md` 中的人设/指令
+- 思考默认值（如需要）
+- 心跳（在你信任之后）
+
+示例：
+
+```json5
+{
+  logging: { level: "info" },
+  agent: {
+    model: "anthropic/claude-opus-4-5",
+    workspace: "~/.openclaw/workspace",
+    thinkingDefault: "high",
+    timeoutSeconds: 1800,
+    // Start with 0; enable later.
+    heartbeat: { every: "0m" },
+  },
+  channels: {
+    whatsapp: {
+      allowFrom: ["+15555550123"],
+      groups: {
+        "*": { requireMention: true },
+      },
+    },
+  },
+  routing: {
+    groupChat: {
+      mentionPatterns: ["@openclaw", "openclaw"],
+    },
+  },
+  session: {
+    scope: "per-sender",
+    resetTriggers: ["/new", "/reset"],
+    reset: {
+      mode: "daily",
+      atHour: 4,
+      idleMinutes: 10080,
+    },
+  },
+}
+```
+
+## 会话和记忆
+
+- 会话文件：`~/.openclaw/agents/<agentId>/sessions/{{SessionId}}.jsonl`
+- 会话元数据（令牌用量、最后路由等）：`~/.openclaw/agents/<agentId>/sessions/sessions.json`（旧版：`~/.openclaw/sessions/sessions.json`）
+- `/new` 或 `/reset` 为该聊天启动新会话（可通过 `resetTriggers` 配置）。如果单独发送，智能体会回复一条简短的问候以确认重置。
+- `/compact [instructions]` 压缩会话上下文并报告剩余的上下文预算。
+
+## 心跳（主动模式）
+
+默认情况下，OpenClaw 每 30 分钟运行一次心跳，提示词为：
+`Read HEARTBEAT.md if it exists (workspace context). Follow it strictly. Do not infer or repeat old tasks from prior chats. If nothing needs attention, reply HEARTBEAT_OK.`
+设置 `agents.defaults.heartbeat.every: "0m"` 可禁用。
+
+- 如果 `HEARTBEAT.md` 存在但实际为空（仅包含空行和 markdown 标题如 `# Heading`），OpenClaw 会跳过心跳运行以节省 API 调用。
+- 如果文件不存在，心跳仍会运行，由模型决定执行什么操作。
+- 如果智能体回复 `HEARTBEAT_OK`（可选带有短填充内容；参见 `agents.defaults.heartbeat.ackMaxChars`），OpenClaw 会抑制该次心跳的出站消息投递。
+- 心跳运行完整的智能体回合——较短的间隔会消耗更多令牌。
+
+```json5
+{
+  agent: {
+    heartbeat: { every: "30m" },
+  },
+}
+```
+
+## 媒体输入和输出
+
+入站附件（图片/音频/文档）可通过模板传递给你的命令：
+
+- `{{MediaPath}}`（本地临时文件路径）
+- `{{MediaUrl}}`（伪 URL）
+- `{{Transcript}}`（如果启用了音频转录）
+
+智能体的出站附件：在单独一行中包含 `MEDIA:<path-or-url>`（无空格）。示例：
+
+```
+Here's the screenshot.
+MEDIA:https://example.com/screenshot.png
+```
+
+OpenClaw 会提取这些内容并将其作为媒体与文本一起发送。
+
+## 运维清单
+
+```bash
+openclaw status          # 本地状态（凭证、会话、排队事件）
+openclaw status --all    # 完整诊断（只读，可粘贴）
+openclaw status --deep   # 添加 Gateway 健康探测（Telegram + Discord）
+openclaw health --json   # Gateway 健康快照（WS）
+```
+
+日志位于 `/tmp/openclaw/`（默认：`openclaw-YYYY-MM-DD.log`）。
+
+## 后续步骤
+
+- 网页聊天：[网页聊天](/web/webchat)
+- Gateway 运维：[Gateway 运维手册](/gateway)
+- 定时任务 + 唤醒：[定时任务](/automation/cron-jobs)
+- macOS 菜单栏伴侣应用：[OpenClaw macOS 应用](/platforms/macos)
+- iOS 节点应用：[iOS 应用](/platforms/ios)
+- Android 节点应用：[Android 应用](/platforms/android)
+- Windows 状态：[Windows (WSL2)](/platforms/windows)
+- Linux 状态：[Linux 应用](/platforms/linux)
+- 安全：[安全](/gateway/security)
--- a/docs/zh-CN/start/pairing.md
+++ b/docs/zh-CN/start/pairing.md
@@ -0,0 +1,90 @@
+---
+read_when:
+  - 设置私信访问控制时
+  - 配对新的 iOS/Android 节点时
+  - 审查 OpenClaw 安全态势时
+summary: 配对概览：审批谁可以私信你 + 哪些节点可以加入
+title: 配对
+x-i18n:
+  generated_at: "2026-02-01T21:38:45Z"
+  model: claude-opus-4-5
+  provider: pi
+  source_hash: c46a5c39f289c8fd0783baacd927f550c3d3ae8889a7bc7de133b795f16fa08a
+  source_path: start/pairing.md
+  workflow: 15
+---
+
+# 配对
+
+"配对"是 OpenClaw 的显式**所有者审批**步骤。
+它用于两个场景：
+
+1. **私信配对**（谁被允许与机器人对话）
+2. **节点配对**（哪些设备/节点被允许加入 Gateway 网络）
+
+安全上下文：[安全](/gateway/security)
+
+## 1) 私信配对（入站聊天访问）
+
+当渠道配置了私信策略 `pairing` 时，未知发送者会收到一个短码，其消息在你批准之前**不会被处理**。
+
+默认私信策略记录在：[安全](/gateway/security)
+
+配对码：
+
+- 8 个字符，大写，不含歧义字符（`0O1I`）。
+- **1 小时后过期**。机器人仅在创建新请求时发送配对消息（每个发送者大约每小时一次）。
+- 待处理的私信配对请求默认每个渠道上限为 **3 个**；额外请求将被忽略，直到有请求过期或被批准。
+
+### 批准发送者
+
+```bash
+openclaw pairing list telegram
+openclaw pairing approve telegram <CODE>
+```
+
+支持的渠道：`telegram`、`whatsapp`、`signal`、`imessage`、`discord`、`slack`。
+
+### 状态存储位置
+
+存储在 `~/.openclaw/credentials/` 下：
+
+- 待处理请求：`<channel>-pairing.json`
+- 已批准的允许列表存储：`<channel>-allowFrom.json`
+
+请将这些文件视为敏感信息（它们控制着对你助手的访问权限）。
+
+## 2) 节点设备配对（iOS/Android/macOS/无头节点）
+
+节点以 `role: node` 的**设备**身份连接到 Gateway。Gateway 会创建一个需要批准的设备配对请求。
+
+### 批准节点设备
+
+```bash
+openclaw devices list
+openclaw devices approve <requestId>
+openclaw devices reject <requestId>
+```
+
+### 状态存储位置
+
+存储在 `~/.openclaw/devices/` 下：
+
+- `pending.json`（短期有效；待处理请求会过期）
+- `paired.json`（已配对设备 + 令牌）
+
+### 注意事项
+
+- 旧版 `node.pair.*` API（CLI：`openclaw nodes pending/approve`）是一个独立的 Gateway 所拥有的配对存储。WebSocket 节点仍然需要设备配对。
+
+## 相关文档
+
+- 安全模型 + 提示注入：[安全](/gateway/security)
+- 安全更新（运行 doctor）：[更新](/install/updating)
+- 渠道配置：
+  - Telegram：[Telegram](/channels/telegram)
+  - WhatsApp：[WhatsApp](/channels/whatsapp)
+  - Signal：[Signal](/channels/signal)
+  - iMessage：[iMessage](/channels/imessage)
+  - Discord：[Discord](/channels/discord)
+  - Slack：[Slack](/channels/slack)
--- a/docs/zh-CN/start/setup.md
+++ b/docs/zh-CN/start/setup.md
@@ -0,0 +1,156 @@
+---
+read_when:
+  - 在新机器上进行设置
+  - 你想要"最新最好的版本"同时不破坏你的个人配置
+summary: 设置指南：在保持更新的同时维护你的个性化 OpenClaw 配置
+title: 设置
+x-i18n:
+  generated_at: "2026-02-01T21:39:04Z"
+  model: claude-opus-4-5
+  provider: pi
+  source_hash: b7f4bd657d0df4feb5035c9f5ee727f9c67b991e9cedfc7768f99d010553fa01
+  source_path: start/setup.md
+  workflow: 15
+---
+
+# 设置
+
+最后更新：2026-01-01
+
+## 简而言之
+
+- **个性化配置存放在仓库之外：** `~/.openclaw/workspace`（工作区）+ `~/.openclaw/openclaw.json`（配置）。
+- **稳定工作流：** 安装 macOS 应用；让它运行内置的 Gateway。
+- **前沿工作流：** 自行通过 `pnpm gateway:watch` 运行 Gateway，然后让 macOS 应用以本地模式接入。
+
+## 前置条件（从源码构建）
+
+- Node `>=22`
+- `pnpm`
+- Docker（可选；仅用于容器化设置/端到端测试——参见 [Docker](/install/docker)）
+
+## 个性化策略（让更新不会造成麻烦）
+
+如果你想要"100% 按我的方式定制"*同时*方便更新，请将自定义内容放在：
+
+- **配置：** `~/.openclaw/openclaw.json`（JSON/JSON5 风格）
+- **工作区：** `~/.openclaw/workspace`（技能、提示词、记忆；建议设为私有 git 仓库）
+
+初始化一次：
+
+```bash
+openclaw setup
+```
+
+在本仓库内，使用本地 CLI 入口：
+
+```bash
+openclaw setup
+```
+
+如果你还没有全局安装，请通过 `pnpm openclaw setup` 运行。
+
+## 稳定工作流（macOS 应用优先）
+
+1. 安装并启动 **OpenClaw.app**（菜单栏）。
+2. 完成上手引导/权限检查清单（TCC 授权提示）。
+3. 确保 Gateway 处于**本地**模式并正在运行（由应用管理）。
+4. 关联聊天界面（示例：WhatsApp）：
+
+```bash
+openclaw channels login
+```
+
+5. 安装完整性检查：
+
+```bash
+openclaw health
+```
+
+如果你的版本中上手引导不可用：
+
+- 运行 `openclaw setup`，然后 `openclaw channels login`，接着手动启动 Gateway（`openclaw gateway`）。
+
+## 前沿工作流（在终端中运行 Gateway）
+
+目标：开发 TypeScript Gateway，获得热重载，同时保持 macOS 应用界面接入。
+
+### 0)（可选）同样从源码运行 macOS 应用
+
+如果你也想让 macOS 应用使用最前沿版本：
+
+```bash
+./scripts/restart-mac.sh
+```
+
+### 1) 启动开发 Gateway
+
+```bash
+pnpm install
+pnpm gateway:watch
+```
+
+`gateway:watch` 以监视模式运行 Gateway，TypeScript 文件变更时自动重载。
+
+### 2) 将 macOS 应用指向你运行的 Gateway
+
+在 **OpenClaw.app** 中：
+
+- 连接模式：**本地**
+  应用将接入在配置端口上运行的 Gateway。
+
+### 3) 验证
+
+- 应用内 Gateway 状态应显示 **"Using existing gateway …"**
+- 或通过 CLI 验证：
+
+```bash
+openclaw health
+```
+
+### 常见陷阱
+
+- **端口错误：** Gateway WS 默认使用 `ws://127.0.0.1:18789`；保持应用 + CLI 使用相同端口。
+- **状态存储位置：**
+  - 凭据：`~/.openclaw/credentials/`
+  - 会话：`~/.openclaw/agents/<agentId>/sessions/`
+  - 日志：`/tmp/openclaw/`
+
+## 凭据存储映射
+
+在调试认证或决定备份内容时参考：
+
+- **WhatsApp**：`~/.openclaw/credentials/whatsapp/<accountId>/creds.json`
+- **Telegram 机器人令牌**：配置/环境变量或 `channels.telegram.tokenFile`
+- **Discord 机器人令牌**：配置/环境变量（尚不支持令牌文件）
+- **Slack 令牌**：配置/环境变量（`channels.slack.*`）
+- **配对允许列表**：`~/.openclaw/credentials/<channel>-allowFrom.json`
+- **模型认证配置文件**：`~/.openclaw/agents/<agentId>/agent/auth-profiles.json`
+- **旧版 OAuth 导入**：`~/.openclaw/credentials/oauth.json`
+  更多详情：[安全](/gateway/security#credential-storage-map)。
+
+## 更新（不破坏你的配置）
+
+- 将 `~/.openclaw/workspace` 和 `~/.openclaw/` 视为"你的东西"；不要将个人提示词/配置放入 `openclaw` 仓库中。
+- 更新源码：`git pull` + `pnpm install`（当 lockfile 变更时）+ 继续使用 `pnpm gateway:watch`。
+
+## Linux（systemd 用户服务）
+
+Linux 安装使用 systemd **用户**服务。默认情况下，systemd 在注销/空闲时会停止用户
+服务，这会终止 Gateway。上手引导会尝试为你启用
+持久化（可能提示输入 sudo 密码）。如果仍未开启，请运行：
+
+```bash
+sudo loginctl enable-linger $USER
+```
+
+对于常驻或多用户服务器，建议使用**系统**服务而非
+用户服务（无需持久化）。参见 [Gateway 运维手册](/gateway) 中的 systemd 说明。
+
+## 相关文档
+
+- [Gateway 运维手册](/gateway)（标志、进程管理、端口）
+- [Gateway 配置](/gateway/configuration)（配置结构 + 示例）
+- [Discord](/channels/discord) 和 [Telegram](/channels/telegram)（回复标签 + replyToMode 设置）
+- [OpenClaw 助手设置](/start/openclaw)
+- [macOS 应用](/platforms/macos)（Gateway 生命周期）
--- a/docs/zh-CN/start/showcase.md
+++ b/docs/zh-CN/start/showcase.md
@@ -0,0 +1,423 @@
+---
+description: Real-world OpenClaw projects from the community
+summary: 由 OpenClaw 驱动的社区项目和集成展示
+title: 项目展示
+x-i18n:
+  generated_at: "2026-02-01T21:40:20Z"
+  model: claude-opus-4-5
+  provider: pi
+  source_hash: b3460f6a7b9948799a6082fee90fa8e5ac1d43e34872aea51ba431813dcead7a
+  source_path: start/showcase.md
+  workflow: 15
+---
+
+# 项目展示
+
+来自社区的真实项目。看看大家正在用 OpenClaw 构建什么。
+
+<Info>
+**想要展示你的项目？** 在 [Discord 的 #showcase 频道](https://discord.gg/clawd) 分享你的项目，或在 [X 上 @openclaw](https://x.com/openclaw)。
+</Info>
+
+## 🎥 OpenClaw 实战演示
+
+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="OpenClaw: 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="OpenClaw 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="OpenClaw 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 → OpenClaw 审查差异并在 Telegram 中回复"小建议"以及明确的合并意见（包括需要优先应用的关键修复）。
+
+  <img src="/assets/showcase/pr-review-telegram.jpg" alt="OpenClaw PR 审查反馈通过 Telegram 发送" />
+</Card>
+
+<Card title="几分钟内创建酒窖技能" icon="wine-glass" href="https://x.com/i/status/2010916352454791216">
+  **@prades_maxime** • `skills` `local` `csv`
+
+让"Robby"（@openclaw）创建一个本地酒窖技能。它请求一个 CSV 导出样本和存储位置，然后快速构建并测试技能（示例中有 962 瓶酒）。
+
+  <img src="/assets/showcase/wine-cellar-skill.jpg" alt="OpenClaw 从 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 购物自动化" />
+</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 截图转 Markdown 工具" />
+</Card>
+
+<Card title="Agents UI" icon="window-maximize" href="https://releaseflow.net/kitze/agents-ui">
+  **@kitze** • `ui` `skills` `sync`
+
+桌面应用，用于跨 Agents、Claude、Codex 和 OpenClaw 管理技能/命令。
+
+  <img src="/assets/showcase/agents-ui.jpg" alt="Agents UI 应用" />
+</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="TTS 输出的 Telegram 语音消息" />
+</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="ClawHub 上的 CodexMonitor" />
+</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="ClawHub 上的 Bambu CLI 技能" />
+</Card>
+
+<Card title="维也纳公共交通（Wiener Linien）" icon="train" href="https://clawhub.com/hjanuschka/wienerlinien">
+  **@hjanuschka** • `travel` `transport` `skill`
+
+维也纳公共交通的实时出发信息、中断情况、电梯状态和路线规划。
+
+  <img src="/assets/showcase/wienerlinien.png" alt="ClawHub 上的 Wiener Linien 技能" />
+</Card>
+
+<Card title="ParentPay 学校餐食" icon="utensils" href="#">
+  **@George5562** • `automation` `browser` `parenting`
+
+通过 ParentPay 自动预订英国学校餐食。使用鼠标坐标实现可靠的表格单元格点击。
+</Card>
+
+<Card title="R2 上传（发送我的文件）" icon="cloud-arrow-up" href="https://clawhub.com/skills/r2-upload">
+  **@julianengel** • `files` `r2` `presigned-urls`
+
+上传到 Cloudflare R2/S3 并生成安全的预签名下载链接。非常适合远程 OpenClaw 实例。
+</Card>
+
+<Card title="通过 Telegram 开发 iOS 应用" icon="mobile" href="#">
+  **@coard** • `ios` `xcode` `testflight`
+
+完整构建了一个包含地图和语音录制功能的 iOS 应用，完全通过 Telegram 聊天部署到 TestFlight。
+
+  <img src="/assets/showcase/ios-testflight.jpg" alt="TestFlight 上的 iOS 应用" />
+</Card>
+
+<Card title="Oura 戒指健康助手" icon="heart-pulse" href="#">
+  **@AS** • `health` `oura` `calendar`
+
+个人 AI 健康助手，将 Oura 戒指数据与日历、预约和健身计划整合。
+
+  <img src="/assets/showcase/oura-health.png" alt="Oura 戒指健康助手" />
+</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、OpenClaw）的 Linear CLI。从终端管理 issue、项目和工作流。首个外部 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 发现并确认了净化器控制方式，然后 OpenClaw 接管并管理室内空气质量。
+
+  <img src="/assets/showcase/winix-air-purifier.jpg" alt="通过 OpenClaw 控制 Winix 空气净化器" />
+</Card>
+
+<Card title="美丽天空相机抓拍" icon="camera" href="https://x.com/signalgaining/status/2010523120604746151">
+  **@signalgaining** • `automation` `camera` `skill` `images`
+
+由屋顶摄像头触发：当天空看起来很美时，让 OpenClaw 拍一张天空照片——它设计了一个技能并完成了拍摄。
+
+  <img src="/assets/showcase/roof-camera-sky.jpg" alt="OpenClaw 捕获的屋顶摄像头天空快照" />
+</Card>
+
+<Card title="可视化早间简报场景" icon="robot" href="https://x.com/buddyhadry/status/2010005331925954739">
+  **@buddyhadry** • `automation` `briefing` `images` `telegram`
+
+定时提示每天早上通过 OpenClaw 角色生成一张"场景"图片（天气、任务、日期、喜欢的帖子/名言）。
+</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 截图" />
+</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 技能构建器" icon="diagram-project" href="https://x.com/jdrhyne/status/2008336434827002232">
+  **@jdrhyne** • `automation` `jira` `skill` `devtools`
+
+OpenClaw 连接到 Jira，然后即时生成了一个新技能（在 ClawHub 上还不存在时）。
+</Card>
+
+<Card title="通过 Telegram 创建 Todoist 技能" icon="list-check" href="https://x.com/iamsubhrajyoti/status/2009949389884920153">
+  **@iamsubhrajyoti** • `automation` `todoist` `skill` `telegram`
+
+自动化 Todoist 任务，并让 OpenClaw 直接在 Telegram 聊天中生成技能。
+</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`
+  
+  通过 OpenClaw 实现的中文学习引擎，具备发音反馈和学习流程。
+  
+  <img src="/assets/showcase/xuezh-pronunciation.jpeg" alt="xuezh 发音反馈" />
+</Card>
+
+<Card title="WhatsApp 记忆库" icon="vault">
+  **社区** • `memory` `transcription` `indexing`
+  
+  导入完整的 WhatsApp 导出数据，转录 1000+ 条语音消息，与 git 日志交叉核对，输出关联的 Markdown 报告。
+</Card>
+
+<Card title="Karakeep 语义搜索" icon="magnifying-glass" href="https://github.com/jamesbrooksco/karakeep-semantic-search">
+  **@jamesbrooksco** • `search` `vector` `bookmarks`
+  
+  使用 Qdrant + OpenAI/Ollama 嵌入为 Karakeep 书签添加向量搜索。
+</Card>
+
+<Card title="头脑特工队 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 语音助手 ↔ OpenClaw 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/openclaw-ha-addon">
+  **@ngutman** • `homeassistant` `docker` `raspberry-pi`
+  
+  在 Home Assistant OS 上运行 OpenClaw Gateway，支持 SSH 隧道和持久化状态。
+</Card>
+
+<Card title="Home Assistant 技能" 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/openclaw/nix-openclaw">
+  **@openclaw** • `nix` `packaging` `deployment`
+  
+  开箱即用的 Nix 化 OpenClaw 配置，实现可复现部署。
+</Card>
+
+<Card title="CalDAV 日历" icon="calendar" href="https://clawhub.com/skills/caldav-calendar">
+  **ClawHub** • `calendar` `caldav` `skill`
+  
+  使用 khal/vdirsyncer 的日历技能。自托管日历集成。
+</Card>
+
+</CardGroup>
+
+## 🏠 家居与硬件
+
+<CardGroup cols={2}>
+
+<Card title="GoHome 自动化" icon="house-signal" href="https://github.com/joshp123/gohome">
+  **@joshp123** • `home` `nix` `grafana`
+  
+  以 Nix 为基础的家居自动化，OpenClaw 作为交互界面，并配有精美的 Grafana 仪表盘。
+  
+  <img src="/assets/showcase/gohome-grafana.png" alt="GoHome Grafana 仪表盘" />
+</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 状态" />
+</Card>
+
+</CardGroup>
+
+## 🌟 社区项目
+
+<CardGroup cols={2}>
+
+<Card title="StarSwap 交易市场" icon="star" href="https://star-swap.com/">
+  **社区** • `marketplace` `astronomy` `webapp`
+  
+  完整的天文设备交易市场。基于 OpenClaw 生态系统构建。
+</Card>
+
+</CardGroup>
+
+---
+
+## 提交你的项目
+
+有想要分享的内容？我们很乐意展示它！
+
+<Steps>
+  <Step title="分享它">
+    发布到 [Discord 的 #showcase 频道](https://discord.gg/clawd) 或 [在推特上 @openclaw](https://x.com/openclaw)
+  </Step>
+  <Step title="提供详细信息">
+    告诉我们它的功能，附上仓库/演示链接，如果有的话分享一张截图
+  </Step>
+  <Step title="获得展示">
+    我们会将优秀项目添加到本页面
+  </Step>
+</Steps>