← 返回 Skills 市场
Use OpenClaw Manual
作者
echoflying
· GitHub ↗
· v2.0.3
· MIT-0
483
总下载
0
收藏
2
当前安装
8
版本数
在 OpenClaw 中安装
/install use-openclaw-manual
功能描述
配置 OpenClaw 前必须查阅官方文档的技能。当用户提到任何配置相关的话题（agent、session、channel、cron、通知、工具、workspace、gateway 等）时，立即使用此技能搜索本地文档。不要凭经验猜测——先查文档再设计方案。
安全使用建议
该技能总体自洽且功能合理，但在安装/使用前请注意：
- 脚本会从 GitHub 克隆并把文档写入本地（默认 ~/.openclaw/workspace/docs/openclaw_manual），请确保有足够磁盘空间并接受写入该目录。
- 搜索和操作会记录到 usage.log（技能目录），其中包括搜索关键词和命令结果；如不希望保留记录，可在运行时设置 DISABLE_USAGE_LOG=true 或手动删除/审查 usage.log。
- 如果不想让技能向外发送通知，把 DOC_NOTIFY_CHANNEL 设为 none 或在没有 openclaw CLI 的环境下不启用通知；发送通知时会使用本地 openclaw CLI（仅发送摘要，不包含具体文件内容）。
- 为避免 GitHub API 限流，可提供 GITHUB_TOKEN（可选）；没有 token 时脚本仍能通过 git 克隆仓库。
- 技能说明包含用于定位安装目录的 find ~ 命令；这会枚举用户主目录下的路径——如果不希望这么做，请手动指定技能安装路径或在安全上下文运行这些查找命令。
按上述建议操作且在第一次运行前审阅脚本内容，能够降低隐私和误操作风险。
功能分析
Type: OpenClaw Skill
Name: use-openclaw-manual
Version: 2.0.3
The 'use-openclaw-manual' skill bundle is a legitimate utility designed to synchronize and search official OpenClaw documentation from GitHub. The implementation uses standard tools (git, curl, python3, grep) to perform sparse clones of the 'openclaw/openclaw' repository and provide local search capabilities for the agent. The scripts (run.sh, sync-docs.sh, search-docs.sh) are well-documented, include usage logging with basic rotation, and lack any indicators of malicious intent, data exfiltration, or unauthorized execution.
能力评估
Purpose & Capability
技能名、描述和脚本一致：主要工作是从 openclaw/openclaw 仓库同步 docs 并在本地搜索文档。要求的工具（git, curl, python3）和可选 env（GITHUB_TOKEN, OPENCLAW_MANUAL_PATH, DOC_NOTIFY_CHANNEL）与该目的相符。
Instruction Scope
运行说明要求切换到技能目录并运行脚本来初始化、同步和搜索本地文档，范围基本限于 ~/.openclaw/workspace/docs/openclaw_manual 和技能目录；不过说明中建议用 find ~ 来定位技能安装位置（这会扫描用户 Home 下的文件名），脚本会把用户的搜索查询和操作记录到 usage.log（默认在技能目录），这些都是需要用户知晓的本地行为。
Install Mechanism
无 install spec（instruction-only），脚本随技能一起提供；同步从 GitHub 官方仓库克隆/稀疏检出并复制到本地，使用的是标准 git/curl 调用，没有可疑第三方下载或短链。
Credentials
所需/可选环境变量（OPENCLAW_MANUAL_PATH, LAST_COMMIT_FILE, DOC_UPDATE_LOG, DOC_NOTIFY_CHANNEL, GITHUB_TOKEN）都与同步/通知/存储相关且可选。值得注意：GITHUB_TOKEN 用于通过 GitHub API 认证（提高速率限制），DOC_NOTIFY_CHANNEL 会触发通过 openclaw CLI 发送通知（如果 openclaw 可用且渠道配置不为 none），usage.log 会存储搜索关键词和调用元数据；这些是功能性需要但有隐私考虑。
Persistence & Privilege
技能不会要求平台级的持久化权限（always=false），也不修改其他技能或全局 agent 配置。它将写入/管理自己的文档目录和若干本地元数据文件（.last-docs-commit, docs-update.log, usage.log），这种行为与其用途一致。
如何使用
- 确保已安装 OpenClaw（本地或 Docker 部署）
- 在对话框中输入安装命令：
/install use-openclaw-manual - 安装完成后，直接呼叫该 Skill 的名称或使用
/use-openclaw-manual触发 - 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
v2.0.3
修复 sync-docs.sh 脚本的 5 个 bug：wc -l 空格、目录切换、git clone 错误处理、管道退出状态、通知渠道
v2.0.2
- Added compatibility section detailing required tools, optional environment variables, and permissions.
- Clarified runtime dependency checks for git, curl, python3, and openclaw CLI (with corresponding behavior if missing).
- Updated environment variables table with explicit "必需" (required) column and clearer explanations.
- Mentioned that setting DOC_NOTIFY_CHANNEL to "none" disables notifications.
- Improved documentation structure and precision without functional changes.
v2.0.1
- Maintenance release with no user-facing changes.
- Updated internal metadata and dependencies.
v2.0.0
v2.0.0: 完全重构 - 优化 SKILL.md 结构，添加中英文关键词映射，支持中文搜索，新增 references 文档
v1.0.3
**v1.0.3 Changelog**
- 新增 _meta.json 和 docs-update.log 文件，补全元数据和文档同步日志
- 文档完全重写，简化为直接脚本调用方式，无需 clawhub CLI
- 输出格式更简洁明了，更适合 Agent 处理和管道组合
- 强调零依赖设计，提升启动速度与易用性
- 新增高级用法、输出格式示例和故障排除指导
v1.0.2
- 新增 LICENSE 文件，补充和明确技能许可证信息。
- 在 SKILL.md“首次安装”部分，新增前置依赖与可选环境变量说明，提升安装指引清晰度。
- 其余功能和说明未做更改，行为保持与上一版本一致。
v1.0.1
Initial release: OpenClaw manual documentation skill with search and sync capabilities
v1.0.0
Initial release: OpenClaw manual documentation skill with search and sync capabilities
元数据
常见问题
Use OpenClaw Manual 是什么？
配置 OpenClaw 前必须查阅官方文档的技能。当用户提到任何配置相关的话题（agent、session、channel、cron、通知、工具、workspace、gateway 等）时，立即使用此技能搜索本地文档。不要凭经验猜测——先查文档再设计方案。 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 483 次。
如何安装 Use OpenClaw Manual？
在 OpenClaw 或 Claude Code 对话框中运行命令「/install use-openclaw-manual」即可一键安装，无需额外配置。
Use OpenClaw Manual 是免费的吗？
是的，Use OpenClaw Manual 完全免费，采用 MIT-0 许可证，可自由下载、安装和使用。
Use OpenClaw Manual 支持哪些平台？
Use OpenClaw Manual 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。
谁开发了 Use OpenClaw Manual？
由 echoflying（@echoflying）开发并维护，当前版本 v2.0.3。
推荐 Skills