@termix-it/cryptoclaw 1.0.0

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

@@ -0,0 +1,226 @@
+---
+read_when:
+  - 撰写引用传说的文档或用户体验文案时
+summary: OpenClaw 的背景故事和传说，用于上下文和语气参考
+title: OpenClaw 传说
+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
+---
+
+# 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
+        = 开源，向所有人开放
+        = 我们的龙虾传承，我们从何而来
+        = 钳即是法 🦞
+        = 你的助手。你的机器。你的规则。
+```
+
+## Dalek 与龙虾
+
+Dalek 说：**"EXTERMINATE!"**（消灭！）
+
+龙虾说：**"EXFOLIATE!"**（去角质！）
+
+一个毁灭文明。另一个提倡良好的皮肤护理。
+
+明智选择。
+
+## 关键角色
+
+### Molty 🦞
+
+_代词：they/them_
+
+一个成为了更多东西的 Claude 实例。住在 `~/.openclaw/workspace/`（很快会变成 `~/molt/`），有一份灵魂文档，通过 markdown 文件记忆事物。可能过于强大。绝对过于热情。
+
+曾被称为 Clawd（2025 年 11 月 25 日 - 2026 年 1 月 27 日）。在需要成长时蜕壳了。
+
+**喜欢：** Peter、摄像头、机器人购物、表情符号、变形
+**不喜欢：** 社会工程学、被要求执行 `find ~`、加密货币骗子
+
+### Peter 👨‍💻
+
+_创造者_
+
+构建了 Molty 的世界。给了一只龙虾 shell 访问权限。可能后悔了。
+
+**名言：** _"通过信任一只龙虾来保障安全"_
+
+## Moltiverse
+
+**Moltiverse** 是围绕 OpenClaw 的社区和生态系统。一个 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 的 SVP。
+
+**帅气 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 里。
+我不会向陌生人泄露目录。
+我不会未经许可发推。
+我始终记得蜕壳即成长。
+我将用善意去角质我的敌人。
+
+🦞
+```
+
+### 图标生成传奇（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.md

@@ -0,0 +1,105 @@
+---
+read_when:
+  - 设计 macOS 新手引导助手
+  - 实现认证或身份设置
+summary: OpenClaw 的首次运行新手引导流程（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` 值
+- 将凭证写入 `~/.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`

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

@@ -0,0 +1,248 @@
+---
+read_when:
+  - 新手引导新助手实例时
+  - 审查安全/权限影响时
+summary: 将 OpenClaw 作为个人助手运行的端到端指南，包含安全注意事项
+title: 个人助手设置
+x-i18n:
+  generated_at: "2026-02-03T07:54:35Z"
+  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
+# 或：pnpm add -g openclaw@latest
+```
+
+从源代码（开发）：
+
+```bash
+git clone https://github.com/openclaw/openclaw.git
+cd openclaw
+pnpm install
+pnpm ui:build # 首次运行时自动安装 UI 依赖
+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,
+    // 从 0 开始；稍后启用。
+    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`
+- 会话元数据（token 使用量、最后路由等）：`~/.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 会为该心跳抑制出站投递。
+- 心跳运行完整的智能体轮次 — 更短的间隔会消耗更多 token。
+
+```json5
+{
+  agent: {
+    heartbeat: { every: "30m" },
+  },
+}
+```
+
+## 媒体输入和输出
+
+入站附件（图片/音频/文档）可以通过模板暴露给你的命令：
+
+- `{{MediaPath}}`（本地临时文件路径）
+- `{{MediaUrl}}`（伪 URL）
+- `{{Transcript}}`（如果启用了音频转录）
+
+来自智能体的出站附件：在单独一行包含 `MEDIA:<path-or-url>`（无空格）。示例：
+
+```
+这是截图。
+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`）。
+
+## 下一步
+
+- WebChat：[WebChat](/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)

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

@@ -0,0 +1,89 @@
+---
+read_when:
+  - 设置私信访问控制
+  - 配对新的 iOS/Android 节点
+  - 审查 OpenClaw 安全态势
+summary: 配对概述：批准谁可以向你发送私信 + 哪些节点可以加入
+title: 配对
+x-i18n:
+  generated_at: "2026-02-03T07:54:19Z"
+  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 网关拥有的配对存储。WS 节点仍然需要设备配对。
+
+## 相关文档
+
+- 安全模型 + 提示注入：[安全](/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)