mirror of
https://github.com/farcasclaudiu/openclaw.git
synced 2026-06-29 09:02:02 +03:00
docs: canonicalize docs paths and align zh navigation (#11428)
* docs(navigation): canonicalize paths and align zh nav * chore(docs): remove stray .DS_Store * docs(scripts): add non-mint docs link audit * docs(nav): fix zh source paths and preserve legacy redirects (#11428) (thanks @sebslight) * chore(docs): satisfy lint for docs link audit script (#11428) (thanks @sebslight)
This commit is contained in:
Seb Slight
@@ -0,0 +1,9 @@
|
||||
---
|
||||
summary: 智能体引导流程：首次运行时如何初始化工作区与身份文件
|
||||
title: 智能体引导
|
||||
sidebarTitle: 引导
|
||||
---
|
||||
|
||||
# 智能体引导
|
||||
|
||||
该页面是英文文档的中文占位版本，完整内容请先参考英文版：[Agent Bootstrapping](/start/bootstrapping)。
|
||||
@@ -25,7 +25,7 @@ x-i18n:
|
||||
- [斜杠命令](/tools/slash-commands)
|
||||
- [多智能体路由](/concepts/multi-agent)
|
||||
- [更新与回滚](/install/updating)
|
||||
- [配对（私信和节点）](/start/pairing)
|
||||
- [配对（私信和节点）](/channels/pairing)
|
||||
- [Nix 模式](/install/nix)
|
||||
- [OpenClaw 助手设置](/start/openclaw)
|
||||
- [Skills](/tools/skills)
|
||||
@@ -47,8 +47,8 @@ x-i18n:
|
||||
- [Mattermost（插件）](/channels/mattermost)
|
||||
- [BlueBubbles (iMessage)](/channels/bluebubbles)
|
||||
- [iMessage（旧版）](/channels/imessage)
|
||||
- [群组](/concepts/groups)
|
||||
- [WhatsApp 群消息](/concepts/group-messages)
|
||||
- [群组](/channels/groups)
|
||||
- [WhatsApp 群消息](/channels/group-messages)
|
||||
- [媒体图片](/nodes/images)
|
||||
- [媒体音频](/nodes/audio)
|
||||
|
||||
|
||||
@@ -28,7 +28,7 @@ x-i18n:
|
||||
- 工作区引导 + Skills
|
||||
- 可选的后台服务
|
||||
|
||||
如果你想要更深入的参考页面，跳转到：[向导](/start/wizard)、[设置](/start/setup)、[配对](/start/pairing)、[安全](/gateway/security)。
|
||||
如果你想要更深入的参考页面，跳转到：[向导](/start/wizard)、[设置](/start/setup)、[配对](/channels/pairing)、[安全](/gateway/security)。
|
||||
|
||||
沙箱注意事项：`agents.defaults.sandbox.mode: "non-main"` 使用 `session.mainKey`（默认 `"main"`），因此群组/渠道会话会被沙箱隔离。如果你想要主智能体始终在主机上运行，设置显式的每智能体覆盖：
|
||||
|
||||
@@ -162,7 +162,7 @@ openclaw pairing list whatsapp
|
||||
openclaw pairing approve whatsapp <code>
|
||||
```
|
||||
|
||||
配对文档：[配对](/start/pairing)
|
||||
配对文档：[配对](/channels/pairing)
|
||||
|
||||
## 从源代码（开发）
|
||||
|
||||
|
||||
@@ -64,9 +64,9 @@ x-i18n:
|
||||
- [在线状态](/concepts/presence)
|
||||
- [设备发现 + 传输协议](/gateway/discovery)
|
||||
- [Bonjour](/gateway/bonjour)
|
||||
- [渠道路由](/concepts/channel-routing)
|
||||
- [群组](/concepts/groups)
|
||||
- [群组消息](/concepts/group-messages)
|
||||
- [渠道路由](/channels/channel-routing)
|
||||
- [群组](/channels/groups)
|
||||
- [群组消息](/channels/group-messages)
|
||||
- [模型故障转移](/concepts/model-failover)
|
||||
- [OAuth](/concepts/oauth)
|
||||
|
||||
@@ -121,7 +121,7 @@ x-i18n:
|
||||
- [模型](/concepts/models)
|
||||
- [子智能体](/tools/subagents)
|
||||
- [Agent send CLI](/tools/agent-send)
|
||||
- [终端界面](/tui)
|
||||
- [终端界面](/web/tui)
|
||||
- [浏览器控制](/tools/browser)
|
||||
- [浏览器（Linux 故障排除）](/tools/browser-linux-troubleshooting)
|
||||
- [轮询](/automation/poll)
|
||||
|
||||
@@ -1,89 +0,0 @@
|
||||
---
|
||||
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)
|
||||
Reference in New Issue
Block a user