Skip to content
OpenClaw Docs

Skills

openclaw skills

Section titled “openclaw skills”

檢查本地技能、搜尋 ClawHub、從 ClawHub/Git/本機目錄安裝技能、驗證 ClawHub 技能，以及更新 ClawHub 追蹤的安裝。

相關：

指令

Section titled “指令”
Terminal window
openclaw skills search "calendar"
openclaw skills search --limit 20 --json
openclaw skills install <slug>
openclaw skills install <slug> --version <version>
openclaw skills install git:owner/repo
openclaw skills install git:owner/repo@main
openclaw skills install ./path/to/skill --as custom-name
openclaw skills install <slug> --force
openclaw skills install <slug> --agent <id>
openclaw skills install <slug> --global
openclaw skills update <slug>
openclaw skills update <slug> --global
openclaw skills update --all
openclaw skills update --all --agent <id>
openclaw skills update --all --global
openclaw skills verify <slug>
openclaw skills verify <slug> --version <version>
openclaw skills verify <slug> --tag <tag>
openclaw skills verify <slug> --card
openclaw skills verify <slug> --global
openclaw skills list
openclaw skills list --eligible
openclaw skills list --json
openclaw skills list --verbose
openclaw skills list --agent <id>
openclaw skills info <name>
openclaw skills info <name> --json
openclaw skills info <name> --agent <id>
openclaw skills check
openclaw skills check --agent <id>
openclaw skills check --json
openclaw skills workshop propose-create --name "qa-check" --description "QA checklist" --proposal ./PROPOSAL.md
openclaw skills workshop propose-update qa-check --proposal ./PROPOSAL.md
openclaw skills workshop list
openclaw skills workshop inspect <proposal-id>
openclaw skills workshop revise <proposal-id> --proposal ./PROPOSAL.md
openclaw 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 <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> 解析目標工作區，接著 在當前工作目錄位於已設定的 agent 工作區內時從該處解析，然後是預設 agent。

Git 和本機目錄安裝預期來源根目錄中有 SKILL.md。當有效時， 安裝的 slug 來自 SKILL.md frontmatter name，然後是 來源目錄或存放庫名稱；請使用 --as <slug> 加以覆寫。--version 僅限 ClawHub。Skill 安裝不支援 npm 套件規格或 zip/壓縮檔 路徑，且 openclaw skills update 僅更新由 ClawHub 追蹤的安裝項目。

從 onboarding 或 Skills 設定觸發的 Gateway 支援 skill 相依性安裝，改用 個別的 skills.install 要求路徑。

備註：

  • search [query...] 接受選用查詢；省略它以瀏覽預設的 ClawHub 搜尋動態饋送。
  • search --limit <n> 限制傳回結果。
  • install git:owner/repo[@ref] 安裝 Git 技能。分支參照可能包含斜線，例如 git:owner/repo@feature/foo。
  • install ./path/to/skill 安裝一個本機目錄，其根目錄包含 SKILL.md。
  • install --as <slug> 覆寫 Git 和本機目錄安裝的推斷 slug。
  • install --version <version> 僅適用於 ClawHub 技能 slug。
  • install --force 覆寫相同 slug 的現有工作區技能資料夾。
  • --global 指向共享管理技能目錄，且不能與 --agent <id> 結合使用。
  • --agent <id> 指向一個設定的代理程式工作區，並覆寫目前工作目錄的推斷。
  • update <slug> 更新單一追蹤的技能。新增 --global 以指向共享管理技能目錄而非工作區。
  • update --all 更新所選工作區中已追蹤的 ClawHub 安裝，或在與 --global 結合時更新共享管理技能目錄中的安裝。
  • verify <slug> 預設會列印 ClawHub 的 clawhub.skill.verify.v1 JSON 信封。沒有 --json 標誌，因為 JSON 已經是預設值。
  • verify 對已安裝的 ClawHub 技能使用 .clawhub/origin.json，因此它會根據其來源註冊表驗證已安裝的版本。--version 和 --tag 會覆寫版本選擇器，但在來源中繼資料存在時保留該已安裝的註冊表。
  • verify --card 列印產生的技能卡 Markdown 而非 JSON。當 ClawHub 傳回 ok: false 或 decision: "fail" 時，指令會以非零值結束；除非 ClawHub 政策變更，否則未簽署的簽章僅供參考。
  • 已安裝的 ClawHub 套件可能包含生成的 skill-card.md。OpenClaw 將驗證視為 ClawHub 伺服器的決定，並不會僅因該生成的卡片變更了套件 指紋而拒絕已安裝的技能。
  • check --agent <id> 會檢查所選代理人的工作區，並報告哪些 就緒的技能實際上對該代理人的提示或命令介面可見。
  • 當未提供子指令時，list 為預設動作。
  • list、info 和 check 會將其輸出結果寫入 stdout。對於 --json，這意味著機器可讀的酬載會保留在 stdout 上以供管道 和腳本使用。

技能工作坊

Section titled “技能工作坊”

openclaw skills workshop 管理所選工作區中的待處理技能提案。提案在被套用之前 並非有效技能。關於提案儲存、支援檔案防護措施、Gateway 方法以及審核策略，請參閱 技能工作坊。

Terminal window
openclaw skills workshop propose-create \
  --name "qa-check" \
  --description "Repeatable QA checklist" \
  --proposal ./PROPOSAL.md
openclaw skills workshop propose-create \
  --name "qa-check" \
  --description "Repeatable QA checklist" \
  --proposal-dir ./qa-check-proposal
openclaw skills workshop propose-update qa-check --proposal ./PROPOSAL.md
openclaw skills workshop list
openclaw skills workshop inspect <proposal-id>
openclaw skills workshop revise <proposal-id> --proposal ./PROPOSAL.md
openclaw skills workshop apply <proposal-id>
openclaw skills workshop reject <proposal-id> --reason "Duplicate"
openclaw skills workshop quarantine <proposal-id> --reason "Needs security review"

相關

Section titled “相關”