你来自哪里（OpenClaw 技能清单管理器）

该技能全面审计从各类来源（ClawHub、GitHub、npm、本地等）安装的 OpenClaw 技能。它生成人类可读与机器可读的清单文件（SKILLS_MANIFEST.json 和 SKILLS_MANIFEST.md），并安全地将它们备份至你的个人 GitHub 仓库。

[!WARNING] 前提条件：需安装 Node.js 本技能管理器依赖 JavaScript（inventory.js）执行文件扫描与 Git 集成。 你 必须 在系统中安装 Node.js（推荐 v14 或更高版本），否则无法正常运行。

核心功能

• 定向扫描：仅扫描 ~/.openclaw/inventory.json 中预定义的路径，从而优化性能。
• 来源识别：通过分析 .git、package.json 和 clawhub.json，精准追踪技能的来源及安装方式。
• 安全清洗：自动检测并掩码超过 10 种 API Key 模式（例如 sk-、ghp_、hf_），防止敏感数据在清单中泄露。
• 隐私层保护：若发现 SKILL.private.md 文件，则该技能在清单中被标记为“私有技能（内容已掩码）”，其全部细节均被完全隐藏。
• Git 同步：提供单一命令 sync --push，自动完成清单变更检测、本地提交及推送至 GitHub 全流程。

详细命令指南

0. 引导式初始化（inventory bootstrap）[推荐]

首次使用用户的最简配置方式（含配置 + Git + 初始扫描）。

node .agents/skills/openclaw-inventory-manager/inventory.js bootstrap

1. 初始化（inventory init）

初始化清单配置，并建立根 Git 仓库以追踪技能。

# 在当前目录启用 Git 追踪并生成配置
node .agents/skills/openclaw-inventory-manager/inventory.js init 

# 初始化并直接关联远程 GitHub 仓库
node .agents/skills/openclaw-inventory-manager/inventory.js init https://github.com/yourname/my-skills-inventory.git

2. 状态检查（inventory status）

扫描自上次清单同步以来的变更。

node .agents/skills/openclaw-inventory-manager/inventory.js status

3. 同步与提交（inventory sync）

更新清单文件，并将变更提交至本地 Git 仓库；添加 --push 参数可同步上传至远程仓库。

# 仅更新清单并执行本地提交
node .agents/skills/openclaw-inventory-manager/inventory.js sync

# 将变更上传至远程 GitHub 仓库
node .agents/skills/openclaw-inventory-manager/inventory.js sync --push

4. 搜索技能列表（inventory list / search）

在终端输出所有已安装技能的简明表格。

node .agents/skills/openclaw-inventory-manager/inventory.js list

配置结构

配置文件存储于以下位置：
~/.openclaw/inventory.json（本地用户主目录）

{
  "searchRoots": ["~/.openclaw/skills", "./skills"], // 扫描路径
  "maxDepth": 5,                                     // 递归深度限制
  "excludedDirs": ["node_modules", ".git", "dist"],  // 忽略的文件夹
  "maskPatterns": ["sk-", "ghp_", "hf_", "AIza"],    // 敏感信息掩码模式
  "autoPush": false,                                 // 是否启用自动推送
  "manifestPath": "~/.openclaw/SKILLS_MANIFEST.json"           // 输出路径
}

代理指令（自然语言触发词）

当用户发送的消息匹配以下任一触发短语时，执行对应工作流。匹配应基于 语义意图，无需严格字面一致。

🔍 意图：审计 / 检查技能

触发短语（英文）

• "Where are you from?"
• "Where did my skills come from?"
• "Show me my skill inventory"
• "List all my installed skills"
• "What skills do I have?"
• "Audit my skills"
• "Analyze my agent environment"
• "Check my skill history"
• "Show my skill manifest"
• "What's installed?"

触发短语（韩文）

• "내 스킬 내역 확인해줘"
• "스킬 목록 보여줘"
• "어떤 스킬 설치되어 있어?"
• "스킬 히스토리 알려줘"

工作流：

1. 检查 ~/.openclaw/inventory.json 是否存在。
2. 若 不存在 → 告知用户该技能尚未初始化，并建议执行：

   node inventory.js bootstrap
   

3. 若 存在 → 运行 inventory status 并汇总结果（已发现技能数量、距上次同步的变更情况）。
4. 若检测到变更，主动提供执行 inventory sync 的选项。

☁️ 意图：同步 / 提交 / 推送至 GitHub

触发短语（英文）

• "Sync my skills to GitHub"
• "Update my skill manifest"
• "Commit my inventory"
• "Push my skill list"
• "Save skill inventory to GitHub"
• "Back up my skills"

触发短语（韩文）

• "스킬 동기화해줘"
• "깃허브에 올려줘"
• "인벤토리 업데이트해줘"
• "커밋해줘"

工作流：

1. 执行 inventory sync --push。
2. 向用户报告提交状态（成功、无变更或错误）。
3. 若推送失败，提示用户检查 GitHub 认证（SSH 密钥或 Personal Access Token）。

🚀 意图：首次设置 / 引导初始化

触发短语（英文）

• "Set up skill inventory"
• "Initialize skill tracking"
• "Get started with skill manager"
• "Configure the inventory"
• "I just installed this skill, what do I do?"

触发短语（韩文）

• "스킬 매니저 설정해줘"
• "처음 시작하는 방법 알려줘"
• "초기화해줘"

工作流：

1. 检查 ~/.openclaw/inventory.json 是否已存在。
2. 若 不存在 → 执行 inventory bootstrap，并逐步引导用户完成各步骤。
3. 若 已存在 → 告知用户已有配置，并询问是否需重新初始化，或仅运行 status 查看当前状态。

安全提醒

• 使用 sync --push 前，请务必确认 GitHub 认证已正确配置。
• 使用 .gitignore 防止敏感凭证文件被意外提交。
• 对于绝不可公开的内部说明，请使用 SKILL.private.md 文件。