首页 / 操作手册 / 技能管理

技能管理

最后更新时间：2026年10月1日

SKILL 技能用于把一组提示词、领域知识与执行步骤封装为可复用的能力单元，供自主规划智能体在运行时按需调用。 与 MCP 工具（连接外部系统）不同，技能更适合沉淀「怎么做某件事」的领域经验与标准化流程，例如合同审核要点、报告撰写规范、行业术语解释等。

技能与 MCP 工具的区别 技能侧重「方法、规范与流程」，以 Markdown 指令（SKILL.md）为核心；MCP 工具侧重「连接与执行」，用于调用外部接口或系统。两者可以组合使用：智能体在自主规划时，既可选择某项技能，也可调用某个 MCP 工具。

功能的入口与构成

进入平台左侧导航的「技能库」菜单，即可看到技能管理页面。页面顶部提供「公开技能库」与「我的技能库」两个页签：

  • 我的技能库：展示由当前账号创建的技能。
  • 公开技能库：展示他人公开（或共享授权给你）的技能，可直接在智能体中引用。

技能列表

技能以卡片形式展示，每张卡片包含：

信息 说明
名称 / 标识 技能名称与唯一标识（slug），标识在创建后不可修改。
描述 技能用途与适用场景的简要说明。
可见性 私有、共享授权或公开。
状态 已启用或已禁用。仅已启用的技能可被智能体绑定。
绑定数 当前引用该技能的智能体数量。
创建人 / 创建时间 技能的创建账号与创建时间。

页面顶部支持按技能名称、标识进行模糊搜索，并按可见性与启用状态筛选。卡片操作菜单提供以下入口（部分操作仅创建者可见）：

  • 查看：查看技能详情。
  • 共享：将技能授权给指定用户或部门，详见 共享授权。
  • 编辑：修改技能信息（仅创建者）。
  • 启用 / 禁用：控制技能是否可被智能体绑定（仅创建者）。
  • 删除：删除技能（仅创建者）。

新建技能

点击「新建 Skill」，填写以下信息后保存：

字段 是否必填 说明
Skill 名称 必填 技能名称，全局唯一，建议使用能体现能力的中文名称。
Skill 标识 必填 技能的唯一标识（slug）。系统会自动转为小写，并将空格等字符规范化为下划线；仅允许小写字母、数字、下划线与短横线，且全局唯一。保存后不可修改。
描述 必填 说明该技能适用什么场景、解决什么问题，便于他人理解与选用。
指令内容 必填 技能的核心正文，即智能体执行该技能时遵循的指令，会被保存为技能的 SKILL.md 主体内容。
可见性 必填 私有（仅创建者可用）、共享授权（授权给指定用户/部门）、公开（所有登录用户可用）。
指令内容怎么写 建议在「指令内容」中清晰描述：技能要达成的目标、执行步骤或检查清单、输出格式要求、以及需要遵守的边界与禁止事项。指令越具体，智能体执行越稳定。

上传技能包

如果已有按规范打包的技能，可直接上传 zip 技能包导入。点击「上传 Skill」，选择 zip 文件并按需填写名称、标识、描述与可见性即可。

  • 仅支持 .zip 格式的技能包。
  • 支持符合 ClawHub 规范的技能包（包内包含 manifest.json，其中 name 为必填字段）。
  • 同时兼容 openclaw 规范的技能包（包含 _meta.json 与 SKILL.md，系统会自动解析其中的元信息）。
  • 包内若为单层子目录嵌套，系统会自动识别并整理。
  • 上传时不填写名称或标识，将自动读取技能包中的信息或使用文件名。
上传安全 请仅上传来源可信的技能包。平台会校验并拒绝包含绝对路径或 .. 路径穿越的压缩包，避免文件被写入非预期目录。

查看技能详情

点击「查看」可查看技能的名称、标识、绑定次数、可见性、启用状态、创建者、创建时间、描述、指令内容与技能清单（Manifest）。

当技能创建或上传过程中出现异常时，「最近错误」字段会展示失败原因，可据此定位问题后重新创建或重新上传。

启用与禁用

技能创建后默认启用。禁用后，该技能不能再被智能体绑定；已绑定的智能体会在保存或运行时校验失败。启用/禁用操作仅技能创建者可以执行。

在智能体中使用技能

进入「自主规划」智能体的创建或编辑页面，在技能装配区域勾选需要装配的技能即可。可被选用的技能需同时满足：技能已启用、且对当前账号可见（公开、本人创建或已共享授权给你）。

保存智能体时，平台会校验所选技能是否有效、是否被禁用、是否有绑定权限，并给出对应提示。

运行时，智能体会加载技能目录内容，并根据任务需要自主决定是否使用该技能。每个技能以 /skills/{技能标识}/ 的虚拟路径挂载给智能体访问。

实践建议 技能数量不宜过多。建议一个技能聚焦一类明确任务，并通过清晰的描述与指令内容帮助智能体在规划时准确判断「何时该用这个技能」。

删除技能

  • 仅技能创建者可以删除技能。
  • 若该技能仍被智能体绑定，需先在智能体中解绑，否则无法删除。
  • 删除后，技能文件与相关共享授权会一并清理，且无法恢复，请谨慎操作。

权限与可见范围

  • 私有：仅创建者（及被共享授权的用户/部门）可见、可用。
  • 共享授权：由创建者授权给指定用户或部门，授权级别分为「使用」与「管理」。
  • 公开：所有登录用户可见、可用，但仅创建者可以编辑、启用/禁用与删除。

技能创建与上传功能受平台 License 的「技能（SKILL）」功能开关控制；若开关关闭，将无法创建或上传技能。

相关章节