使用技能扩展 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 配置额外的技能文件夹。

每代理 vs 共享技能

在多代理设置中：

每代理技能：位于 <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: 这个技能做什么
---

给代理的说明...

可选前置内容键

键	描述
`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: 我的技能描述
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