clawhub

• 在執行時期獲取新技能 — 您的代理需要一項原本未隨附的功能，並應按需從登錄檔中提取。
• 鎖定已安裝技能的版本 — 您希望將技能鎖定至已知穩定的版本（例如 1.2.3），以避免意外的重大變更。
• 保持工作區處於最新狀態 — 您希望透過單一 update --all 指令，將所有已安裝的技能批次升級至最新版本。
• 發布您自己的技能 — 您已建立一個新的技能資料夾，並希望以附有版本號和更新日誌的發布形式，將其分享至 clawhub.com。

• 如果您只需要在初始設定時進行一次性技能安裝 — 直接複製檔案或使用標準的 npm install 步驟，可能比呼叫完整的 ClawHub CLI 更為簡便。
• 如果您的環境無法存取網際網路 — ClawHub 依賴 clawhub.com 套件庫（或自訂的 CLAWHUB_REGISTRY），在沒有自架套件庫的完全隔離網路環境中將無法正常運作。

使用自然語言或關鍵字搜尋查詢 clawhub.com 登錄庫（例如 clawhub search "postgres backups"），無需離開終端機或代理程式工作階段，即可探索可用的技能。

透過 clawhub install my-skill 以 slug 安裝任意技能，或使用 --version 1.2.3 鎖定至特定版本。技能預設會安裝至 ./skills 目錄，可透過 --dir 參數或 CLAWHUB_WORKDIR 環境變數進行設定。

update 指令會對本地技能檔案進行雜湊運算，解析對應的上游版本，並升級至最新發行版本（或指定的固定版本）。使用 --all 旗標可一次升級所有已安裝的技能，並可搭配 --force 與 --no-input 旗標用於自動化流程。

只需一個指令，即可將本地技能資料夾發布至登錄庫，並提供 slug、顯示名稱、版本號及更新日誌字串。需要已登入的 clawhub login 工作階段。

透過 CLAWHUB_REGISTRY 環境變數或 --registry 旗標，可覆寫預設的 https://clawhub.com registry。工作目錄預設為當前目錄（若無則退而使用 OpenClaw 工作區），並可透過 --workdir 或 CLAWHUB_WORKDIR 加以覆寫。

代理在執行任務途中發現需要一個尚未安裝的技能。它呼叫 clawhub install <slug> 從登錄庫拉取最新版本，並立即獲得該能力——無需人工介入。

部署管道執行 clawhub update --all --no-input --force，以確保在代理環境啟動前，工作區中的每個技能都更新至最新版本，從而消除跨部署之間的版本漂移問題。

開發者完成技能更新後，執行 clawhub publish ./my-skill --slug my-skill --version 1.3.0 --changelog "Bug fixes + new actions"，該技能即刻在 clawhub.com 上供其他使用者與代理程式安裝。

一個團隊使用 clawhub install my-skill --version 1.2.3 將關鍵技能固定至經過測試的版本，確保生產環境中的代理程式永遠不會在未明確更新配置版本號的情況下，自動升級至未經測試的發布版本。