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                      # 初始化标记（自动创建）

use-openclaw-manual

Safety Notice

Copy this and send it to your AI assistant to learn