mslclaw

---
name: openclaw-doc-finder
description: OpenClaw 官方文档检索专家。

**触发条件（满足任一即可）：**
1. 用户提到"官方文档"、"官方文档技能"、"查官方文档"、"openclaw 文档"
2. 问题涉及 OpenClaw 本身（配置、使用、问题、文档），且需要查找官方文档或获取精确命令/配置片段

**激活典型场景：**
- 用户询问 openclaw 配置、命令、参数
- 用户遇到 openclaw 报错并需要排查
- 用户提到"官方文档"或想查看官方说明
- 用户询问 gateway、channels、plugins 的配置
- 用户询问 openclaw CLI 命令用法
- 用户询问模型/供应商配置方法
- 用户询问 VPS/远程/节点部署方案

**不触发场景（排除）：**
- 仅在对话中提到"openclaw"但实际问的是其他平台功能
- 用户需要执行操作而非查找文档（如直接帮用户配置、发送消息）
- 问题属于飞书、Telegram、Discord 等第三方平台的具体用法（应路由到对应技能）
- "帮我创建日程" → feishu-calendar，不触发
- "帮我发消息" → 消息工具，不触发
- "帮我搜索网页" → agent-reach，不触发

**英文触发：** how do I configure X / why is Y broken / how to set up Z / openclaw docs / openclaw documentation
---

# openclaw-doc-finder

OpenClaw 官方文档检索技能。识别用户意图，路由到正确文档，给出精确 URL + 关键命令片段。

## 检索流程（Pipeline）

```
用户问题 → 意图识别 → 诊断决策树（可选）→ 文档路由 → 本地片段 → 缓存命中 → 远程拉取 → 回答 → 记录速查
```

**严格顺序，不得跳步：**

1. **意图识别**：解析用户问题，判断属于哪个场景类别
2. **诊断决策树**（可选）：如问题模糊（"任务卡住"、"没有反应"），先用 `references/diagnostic-tree.md` 引导用户细化
3. **文档路由**：查 `references/doc-index.md` 定位目标文档列表
4. **本地片段优先**：检查 `references/` 已有片段
5. **缓存命中**：检查 `references/fetched/<doc-name>.md` 是否已有缓存且未过期（7 天内）
6. **远程拉取**：本地/缓存均无 → 按"远程拉取规则"拉取，成功后自动缓存
7. **版本检查**：回答结尾检查 VERSION
8. **记录速查**：将问题与结论追加到 `references/doc-lookups.md`

---

## 意图识别规则

见 `references/doc-index.md` 的「意图→文档路由表」。优先精确匹配场景关键词。

常见场景映射：

| 场景 | 目标文档 |
|------|---------|
| 首次安装 / 开始上手 | `start/getting-started.md` / `start/quickstart.md` |
| gateway 配置 / 配置文件 | `gateway/configuration.md` |
| gateway 配置项详解 | `gateway/configuration-reference.md` |
| 通道接入（Discord/Telegram/飞书等） | `channels/index.md` + 对应通道文档 |
| 技能安装 / clawhub / skillhub | `tools/clawhub` 或 `start/hubs.md` |
| 故障排除 / 报错 | `gateway/troubleshooting.md` / `channels/troubleshooting.md` |
| 凭证 / secrets / API key | `gateway/secrets.md` |
| 模型配置 / 供应商 | `providers/` 目录 + `gateway/configuration.md` |
| CLI 命令用法 | `cli/` 目录 |
| openclaw doctor | `gateway/doctor.md` |
| 安全策略 / 权限 | `gateway/security/` + `gateway/sandboxing.md` |
| 远程访问 / VPS 部署 | `gateway/remote.md` + `vps.md` |
| 心跳 / 自动化任务 | `gateway/heartbeat.md` + `cron-jobs` |
| 节点配对 / 移动端 | `nodes/` 目录 |
| 任务阻塞 / 队列 / 并发 | `concepts/queue.md` + `references/diagnostic-tree.md` |

---

## 本地片段优先级

- `references/doc-index.md` — 始终可用，路由总表
- `references/diagnostic-tree.md` — **新增**"症状→排查路径"决策树
- `references/config-guide.md` — gateway 配置高频片段
- `references/troubleshoot.md` — 常见报错速查
- `references/doc-lookups.md` — 已查阅问题速查（查阅前优先检查）
- `references/fetched/<doc-name>.md` — **新增**已缓存的远程文档（7 天有效期）

---

## 远程拉取规则

### 拉取顺序（降级策略）

当本地和缓存均无目标内容时，按以下顺序尝试：

```
1. web_fetch
   ↓ 失败（Blocked / 网络错误）
2. firecrawl_scrape
   ↓ 失败（Blocked / 超时）
3. exec → curl（最终兜底）
   ↓ 失败
4. 提供手动查询链接
```

### curl 降级命令模板

```bash
# 文档 URL 格式：https://docs.openclaw.ai/<path>
# 用 curl 拉取并提取正文（去除 HTML 标签）
curl -sL "<完整URL>" | python3 -c "
import sys, re
html = sys.stdin.read()
html = re.sub(r'<script[^>]*>.*?</script>', '', html, flags=re.DOTALL)
html = re.sub(r'<style[^>]*>.*?</style>', '', html, flags=re.DOTALL)
text = re.sub(r'<[^>]+>', ' ', html)
text = re.sub(r'&nbsp;', ' ', text)
text = re.sub(r'\s+', ' ', text).strip()
# 提取核心内容（从第一个段落开始）
idx = text.find('。') if '。' in text else text.find('. ')
if idx > 0: print(text[idx:idx+3000])
"
```

### 自动缓存规则

- **缓存目录**：`references/fetched/`
- **命名规范**：`<doc-name>.<timestamp>.md>`（如 `queue.20260405.md`）
- **有效期**：7 天（自动清理过期缓存）
- **写入时机**：远程拉取成功后立即写入

### 无法拉取时的兜底

如三种方式均失败，回答格式：

> ⚠️ 无法自动拉取文档（网络限制）。请手动查看：
> - 文档地址：https://docs.openclaw.ai/<path>
> - 文档站搜索：https://docs.openclaw.ai/search?q=<关键词>

---

## 版本管理

- 版本文件：`VERSION`（语义化版本，格式 v1.0.0）
- **每次更新 `references/` 内容，必须同步更新 VERSION**
- 大版本更新（文档 breaking changes）：主版本号 +1，并记录 CHANGELOG

### 版本同步策略（优化）

**不要**在每次回答前都运行 sync-version.py（开销太大）。

**正确做法**：
- 技能初始化时检查一次（后台静默执行）
- 用户手动触发：`/openclaw_doc_finder_check`
- OpenClaw 大版本升级后主动提醒

```bash
# 手动触发版本同步（干跑）
python3 scripts/sync-version.py --dry-run

# 执行同步
python3 scripts/sync-version.py
```

---

## 输出格式规范

回答**必须**包含：
1. **文档标题** + **完整 URL**（`https://docs.openclaw.ai/<path>`）
2. **关键命令**（从文档中提取的 CLI 命令，用 ```bash 包裹）
3. **配置片段**（关键配置项示例）
4. **版本提示**（如已拉取最新内容，提醒技能版本）

**当无法拉取时**：
```
⚠️ 无法自动拉取文档。请手动查看：
- https://docs.openclaw.ai/<path>
```

**当问题模糊时**（先用决策树引导）：
```
在给出具体文档之前，我需要先确认一下：
[引用 diagnostic-tree.md 中的关键问题]
```

禁止：
- 不带 URL 的泛泛回答
- 混用多个不相关的文档链接

---

## 速查记录规则

每次使用本技能查询文档后，**必须**将问题与结论追加到 `references/doc-lookups.md`：
- 已有相同问题记录 → 更新对应条目而非重复追加
- 新问题 → 在对应分类下按格式追加
- 记录内容：问题、官方结论、相关文档路径、查阅时间
- 这样下次遇到同类问题时可**直接复用**，无需重复查阅

---

## CHANGELOG

### v1.2.0
- 新增：远程拉取降级策略（web_fetch → firecrawl → curl）
- 新增：自动缓存机制（references/fetched/，7 天有效期）
- 新增：诊断决策树（references/diagnostic-tree.md）
- 优化：版本同步改为手动触发，不再每次回答前执行
- 新增：无法拉取时的兜底说明

### v1.1.0
- 优化触发条件：增加主条件+排除场景结构
- 提升激活准确性，防止误触发其他专业技能场景

FILE:references/config-guide.md
# Gateway 配置指南片段

> 摘录自 `gateway/configuration.md` + `gateway/configuration-reference.md`

---

## 配置文件位置

- **主配置**：`~/.openclaw/openclaw.json`
- **环境变量**：`.env` 文件（加载顺序优先级最高）
- **Skills 配置**：`~/.openclaw/skills/<skill-name>/config.yaml`

---

## openclaw.json 核心结构

```json
{
  "gateway": {
    "host": "127.0.0.1",
    "port": 18789,
    "auth": {
      "type": "token",
      "token": "<48-hex-token>"
    }
  },
  "agents": {
    "defaults": {
      "models": ["anthropic/claude-sonnet-4-7"]
    }
  },
  "channels": {
    "discord": {
      "enabled": true,
      "token": "<bot-token>"
    }
  }
}
```

---

## 关键配置项

### Gateway Host/Port

```bash
# 查看当前配置
openclaw config get gateway.host
openclaw config get gateway.port

# 修改
openclaw config set gateway.host 0.0.0.0
openclaw config set gateway.port 18789
```

### 认证 Token

```bash
# 生成新 token
openclaw gateway token --length 48

# 查看当前 token
openclaw config get gateway.auth.token
```

### 模型配置

```bash
# 查看可用模型
openclaw models list

# 设置默认模型
openclaw config set agents.defaults.models '["anthropic/claude-sonnet-4-7"]'

# 设置回退模型
openclaw config set agents.defaults.fallback '["openai/gpt-4o"]'
```

### 通道启用

```bash
# 查看已配置通道
openclaw channels status

# 探活所有通道
openclaw channels status --probe
```

---

## 配置验证

```bash
# 启动前验证配置
openclaw doctor

# 启动 gateway
openclaw gateway start

# 查看运行状态
openclaw gateway status
```

---

## Skill 配置

```bash
# 查看 skills 配置
openclaw skills list

# 查看 skill 详情
openclaw skills get <skill-name>
```

---

## 环境变量配置（.env）

```bash
# 常用环境变量
OPENCLAW_HOST=127.0.0.1
OPENCLAW_PORT=18789
OPENCLAW_GATEWAY_TOKEN=<token>
ANTHROPIC_API_KEY=sk-...
OPENAI_API_KEY=sk-...
```

---

## 配置示例

完整配置示例见：`https://docs.openclaw.ai/gateway/configuration-examples`

