Use OpenClaw Manual OpenClaw Skill

配置 OpenClaw 前必须查阅官方文档的技能。当用户提到任何配置相关的话题（agent、session、channel、cron、通知、工具、workspace、gateway 等）时，立即使用此技能搜索本地文档。不要凭经验猜测——先查文档再设计方案。

v2.0.3 Recently Updated Updated 2 wk ago

Installation

clawhub install use-openclaw-manual

Requires npm i -g clawhub

View on ClawHub Download .zip

381

Downloads

0

Stars

2

current installs

3 all-time

8

Versions

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. 进入技能目录
   $ cd path/to/use-openclaw-manual/

2. 搜索文档
   $ ./run.sh --search "<关键词>"

3. 阅读相关文档
   $ ./run.sh --read "<文档路径>"

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

5. 用户批准

6. 执行配置
          

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

使用方法

首次配置

运行配置脚本完成权限设置和文档初始化：

            # 进入技能目录
cd path/to/use-openclaw-manual/

# 运行配置脚本
./setup.sh
          

配置脚本会：

检查必需依赖（git, curl, python3）
添加执行权限到所有脚本
（可选）初始化官方文档

快速搜索

            # 搜索关键词（默认搜索内容）
./run.sh --search "cron schedule"

# 指定搜索类型
./run.sh --search "agent" --type filename
./run.sh --search "notification" --type title

# 限制结果数量
./run.sh --search "discord" --limit 5
          

查阅文档

            # 列出目录内容
./run.sh --list "automation"

# 阅读特定文档
./run.sh --read "automation/cron.md"
          

文档同步

            # 增量同步（仅更新变更）
./run.sh --sync

# 仅检查更新（不同步）
./run.sh --check
          

查看统计

./run.sh --stats

帮助

./run.sh --help

查找技能安装位置

如果你不记得技能安装在哪里：

            # 搜索技能目录
find ~ -name "use-openclaw-manual" -type d 2>/dev/null

# 或搜索 run.sh 文件
find ~ -path "*/use-openclaw-manual/run.sh" 2>/dev/null
          

找到后 cd 进入该目录即可使用。

详细文档

本技能提供以下详细文档：

文档	用途	何时读取
references/scripts.md	脚本详细说明	首次使用或忘记参数时
references/troubleshooting.md	故障排除指南	遇到错误或异常时

Agent 提示：搜索时优先使用英文关键词（如 notification, cron, gateway），可获得更准确的搜索结果。

快速导航

了解脚本功能 → 读取 references/scripts.md
搜索无结果 → 读取 references/troubleshooting.md 的"搜索无结果"章节
同步失败 → 读取 references/troubleshooting.md 的"同步失败"章节
查看日志 → 读取 references/troubleshooting.md 的"日志分析"章节

环境变量

变量	默认值	必需	说明
`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 解析（必需）
⚠️ jq - JSON 输出（可选，用于 --json 模式）
⚠️ openclaw CLI - 发送通知（可选，缺失时跳过通知）

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

配置规范

✅ 必须做

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

❌ 禁止做

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

示例场景

配置 Discord 通知

            用户：帮我配置 Discord 通知

助手：
1. 进入技能目录
   $ cd path/to/use-openclaw-manual/

2. 搜索文档
   $ ./run.sh --search "discord notification"

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

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

5. 用户批准后执行
          

配置定时任务

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

助手：
1. 搜索文档
   $ ./run.sh --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                      # 初始化标记（自动创建）
          

Related Skills

Other popular skills you might find useful.

Agent Browser

MaTriXy

Headless browser automation CLI optimized for AI agents with accessibility tree snapshots and ref-based element selection

69.1k 248 v0.1.0

Browser Automation

peytoncasper

Automate web browser interactions using natural language via CLI commands. Use when the user asks to browse websites, navigate web pages, extract data from websites, take screenshots, fill forms, click buttons, or interact with web applications.

31.8k 46 v1.0.1

Code

Iván

Coding workflow with planning, implementation, verification, and testing for clean software development.

18.2k 35 v1.0.4

Agent Browser - Stagehand