name: skill-isolator description: | Project-based skill isolation and management. Enables different projects to use different skill sets with automatic loading based on current working directory. Supports multiple skill sources (clawhub, local, git, url) with priority-based resolution, version locking, and auto-sync. Use when: (1) working in a project with .openclaw-skills.json, (2) need to manage project-specific skills, (3) want to isolate skills between projects, (4) need to install skills from clawhub or other sources. version: 1.0.0 author: Xiao Xia license: MIT

skill-isolator

為不同專案提供獨立的技能配置和隔離管理，實現技能按需載入、專案間完全隔離。

快速開始

1️⃣ 建立專案配置

在專案根目錄建立 .openclaw-skills.json：

# 使用交互向導
node scripts/init-project-config.js

# 或手動建立（最小配置）
echo '{"skills":["weather"],"excludeGlobal":true}' > .openclaw-skills.json

2️⃣ 同步技能

# 自動檢測並安裝缺失技能
node scripts/sync-project-skills.js

3️⃣ 驗證配置

node scripts/validate-config.js

核心功能

配置檔案詳解

完整示例

{
  "name": "my-project",
  "skills": [
    { "name": "feishu-doc", "version": "latest" },
    { "name": "weather", "version": "1.2.0" },
    "stock-analyzer"
  ],
  "excludeGlobal": true,
  "sources": [
    {
      "name": "clawhub",
      "type": "registry",
      "priority": 1,
      "enabled": true
    },
    {
      "name": "local",
      "type": "filesystem",
      "priority": 2,
      "paths": ["~/.openclaw/skills", "~/my-skills"]
    }
  ],
  "cache": {
    "enabled": true,
    "ttlHours": 24
  },
  "autoSync": {
    "onProjectEnter": true,
    "onSkillMissing": true
  }
}

欄位說明

技能格式

{
  "skills": [
    "weather",                          // 簡單格式 - 最新版本的技能
    { "name": "feishu-doc" },           // 物件格式 - 最新版本
    { "name": "stock-analyzer", "version": "1.2.0" }  // 鎖定版本
  ]
}

來源型別

命令介面

同步與狀態

配置管理

工作流程

專案載入流程

1. 檢測當前工作目錄
   ↓
2. 向上查詢最近的 .openclaw-skills.json
   ↓
3. 解析技能列表和來源配置
   ↓
4. 檢查每個技能是否已安裝
   ↓
5. 缺失技能 → 按源優先順序查詢並安裝
   ↓
6. 啟用配置的技能
   ↓
7. 快取載入狀態

技能安裝流程

1. 遍歷配置的技能列表
   ↓
2. 檢查技能是否已安裝（多目錄檢測）
   ↓
3. 未安裝 → 按優先順序遍歷來源
   ↓
4. 找到技能 → 下載/克隆
   ↓
5. 驗證技能格式（SKILL.md 必需）
   ↓
6. 安裝到本地技能目錄
   ↓
7. 更新快取

指令碼工具

sync-project-skills.js

同步專案技能的主指令碼。

# 基本用法
node scripts/sync-project-skills.js

# 強制重新同步（忽略快取）
node scripts/sync-project-skills.js --force

# 顯示詳細資訊
node scripts/sync-project-skills.js --verbose

# 組合使用
node scripts/sync-project-skills.js --force --verbose

引數： - --force, -f: 強制重新同步，忽略快取 - --verbose, -v: 顯示詳細資訊

validate-config.js

驗證配置檔案格式和完整性。

# 驗證當前目錄配置
node scripts/validate-config.js

# 驗證指定檔案
node scripts/validate-config.js path/to/config.json

驗證內容： - JSON 格式正確性 - 必需欄位存在性 - 欄位型別正確性 - 來源型別有效性 - 重複技能檢測

init-project-config.js

互動式配置建立嚮導。

node scripts/init-project-config.js

引導內容： - 專案名稱 - 技能列表 - 是否排除全域性技能 - 技能來源配置 - 快取設定 - 自動同步設定

快取機制

快取位置

~/.openclaw/cache/skills.json

快取內容

{
  "skills": {
    "weather": { "installed": true, "timestamp": 1710000000000 },
    "feishu-doc": { "installed": true, "timestamp": 1710000000000 }
  },
  "sources": {
    "clawhub": { "reachable": true, "lastCheck": 1710000000000 }
  },
  "lastSync": 1710000000000
}

快取策略

錯誤處理

最佳實踐

1️⃣ 配置最小化

只配置專案真正需要的技能：

{
  "skills": ["feishu-doc", "weather"],
  "excludeGlobal": true
}

2️⃣ 版本鎖定

生產專案鎖定技能版本：

{
  "skills": [
    { "name": "feishu-doc", "version": "2.1.0" },
    { "name": "weather", "version": "1.0.3" }
  ]
}

3️⃣ 本地開發

開發中的技能使用本地源：

{
  "sources": [
    { "name": "local-dev", "type": "filesystem", "paths": ["~/dev/my-skills"], "priority": 1 }
  ]
}

4️⃣ 團隊共享

提交配置到版本控制：

git add .openclaw-skills.json
git commit -m "Add project skill configuration"

故障排查

技能未載入

# 1. 檢查配置檔案是否存在
ls .openclaw-skills.json

# 2. 驗證配置格式
node scripts/validate-config.js

# 3. 強制同步
node scripts/sync-project-skills.js --force --verbose

安裝失敗

# 1. 檢查網路連線
ping clawhub.com

# 2. 檢查技能目錄許可權
ls -la ~/.openclaw/skills/

# 3. 檢視詳細日誌
node scripts/sync-project-skills.js --verbose

配置錯誤

# 驗證配置並檢視示例
node scripts/validate-config.js
小蔥技能7w4.net有完整的技能分類。

檔案位置

與其他技能協作

clawhub

本技能依賴 clawhub 技能來安裝 registry 源的技能。確保 clawhub 技能已安裝。

skill-creator

建立新技能後，可以用本技能將新技能新增到專案配置中。

更新歷史

許可證

MIT License

這個 Skill 質量不錯，功能實用，文件非常詳細。優點是配置靈活、支援多來源、自動同步方便，管理不同專案的技能很省心。缺點是配置示例有細微不一致，可能讓人困惑；某些高階功能（如 Git 源認證）的說明還不夠詳細。適合需要管理多個專案技能配置的進階使用者，新手也能快速上手。