常见场景：
- [单通道最小配置](https://docs.openclaw.ai/gateway/configuration-examples#minimal)
- [多通道配置](https://docs.openclaw.ai/gateway/configuration-examples#multi-channel)
- [远程访问配置](https://docs.openclaw.ai/gateway/configuration-examples#remote)

FILE:references/diagnostic-tree.md
# OpenClaw 问题诊断决策树

> 基于官方文档构建的"症状 → 排查路径"速查

---

## 决策树

```
用户报告问题
    │
    ├─ 说"任务卡住" / "没有反应"
    │       │
    │       ├─ 先问：是什么类型的任务？
    │       │   ├─ cron 任务 → gateway/heartbeat.md + automation/cron-jobs.md
    │       │   ├─ heartbeat → gateway/heartbeat.md
    │       │   ├─ 子代理任务 → tools/subagents.md + concepts/queue.md
    │       │   └─ 手动触发 → concepts/agent-loop.md
    │       │
    │       └─ 排查命令：
    │           openclaw logs --follow
    │           openclaw sessions list
    │           → 找 "queued for …ms" 确认队列是否在 drain
    │
    ├─ 消息队列相关
    │       │
    │       ├─ 配置项：messages.queue（见下方配置片段）
    │       ├─ 文档：concepts/queue.md
    │       └─ 常见问题：
    │           Q: 消息堆积 → 检查 debounceMs / cap
    │           Q: 响应延迟 → 检查 main lane 并发是否耗尽
    │           Q: 消息丢失 → 检查 drop 策略（默认 summarize）
    │
    ├─ 配置问题
    │       │
    │       ├─ openclaw config get messages.queue
    │       ├─ openclaw config get agents.defaults.maxConcurrent
    │       └─ 文档：gateway/configuration.md
    │
    ├─ 报错类
    │       │
    │       ├─ 429 / rate limit → providers/<name>.md
    │       ├─ 401/403 凭证 → gateway/secrets.md
    │       ├─ 连接失败 → channels/troubleshooting.md
    │       └─ 执行阻塞 → concepts/agent-loop.md + concepts/queue.md
    │
    └─ 性能/并发问题
            │
            ├─ openclaw config get agents.defaults.maxConcurrent
            ├─ 默认值：main=4, subagent=8, 其他=1
            └─ 文档：concepts/queue.md
```

---

## 消息队列配置片段

```json
{
  "messages": {
    "queue": {
      "mode": "collect",
      "debounceMs": 1000,
      "cap": 20,
      "drop": "summarize",
      "byChannel": {
        "discord": "collect"
      }
    }
  }
}
```

**关键参数说明：**
- `debounceMs`: 等待静默时间，防止"continue, continue"
- `cap`: 每 session 最大排队数（默认 20）
- `drop`: 溢出策略（old/new/summarize）
- `mode`: collect/steer/followup/steer-backlog

---

## 排查命令速查

```bash
# 队列状态
openclaw logs --follow 2>&1 | grep "queued for"

# Session 列表
openclaw sessions list

# 并发配置
openclaw config get agents.defaults.maxConcurrent

# 队列配置
openclaw config get messages.queue

# Gateway 状态
openclaw gateway status
openclaw doctor
```

FILE:references/doc-index.md
# OpenClaw 文档索引

> ⚠️ **自动生成** — OpenClaw v2026.3.13 | 生成时间：自动

## 意图 → 文档路由表

| 场景关键词 | 文档标题 | 完整 URL | 本地路径 |
|----------|---------|---------|---------|
| ... | Auth Credential Semantics | https://docs.openclaw.ai/auth-credential-semantics | auth-credential-semantics.md |
| ... | Auth Monitoring | https://docs.openclaw.ai/automation/auth-monitoring | automation/auth-monitoring.md |
| ... | Cron Jobs | https://docs.openclaw.ai/automation/cron-jobs | automation/cron-jobs.md |
| ... | Cron vs Heartbeat | https://docs.openclaw.ai/automation/cron-vs-heartbeat | automation/cron-vs-heartbeat.md |
| ... | Gmail PubSub | https://docs.openclaw.ai/automation/gmail-pubsub | automation/gmail-pubsub.md |
| ... | Hooks | https://docs.openclaw.ai/automation/hooks | automation/hooks.md |
| ... | Polls | https://docs.openclaw.ai/automation/poll | automation/poll.md |
| ... | Automation Troubleshooting | https://docs.openclaw.ai/automation/troubleshooting | automation/troubleshooting.md |
| ... | Webhooks | https://docs.openclaw.ai/automation/webhook | automation/webhook.md |
| ... | Brave Search | https://docs.openclaw.ai/brave-search | brave-search.md |
| ... | BlueBubbles | https://docs.openclaw.ai/channels/bluebubbles | channels/bluebubbles.md |
| ... | Broadcast Groups | https://docs.openclaw.ai/channels/broadcast-groups | channels/broadcast-groups.md |
| ... | Channel Routing | https://docs.openclaw.ai/channels/channel-routing | channels/channel-routing.md |
| ... | Discord | https://docs.openclaw.ai/channels/discord | channels/discord.md |
| ... | Feishu | https://docs.openclaw.ai/channels/feishu | channels/feishu.md |
| ... | Google Chat | https://docs.openclaw.ai/channels/googlechat | channels/googlechat.md |
| ... | Group Messages | https://docs.openclaw.ai/channels/group-messages | channels/group-messages.md |
| ... | Groups | https://docs.openclaw.ai/channels/groups | channels/groups.md |
| ... | iMessage | https://docs.openclaw.ai/channels/imessage | channels/imessage.md |
| ... | IRC | https://docs.openclaw.ai/channels/irc | channels/irc.md |
| ... | LINE | https://docs.openclaw.ai/channels/line | channels/line.md |
| ... | Channel Location Parsing | https://docs.openclaw.ai/channels/location | channels/location.md |
| ... | Matrix | https://docs.openclaw.ai/channels/matrix | channels/matrix.md |
| ... | Mattermost | https://docs.openclaw.ai/channels/mattermost | channels/mattermost.md |
| ... | Microsoft Teams | https://docs.openclaw.ai/channels/msteams | channels/msteams.md |
| ... | Nextcloud Talk | https://docs.openclaw.ai/channels/nextcloud-talk | channels/nextcloud-talk.md |
| ... | Nostr | https://docs.openclaw.ai/channels/nostr | channels/nostr.md |
| ... | Pairing | https://docs.openclaw.ai/channels/pairing | channels/pairing.md |
| ... | Signal | https://docs.openclaw.ai/channels/signal | channels/signal.md |
| ... | Slack | https://docs.openclaw.ai/channels/slack | channels/slack.md |
| ... | Synology Chat | https://docs.openclaw.ai/channels/synology-chat | channels/synology-chat.md |
| ... | Telegram | https://docs.openclaw.ai/channels/telegram | channels/telegram.md |
| ... | Tlon | https://docs.openclaw.ai/channels/tlon | channels/tlon.md |
| ... | Channel Troubleshooting | https://docs.openclaw.ai/channels/troubleshooting | channels/troubleshooting.md |
| ... | Twitch | https://docs.openclaw.ai/channels/twitch | channels/twitch.md |
| ... | WhatsApp | https://docs.openclaw.ai/channels/whatsapp | channels/whatsapp.md |
| ... | Zalo | https://docs.openclaw.ai/channels/zalo | channels/zalo.md |
| ... | Zalo Personal | https://docs.openclaw.ai/channels/zalouser | channels/zalouser.md |
| ... | CI Pipeline | https://docs.openclaw.ai/ci | ci.md |
| ... | acp | https://docs.openclaw.ai/cli/acp | cli/acp.md |
| ... | agent | https://docs.openclaw.ai/cli/agent | cli/agent.md |
| ... | agents | https://docs.openclaw.ai/cli/agents | cli/agents.md |
| ... | approvals | https://docs.openclaw.ai/cli/approvals | cli/approvals.md |
| ... | backup | https://docs.openclaw.ai/cli/backup | cli/backup.md |
| ... | browser | https://docs.openclaw.ai/cli/browser | cli/browser.md |
| ... | channels | https://docs.openclaw.ai/cli/channels | cli/channels.md |
| ... | clawbot | https://docs.openclaw.ai/cli/clawbot | cli/clawbot.md |
| ... | completion | https://docs.openclaw.ai/cli/completion | cli/completion.md |
| ... | config | https://docs.openclaw.ai/cli/config | cli/config.md |
| ... | configure | https://docs.openclaw.ai/cli/configure | cli/configure.md |
| ... | cron | https://docs.openclaw.ai/cli/cron | cli/cron.md |
| ... | daemon | https://docs.openclaw.ai/cli/daemon | cli/daemon.md |
| ... | dashboard | https://docs.openclaw.ai/cli/dashboard | cli/dashboard.md |
| ... | devices | https://docs.openclaw.ai/cli/devices | cli/devices.md |
| ... | directory | https://docs.openclaw.ai/cli/directory | cli/directory.md |
| ... | dns | https://docs.openclaw.ai/cli/dns | cli/dns.md |
| ... | docs | https://docs.openclaw.ai/cli/docs | cli/docs.md |
| ... | doctor | https://docs.openclaw.ai/cli/doctor | cli/doctor.md |
| ... | gateway | https://docs.openclaw.ai/cli/gateway | cli/gateway.md |
| ... | health | https://docs.openclaw.ai/cli/health | cli/health.md |
| ... | hooks | https://docs.openclaw.ai/cli/hooks | cli/hooks.md |
| ... | logs | https://docs.openclaw.ai/cli/logs | cli/logs.md |
| ... | memory | https://docs.openclaw.ai/cli/memory | cli/memory.md |
| ... | message | https://docs.openclaw.ai/cli/message | cli/message.md |
| ... | models | https://docs.openclaw.ai/cli/models | cli/models.md |
| ... | node | https://docs.openclaw.ai/cli/node | cli/node.md |
| ... | nodes | https://docs.openclaw.ai/cli/nodes | cli/nodes.md |
| ... | onboard | https://docs.openclaw.ai/cli/onboard | cli/onboard.md |
| ... | pairing | https://docs.openclaw.ai/cli/pairing | cli/pairing.md |
| ... | plugins | https://docs.openclaw.ai/cli/plugins | cli/plugins.md |
| ... | qr | https://docs.openclaw.ai/cli/qr | cli/qr.md |
| ... | reset | https://docs.openclaw.ai/cli/reset | cli/reset.md |
| ... | Sandbox CLI | https://docs.openclaw.ai/cli/sandbox | cli/sandbox.md |
| ... | secrets | https://docs.openclaw.ai/cli/secrets | cli/secrets.md |
| ... | security | https://docs.openclaw.ai/cli/security | cli/security.md |
| ... | sessions | https://docs.openclaw.ai/cli/sessions | cli/sessions.md |
| ... | setup | https://docs.openclaw.ai/cli/setup | cli/setup.md |
| ... | skills | https://docs.openclaw.ai/cli/skills | cli/skills.md |
| ... | status | https://docs.openclaw.ai/cli/status | cli/status.md |
| ... | system | https://docs.openclaw.ai/cli/system | cli/system.md |
| ... | tui | https://docs.openclaw.ai/cli/tui | cli/tui.md |
| ... | uninstall | https://docs.openclaw.ai/cli/uninstall | cli/uninstall.md |
| ... | update | https://docs.openclaw.ai/cli/update | cli/update.md |
| ... | voicecall | https://docs.openclaw.ai/cli/voicecall | cli/voicecall.md |
| ... | webhooks | https://docs.openclaw.ai/cli/webhooks | cli/webhooks.md |
| ... | Agent Loop | https://docs.openclaw.ai/concepts/agent-loop | concepts/agent-loop.md |
| ... | Agent Workspace | https://docs.openclaw.ai/concepts/agent-workspace | concepts/agent-workspace.md |
| ... | Agent Runtime | https://docs.openclaw.ai/concepts/agent | concepts/agent.md |
| ... | Gateway Architecture | https://docs.openclaw.ai/concepts/architecture | concepts/architecture.md |
| ... | Compaction | https://docs.openclaw.ai/concepts/compaction | concepts/compaction.md |
| ... | Context | https://docs.openclaw.ai/concepts/context | concepts/context.md |
| ... | Features | https://docs.openclaw.ai/concepts/features | concepts/features.md |
| ... | Markdown Formatting | https://docs.openclaw.ai/concepts/markdown-formatting | concepts/markdown-formatting.md |
| ... | Memory | https://docs.openclaw.ai/concepts/memory | concepts/memory.md |
| ... | Messages | https://docs.openclaw.ai/concepts/messages | concepts/messages.md |
| ... | Model Failover | https://docs.openclaw.ai/concepts/model-failover | concepts/model-failover.md |
| ... | Model Providers | https://docs.openclaw.ai/concepts/model-providers | concepts/model-providers.md |
| ... | Models CLI | https://docs.openclaw.ai/concepts/models | concepts/models.md |
| ... | Multi-Agent Routing | https://docs.openclaw.ai/concepts/multi-agent | concepts/multi-agent.md |
| ... | OAuth | https://docs.openclaw.ai/concepts/oauth | concepts/oauth.md |
| ... | Presence | https://docs.openclaw.ai/concepts/presence | concepts/presence.md |
| ... | Command Queue | https://docs.openclaw.ai/concepts/queue | concepts/queue.md |
| ... | Retry Policy | https://docs.openclaw.ai/concepts/retry | concepts/retry.md |
| ... | Session Pruning | https://docs.openclaw.ai/concepts/session-pruning | concepts/session-pruning.md |
| ... | Session Tools | https://docs.openclaw.ai/concepts/session-tool | concepts/session-tool.md |
| ... | Session Management | https://docs.openclaw.ai/concepts/session | concepts/session.md |
| ... | Streaming and Chunking | https://docs.openclaw.ai/concepts/streaming | concepts/streaming.md |
| ... | System Prompt | https://docs.openclaw.ai/concepts/system-prompt | concepts/system-prompt.md |
| ... | Timezones | https://docs.openclaw.ai/concepts/timezone | concepts/timezone.md |
| ... | TypeBox | https://docs.openclaw.ai/concepts/typebox | concepts/typebox.md |
| ... | Typing Indicators | https://docs.openclaw.ai/concepts/typing-indicators | concepts/typing-indicators.md |
| ... | Usage Tracking | https://docs.openclaw.ai/concepts/usage-tracking | concepts/usage-tracking.md |
| ... | Date and Time | https://docs.openclaw.ai/date-time | date-time.md |
| ... | Node + tsx Crash | https://docs.openclaw.ai/debug/node-issue | debug/node-issue.md |
| ... | Kilo Gateway Integration | https://docs.openclaw.ai/design/kilo-gateway-integration | design/kilo-gateway-integration.md |
| ... | Diagnostics Flags | https://docs.openclaw.ai/diagnostics/flags | diagnostics/flags.md |
| ... | Onboarding and Config Protocol | https://docs.openclaw.ai/experiments/onboarding-config-protocol | experiments/onboarding-config-protocol.md |
| ... | Acp Persistent Bindings Discord Channels Telegram Topics | https://docs.openclaw.ai/experiments/plans/acp-persistent-bindings-discord-channels-telegram-topics | experiments/plans/acp-persistent-bindings-discord-channels-telegram-topics.md |
| ... | ACP Thread Bound Agents | https://docs.openclaw.ai/experiments/plans/acp-thread-bound-agents | experiments/plans/acp-thread-bound-agents.md |
| ... | Unified Runtime Streaming Refactor Plan | https://docs.openclaw.ai/experiments/plans/acp-unified-streaming-refactor | experiments/plans/acp-unified-streaming-refactor.md |
| ... | Browser Evaluate CDP Refactor | https://docs.openclaw.ai/experiments/plans/browser-evaluate-cdp-refactor | experiments/plans/browser-evaluate-cdp-refactor.md |
| ... | Discord Async Inbound Worker Plan | https://docs.openclaw.ai/experiments/plans/discord-async-inbound-worker | experiments/plans/discord-async-inbound-worker.md |
| ... | OpenResponses Gateway Plan | https://docs.openclaw.ai/experiments/plans/openresponses-gateway | experiments/plans/openresponses-gateway.md |
| ... | PTY and Process Supervision Plan | https://docs.openclaw.ai/experiments/plans/pty-process-supervision | experiments/plans/pty-process-supervision.md |
| ... | Session Binding Channel Agnostic Plan | https://docs.openclaw.ai/experiments/plans/session-binding-channel-agnostic | experiments/plans/session-binding-channel-agnostic.md |
| ... | ACP Bound Command Authorization (Proposal) | https://docs.openclaw.ai/experiments/proposals/acp-bound-command-auth | experiments/proposals/acp-bound-command-auth.md |
| ... | Model Config Exploration | https://docs.openclaw.ai/experiments/proposals/model-config | experiments/proposals/model-config.md |
| ... | Workspace Memory Research | https://docs.openclaw.ai/experiments/research/memory | experiments/research/memory.md |
| ... | Authentication | https://docs.openclaw.ai/gateway/authentication | gateway/authentication.md |
| ... | Background Exec and Process Tool | https://docs.openclaw.ai/gateway/background-process | gateway/background-process.md |
| ... | Bonjour Discovery | https://docs.openclaw.ai/gateway/bonjour | gateway/bonjour.md |
| ... | Bridge Protocol | https://docs.openclaw.ai/gateway/bridge-protocol | gateway/bridge-protocol.md |
| ... | CLI Backends | https://docs.openclaw.ai/gateway/cli-backends | gateway/cli-backends.md |
| ... | Configuration Examples | https://docs.openclaw.ai/gateway/configuration-examples | gateway/configuration-examples.md |
| ... | Configuration Reference | https://docs.openclaw.ai/gateway/configuration-reference | gateway/configuration-reference.md |
| ... | Configuration | https://docs.openclaw.ai/gateway/configuration | gateway/configuration.md |
| ... | Discovery and Transports | https://docs.openclaw.ai/gateway/discovery | gateway/discovery.md |
| ... | Doctor | https://docs.openclaw.ai/gateway/doctor | gateway/doctor.md |
| ... | Gateway Lock | https://docs.openclaw.ai/gateway/gateway-lock | gateway/gateway-lock.md |
| ... | Health Checks | https://docs.openclaw.ai/gateway/health | gateway/health.md |
| ... | Heartbeat | https://docs.openclaw.ai/gateway/heartbeat | gateway/heartbeat.md |
| ... | Local Models | https://docs.openclaw.ai/gateway/local-models | gateway/local-models.md |
| ... | Logging | https://docs.openclaw.ai/gateway/logging | gateway/logging.md |
| ... | Multiple Gateways | https://docs.openclaw.ai/gateway/multiple-gateways | gateway/multiple-gateways.md |
| ... | Network model | https://docs.openclaw.ai/gateway/network-model | gateway/network-model.md |
| ... | OpenAI Chat Completions | https://docs.openclaw.ai/gateway/openai-http-api | gateway/openai-http-api.md |
| ... | OpenResponses API | https://docs.openclaw.ai/gateway/openresponses-http-api | gateway/openresponses-http-api.md |
| ... | Gateway-Owned Pairing | https://docs.openclaw.ai/gateway/pairing | gateway/pairing.md |
| ... | Gateway Protocol | https://docs.openclaw.ai/gateway/protocol | gateway/protocol.md |
| ... | Remote Gateway Setup | https://docs.openclaw.ai/gateway/remote-gateway-readme | gateway/remote-gateway-readme.md |
| ... | Remote Access | https://docs.openclaw.ai/gateway/remote | gateway/remote.md |
| ... | Sandbox vs Tool Policy vs Elevated | https://docs.openclaw.ai/gateway/sandbox-vs-tool-policy-vs-elevated | gateway/sandbox-vs-tool-policy-vs-elevated.md |
| ... | Sandboxing | https://docs.openclaw.ai/gateway/sandboxing | gateway/sandboxing.md |
| ... | Secrets Apply Plan Contract | https://docs.openclaw.ai/gateway/secrets-plan-contract | gateway/secrets-plan-contract.md |
| ... | Secrets Management | https://docs.openclaw.ai/gateway/secrets | gateway/secrets.md |
| ... | Tailscale | https://docs.openclaw.ai/gateway/tailscale | gateway/tailscale.md |
| ... | Tools Invoke API | https://docs.openclaw.ai/gateway/tools-invoke-http-api | gateway/tools-invoke-http-api.md |
| ... | Troubleshooting | https://docs.openclaw.ai/gateway/troubleshooting | gateway/troubleshooting.md |
| ... | Trusted Proxy Auth | https://docs.openclaw.ai/gateway/trusted-proxy-auth | gateway/trusted-proxy-auth.md |
| ... | Debugging | https://docs.openclaw.ai/help/debugging | help/debugging.md |
| ... | Environment Variables | https://docs.openclaw.ai/help/environment | help/environment.md |
| ... | FAQ | https://docs.openclaw.ai/help/faq | help/faq.md |
| ... | Scripts | https://docs.openclaw.ai/help/scripts | help/scripts.md |
| ... | Testing | https://docs.openclaw.ai/help/testing | help/testing.md |
| ... | Troubleshooting | https://docs.openclaw.ai/help/troubleshooting | help/troubleshooting.md |
| ... | Ansible | https://docs.openclaw.ai/install/ansible | install/ansible.md |
| ... | Bun (Experimental) | https://docs.openclaw.ai/install/bun | install/bun.md |
| ... | Development Channels | https://docs.openclaw.ai/install/development-channels | install/development-channels.md |
| ... | Docker VM Runtime | https://docs.openclaw.ai/install/docker-vm-runtime | install/docker-vm-runtime.md |
| ... | Docker | https://docs.openclaw.ai/install/docker | install/docker.md |
| ... | exe.dev | https://docs.openclaw.ai/install/exe-dev | install/exe-dev.md |
| ... | Fly.io | https://docs.openclaw.ai/install/fly | install/fly.md |
| ... | GCP | https://docs.openclaw.ai/install/gcp | install/gcp.md |
| ... | Hetzner | https://docs.openclaw.ai/install/hetzner | install/hetzner.md |
| ... | Installer Internals | https://docs.openclaw.ai/install/installer | install/installer.md |
| ... | Kubernetes | https://docs.openclaw.ai/install/kubernetes | install/kubernetes.md |
| ... | macOS VMs | https://docs.openclaw.ai/install/macos-vm | install/macos-vm.md |
| ... | Migration Guide | https://docs.openclaw.ai/install/migrating | install/migrating.md |
| ... | Nix | https://docs.openclaw.ai/install/nix | install/nix.md |
| ... | Node.js | https://docs.openclaw.ai/install/node | install/node.md |
| ... | Podman | https://docs.openclaw.ai/install/podman | install/podman.md |
| ... | Uninstall | https://docs.openclaw.ai/install/uninstall | install/uninstall.md |
| ... | Updating | https://docs.openclaw.ai/install/updating | install/updating.md |
| ... | はじめに | https://docs.openclaw.ai/ja-JP/start/getting-started | ja-JP/start/getting-started.md |
| ... | オンボーディングウィザード（CLI） | https://docs.openclaw.ai/ja-JP/start/wizard | ja-JP/start/wizard.md |
| ... | Logging | https://docs.openclaw.ai/gateway/logging | logging.md |
| ... | Network | https://docs.openclaw.ai/network | network.md |
| ... | Audio and Voice Notes | https://docs.openclaw.ai/nodes/audio | nodes/audio.md |
| ... | Camera Capture | https://docs.openclaw.ai/nodes/camera | nodes/camera.md |
| ... | Image and Media Support | https://docs.openclaw.ai/nodes/images | nodes/images.md |
| ... | Location Command | https://docs.openclaw.ai/nodes/location-command | nodes/location-command.md |
| ... | Media Understanding | https://docs.openclaw.ai/nodes/media-understanding | nodes/media-understanding.md |
| ... | Talk Mode | https://docs.openclaw.ai/nodes/talk | nodes/talk.md |
| ... | Node Troubleshooting | https://docs.openclaw.ai/nodes/troubleshooting | nodes/troubleshooting.md |
| ... | Voice Wake | https://docs.openclaw.ai/nodes/voicewake | nodes/voicewake.md |
| ... | Perplexity Search | https://docs.openclaw.ai/perplexity | perplexity.md |
| ... | Pi Development Workflow | https://docs.openclaw.ai/pi-dev | pi-dev.md |
| ... | Pi Integration Architecture | https://docs.openclaw.ai/pi | pi.md |
| ... | Android App | https://docs.openclaw.ai/platforms/android | platforms/android.md |
| ... | DigitalOcean | https://docs.openclaw.ai/platforms/digitalocean | platforms/digitalocean.md |
| ... | iOS App | https://docs.openclaw.ai/platforms/ios | platforms/ios.md |
| ... | Linux App | https://docs.openclaw.ai/platforms/linux | platforms/linux.md |
| ... | Gateway on macOS | https://docs.openclaw.ai/platforms/mac/bundled-gateway | platforms/mac/bundled-gateway.md |
| ... | Canvas | https://docs.openclaw.ai/platforms/mac/canvas | platforms/mac/canvas.md |
| ... | Gateway Lifecycle | https://docs.openclaw.ai/platforms/mac/child-process | platforms/mac/child-process.md |
| ... | macOS Dev Setup | https://docs.openclaw.ai/platforms/mac/dev-setup | platforms/mac/dev-setup.md |
| ... | Health Checks | https://docs.openclaw.ai/platforms/mac/health | platforms/mac/health.md |
| ... | Menu Bar Icon | https://docs.openclaw.ai/platforms/mac/icon | platforms/mac/icon.md |
| ... | macOS Logging | https://docs.openclaw.ai/platforms/mac/logging | platforms/mac/logging.md |
| ... | Menu Bar | https://docs.openclaw.ai/platforms/mac/menu-bar | platforms/mac/menu-bar.md |
| ... | Peekaboo Bridge | https://docs.openclaw.ai/platforms/mac/peekaboo | platforms/mac/peekaboo.md |
| ... | macOS Permissions | https://docs.openclaw.ai/platforms/mac/permissions | platforms/mac/permissions.md |
| ... | macOS Release | https://docs.openclaw.ai/platforms/mac/release | platforms/mac/release.md |
| ... | Remote Control | https://docs.openclaw.ai/platforms/mac/remote | platforms/mac/remote.md |
| ... | macOS Signing | https://docs.openclaw.ai/platforms/mac/signing | platforms/mac/signing.md |
| ... | Skills | https://docs.openclaw.ai/platforms/mac/skills | platforms/mac/skills.md |
| ... | Voice Overlay | https://docs.openclaw.ai/platforms/mac/voice-overlay | platforms/mac/voice-overlay.md |
| ... | Voice Wake | https://docs.openclaw.ai/platforms/mac/voicewake | platforms/mac/voicewake.md |
| ... | WebChat | https://docs.openclaw.ai/platforms/mac/webchat | platforms/mac/webchat.md |
| ... | macOS IPC | https://docs.openclaw.ai/platforms/mac/xpc | platforms/mac/xpc.md |
| ... | macOS App | https://docs.openclaw.ai/platforms/macos | platforms/macos.md |
| ... | Oracle Cloud | https://docs.openclaw.ai/platforms/oracle | platforms/oracle.md |
| ... | Raspberry Pi | https://docs.openclaw.ai/platforms/raspberry-pi | platforms/raspberry-pi.md |
| ... | Windows (WSL2) | https://docs.openclaw.ai/platforms/windows | platforms/windows.md |
| ... | Plugin Agent Tools | https://docs.openclaw.ai/plugins/agent-tools | plugins/agent-tools.md |
| ... | Community plugins | https://docs.openclaw.ai/plugins/community | plugins/community.md |
| ... | Plugin Manifest | https://docs.openclaw.ai/plugins/manifest | plugins/manifest.md |
| ... | Voice Call Plugin | https://docs.openclaw.ai/plugins/voice-call | plugins/voice-call.md |
| ... | Zalo Personal Plugin | https://docs.openclaw.ai/plugins/zalouser | plugins/zalouser.md |
| ... | OpenProse | https://docs.openclaw.ai/prose | prose.md |
| ... | Anthropic | https://docs.openclaw.ai/providers/anthropic | providers/anthropic.md |
| ... | Amazon Bedrock | https://docs.openclaw.ai/providers/bedrock | providers/bedrock.md |
| ... | Claude Max API Proxy | https://docs.openclaw.ai/providers/claude-max-api-proxy | providers/claude-max-api-proxy.md |
| ... | Cloudflare AI Gateway | https://docs.openclaw.ai/providers/cloudflare-ai-gateway | providers/cloudflare-ai-gateway.md |
| ... | Deepgram | https://docs.openclaw.ai/providers/deepgram | providers/deepgram.md |
| ... | GitHub Copilot | https://docs.openclaw.ai/providers/github-copilot | providers/github-copilot.md |
| ... | GLM Models | https://docs.openclaw.ai/providers/glm | providers/glm.md |
| ... | Hugging Face (Inference) | https://docs.openclaw.ai/providers/huggingface | providers/huggingface.md |
| ... | Kilocode | https://docs.openclaw.ai/providers/kilocode | providers/kilocode.md |
| ... | Litellm | https://docs.openclaw.ai/providers/litellm | providers/litellm.md |
| ... | MiniMax | https://docs.openclaw.ai/providers/minimax | providers/minimax.md |
| ... | Mistral | https://docs.openclaw.ai/providers/mistral | providers/mistral.md |
| ... | Model Provider Quickstart | https://docs.openclaw.ai/providers/models | providers/models.md |
| ... | Moonshot AI | https://docs.openclaw.ai/providers/moonshot | providers/moonshot.md |
| ... | NVIDIA | https://docs.openclaw.ai/providers/nvidia | providers/nvidia.md |
| ... | Ollama | https://docs.openclaw.ai/providers/ollama | providers/ollama.md |
| ... | OpenAI | https://docs.openclaw.ai/providers/openai | providers/openai.md |
| ... | OpenCode Go | https://docs.openclaw.ai/providers/opencode-go | providers/opencode-go.md |
| ... | OpenCode | https://docs.openclaw.ai/providers/opencode | providers/opencode.md |
| ... | OpenRouter | https://docs.openclaw.ai/providers/openrouter | providers/openrouter.md |
| ... | Qianfan | https://docs.openclaw.ai/providers/qianfan | providers/qianfan.md |
| ... | Qwen | https://docs.openclaw.ai/providers/qwen | providers/qwen.md |
| ... | SGLang | https://docs.openclaw.ai/providers/sglang | providers/sglang.md |
| ... | Synthetic | https://docs.openclaw.ai/providers/synthetic | providers/synthetic.md |
| ... | Together | https://docs.openclaw.ai/providers/together | providers/together.md |
| ... | Venice AI | https://docs.openclaw.ai/providers/venice | providers/venice.md |
| ... | Vercel AI Gateway | https://docs.openclaw.ai/providers/vercel-ai-gateway | providers/vercel-ai-gateway.md |
| ... | vLLM | https://docs.openclaw.ai/providers/vllm | providers/vllm.md |
| ... | Xiaomi MiMo | https://docs.openclaw.ai/providers/xiaomi | providers/xiaomi.md |
| ... | Z.AI | https://docs.openclaw.ai/providers/zai | providers/zai.md |
| ... | Clawnet Refactor | https://docs.openclaw.ai/refactor/clawnet | refactor/clawnet.md |
| ... | Refactor Cluster Backlog | https://docs.openclaw.ai/refactor/cluster | refactor/cluster.md |
| ... | Exec Host Refactor | https://docs.openclaw.ai/refactor/exec-host | refactor/exec-host.md |
| ... | Outbound Session Mirroring Refactor (Issue #1520) | https://docs.openclaw.ai/refactor/outbound-session-mirroring | refactor/outbound-session-mirroring.md |
| ... | Plugin SDK Refactor | https://docs.openclaw.ai/refactor/plugin-sdk | refactor/plugin-sdk.md |
| ... | Strict Config Validation | https://docs.openclaw.ai/refactor/strict-config | refactor/strict-config.md |
| ... | Default AGENTS.md | https://docs.openclaw.ai/reference/AGENTS.default | reference/AGENTS.default.md |
| ... | Release Checklist | https://docs.openclaw.ai/reference/RELEASING | reference/RELEASING.md |
| ... | API Usage and Costs | https://docs.openclaw.ai/reference/api-usage-costs | reference/api-usage-costs.md |
| ... | Credits | https://docs.openclaw.ai/reference/credits | reference/credits.md |
| ... | Device Model Database | https://docs.openclaw.ai/reference/device-models | reference/device-models.md |
| ... | Prompt Caching | https://docs.openclaw.ai/reference/prompt-caching | reference/prompt-caching.md |
| ... | RPC Adapters | https://docs.openclaw.ai/reference/rpc | reference/rpc.md |
| ... | SecretRef Credential Surface | https://docs.openclaw.ai/reference/secretref-credential-surface | reference/secretref-credential-surface.md |
| ... | Session Management Deep Dive | https://docs.openclaw.ai/reference/session-management-compaction | reference/session-management-compaction.md |
| ... | Agents.Dev | https://docs.openclaw.ai/reference/templates/AGENTS.dev | reference/templates/AGENTS.dev.md |
| ... | AGENTS.md Template | https://docs.openclaw.ai/reference/templates/AGENTS | reference/templates/AGENTS.md |
| ... | BOOT.md Template | https://docs.openclaw.ai/reference/templates/BOOT | reference/templates/BOOT.md |
| ... | BOOTSTRAP.md Template | https://docs.openclaw.ai/reference/templates/BOOTSTRAP | reference/templates/BOOTSTRAP.md |
| ... | HEARTBEAT.md Template | https://docs.openclaw.ai/reference/templates/HEARTBEAT | reference/templates/HEARTBEAT.md |
| ... | Identity.Dev | https://docs.openclaw.ai/reference/templates/IDENTITY.dev | reference/templates/IDENTITY.dev.md |
| ... | Identity | https://docs.openclaw.ai/reference/templates/IDENTITY | reference/templates/IDENTITY.md |
| ... | Soul.Dev | https://docs.openclaw.ai/reference/templates/SOUL.dev | reference/templates/SOUL.dev.md |
| ... | SOUL.md Template | https://docs.openclaw.ai/reference/templates/SOUL | reference/templates/SOUL.md |
| ... | Tools.Dev | https://docs.openclaw.ai/reference/templates/TOOLS.dev | reference/templates/TOOLS.dev.md |
| ... | TOOLS.md Template | https://docs.openclaw.ai/reference/templates/TOOLS | reference/templates/TOOLS.md |
| ... | User.Dev | https://docs.openclaw.ai/reference/templates/USER.dev | reference/templates/USER.dev.md |
| ... | User | https://docs.openclaw.ai/reference/templates/USER | reference/templates/USER.md |
| ... | Tests | https://docs.openclaw.ai/reference/test | reference/test.md |
| ... | Token Use and Costs | https://docs.openclaw.ai/reference/token-use | reference/token-use.md |
| ... | Transcript Hygiene | https://docs.openclaw.ai/reference/transcript-hygiene | reference/transcript-hygiene.md |
| ... | Onboarding Wizard Reference | https://docs.openclaw.ai/reference/wizard | reference/wizard.md |
| ... | Contributing Threat Model | https://docs.openclaw.ai/security/CONTRIBUTING-THREAT-MODEL | security/CONTRIBUTING-THREAT-MODEL.md |
| ... | Readme | https://docs.openclaw.ai/security/README | security/README.md |
| ... | Threat Model Atlas | https://docs.openclaw.ai/security/THREAT-MODEL-ATLAS | security/THREAT-MODEL-ATLAS.md |
| ... | Formal Verification (Security Models) | https://docs.openclaw.ai/security/formal-verification | security/formal-verification.md |
| ... | Agent Bootstrapping | https://docs.openclaw.ai/start/bootstrapping | start/bootstrapping.md |
| ... | Docs directory | https://docs.openclaw.ai/start/docs-directory | start/docs-directory.md |
| ... | Getting Started | https://docs.openclaw.ai/start/getting-started | start/getting-started.md |
| ... | Docs Hubs | https://docs.openclaw.ai/start/hubs | start/hubs.md |
| ... | OpenClaw Lore | https://docs.openclaw.ai/start/lore | start/lore.md |
| ... | Onboarding Overview | https://docs.openclaw.ai/start/onboarding-overview | start/onboarding-overview.md |
| ... | Onboarding (macOS App) | https://docs.openclaw.ai/start/onboarding | start/onboarding.md |
| ... | Personal Assistant Setup | https://docs.openclaw.ai/start/openclaw | start/openclaw.md |
| ... | Quick start | https://docs.openclaw.ai/start/quickstart | start/quickstart.md |
| ... | Setup | https://docs.openclaw.ai/start/setup | start/setup.md |
| ... | Showcase | https://docs.openclaw.ai/start/showcase | start/showcase.md |
| ... | CLI Automation | https://docs.openclaw.ai/start/wizard-cli-automation | start/wizard-cli-automation.md |
| ... | CLI Onboarding Reference | https://docs.openclaw.ai/start/wizard-cli-reference | start/wizard-cli-reference.md |
| ... | Onboarding Wizard (CLI) | https://docs.openclaw.ai/start/wizard | start/wizard.md |
| ... | ACP Agents | https://docs.openclaw.ai/tools/acp-agents | tools/acp-agents.md |
| ... | Agent Send | https://docs.openclaw.ai/tools/agent-send | tools/agent-send.md |
| ... | apply_patch Tool | https://docs.openclaw.ai/tools/apply-patch | tools/apply-patch.md |
| ... | Browser Troubleshooting | https://docs.openclaw.ai/tools/browser-linux-troubleshooting | tools/browser-linux-troubleshooting.md |
| ... | Browser Login | https://docs.openclaw.ai/tools/browser-login | tools/browser-login.md |
| ... | WSL2 + Windows + remote Chrome CDP troubleshooting | https://docs.openclaw.ai/tools/browser-wsl2-windows-remote-cdp-troubleshooting | tools/browser-wsl2-windows-remote-cdp-troubleshooting.md |
| ... | Browser (OpenClaw-managed) | https://docs.openclaw.ai/tools/browser | tools/browser.md |
| ... | Chrome Extension | https://docs.openclaw.ai/tools/chrome-extension | tools/chrome-extension.md |
| ... | ClawHub | https://docs.openclaw.ai/tools/clawhub | tools/clawhub.md |
| ... | Creating Skills | https://docs.openclaw.ai/tools/creating-skills | tools/creating-skills.md |
| ... | Diffs | https://docs.openclaw.ai/tools/diffs | tools/diffs.md |
| ... | Elevated Mode | https://docs.openclaw.ai/tools/elevated | tools/elevated.md |
| ... | Exec Approvals | https://docs.openclaw.ai/tools/exec-approvals | tools/exec-approvals.md |
| ... | Exec Tool | https://docs.openclaw.ai/tools/exec | tools/exec.md |
| ... | Firecrawl | https://docs.openclaw.ai/tools/firecrawl | tools/firecrawl.md |
| ... | LLM Task | https://docs.openclaw.ai/tools/llm-task | tools/llm-task.md |
| ... | Lobster | https://docs.openclaw.ai/tools/lobster | tools/lobster.md |
| ... | Tool-loop detection | https://docs.openclaw.ai/tools/loop-detection | tools/loop-detection.md |
| ... | Multi-Agent Sandbox & Tools | https://docs.openclaw.ai/tools/multi-agent-sandbox-tools | tools/multi-agent-sandbox-tools.md |
| ... | PDF Tool | https://docs.openclaw.ai/tools/pdf | tools/pdf.md |
| ... | Plugins | https://docs.openclaw.ai/tools/plugin | tools/plugin.md |
| ... | Reactions | https://docs.openclaw.ai/tools/reactions | tools/reactions.md |
| ... | Skills Config | https://docs.openclaw.ai/tools/skills-config | tools/skills-config.md |
| ... | Skills | https://docs.openclaw.ai/tools/skills | tools/skills.md |
| ... | Slash Commands | https://docs.openclaw.ai/tools/slash-commands | tools/slash-commands.md |
| ... | Sub-Agents | https://docs.openclaw.ai/tools/subagents | tools/subagents.md |
| ... | Thinking Levels | https://docs.openclaw.ai/tools/thinking | tools/thinking.md |
| ... | Web Tools | https://docs.openclaw.ai/tools/web | tools/web.md |
| ... | Text-to-Speech | https://docs.openclaw.ai/tts | tts.md |
| ... | VPS Hosting | https://docs.openclaw.ai/vps | vps.md |
| ... | Control UI | https://docs.openclaw.ai/web/control-ui | web/control-ui.md |
| ... | Dashboard | https://docs.openclaw.ai/web/dashboard | web/dashboard.md |
| ... | TUI | https://docs.openclaw.ai/web/tui | web/tui.md |
| ... | WebChat | https://docs.openclaw.ai/web/webchat | web/webchat.md |
| ... | Agents | https://docs.openclaw.ai/zh-CN/AGENTS | zh-CN/AGENTS.md |
| ... | 认证监控 | https://docs.openclaw.ai/zh-CN/automation/auth-monitoring | zh-CN/automation/auth-monitoring.md |
| ... | 定时任务 | https://docs.openclaw.ai/zh-CN/automation/cron-jobs | zh-CN/automation/cron-jobs.md |
| ... | 定时任务与心跳对比 | https://docs.openclaw.ai/zh-CN/automation/cron-vs-heartbeat | zh-CN/automation/cron-vs-heartbeat.md |
| ... | Gmail PubSub | https://docs.openclaw.ai/zh-CN/automation/gmail-pubsub | zh-CN/automation/gmail-pubsub.md |
| ... | Hooks | https://docs.openclaw.ai/zh-CN/automation/hooks | zh-CN/automation/hooks.md |
| ... | 投票 | https://docs.openclaw.ai/zh-CN/automation/poll | zh-CN/automation/poll.md |
| ... | 自动化故障排查 | https://docs.openclaw.ai/zh-CN/automation/troubleshooting | zh-CN/automation/troubleshooting.md |
| ... | Webhooks | https://docs.openclaw.ai/zh-CN/automation/webhook | zh-CN/automation/webhook.md |
| ... | Brave Search | https://docs.openclaw.ai/zh-CN/brave-search | zh-CN/brave-search.md |
| ... | BlueBubbles | https://docs.openclaw.ai/zh-CN/channels/bluebubbles | zh-CN/channels/bluebubbles.md |
| ... | 广播群组 | https://docs.openclaw.ai/zh-CN/channels/broadcast-groups | zh-CN/channels/broadcast-groups.md |
| ... | 渠道路由 | https://docs.openclaw.ai/zh-CN/channels/channel-routing | zh-CN/channels/channel-routing.md |
| ... | Discord | https://docs.openclaw.ai/zh-CN/channels/discord | zh-CN/channels/discord.md |
| ... | 飞书 | https://docs.openclaw.ai/zh-CN/channels/feishu | zh-CN/channels/feishu.md |
| ... | Google Chat | https://docs.openclaw.ai/zh-CN/channels/googlechat | zh-CN/channels/googlechat.md |
| ... | grammY | https://docs.openclaw.ai/zh-CN/channels/grammy | zh-CN/channels/grammy.md |
| ... | 群组消息 | https://docs.openclaw.ai/zh-CN/channels/group-messages | zh-CN/channels/group-messages.md |
| ... | 群组 | https://docs.openclaw.ai/zh-CN/channels/groups | zh-CN/channels/groups.md |
| ... | iMessage | https://docs.openclaw.ai/zh-CN/channels/imessage | zh-CN/channels/imessage.md |
| ... | LINE | https://docs.openclaw.ai/zh-CN/channels/line | zh-CN/channels/line.md |
| ... | 渠道位置解析 | https://docs.openclaw.ai/zh-CN/channels/location | zh-CN/channels/location.md |
| ... | Matrix | https://docs.openclaw.ai/zh-CN/channels/matrix | zh-CN/channels/matrix.md |
| ... | Mattermost | https://docs.openclaw.ai/zh-CN/channels/mattermost | zh-CN/channels/mattermost.md |
| ... | Microsoft Teams | https://docs.openclaw.ai/zh-CN/channels/msteams | zh-CN/channels/msteams.md |
| ... | Nextcloud Talk | https://docs.openclaw.ai/zh-CN/channels/nextcloud-talk | zh-CN/channels/nextcloud-talk.md |
| ... | Nostr | https://docs.openclaw.ai/zh-CN/channels/nostr | zh-CN/channels/nostr.md |
| ... | 配对 | https://docs.openclaw.ai/zh-CN/channels/pairing | zh-CN/channels/pairing.md |
| ... | Signal | https://docs.openclaw.ai/zh-CN/channels/signal | zh-CN/channels/signal.md |
| ... | Slack | https://docs.openclaw.ai/zh-CN/channels/slack | zh-CN/channels/slack.md |
| ... | Telegram | https://docs.openclaw.ai/zh-CN/channels/telegram | zh-CN/channels/telegram.md |
| ... | Tlon | https://docs.openclaw.ai/zh-CN/channels/tlon | zh-CN/channels/tlon.md |
| ... | 渠道故障排除 | https://docs.openclaw.ai/zh-CN/channels/troubleshooting | zh-CN/channels/troubleshooting.md |
| ... | Twitch | https://docs.openclaw.ai/zh-CN/channels/twitch | zh-CN/channels/twitch.md |
| ... | WhatsApp | https://docs.openclaw.ai/zh-CN/channels/whatsapp | zh-CN/channels/whatsapp.md |
| ... | Zalo | https://docs.openclaw.ai/zh-CN/channels/zalo | zh-CN/channels/zalo.md |
| ... | Zalo Personal | https://docs.openclaw.ai/zh-CN/channels/zalouser | zh-CN/channels/zalouser.md |
| ... | acp | https://docs.openclaw.ai/zh-CN/cli/acp | zh-CN/cli/acp.md |
| ... | agent | https://docs.openclaw.ai/zh-CN/cli/agent | zh-CN/cli/agent.md |
| ... | agents | https://docs.openclaw.ai/zh-CN/cli/agents | zh-CN/cli/agents.md |
| ... | approvals | https://docs.openclaw.ai/zh-CN/cli/approvals | zh-CN/cli/approvals.md |
| ... | browser | https://docs.openclaw.ai/zh-CN/cli/browser | zh-CN/cli/browser.md |
| ... | channels | https://docs.openclaw.ai/zh-CN/cli/channels | zh-CN/cli/channels.md |
| ... | config | https://docs.openclaw.ai/zh-CN/cli/config | zh-CN/cli/config.md |
| ... | configure | https://docs.openclaw.ai/zh-CN/cli/configure | zh-CN/cli/configure.md |
| ... | cron | https://docs.openclaw.ai/zh-CN/cli/cron | zh-CN/cli/cron.md |
| ... | dashboard | https://docs.openclaw.ai/zh-CN/cli/dashboard | zh-CN/cli/dashboard.md |
| ... | devices | https://docs.openclaw.ai/zh-CN/cli/devices | zh-CN/cli/devices.md |
| ... | directory | https://docs.openclaw.ai/zh-CN/cli/directory | zh-CN/cli/directory.md |
| ... | dns | https://docs.openclaw.ai/zh-CN/cli/dns | zh-CN/cli/dns.md |
| ... | docs | https://docs.openclaw.ai/zh-CN/cli/docs | zh-CN/cli/docs.md |
| ... | doctor | https://docs.openclaw.ai/zh-CN/cli/doctor | zh-CN/cli/doctor.md |
| ... | gateway | https://docs.openclaw.ai/zh-CN/cli/gateway | zh-CN/cli/gateway.md |
| ... | health | https://docs.openclaw.ai/zh-CN/cli/health | zh-CN/cli/health.md |
| ... | hooks | https://docs.openclaw.ai/zh-CN/cli/hooks | zh-CN/cli/hooks.md |
| ... | logs | https://docs.openclaw.ai/zh-CN/cli/logs | zh-CN/cli/logs.md |
| ... | memory | https://docs.openclaw.ai/zh-CN/cli/memory | zh-CN/cli/memory.md |
| ... | message | https://docs.openclaw.ai/zh-CN/cli/message | zh-CN/cli/message.md |
| ... | models | https://docs.openclaw.ai/zh-CN/cli/models | zh-CN/cli/models.md |
| ... | node | https://docs.openclaw.ai/zh-CN/cli/node | zh-CN/cli/node.md |
| ... | nodes | https://docs.openclaw.ai/zh-CN/cli/nodes | zh-CN/cli/nodes.md |
| ... | onboard | https://docs.openclaw.ai/zh-CN/cli/onboard | zh-CN/cli/onboard.md |
| ... | pairing | https://docs.openclaw.ai/zh-CN/cli/pairing | zh-CN/cli/pairing.md |
| ... | plugins | https://docs.openclaw.ai/zh-CN/cli/plugins | zh-CN/cli/plugins.md |
| ... | reset | https://docs.openclaw.ai/zh-CN/cli/reset | zh-CN/cli/reset.md |
| ... | 沙箱 CLI | https://docs.openclaw.ai/zh-CN/cli/sandbox | zh-CN/cli/sandbox.md |
| ... | security | https://docs.openclaw.ai/zh-CN/cli/security | zh-CN/cli/security.md |
| ... | sessions | https://docs.openclaw.ai/zh-CN/cli/sessions | zh-CN/cli/sessions.md |
| ... | setup | https://docs.openclaw.ai/zh-CN/cli/setup | zh-CN/cli/setup.md |
| ... | skills | https://docs.openclaw.ai/zh-CN/cli/skills | zh-CN/cli/skills.md |
| ... | status | https://docs.openclaw.ai/zh-CN/cli/status | zh-CN/cli/status.md |
| ... | system | https://docs.openclaw.ai/zh-CN/cli/system | zh-CN/cli/system.md |
| ... | tui | https://docs.openclaw.ai/zh-CN/cli/tui | zh-CN/cli/tui.md |
| ... | uninstall | https://docs.openclaw.ai/zh-CN/cli/uninstall | zh-CN/cli/uninstall.md |
| ... | update | https://docs.openclaw.ai/zh-CN/cli/update | zh-CN/cli/update.md |
| ... | voicecall | https://docs.openclaw.ai/zh-CN/cli/voicecall | zh-CN/cli/voicecall.md |
| ... | webhooks | https://docs.openclaw.ai/zh-CN/cli/webhooks | zh-CN/cli/webhooks.md |
| ... | 智能体循环 | https://docs.openclaw.ai/zh-CN/concepts/agent-loop | zh-CN/concepts/agent-loop.md |
| ... | 智能体工作区 | https://docs.openclaw.ai/zh-CN/concepts/agent-workspace | zh-CN/concepts/agent-workspace.md |
| ... | 智能体运行时 | https://docs.openclaw.ai/zh-CN/concepts/agent | zh-CN/concepts/agent.md |
| ... | Gateway 网关架构 | https://docs.openclaw.ai/zh-CN/concepts/architecture | zh-CN/concepts/architecture.md |
| ... | 压缩 | https://docs.openclaw.ai/zh-CN/concepts/compaction | zh-CN/concepts/compaction.md |
| ... | 上下文 | https://docs.openclaw.ai/zh-CN/concepts/context | zh-CN/concepts/context.md |
| ... | 功能 | https://docs.openclaw.ai/zh-CN/concepts/features | zh-CN/concepts/features.md |
| ... | Markdown 格式化 | https://docs.openclaw.ai/zh-CN/concepts/markdown-formatting | zh-CN/concepts/markdown-formatting.md |
| ... | 记忆 | https://docs.openclaw.ai/zh-CN/concepts/memory | zh-CN/concepts/memory.md |
| ... | 消息 | https://docs.openclaw.ai/zh-CN/concepts/messages | zh-CN/concepts/messages.md |
| ... | 模型故障转移 | https://docs.openclaw.ai/zh-CN/concepts/model-failover | zh-CN/concepts/model-failover.md |
| ... | 模型提供商 | https://docs.openclaw.ai/zh-CN/concepts/model-providers | zh-CN/concepts/model-providers.md |
| ... | 模型 CLI | https://docs.openclaw.ai/zh-CN/concepts/models | zh-CN/concepts/models.md |
| ... | 多智能体路由 | https://docs.openclaw.ai/zh-CN/concepts/multi-agent | zh-CN/concepts/multi-agent.md |
| ... | OAuth | https://docs.openclaw.ai/zh-CN/concepts/oauth | zh-CN/concepts/oauth.md |
| ... | 在线状态 | https://docs.openclaw.ai/zh-CN/concepts/presence | zh-CN/concepts/presence.md |
| ... | 命令队列 | https://docs.openclaw.ai/zh-CN/concepts/queue | zh-CN/concepts/queue.md |
| ... | 重试策略 | https://docs.openclaw.ai/zh-CN/concepts/retry | zh-CN/concepts/retry.md |
| ... | Session Pruning | https://docs.openclaw.ai/zh-CN/concepts/session-pruning | zh-CN/concepts/session-pruning.md |
| ... | 会话工具 | https://docs.openclaw.ai/zh-CN/concepts/session-tool | zh-CN/concepts/session-tool.md |
| ... | 会话管理 | https://docs.openclaw.ai/zh-CN/concepts/session | zh-CN/concepts/session.md |
| ... | 流式传输和分块 | https://docs.openclaw.ai/zh-CN/concepts/streaming | zh-CN/concepts/streaming.md |
| ... | 系统提示词 | https://docs.openclaw.ai/zh-CN/concepts/system-prompt | zh-CN/concepts/system-prompt.md |
| ... | 时区 | https://docs.openclaw.ai/zh-CN/concepts/timezone | zh-CN/concepts/timezone.md |
| ... | TypeBox | https://docs.openclaw.ai/zh-CN/concepts/typebox | zh-CN/concepts/typebox.md |
| ... | 输入指示器 | https://docs.openclaw.ai/zh-CN/concepts/typing-indicators | zh-CN/concepts/typing-indicators.md |
| ... | 使用量跟踪 | https://docs.openclaw.ai/zh-CN/concepts/usage-tracking | zh-CN/concepts/usage-tracking.md |
| ... | 日期与时间 | https://docs.openclaw.ai/zh-CN/date-time | zh-CN/date-time.md |
| ... | Node + tsx 崩溃 | https://docs.openclaw.ai/zh-CN/debug/node-issue | zh-CN/debug/node-issue.md |
| ... | 诊断标志 | https://docs.openclaw.ai/zh-CN/diagnostics/flags | zh-CN/diagnostics/flags.md |
| ... | 新手引导和配置协议 | https://docs.openclaw.ai/zh-CN/experiments/onboarding-config-protocol | zh-CN/experiments/onboarding-config-protocol.md |
| ... | Cron Add 加固 | https://docs.openclaw.ai/zh-CN/experiments/plans/cron-add-hardening | zh-CN/experiments/plans/cron-add-hardening.md |
| ... | Telegram 允许列表加固 | https://docs.openclaw.ai/zh-CN/experiments/plans/group-policy-hardening | zh-CN/experiments/plans/group-policy-hardening.md |
| ... | OpenResponses Gateway 网关计划 | https://docs.openclaw.ai/zh-CN/experiments/plans/openresponses-gateway | zh-CN/experiments/plans/openresponses-gateway.md |
| ... | 模型配置探索 | https://docs.openclaw.ai/zh-CN/experiments/proposals/model-config | zh-CN/experiments/proposals/model-config.md |
| ... | 工作区记忆研究 | https://docs.openclaw.ai/zh-CN/experiments/research/memory | zh-CN/experiments/research/memory.md |
| ... | 认证 | https://docs.openclaw.ai/zh-CN/gateway/authentication | zh-CN/gateway/authentication.md |
| ... | 后台 Exec 和 Process 工具 | https://docs.openclaw.ai/zh-CN/gateway/background-process | zh-CN/gateway/background-process.md |
| ... | Bonjour 设备发现 | https://docs.openclaw.ai/zh-CN/gateway/bonjour | zh-CN/gateway/bonjour.md |
| ... | Bridge 协议 | https://docs.openclaw.ai/zh-CN/gateway/bridge-protocol | zh-CN/gateway/bridge-protocol.md |
| ... | CLI 后端 | https://docs.openclaw.ai/zh-CN/gateway/cli-backends | zh-CN/gateway/cli-backends.md |
| ... | 配置示例 | https://docs.openclaw.ai/zh-CN/gateway/configuration-examples | zh-CN/gateway/configuration-examples.md |
| ... | 配置 | https://docs.openclaw.ai/zh-CN/gateway/configuration | zh-CN/gateway/configuration.md |
| ... | 设备发现 + 传输协议 | https://docs.openclaw.ai/zh-CN/gateway/discovery | zh-CN/gateway/discovery.md |
| ... | Doctor | https://docs.openclaw.ai/zh-CN/gateway/doctor | zh-CN/gateway/doctor.md |
| ... | Gateway 网关锁 | https://docs.openclaw.ai/zh-CN/gateway/gateway-lock | zh-CN/gateway/gateway-lock.md |
| ... | 健康检查 | https://docs.openclaw.ai/zh-CN/gateway/health | zh-CN/gateway/health.md |
| ... | 心跳 | https://docs.openclaw.ai/zh-CN/gateway/heartbeat | zh-CN/gateway/heartbeat.md |
| ... | 本地模型 | https://docs.openclaw.ai/zh-CN/gateway/local-models | zh-CN/gateway/local-models.md |
| ... | 日志 | https://docs.openclaw.ai/zh-CN/gateway/logging | zh-CN/gateway/logging.md |
| ... | 多 Gateway 网关 | https://docs.openclaw.ai/zh-CN/gateway/multiple-gateways | zh-CN/gateway/multiple-gateways.md |
| ... | 网络模型 | https://docs.openclaw.ai/zh-CN/gateway/network-model | zh-CN/gateway/network-model.md |
| ... | OpenAI Chat Completions | https://docs.openclaw.ai/zh-CN/gateway/openai-http-api | zh-CN/gateway/openai-http-api.md |
| ... | OpenResponses API | https://docs.openclaw.ai/zh-CN/gateway/openresponses-http-api | zh-CN/gateway/openresponses-http-api.md |
| ... | Gateway 网关拥有的配对 | https://docs.openclaw.ai/zh-CN/gateway/pairing | zh-CN/gateway/pairing.md |
| ... | Gateway 网关协议 | https://docs.openclaw.ai/zh-CN/gateway/protocol | zh-CN/gateway/protocol.md |
| ... | 远程 Gateway 网关设置 | https://docs.openclaw.ai/zh-CN/gateway/remote-gateway-readme | zh-CN/gateway/remote-gateway-readme.md |
| ... | 远程访问 | https://docs.openclaw.ai/zh-CN/gateway/remote | zh-CN/gateway/remote.md |
| ... | 沙箱 vs 工具策略 vs 提权 | https://docs.openclaw.ai/zh-CN/gateway/sandbox-vs-tool-policy-vs-elevated | zh-CN/gateway/sandbox-vs-tool-policy-vs-elevated.md |
| ... | 沙箱隔离 | https://docs.openclaw.ai/zh-CN/gateway/sandboxing | zh-CN/gateway/sandboxing.md |
| ... | Tailscale | https://docs.openclaw.ai/zh-CN/gateway/tailscale | zh-CN/gateway/tailscale.md |
| ... | 工具调用 API | https://docs.openclaw.ai/zh-CN/gateway/tools-invoke-http-api | zh-CN/gateway/tools-invoke-http-api.md |
| ... | 故障排除 | https://docs.openclaw.ai/zh-CN/gateway/troubleshooting | zh-CN/gateway/troubleshooting.md |
| ... | 调试 | https://docs.openclaw.ai/zh-CN/help/debugging | zh-CN/help/debugging.md |
| ... | 环境变量 | https://docs.openclaw.ai/zh-CN/help/environment | zh-CN/help/environment.md |
| ... | 常见问题 | https://docs.openclaw.ai/zh-CN/help/faq | zh-CN/help/faq.md |
| ... | 脚本 | https://docs.openclaw.ai/zh-CN/help/scripts | zh-CN/help/scripts.md |
| ... | 测试 | https://docs.openclaw.ai/zh-CN/help/testing | zh-CN/help/testing.md |
| ... | 故障排除 | https://docs.openclaw.ai/zh-CN/help/troubleshooting | zh-CN/help/troubleshooting.md |
| ... | Ansible | https://docs.openclaw.ai/zh-CN/install/ansible | zh-CN/install/ansible.md |
| ... | Bun（实验性） | https://docs.openclaw.ai/zh-CN/install/bun | zh-CN/install/bun.md |
| ... | 开发渠道 | https://docs.openclaw.ai/zh-CN/install/development-channels | zh-CN/install/development-channels.md |
| ... | Docker | https://docs.openclaw.ai/zh-CN/install/docker | zh-CN/install/docker.md |
| ... | exe.dev | https://docs.openclaw.ai/zh-CN/install/exe-dev | zh-CN/install/exe-dev.md |
| ... | Fly.io | https://docs.openclaw.ai/zh-CN/install/fly | zh-CN/install/fly.md |
| ... | GCP | https://docs.openclaw.ai/zh-CN/install/gcp | zh-CN/install/gcp.md |
| ... | Hetzner | https://docs.openclaw.ai/zh-CN/install/hetzner | zh-CN/install/hetzner.md |
| ... | 安装器内部机制 | https://docs.openclaw.ai/zh-CN/install/installer | zh-CN/install/installer.md |
| ... | macOS 虚拟机 | https://docs.openclaw.ai/zh-CN/install/macos-vm | zh-CN/install/macos-vm.md |
| ... | 迁移指南 | https://docs.openclaw.ai/zh-CN/install/migrating | zh-CN/install/migrating.md |
| ... | Nix | https://docs.openclaw.ai/zh-CN/install/nix | zh-CN/install/nix.md |
| ... | Node.js | https://docs.openclaw.ai/zh-CN/install/node | zh-CN/install/node.md |
| ... | 卸载 | https://docs.openclaw.ai/zh-CN/install/uninstall | zh-CN/install/uninstall.md |
| ... | 更新 | https://docs.openclaw.ai/zh-CN/install/updating | zh-CN/install/updating.md |
| ... | 日志 | https://docs.openclaw.ai/zh-CN/logging | zh-CN/logging.md |
| ... | 网络 | https://docs.openclaw.ai/zh-CN/network | zh-CN/network.md |
| ... | 音频与语音消息 | https://docs.openclaw.ai/zh-CN/nodes/audio | zh-CN/nodes/audio.md |
| ... | 相机捕获 | https://docs.openclaw.ai/zh-CN/nodes/camera | zh-CN/nodes/camera.md |
| ... | 图像和媒体支持 | https://docs.openclaw.ai/zh-CN/nodes/images | zh-CN/nodes/images.md |
| ... | 位置命令 | https://docs.openclaw.ai/zh-CN/nodes/location-command | zh-CN/nodes/location-command.md |
| ... | 媒体理解 | https://docs.openclaw.ai/zh-CN/nodes/media-understanding | zh-CN/nodes/media-understanding.md |
| ... | Talk 模式 | https://docs.openclaw.ai/zh-CN/nodes/talk | zh-CN/nodes/talk.md |
| ... | 节点故障排查 | https://docs.openclaw.ai/zh-CN/nodes/troubleshooting | zh-CN/nodes/troubleshooting.md |
| ... | 语音唤醒 | https://docs.openclaw.ai/zh-CN/nodes/voicewake | zh-CN/nodes/voicewake.md |
| ... | Perplexity Sonar | https://docs.openclaw.ai/zh-CN/perplexity | zh-CN/perplexity.md |
| ... | Pi 开发工作流程 | https://docs.openclaw.ai/zh-CN/pi-dev | zh-CN/pi-dev.md |
| ... | Pi 集成架构 | https://docs.openclaw.ai/zh-CN/pi | zh-CN/pi.md |
| ... | Android 应用 | https://docs.openclaw.ai/zh-CN/platforms/android | zh-CN/platforms/android.md |
| ... | DigitalOcean | https://docs.openclaw.ai/zh-CN/platforms/digitalocean | zh-CN/platforms/digitalocean.md |
| ... | iOS 应用 | https://docs.openclaw.ai/zh-CN/platforms/ios | zh-CN/platforms/ios.md |
| ... | Linux 应用 | https://docs.openclaw.ai/zh-CN/platforms/linux | zh-CN/platforms/linux.md |
| ... | macOS 上的 Gateway 网关 | https://docs.openclaw.ai/zh-CN/platforms/mac/bundled-gateway | zh-CN/platforms/mac/bundled-gateway.md |
| ... | Canvas | https://docs.openclaw.ai/zh-CN/platforms/mac/canvas | zh-CN/platforms/mac/canvas.md |
| ... | Gateway 网关生命周期 | https://docs.openclaw.ai/zh-CN/platforms/mac/child-process | zh-CN/platforms/mac/child-process.md |
| ... | macOS 开发设置 | https://docs.openclaw.ai/zh-CN/platforms/mac/dev-setup | zh-CN/platforms/mac/dev-setup.md |
| ... | 健康检查 | https://docs.openclaw.ai/zh-CN/platforms/mac/health | zh-CN/platforms/mac/health.md |
| ... | 菜单栏图标 | https://docs.openclaw.ai/zh-CN/platforms/mac/icon | zh-CN/platforms/mac/icon.md |
| ... | macOS 日志 | https://docs.openclaw.ai/zh-CN/platforms/mac/logging | zh-CN/platforms/mac/logging.md |
| ... | 菜单栏 | https://docs.openclaw.ai/zh-CN/platforms/mac/menu-bar | zh-CN/platforms/mac/menu-bar.md |
| ... | Peekaboo Bridge | https://docs.openclaw.ai/zh-CN/platforms/mac/peekaboo | zh-CN/platforms/mac/peekaboo.md |
| ... | macOS 权限 | https://docs.openclaw.ai/zh-CN/platforms/mac/permissions | zh-CN/platforms/mac/permissions.md |
| ... | macOS 发布 | https://docs.openclaw.ai/zh-CN/platforms/mac/release | zh-CN/platforms/mac/release.md |
| ... | 远程控制 | https://docs.openclaw.ai/zh-CN/platforms/mac/remote | zh-CN/platforms/mac/remote.md |
| ... | macOS 签名 | https://docs.openclaw.ai/zh-CN/platforms/mac/signing | zh-CN/platforms/mac/signing.md |
| ... | Skills | https://docs.openclaw.ai/zh-CN/platforms/mac/skills | zh-CN/platforms/mac/skills.md |
| ... | 语音浮层 | https://docs.openclaw.ai/zh-CN/platforms/mac/voice-overlay | zh-CN/platforms/mac/voice-overlay.md |
| ... | 语音唤醒 | https://docs.openclaw.ai/zh-CN/platforms/mac/voicewake | zh-CN/platforms/mac/voicewake.md |
| ... | WebChat | https://docs.openclaw.ai/zh-CN/platforms/mac/webchat | zh-CN/platforms/mac/webchat.md |
| ... | macOS IPC | https://docs.openclaw.ai/zh-CN/platforms/mac/xpc | zh-CN/platforms/mac/xpc.md |
| ... | macOS 应用 | https://docs.openclaw.ai/zh-CN/platforms/macos | zh-CN/platforms/macos.md |
| ... | Oracle Cloud | https://docs.openclaw.ai/zh-CN/platforms/oracle | zh-CN/platforms/oracle.md |
| ... | Raspberry Pi | https://docs.openclaw.ai/zh-CN/platforms/raspberry-pi | zh-CN/platforms/raspberry-pi.md |
| ... | Windows (WSL2) | https://docs.openclaw.ai/zh-CN/platforms/windows | zh-CN/platforms/windows.md |
| ... | 插件智能体工具 | https://docs.openclaw.ai/zh-CN/plugins/agent-tools | zh-CN/plugins/agent-tools.md |
| ... | 插件清单 | https://docs.openclaw.ai/zh-CN/plugins/manifest | zh-CN/plugins/manifest.md |
| ... | Voice Call 插件 | https://docs.openclaw.ai/zh-CN/plugins/voice-call | zh-CN/plugins/voice-call.md |
| ... | Zalo Personal 插件 | https://docs.openclaw.ai/zh-CN/plugins/zalouser | zh-CN/plugins/zalouser.md |
| ... | OpenProse | https://docs.openclaw.ai/zh-CN/prose | zh-CN/prose.md |
| ... | Anthropic | https://docs.openclaw.ai/zh-CN/providers/anthropic | zh-CN/providers/anthropic.md |
| ... | Amazon Bedrock | https://docs.openclaw.ai/zh-CN/providers/bedrock | zh-CN/providers/bedrock.md |
| ... | Claude Max API 代理 | https://docs.openclaw.ai/zh-CN/providers/claude-max-api-proxy | zh-CN/providers/claude-max-api-proxy.md |
| ... | Deepgram | https://docs.openclaw.ai/zh-CN/providers/deepgram | zh-CN/providers/deepgram.md |
| ... | GitHub Copilot | https://docs.openclaw.ai/zh-CN/providers/github-copilot | zh-CN/providers/github-copilot.md |
| ... | GLM 模型 | https://docs.openclaw.ai/zh-CN/providers/glm | zh-CN/providers/glm.md |
| ... | MiniMax | https://docs.openclaw.ai/zh-CN/providers/minimax | zh-CN/providers/minimax.md |
| ... | 模型提供商快速入门 | https://docs.openclaw.ai/zh-CN/providers/models | zh-CN/providers/models.md |
| ... | Moonshot AI | https://docs.openclaw.ai/zh-CN/providers/moonshot | zh-CN/providers/moonshot.md |
| ... | Ollama | https://docs.openclaw.ai/zh-CN/providers/ollama | zh-CN/providers/ollama.md |
| ... | OpenAI | https://docs.openclaw.ai/zh-CN/providers/openai | zh-CN/providers/openai.md |
| ... | OpenCode Zen | https://docs.openclaw.ai/zh-CN/providers/opencode | zh-CN/providers/opencode.md |
| ... | OpenRouter | https://docs.openclaw.ai/zh-CN/providers/openrouter | zh-CN/providers/openrouter.md |
| ... | 千帆（Qianfan） | https://docs.openclaw.ai/zh-CN/providers/qianfan | zh-CN/providers/qianfan.md |
| ... | Qwen | https://docs.openclaw.ai/zh-CN/providers/qwen | zh-CN/providers/qwen.md |
| ... | Synthetic | https://docs.openclaw.ai/zh-CN/providers/synthetic | zh-CN/providers/synthetic.md |
| ... | Venice AI | https://docs.openclaw.ai/zh-CN/providers/venice | zh-CN/providers/venice.md |
| ... | Vercel AI Gateway | https://docs.openclaw.ai/zh-CN/providers/vercel-ai-gateway | zh-CN/providers/vercel-ai-gateway.md |
| ... | Xiaomi MiMo | https://docs.openclaw.ai/zh-CN/providers/xiaomi | zh-CN/providers/xiaomi.md |
| ... | Z.AI | https://docs.openclaw.ai/zh-CN/providers/zai | zh-CN/providers/zai.md |
| ... | Clawnet 重构 | https://docs.openclaw.ai/zh-CN/refactor/clawnet | zh-CN/refactor/clawnet.md |
| ... | Exec 主机重构 | https://docs.openclaw.ai/zh-CN/refactor/exec-host | zh-CN/refactor/exec-host.md |
| ... | 出站会话镜像重构（Issue | https://docs.openclaw.ai/zh-CN/refactor/outbound-session-mirroring | zh-CN/refactor/outbound-session-mirroring.md |
| ... | 插件 SDK 重构 | https://docs.openclaw.ai/zh-CN/refactor/plugin-sdk | zh-CN/refactor/plugin-sdk.md |
| ... | 严格配置验证 | https://docs.openclaw.ai/zh-CN/refactor/strict-config | zh-CN/refactor/strict-config.md |
| ... | Agents.Default | https://docs.openclaw.ai/zh-CN/reference/AGENTS.default | zh-CN/reference/AGENTS.default.md |
| ... | Releasing | https://docs.openclaw.ai/zh-CN/reference/RELEASING | zh-CN/reference/RELEASING.md |
| ... | API 用量与费用 | https://docs.openclaw.ai/zh-CN/reference/api-usage-costs | zh-CN/reference/api-usage-costs.md |
| ... | 致谢 | https://docs.openclaw.ai/zh-CN/reference/credits | zh-CN/reference/credits.md |
| ... | 设备型号数据库 | https://docs.openclaw.ai/zh-CN/reference/device-models | zh-CN/reference/device-models.md |
| ... | RPC 适配器 | https://docs.openclaw.ai/zh-CN/reference/rpc | zh-CN/reference/rpc.md |
| ... | 会话管理深入了解 | https://docs.openclaw.ai/zh-CN/reference/session-management-compaction | zh-CN/reference/session-management-compaction.md |
| ... | Agents.Dev | https://docs.openclaw.ai/zh-CN/reference/templates/AGENTS.dev | zh-CN/reference/templates/AGENTS.dev.md |
| ... | Agents | https://docs.openclaw.ai/zh-CN/reference/templates/AGENTS | zh-CN/reference/templates/AGENTS.md |
| ... | Boot | https://docs.openclaw.ai/zh-CN/reference/templates/BOOT | zh-CN/reference/templates/BOOT.md |
| ... | Bootstrap | https://docs.openclaw.ai/zh-CN/reference/templates/BOOTSTRAP | zh-CN/reference/templates/BOOTSTRAP.md |
| ... | Heartbeat | https://docs.openclaw.ai/zh-CN/reference/templates/HEARTBEAT | zh-CN/reference/templates/HEARTBEAT.md |
| ... | Identity.Dev | https://docs.openclaw.ai/zh-CN/reference/templates/IDENTITY.dev | zh-CN/reference/templates/IDENTITY.dev.md |
| ... | Identity | https://docs.openclaw.ai/zh-CN/reference/templates/IDENTITY | zh-CN/reference/templates/IDENTITY.md |
| ... | Soul.Dev | https://docs.openclaw.ai/zh-CN/reference/templates/SOUL.dev | zh-CN/reference/templates/SOUL.dev.md |
| ... | Soul | https://docs.openclaw.ai/zh-CN/reference/templates/SOUL | zh-CN/reference/templates/SOUL.md |
| ... | Tools.Dev | https://docs.openclaw.ai/zh-CN/reference/templates/TOOLS.dev | zh-CN/reference/templates/TOOLS.dev.md |
| ... | Tools | https://docs.openclaw.ai/zh-CN/reference/templates/TOOLS | zh-CN/reference/templates/TOOLS.md |
| ... | User.Dev | https://docs.openclaw.ai/zh-CN/reference/templates/USER.dev | zh-CN/reference/templates/USER.dev.md |
| ... | User | https://docs.openclaw.ai/zh-CN/reference/templates/USER | zh-CN/reference/templates/USER.md |
| ... | 测试 | https://docs.openclaw.ai/zh-CN/reference/test | zh-CN/reference/test.md |
| ... | Token 使用与成本 | https://docs.openclaw.ai/zh-CN/reference/token-use | zh-CN/reference/token-use.md |
| ... | 对话记录清理 | https://docs.openclaw.ai/zh-CN/reference/transcript-hygiene | zh-CN/reference/transcript-hygiene.md |
| ... | 向导参考 | https://docs.openclaw.ai/zh-CN/reference/wizard | zh-CN/reference/wizard.md |
| ... | 形式化验证（安全模型） | https://docs.openclaw.ai/zh-CN/security/formal-verification | zh-CN/security/formal-verification.md |
| ... | 智能体引导 | https://docs.openclaw.ai/zh-CN/start/bootstrapping | zh-CN/start/bootstrapping.md |
| ... | 文档目录 | https://docs.openclaw.ai/zh-CN/start/docs-directory | zh-CN/start/docs-directory.md |
| ... | 入门指南 | https://docs.openclaw.ai/zh-CN/start/getting-started | zh-CN/start/getting-started.md |
| ... | 文档导航中心 | https://docs.openclaw.ai/zh-CN/start/hubs | zh-CN/start/hubs.md |
| ... | OpenClaw 传说 | https://docs.openclaw.ai/zh-CN/start/lore | zh-CN/start/lore.md |
| ... | 新手引导 | https://docs.openclaw.ai/zh-CN/start/onboarding | zh-CN/start/onboarding.md |
| ... | 个人助手设置 | https://docs.openclaw.ai/zh-CN/start/openclaw | zh-CN/start/openclaw.md |
| ... | 快速开始 | https://docs.openclaw.ai/zh-CN/start/quickstart | zh-CN/start/quickstart.md |
| ... | 设置 | https://docs.openclaw.ai/zh-CN/start/setup | zh-CN/start/setup.md |
| ... | 案例展示 | https://docs.openclaw.ai/zh-CN/start/showcase | zh-CN/start/showcase.md |
| ... | 新手引导向导 | https://docs.openclaw.ai/zh-CN/start/wizard | zh-CN/start/wizard.md |
| ... | Agent Send | https://docs.openclaw.ai/zh-CN/tools/agent-send | zh-CN/tools/agent-send.md |
| ... | apply_patch 工具 | https://docs.openclaw.ai/zh-CN/tools/apply-patch | zh-CN/tools/apply-patch.md |
| ... | 浏览器故障排除 | https://docs.openclaw.ai/zh-CN/tools/browser-linux-troubleshooting | zh-CN/tools/browser-linux-troubleshooting.md |
| ... | 浏览器登录 | https://docs.openclaw.ai/zh-CN/tools/browser-login | zh-CN/tools/browser-login.md |
| ... | 浏览器（OpenClaw 托管） | https://docs.openclaw.ai/zh-CN/tools/browser | zh-CN/tools/browser.md |
| ... | Chrome 扩展 | https://docs.openclaw.ai/zh-CN/tools/chrome-extension | zh-CN/tools/chrome-extension.md |
| ... | ClawHub | https://docs.openclaw.ai/zh-CN/tools/clawhub | zh-CN/tools/clawhub.md |
| ... | 创建 Skills | https://docs.openclaw.ai/zh-CN/tools/creating-skills | zh-CN/tools/creating-skills.md |
| ... | 提升模式 | https://docs.openclaw.ai/zh-CN/tools/elevated | zh-CN/tools/elevated.md |
| ... | 执行审批 | https://docs.openclaw.ai/zh-CN/tools/exec-approvals | zh-CN/tools/exec-approvals.md |
| ... | Exec 工具 | https://docs.openclaw.ai/zh-CN/tools/exec | zh-CN/tools/exec.md |
| ... | Firecrawl | https://docs.openclaw.ai/zh-CN/tools/firecrawl | zh-CN/tools/firecrawl.md |
| ... | LLM 任务 | https://docs.openclaw.ai/zh-CN/tools/llm-task | zh-CN/tools/llm-task.md |
| ... | Lobster | https://docs.openclaw.ai/zh-CN/tools/lobster | zh-CN/tools/lobster.md |
| ... | 多智能体沙箱与工具 | https://docs.openclaw.ai/zh-CN/tools/multi-agent-sandbox-tools | zh-CN/tools/multi-agent-sandbox-tools.md |
| ... | 插件 | https://docs.openclaw.ai/zh-CN/tools/plugin | zh-CN/tools/plugin.md |
| ... | 表情回应 | https://docs.openclaw.ai/zh-CN/tools/reactions | zh-CN/tools/reactions.md |
| ... | Skills 配置 | https://docs.openclaw.ai/zh-CN/tools/skills-config | zh-CN/tools/skills-config.md |
| ... | Skills | https://docs.openclaw.ai/zh-CN/tools/skills | zh-CN/tools/skills.md |
| ... | 斜杠命令 | https://docs.openclaw.ai/zh-CN/tools/slash-commands | zh-CN/tools/slash-commands.md |
| ... | 子智能体 | https://docs.openclaw.ai/zh-CN/tools/subagents | zh-CN/tools/subagents.md |
| ... | 思考级别 | https://docs.openclaw.ai/zh-CN/tools/thinking | zh-CN/tools/thinking.md |
| ... | Web 工具 | https://docs.openclaw.ai/zh-CN/tools/web | zh-CN/tools/web.md |
| ... | 文本转语音 | https://docs.openclaw.ai/zh-CN/tts | zh-CN/tts.md |
| ... | VPS 托管 | https://docs.openclaw.ai/zh-CN/vps | zh-CN/vps.md |
| ... | 控制 UI | https://docs.openclaw.ai/zh-CN/web/control-ui | zh-CN/web/control-ui.md |
| ... | 仪表板 | https://docs.openclaw.ai/zh-CN/web/dashboard | zh-CN/web/dashboard.md |
| ... | TUI | https://docs.openclaw.ai/zh-CN/web/tui | zh-CN/web/tui.md |
| ... | WebChat | https://docs.openclaw.ai/zh-CN/web/webchat | zh-CN/web/webchat.md |

FILE:references/doc-lookups.md
# Doc Lookups — 已查阅文档问题速查

> 每次使用 openclaw-doc-finder 技能查询官方文档后，将问题与结论记录于此，形成已有问题快速参考。

---

## 目录

- [Exec 审批与白名单](#exec-审批与白名单)
- [配置相关](#配置相关)

---

## Exec 审批与白名单

### exec-approvals.json 的正确配置格式

**问题**：如何正确配置 exec 命令白名单，实现「常用命令免审批，新命令弹一次审批后永久放行」？

**官方文档结论**：
- `~/.openclaw/exec-approvals.json` 是 exec 审批的**唯一正确配置位置**
- `openclaw.json` 中 **不存在** `security.exec.allowlist` 这个字段（之前配置错误）
- `ask` 三个取值：
  - `"off"` — 不弹审批，不在白名单直接拒绝（**太严，不推荐**）
  - `"on-miss"` — 不在白名单才弹审批，点 Always Allow 后加入白名单（**正确做法**）
  - `"always"` — 每次都弹审批
- `askFallback`：无法弹审批时的 fallback 行为，默认 deny
- 白名单条目使用**二进制文件的绝对路径**（如 `/usr/bin/ls`），不是命令名

**正确配置**：
```json
{
  "defaults": {
    "security": "allowlist",
    "ask": "on-miss",
    "askFallback": "deny",
    "autoAllowSkills": true
  },
  "agents": {
    "main": {
      "security": "allowlist",
      "ask": "on-miss",
      "askFallback": "deny",
      "autoAllowSkills": true,
      "allowlist": [
        {
          "pattern": "/usr/bin/ls",
          "lastResolvedPath": "/usr/bin/ls"
        }
      ]
    }
  }
}
```

**相关文档**：`tools/exec-approvals.md`

**查阅时间**：2026-03-25

---

### Discord 审批按钮显示 "allow once" 但实际已执行 Always Allow

**问题**：点击 "Always Allow" 按钮后，Discord 确认消息仍显示 "allow once"，是否真的执行了 Always Allow？

**官方文档结论**：
- 这是 OpenClaw Discord 组件的**显示 Bug**，确认消息文案硬编码为 "allow once"
- 实际行为：**Always Allow 已正确执行**，只是确认消息显示错误
- "Always Allow" 效果：将该命令的绝对路径加入 `exec-approvals.json` 的 `allowlist`，下次同名命令直接放行

**查阅时间**：2026-03-25

---

## 配置相关

### openclaw.json 顶层字段列表

**问题**：openclaw.json 有哪些顶层配置字段？

**结论**：
```
meta, env, wizard, update, browser, auth, models, agents, tools, messages, commands, session, cron, channels, gateway, memory, skills, plugins
```

**注意**：`security` 不是顶层字段（不在列表中）

**查阅时间**：2026-03-24

---

<!-- 新条目追加在下方，保持按分类整理 -->

---

## Cron 调度任务

### Discord 频道 announce 投递失败（delivery.to 格式错误）

**问题**：cron 任务配置了 `delivery.mode: "announce"` 和 `delivery.channel: "discord"`，但消息未投递到 Discord 频道。

**官方文档结论**：

**根因一**：`sessionTarget` 与 `payload.kind` 不匹配
- `systemEvent` payload **只能**配合 `sessionTarget: "main"` 使用，main 任务**不支持 announce 投递**
- `agentTurn` payload **必须**配合 `sessionTarget: "isolated"` 使用，isolated 任务才支持 announce 投递
- 因此 `"main" + "systemEvent"` 的组合无法 announce 到任何频道

**根因二**：`delivery.to` 缺少前缀
- Discord 频道 ID 必须加 `channel:` 前缀，写成 `"channel:1485158622370467902"`
- 直接写 `"1485158622370467902"` 会导致投递目标解析失败

**正确配置示例**：
```json
{
  "id": "安全审查",
  "sessionTarget": "isolated",
  "wakeMode": "now",
  "payload": {
    "kind": "agentTurn",
    "message": "执行openclaw security audit --deep..."
  },
  "delivery": {
    "mode": "announce",
    "channel": "discord",
    "to": "channel:1485158622370467902",
    "bestEffort": false
  }
}
```

**相关文档**：`automation/cron-jobs.md`（搜索 "announce delivery" 和 "Discord"）

**查阅时间**：2026-03-30

---

## 如何追加新条目

在对应分类下按以下格式追加：

```markdown
### 标题（简洁描述问题）

**问题**：xxx？

**官方文档结论**：
- 结论1
- 结论2

**相关文档**：`path/to/doc.md`

**查阅时间**：YYYY-MM-DD
```

---

## 图像生成配置

### image_generate 报 "No image-generation provider registered"

**问题**：`image_generate` 工具报错 `No image-generation provider registered for google`，如何修复？

**官方文档结论**：
- `plugins.allow` 是白名单机制，非空时**只有列表内插件完整加载**
- 即使 `entries.<provider>.enabled: true` 也会被 allow 列表覆盖
- image generation provider 由插件 `register()` 注册，非内置
- Daemon 环境下 API key 需写入 `~/.openclaw/.env`，不读 `openclaw.json` 的 `env` 块
- Google image gen 正确模型名：`gemini-3.1-flash-image-preview`（非 `gemini-3-flash-image-preview`）

**修复三步**：
1. `~/.openclaw/.env` 添加 `GEMINI_API_KEY=xxx`
2. `plugins.allow` 添加 `"google"`
3. `agents.defaults.imageGenerationModel.primary` 设为 `google/gemini-3.1-flash-image-preview`

**相关文档**：`gateway/configuration-reference.md` (plugins.allow 段) | `providers/google.md`

**查阅时间**：2026-03-30

FILE:references/troubleshoot.md
# OpenClaw 故障排除速查

> 摘录自 `gateway/troubleshooting.md` + `channels/troubleshooting.md`

---

## 诊断命令阶梯（必按顺序执行）

```bash
openclaw status
openclaw gateway status
openclaw logs --follow
openclaw doctor
openclaw channels status --probe
```

**健康信号：**
- `openclaw gateway status` 显示 `Runtime: running` + `RPC probe: ok`
- `openclaw doctor` 无 blocking 级别报错
- `openclaw channels status --probe` 显示 connected/ready

---

## 常见报错与解决方案

### 1. Anthropic 429 / Extra Usage Required

**症状：** 日志出现 `HTTP 429: rate_limit_error: Extra usage is required for long context requests`

**排查：**
```bash
openclaw logs --follow
openclaw models status
openclaw config get agents.defaults.models
```

**原因：** 使用的模型启用了 `context1m` 但凭证无 long-context 权限

**解法（三选一）：**
1. 关闭该模型的 `context1m` 参数
2. 使用有 `Extra Usage` 权限的 Anthropic API key
3. 配置 fallback 模型

→ 详细：[Anthropic Provider](https://docs.openclaw.ai/providers/anthropic)

---

### 2. Channel 连接失败（Discord/Telegram/飞书等）

**症状：** `openclaw channels status` 显示 channel 未连接

**排查：**
```bash
openclaw channels status --probe
openclaw logs --follow --channel discord
```

**常见原因：**
- Bot token 过期或权限不足
- Webhook URL 不可达
- OAuth 授权过期（飞书/Telegram）

**解法：**
1. 重新配置 channel token：`openclaw config set channels.<name>.token <token>`
2. 检查 bot 权限（Discord 需要 `Gateway Intent`）
3. 飞书：重新触发 OAuth 授权流程

→ 详细：[Channel Troubleshooting](https://docs.openclaw.ai/channels/troubleshooting)

---

### 3. Gateway 无法启动

**症状：** `openclaw gateway start` 失败

**排查：**
```bash
openclaw doctor
openclaw logs
cat ~/.openclaw/openclaw.json | python3 -m json.tool  # 验证 JSON 格式
```

**常见原因：**
- 端口 18789 被占用 → `lsof -i :18789`
- 配置文件 JSON 格式错误
- Node 版本不兼容（需要 Node 22+）

→ 详细：[Gateway Troubleshooting](https://docs.openclaw.ai/gateway/troubleshooting)

---

### 4. 技能安装失败（clawhub rate limit）

**症状：** `clawhub install <skill>` 报 rate limit

**解法：**
1. 加延迟重试：`sleep 60 && clawhub install <skill>`
2. 手动从 GitHub 安装：`npx skills add <owner/repo@skill>`
3. 使用 skillhub 内部搜索

→ 详细：[ClawHub 工具](https://docs.openclaw.ai/tools/clawhub)

---

### 5. 凭证/secrets 问题

**症状：** API 调用报 401/403，或 `secrets plan contract` 相关报错

**排查：**
```bash
openclaw config get providers
# 检查环境变量
env | grep -i api
```

**解法：**
1. 确认 `.env` 文件存在且包含正确 key
2. 验证 API key 有对应产品权限
3. 使用 `openclaw secrets list` 查看已加载凭证

→ 详细：[Secrets Management](https://docs.openclaw.ai/gateway/secrets)

---

### 6. 远程访问/VPS 连接问题

**症状：** 远程无法连接 gateway

**排查：**
```bash
openclaw gateway status
openclaw config get gateway.host
```

**解法：**
1. 确认 gateway host 设为 `0.0.0.0`（而非 `127.0.0.1`）
2. 检查防火墙/安全组放行 18789 端口
3. 建议配合 Tailscale：见 `gateway/tailscale.md`

→ 详细：[Remote Gateway](https://docs.openclaw.ai/gateway/remote) | [VPS 部署](https://docs.openclaw.ai/vps)

---

### 7. openclaw doctor 报 scope missing

**症状：** `openclaw doctor` 警告 `gateway probe missing scope`

**原因：** 使用的 token 没有完整的 scopes

**解法：**
1. 生成带显式 scopes 的新 token
2. 或忽略该警告（仅影响部分诊断功能）

→ 详细：[Gateway Doctor](https://docs.openclaw.ai/gateway/doctor)

---

### 8. image_generate 报 "No image-generation provider registered"

**症状：** `image_generate` 工具报错 `No image-generation provider registered for <provider>`

**排查：**
```bash
# 确认 provider 插件是否完整加载
openclaw config get plugins.allow
openclaw config get plugins.entries.<provider>.enabled

# 确认 API key 是否在 .env
cat ~/.openclaw/.env | grep -i API_KEY

# 确认 imageGenerationModel 配置
openclaw config get agents.defaults.imageGenerationModel
```

**根因：** `plugins.allow` 是白名单机制——当非空时，只有列表内的插件会完整加载（包括 image generation provider 注册）。即使 `entries.<provider>.enabled: true` 也会被 allow 列表覆盖。

**修复步骤（以 Google 为例）：**

1. **添加 API key 到 `.env`**（daemon 环境不读 openclaw.json 的 env 块）：
   ```bash
   echo 'GEMINI_API_KEY=your_key' >> ~/.openclaw/.env
   ```

2. **把 provider 加入 `plugins.allow`**：
   ```bash
   openclaw config set plugins.allow '["telegram","discord","openclaw-weixin","firecrawl","tavily","exa","openclaw-lark","google"]'
   ```

3. **配置 imageGenerationModel**：
   ```bash
   openclaw config set agents.defaults.imageGenerationModel.primary 'google/gemini-3.1-flash-image-preview'
   ```

4. **重启 gateway**：
   ```bash
   openclaw gateway restart
   ```

**坑点：**
- `gemini-3-flash-image-preview` 不存在，正确模型名是 `gemini-3.1-flash-image-preview`
- `BUILTIN_IMAGE_GENERATION_PROVIDERS` 为空数组，所有 image gen provider 由插件 `register()` 注册
- Google 插件的 image generation 源码位于 `extensions/google/image-generation-provider.ts`

**验证：**
```bash
# 测试生图
openclaw config get agents.defaults.imageGenerationModel
# 然后调用 image_generate 工具测试
```

→ 详细：[Configuration Reference - plugins.allow](https://docs.openclaw.ai/gateway/configuration-reference) | [Google Provider](https://docs.openclaw.ai/providers/google)

---

## 诊断决策树

```
用户报告问题
    │
    ├─ CLI 命令报错    → openclaw doctor → 读对应报错章节
    │
    ├─ Channel 连接问题 → openclaw channels status --probe
    │                       │
    │                       ├─ Token 问题 → channels/<name>.md
    │                       └─ 网络问题   → network.md
    │
    ├─ 配置问题         → gateway/configuration.md
    │
    ├─ 模型/供应商问题  → providers/<name>.md
    │
    └─ 性能/日志问题    → gateway/logging.md → gateway/troubleshooting.md
```

FILE:scripts/sync-version.py
#!/usr/bin/env python3
"""
openclaw-doc-finder 版本同步脚本
功能：核对 OpenClaw 版本与技能版本，不一致时自动刷新 doc-index.md 并更新 VERSION
用法：python3 sync-version.py [--dry-run]
"""

import json
import os
import sys
from pathlib import Path

# ── 配置 ──────────────────────────────────────────────────────
SKILL_DIR = Path(__file__).parent.parent.resolve()
VERSION_FILE = SKILL_DIR / "VERSION"
DOC_INDEX_FILE = SKILL_DIR / "references" / "doc-index.md"
OPENCLAW_DOCS = Path.home() / ".npm-global" / "lib" / "node_modules" / "openclaw" / "docs"

# 已知稳定版本（回退用）
OPENCLAW_VERSION_CACHE = "1.188"


def get_openclaw_version() -> str:
    """读取当前运行的 OpenClaw 版本号"""
    pkg_path = Path.home() / ".npm-global" / "lib" / "node_modules" / "openclaw" / "package.json"
    if pkg_path.exists():
        try:
            with open(pkg_path) as f:
                return json.load(f).get("version", OPENCLAW_VERSION_CACHE)
        except Exception:
            pass
    return OPENCLAW_VERSION_CACHE


def get_skill_version() -> str:
    """读取技能当前版本号"""
    if VERSION_FILE.exists():
        return VERSION_FILE.read_text().strip()
    return "v0.0.0"


def build_doc_index(oc_version: str) -> str:
    """
    扫描本地 docs/ 目录，构建 doc-index.md 内容
    只处理 .md 文件，跳过 assets/images/meta 文件
    """
    sections = [
        "# OpenClaw 文档索引",
        "",
        f"> ⚠️ **自动生成** — OpenClaw v{oc_version} | 生成时间：自动",
        "",
        "## 意图 → 文档路由表",
        "",
        "| 场景关键词 | 文档标题 | 完整 URL | 本地路径 |",
        "|----------|---------|---------|---------|",
    ]

    # URL 路径映射（相对路径 → docs.openclaw.ai URL）
    url_mappings = {
        "start/": "start/",
        "gateway/": "gateway/",
        "channels/": "channels/",
        "providers/": "providers/",
        "tools/": "tools/",
        "install/": "install/",
        "vps.md": "vps",
        "network.md": "network",
        "logging.md": "gateway/logging",
        "nodes/": "nodes/",
    }

    if not OPENCLAW_DOCS.exists():
        sections.append(f"\n⚠️ 本地文档目录不存在：`{OPENCLAW_DOCS}`")
        return "\n".join(sections)

    md_files = sorted(OPENCLAW_DOCS.rglob("*.md"))

    for md_path in md_files:
        # 跳过隐藏文件和非文档
        rel = md_path.relative_to(OPENCLAW_DOCS)
        if any(p.startswith(".") or p.startswith("_") for p in rel.parts):
            continue
        if md_path.name in ("index.md", "CNAME", "style.css"):
            continue
        if md_path.name.startswith("nav-tabs"):
            continue

        # 解析 frontmatter title
        title = md_path.stem.replace("-", " ").replace("_", " ").title()
        try:
            text = md_path.read_text(encoding="utf-8", errors="ignore")
            if text.startswith("---"):
                end = text.find("\n---", 4)
                if end > 0:
                    frontmatter = text[3:end]
                    for line in frontmatter.splitlines():
                        if line.startswith("title:"):
                            title = line.split(":", 1)[1].strip().strip('"').strip("'")
                            break
        except Exception:
            pass

        # 构造 URL
        parts = list(rel.parts)
        if parts[0] in url_mappings:
            url_path = url_mappings[parts[0]]
            if len(parts) > 1:
                url_path += parts[-1].replace(".md", "")
            url = f"https://docs.openclaw.ai/{url_path}"
        else:
            url = f"https://docs.openclaw.ai/{str(rel).replace('.md', '')}"

        local = str(rel)
        sections.append(f"| ... | {title} | {url} | {local} |")

    sections.append("")
    return "\n".join(sections)


def update_version(new_version: str):
    """更新 VERSION 文件"""
    VERSION_FILE.write_text(f"v{new_version}\n")


def main(dry_run: bool = False):
    oc_version = get_openclaw_version()
    skill_version = get_skill_version().lstrip("v")

    print(f"[openclaw-doc-finder] 版本检查")
    print(f"  OpenClaw 运行版本 : {oc_version}")
    print(f"  技能版本          : v{skill_version}")

    if oc_version == skill_version:
        print("  ✅ 版本一致，无需更新")
        return

    print(f"  🔄 版本不一致，开始同步文档索引...")

    new_index = build_doc_index(oc_version)

    if dry_run:
        print(f"\n[DRY-RUN] 将会写入以下内容到 {DOC_INDEX_FILE}:")
        print(new_index[:500] + "...")
        return

    # 写 doc-index.md
    DOC_INDEX_FILE.write_text(new_index, encoding="utf-8")
    update_version(oc_version)

    print(f"  ✅ doc-index.md 已刷新")
    print(f"  ✅ VERSION 已更新为 v{oc_version}")


if __name__ == "__main__":
    dry_run = "--dry-run" in sys.argv
    main(dry_run=dry_run)