---

name: use-openclaw-manual description: 配置 OpenClaw 前必须查阅官方文档的技能。当用户提到任何配置相关的话题（agent、channel、cron、通知、工具、workspace、gateway 等）时，立即使用此技能搜索本地文档。不要凭经验猜测——先查文档再设计方案。 compatibility: required_tools: git, curl, python3, openclaw CLI optional_env: GITHUB_TOKEN (GitHub API 认证), OPENCLAW_MANUAL_PATH, DOC_NOTIFY_CHANNEL permissions: 本地文件读写 (~/.openclaw/workspace/docs/), GitHub API 访问

use-openclaw-manual - 基于文档的 OpenClaw 配置技能

核心原则

配置前必须查文档 —— 这是使用此技能的根本原因。OpenClaw 的配置字段、命令参数、渠道设置经常变化，凭经验操作容易出错。此技能确保你的配置方案基于最新官方文档，而非过时的记忆。

何时使用此技能

触发场景（看到以下任何关键词就应触发）：

关键词	查阅目录	优先级
agent, workspace, session	concepts/, cli/agents.md	P0
cron, schedule, reminder, 定时	automation/cron.md, cli/cron.md	P1
discord, telegram, whatsapp, qqbot, 通知	channels/, automation/notifications.md	P2
tool, profile, browser, exec	tools/, concepts/tools.md	P1
gateway, config, restart	gateway/, cli/gateway.md	P0
memory, skill, 技能	concepts/memory.md, skills/	P1

不触发的场景：

• 简单的文件操作（读/写/编辑工作区文件）
• 网络搜索（web_search, web_fetch）
• 与 OpenClaw 配置无关的任务

标准工作流程

收到配置需求后，按此流程操作：

1. 搜索文档
   $ clawhub skill run use-openclaw-manual --search "<关键词>"

2. 阅读相关文档
   $ clawhub skill run use-openclaw-manual --read "<文档路径>"

3. 设计方案（引用文档来源）
   "根据 <文档路径>，配置步骤如下：..."

4. 用户批准

5. 执行配置

为什么必须引用文档来源：让用户知道你的方案有官方依据，而非猜测。如果配置出错，也便于回溯是文档问题还是操作问题。

使用方法

快速搜索

# 搜索关键词（默认搜索内容）
clawhub skill run use-openclaw-manual --search "cron schedule"

# 指定搜索类型
clawhub skill run use-openclaw-manual --search "agent" --type filename
clawhub skill run use-openclaw-manual --search "notification" --type title

查阅文档

# 列出目录内容
clawhub skill run use-openclaw-manual --list "automation"

# 阅读特定文档
clawhub skill run use-openclaw-manual --read "automation/cron.md"

文档同步

# 首次初始化（完整同步，约 700+ 文件）
clawhub skill run use-openclaw-manual --init

# 增量同步（仅更新变更）
clawhub skill run use-openclaw-manual --sync

# 仅检查更新（不同步）
clawhub skill run use-openclaw-manual --check

查看统计

clawhub skill run use-openclaw-manual --stats

环境变量

变量	默认值	必需	说明
OPENCLAW_MANUAL_PATH	~/.openclaw/workspace/docs/openclaw_manual	否	文档存储路径
LAST_COMMIT_FILE	$OPENCLAW_MANUAL_PATH/.last-docs-commit	否	同步基线文件
DOC_UPDATE_LOG	技能目录内 docs-update.log	否	同步日志
DOC_NOTIFY_CHANNEL	webchat	否	通知渠道（设为 none 禁用）
GITHUB_TOKEN	无	否	GitHub API Token（提高速率限制）

运行时依赖

脚本执行前会自动检查以下工具：

• ✅ git - 文档同步
• ✅ curl - GitHub API 调用
• ✅ python3 - JSON 解析
• ⚠️ openclaw CLI - 发送通知（可选，缺失时跳过通知）

如缺少必需依赖，脚本会报错并退出。

配置规范

✅ 必须做

• 配置前搜索文档 —— 即使你"记得"怎么配
• 引用文档来源 —— 在方案中说明依据
• 以文档为准 —— 文档与经验冲突时，相信文档
• 定期同步 —— 确保文档最新

❌ 禁止做

• 未查文档直接配置
• 凭猜测填写配置字段
• 忽略文档中的警告或注意事项
• 跳过用户批准步骤

示例场景

配置 Discord 通知

用户：帮我配置 Discord 通知

助手：
1. 搜索文档
   $ clawhub skill run use-openclaw-manual --search "discord notification"

2. 找到相关文档
   - channels/discord.md
   - automation/notifications.md

3. 设计方案（引用文档）
   "根据 channels/discord.md 第 3 节，配置步骤如下：..."

4. 用户批准后执行

配置定时任务

用户：设置一个每天早上 9 点运行的任务

助手：
1. 搜索文档
   $ clawhub skill run use-openclaw-manual --search "cron schedule every"

2. 查阅 automation/cron.md

3. 设计方案
   "根据 cron.md，使用 schedule.kind='every'，everyMs=86400000..."

故障排除

问题	原因	解决
文档目录为空	未初始化	--init
搜索无结果	关键词不匹配	换关键词或检查是否已同步
同步失败	网络问题	检查网络，查看日志

详细故障排除见 references/troubleshooting.md

脚本说明

详细脚本文档见 references/scripts.md

• scripts/sync-docs.sh - 文档同步
• scripts/search-docs.sh - 文档搜索
• run.sh - 入口脚本

文件结构

use-openclaw-manual/
├── SKILL.md                          # 技能说明（本文件）
├── run.sh                            # 入口脚本
├── scripts/
│   ├── sync-docs.sh                  # 文档同步
│   └── search-docs.sh                # 文档搜索
├── references/
│   ├── scripts.md                    # 脚本详细文档
│   └── troubleshooting.md            # 故障排除
└── .initialized                      # 初始化标记（自动创建）

相关资源

• 本地文档：~/.openclaw/workspace/docs/openclaw_manual/
• 官方文档：https://docs.openclaw.ai
• 社区：https://discord.com/invite/clawd

---

版本：v2.0.0 | 最后更新：2026-03-11