CLI commands
Skills
openclaw skills
檢查本機 Skills、搜尋 ClawHub、從 ClawHub／Git／本機目錄安裝 Skills、驗證 ClawHub Skills，以及更新由 ClawHub 追蹤的安裝項目。
相關內容：
命令
openclaw skills search "calendar"openclaw skills search --limit 20 --jsonopenclaw skills install @owner/<slug>openclaw skills install @owner/<slug> --version <version>openclaw skills install git:owner/repoopenclaw skills install git:owner/repo@mainopenclaw skills install ./path/to/skill --as custom-nameopenclaw skills install @owner/<slug> --forceopenclaw skills install @owner/<slug> --force-installopenclaw skills install @owner/<slug> --acknowledge-clawhub-riskopenclaw skills install @owner/<slug> --agent <id>openclaw skills install @owner/<slug> --globalopenclaw skills update @owner/<slug>openclaw skills update @owner/<slug> --force-installopenclaw skills update @owner/<slug> --acknowledge-clawhub-riskopenclaw skills update @owner/<slug> --globalopenclaw skills update --allopenclaw skills update --all --agent <id>openclaw skills update --all --globalopenclaw skills verify @owner/<slug>openclaw skills verify @owner/<slug> --version <version>openclaw skills verify @owner/<slug> --tag <tag>openclaw skills verify @owner/<slug> --cardopenclaw skills verify @owner/<slug> --globalopenclaw skills listopenclaw skills list --eligibleopenclaw skills list --jsonopenclaw skills list --verboseopenclaw skills list --agent <id>openclaw skills info <name>openclaw skills info <name> --jsonopenclaw skills info <name> --agent <id>openclaw skills checkopenclaw skills check --agent <id>openclaw skills check --jsonopenclaw skills workshop propose-create --name "qa-check" --description "QA checklist" --proposal ./PROPOSAL.mdopenclaw skills workshop propose-update qa-check --proposal ./PROPOSAL.mdopenclaw skills workshop listopenclaw skills workshop inspect <proposal-id>openclaw skills workshop revise <proposal-id> --proposal ./PROPOSAL.mdopenclaw skills workshop apply <proposal-id>openclaw skills workshop reject <proposal-id> --reason "Not reusable"openclaw skills workshop quarantine <proposal-id> --reason "Needs security review"search、update 與 verify 會直接使用 ClawHub。install @owner/<slug> 會安裝 ClawHub Skill，install git:owner/repo[@ref] 會複製 Git Skill，而 install ./path 會複製本機 Skill 目錄。install、update 與 verify 預設以作用中的工作區 skills/ 目錄為目標；搭配 --global 時，則以共用的受管理 Skills 目錄為目標。list／info／check 仍會檢查目前工作區與設定可見的本機 Skills。以工作區為基礎的命令會依序從 --agent <id>、位於已設定代理程式工作區內的目前工作目錄，以及預設代理程式解析目標工作區。
Git 與本機目錄安裝要求來源根目錄中存在 SKILL.md。若 SKILL.md frontmatter 中的 name 有效，安裝代稱會取自該值，否則取自來源目錄或儲存庫名稱；可使用 --as <slug> 覆寫。--version 僅適用於 ClawHub。Skill 安裝不支援 npm 套件規格或 zip／封存檔路徑，而 openclaw skills update 僅更新由 ClawHub 追蹤的安裝項目。
從新手引導或 Skills 設定觸發、由閘道支援的 Skill 相依項目安裝，會改用獨立的 skills.install 請求路徑。
注意事項：
| 旗標／行為 | 說明 |
|---|---|
search [query...] |
查詢為選用；省略時會瀏覽預設的 ClawHub 搜尋動態。 |
search --limit <n> |
限制傳回的結果數量。 |
install git:owner/repo[@ref] |
安裝 Git Skill。分支參照可包含斜線，例如 git:owner/repo@feature/foo。 |
install ./path/to/skill |
安裝根目錄含有 SKILL.md 的本機目錄。 |
install --as <slug> |
覆寫為 Git 與本機目錄安裝推斷出的代稱。 |
install --version <version> |
僅適用於 ClawHub Skill 參照。 |
install --force |
覆寫工作區中相同代稱的現有 Skill 資料夾。 |
install/update --force-install |
在 ClawHub 掃描完成前，安裝待處理且由 GitHub 支援的 ClawHub Skill。 |
--global |
以共用的受管理 Skills 目錄為目標；不能與 --agent <id> 搭配使用。 |
--agent <id> |
以一個已設定的代理程式工作區為目標；覆寫根據目前工作目錄進行的推斷。 |
update @owner/<slug> |
更新單一受追蹤的 Skill。加入 --global，即可改以共用的受管理 Skills 目錄而非工作區為目標。 |
update --all |
更新所選工作區內受追蹤的 ClawHub 安裝項目；搭配 --global 時，則更新共用的受管理 Skills 目錄。 |
verify @owner/<slug> |
預設輸出 ClawHub 的 clawhub.skill.verify.v1 JSON 封套。由於 JSON 已是預設格式，因此沒有 --json 旗標。若 Skill 已安裝或代稱無歧義，基於相容性也接受不含擁有者的代稱；使用包含擁有者的參照可避免發布者歧義。 |
verify 來源證明 |
當 ClawHub 傳回由伺服器解析的來源證明時，驗證 JSON 也會包含鎖定至提交的 openclaw.verifiedSourceUrl。無法使用或自行宣告的來源 URL 只會保留於原始來源證明封套中，不會提升為已驗證來源。 |
verify 版本選擇器 |
對於已安裝的 ClawHub Skills，verify 會使用 .clawhub/origin.json，因此會針對其來源登錄檔驗證已安裝版本。--version 與 --tag 會覆寫版本選擇器，但在存在來源中繼資料時仍保留該已安裝項目的登錄檔。 |
verify --card |
輸出產生的 Skill 卡片 Markdown，而非 JSON。當 ClawHub 傳回 ok: false 或 decision: "fail" 時，會以非零狀態結束；除非 ClawHub 政策變更，否則未簽署的簽章僅供參考。 |
| Skill 卡片指紋 | 已安裝的 ClawHub 套件組合可包含產生的 skill-card.md。OpenClaw 將驗證視為 ClawHub 伺服器的決策，不會僅因該產生卡片改變套件組合指紋，就拒絕已安裝的 Skill。 |
check --agent <id> |
檢查所選代理程式的工作區，並回報哪些就緒的 Skills 實際上對該代理程式的提示或命令介面可見。 |
list |
未提供子命令時的預設動作。 |
list/info/check 輸出 |
轉譯後的輸出會送至 stdout。搭配 --json 時，機器可讀的承載資料會保留在 stdout，以供管線與指令碼使用。 |
社群 ClawHub Skill 的安裝與更新會在下載前檢查信任狀態。具有版本的社群封存發行版會使用精確發行版的信任中繼資料。由解析器支援的 GitHub Skills 依賴 ClawHub 的安裝解析器，在傳回鎖定的提交前強制執行掃描與強制安裝政策；可使用 --force-install，在掃描完成前安裝待處理且由 GitHub 支援的 Skill。系統會拒絕惡意或遭封鎖的社群發行版。有風險的社群發行版需要經過審查；若非互動式命令要在審查後繼續執行，則須使用 --acknowledge-clawhub-risk。官方 ClawHub Skill 發布者與 OpenClaw 隨附的 Skill 來源會略過此發行版信任提示。
Skill 工作坊
openclaw skills workshop 會管理所選工作區中待處理的 Skill 提案。提案在套用前不會成為作用中的 Skills。有關提案儲存、支援檔案防護措施、閘道方法與核准政策，請參閱Skill 工作坊。
openclaw skills workshop propose-create \ --name "qa-check" \ --description "Repeatable QA checklist" \ --proposal ./PROPOSAL.mdopenclaw skills workshop propose-create \ --name "qa-check" \ --description "Repeatable QA checklist" \ --proposal-dir ./qa-check-proposalopenclaw skills workshop propose-update qa-check --proposal ./PROPOSAL.mdopenclaw skills workshop listopenclaw skills workshop inspect <proposal-id>openclaw skills workshop revise <proposal-id> --proposal ./PROPOSAL.mdopenclaw skills workshop apply <proposal-id>openclaw skills workshop reject <proposal-id> --reason "Duplicate"openclaw skills workshop quarantine <proposal-id> --reason "Needs security review"propose-create、propose-update 和 revise 也接受 --goal <text>
和 --evidence <text>，用來在 --proposal／--proposal-dir 內容之外，
一併記錄提案的動機與佐證說明。
