Skills

• 省略 agents.defaults.skills，默认不限制任何 Skills。
• 省略 agents.entries.*.skills，以继承 agents.defaults.skills。
• 将 agents.entries.*.skills: [] 设为不向该智能体公开任何 Skills。
• 非空的 agents.entries.*.skills 列表是最终集合，不会 与默认值合并。
• 生效的允许列表适用于提示词构建、斜杠命令 发现、沙箱同步和 Skill 快照。
• 这并非主机 shell 授权边界。如果同一智能体能够 使用 exec，请另外通过沙箱隔离、操作系统用户 隔离、Exec 拒绝／允许列表和按资源配置的凭据来限制该 shell。

默认情况下，openclaw skills install 会安装到当前工作区的 skills/ 目录中。添加 --global 可安装到共享的 ~/.openclaw/skills 目录中；除非智能体允许列表缩小范围，否则所有本地智能体 都可见。

Git 和本地安装要求源根目录中存在 SKILL.md。如果 SKILL.md frontmatter 的 name 有效，则使用它作为 slug，否则回退到 目录或仓库名称。使用 --as <slug> 可覆盖此值。 openclaw skills update 仅跟踪 ClawHub 安装——要刷新 Git 或 本地来源，请重新安装。

openclaw skills verify @owner/<slug> 会向 ClawHub 请求 Skill 的 clawhub.skill.verify.v1 信任边界。已安装的 ClawHub Skills 会根据 .clawhub/origin.json 中记录的版本和注册表进行验证。 对于现有已安装或名称明确的 Skills，仍接受不带所有者的 slug，但 带所有者限定的引用可以避免发布者歧义。

ClawHub Skill 页面会在安装前显示最新的安全扫描状态， 并提供 VirusTotal、ClawScan 和静态分析的详情页面。当 ClawHub 将验证标记为失败时，命令会以非零状态退出。发布者可通过 ClawHub 控制面板或 clawhub skill rescan @owner/<slug> 处理误报。

需要非 ClawHub 交付方式的 Gateway 网关客户端，可以使用 skills.upload.begin、skills.upload.chunk 和 skills.upload.commit 暂存 zip 格式的 Skill 归档，然后使用 skills.install({ source: "upload", ... }) 安装。此路径 默认关闭，并要求在 openclaw.json 中配置 skills.install.allowUploadedArchives: true。常规 ClawHub 安装绝不需要该设置。

工作区、项目智能体和额外目录的 Skill 发现仅接受解析后的 realpath 仍位于已配置根目录内的 Skill 根目录，除非 skills.load.allowSymlinkTargets 明确信任目标根目录。 仅当启用 skills.workshop.allowSymlinkTargetWrites 时，Skill Workshop 才能通过这些受信任的目标 写入。 托管的 ~/.openclaw/skills 和个人的 ~/.agents/skills 可以包含 符号链接 Skill 文件夹，但每个 SKILL.md 的 realpath 仍必须位于 其解析后的 Skill 目录内。

配置 security.installPolicy，以便在继续安装 Skill 前运行受信任的本地策略命令。 该策略会接收元数据和暂存的源路径，适用于 ClawHub、上传、Git、本地、更新和 依赖项安装器路径；命令无法返回有效决策时会采用失败关闭策略。

skills.entries.*.env 和 skills.entries.*.apiKey 仅在该智能体轮次内将密钥注入 主机进程，而不是沙箱。不要在提示词和日志中包含密钥。

• 列出多个安装程序时，Gateway 网关会选择一个首选 选项（有 brew 时选择 brew，否则选择 node）。
• 如果所有安装程序都是 download，OpenClaw 会列出每个条目，以便你 查看所有可用工件。
• 规范可以包含 os: ["darwin"|"linux"|"win32"]，以按平台筛选。
• Node 安装遵循 openclaw.json 中的 skills.install.nodeManager （默认值：npm；选项：npm / pnpm / yarn / bun）。这仅影响技能 安装；Gateway 网关运行时仍应使用 Node。
• Gateway 网关安装程序优先级：Homebrew → uv → 已配置的 node 管理器 → go → download。

• **Homebrew：**OpenClaw 不会自动安装 Homebrew，也不会将 brew 公式转换为系统软件包命令。在缺少 brew 的 Linux 容器中，仅支持 brew 的安装程序会被隐藏；请使用自定义镜像或手动安装 依赖项。
• **Go：**OpenClaw 要求 Go 1.21 或更高版本才能自动安装技能。 如果缺少 go 且 Homebrew 可用，OpenClaw 会先通过 Homebrew 安装 Go；在没有 Homebrew 的 Linux 上，如果刷新的 golang-go 候选版本满足最低版本要求，则可以改为以 root 身份或通过无需密码的 sudo 使用 apt-get。 依赖项实际使用的 go install 始终指向 OpenClaw 管理的专用 bin 目录 （全新安装时为 Homebrew 的 bin，否则为 ~/.local/bin），而不是 你配置的 GOBIN —— 系统会读取你自己的 GOBIN、GOPATH 和 GOTOOLCHAIN 环境变量，但绝不会覆盖它们。
• 下载：url（必需）、archive（tar.gz | tar.bz2 | zip）、 extract（默认值：检测到归档时为 auto）、stripComponents、 targetDir（默认值：~/.openclaw/tools/<skillKey>）。

加载技能时会在宿主机上检查 requires.bins。如果智能体 在沙箱中运行，该二进制文件也必须存在于容器内部。 请通过 agents.defaults.sandbox.docker.setupCommand 或自定义 镜像安装。setupCommand 在容器创建后运行一次，并要求 沙箱具备网络出口、可写的根文件系统以及 root 用户。

默认情况下，OpenClaw 会监视技能文件夹，并在 SKILL.md 文件发生更改时更新快照。请在 skills.load 下配置：

{  skills: {    load: {      extraDirs: ["~/Projects/agent-scripts/skills"],      allowSymlinkTargets: ["~/Projects/manager/skills"],      watch: true, // 默认值    },  },}

监视器事件使用内置的 250 ms 防抖。对于技能 根符号链接指向已配置根目录之外的有意符号链接布局，请使用 allowSymlinkTargets， 例如 <workspace>/skills/manager -> ~/Projects/manager/skills。 仅当 Skill Workshop 也应通过这些受信任的符号链接路径 应用提案时，才启用 skills.workshop.allowSymlinkTargetWrites。

如果 Gateway 网关在 Linux 上运行，但已连接一个允许 system.run 的 macOS 节点，且该节点上存在所需的二进制文件， OpenClaw 可以将仅限 macOS 的技能视为符合条件。智能体应通过 exec 工具并使用 host=node 来运行这些 技能。

离线节点不会使仅限远程的技能可见。如果节点停止 响应二进制文件探测，OpenClaw 会清除其缓存的二进制文件匹配项。