使用技能擴展 Clawdbot AI 助手。了解如何為您的個人 AI 助手創建、安裝和管理技能。

Clawdbot 技能概覽

Clawdbot 使用與 AgentSkills 兼容的技能資料夾來教導代理如何使用工具。每個技能是一個包含 SKILL.md 的目錄，其中包含 YAML 前置元數據和說明。

Clawdbot 加載捆綁的技能以及可選的本地覆蓋，並在加載時根據環境、配置和二進制文件存在情況進行過濾。

技能位置和優先級

技能從三個位置加載：

位置	說明
捆綁技能	隨安裝包提供（npm 包或 Clawdbot.app）
管理/本地技能	`~/.clawdbot/skills`
工作區技能	`<workspace>/skills`

優先級（從高到低）：

<workspace>/skills
~/.clawdbot/skills
捆綁技能

您可以通過 ~/.clawdbot/clawdbot.json 中的 skills.load.extraDirs 配置額外的技能資料夾。

代理專用與共享技能

在多代理設置中：

代理專用技能：位於 <workspace>/skills 中，僅供該代理使用
共享技能：位於 ~/.clawdbot/skills 中，對所有代理可見

ClawHub（安裝 + 同步）

ClawHub 是 Clawdbot 的公共技能註冊表。瀏覽 https://clawhub.com。

常用流程：

# 將技能安裝到您的工作區
clawhub install <skill-slug>

# 更新所有已安裝的技能
clawhub update --all

# 同步（掃描 + 發布更新）
clawhub sync --all

默認情況下，clawhub 會安裝到當前工作目錄下的 ./skills。

技能格式

SKILL.md 必須至少包含：

---
name: my-skill
description: What this skill does
---

Instructions for the agent...

可選的前置元數據鍵

鍵	說明
`homepage`	在技能 UI 中顯示為「網站」的 URL
`user-invocable`	`true\|false`（默認：true）- 作為用戶斜線命令公開
`disable-model-invocation`	`true\|false`（默認：false）- 從模型提示中排除
`command-dispatch`	`tool` - 繞過模型直接分派到工具
`command-tool`	當 `command-dispatch: tool` 時要調用的工具名稱

門控（加載時過濾器）

使用元數據在加載時過濾技能：

---
name: my-skill
description: My skill description
metadata: {"openclaw": {"requires": {"bins": ["uv"], "env": ["API_KEY"], "config": ["browser.enabled"]}}}
---

門控字段

字段	說明
`always: true`	始終包含該技能
`requires.bins`	必需的二進制文件
`requires.env`	必需的環境變量
`requires.config`	必需的配置鍵
`primaryEnv`	技能的主要環境變量

配置覆蓋

在 ~/.clawdbot/clawdbot.json 中覆蓋技能設置：

{
  "skills": {
    "entries": {
      "my-skill": {
        "enabled": true,
        "env": {
          "API_KEY": "your-key"
        }
      }
    }
  }
}

安全注意事項

將第三方技能視為不受信任的代碼
啟用前先閱讀技能
對於不受信任的輸入，優先使用沙盒運行
將密鑰保存在提示和日誌之外

外掛程式 + 技能

外掛程式可以通過在 clawdbot.plugin.json 中列出技能目錄來提供自己的技能。當外掛程式啟用時，外掛程式技能會加載。

技能監視器（自動刷新）

Clawdbot 監視技能目錄的變化，並在添加、修改或刪除技能時自動刷新。

下一步

Clawdbot 斜線命令 - 命令參考
Clawdbot 工具 - 工具配置
Clawdbot 網關 - 網關配置

Clawdbot 技能

On this page