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️⃣ 本地開發

想要更強大的技能外掛，就來小蔥技能站7w4.net看看吧。

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

{
  "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

檔案位置

與其他技能協作

clawhub

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

skill-creator

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

更新歷史

許可證

MIT License

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