• 原始链接：https://docs.openclaw.ai/zh-CN/tools/skills-config
• 来源章节：5. 官方文档：工具、技能、插件与自动化
• 来源小节：无
• 抓取方式：jina:https://r.jina.ai/http://docs.openclaw.ai/zh-CN/tools/skills-config
• 抓取时间：2026-04-05 13:47:10
• 状态：ok

中文内容

Skills 配置 - OpenClaw

跳转到主要内容

OpenClaw home page

简体中文

搜索...

Ctrl K

• GitHub
• Releases
• Discord

搜索...

Navigation

技能

Skills 配置

快速开始安装消息渠道代理工具模型平台网关与运维参考帮助

概览

• 工具

内置工具

• apply_patch 工具
• Brave Search
• 提升模式
• Exec 工具
• 执行审批
• Firecrawl
• LLM 任务
• Lobster
• Perplexity Sonar
• 表情回应
• 思考级别
• Web 工具

浏览器

• 浏览器（OpenClaw 托管）
• 浏览器登录
• 浏览器故障排除

代理协作

• Agent Send
• 子智能体
• 多智能体沙箱与工具

技能

• 创建 Skills
• 斜杠命令
• Skills
• Skills 配置
• ClawHub
• 插件

扩展

• Voice Call 插件
• Zalo Personal 插件
• 插件清单
• 插件智能体工具
• OpenProse

自动化与任务

• Hooks
• 定时任务

媒体与设备

• 节点
• 节点故障排查
• 媒体理解
• 图像和媒体支持
• 音频与语音消息
• 相机捕获
• Talk 模式
• 语音唤醒
• 位置命令
• 文本转语音

在此页面

• Skills 配置
• 字段
• 注意事项
• 沙箱隔离的 Skills + 环境变量

技能

Skills 配置

​

Skills 配置

所有 Skills 相关配置都位于 ~/.openclaw/openclaw.json 中的 skills 下。

{
  skills: {
    allowBundled: ["gemini", "peekaboo"],
    load: {
      extraDirs: ["~/Projects/agent-scripts/skills", "~/Projects/oss/some-skill-pack/skills"],
      watch: true,
      watchDebounceMs: 250,
    },
    install: {
      preferBrew: true,
      nodeManager: "npm", // npm | pnpm | yarn | bun（Gateway 网关运行时仍为 Node；不推荐 bun）
    },
    entries: {
      "nano-banana-pro": {
        enabled: true,
        apiKey: "GEMINI_KEY_HERE",
        env: {
          GEMINI_API_KEY: "GEMINI_KEY_HERE",
        },
      },
      peekaboo: { enabled: true },
      sag: { enabled: false },
    },
  },
}

​

字段

• allowBundled：可选的仅用于内置 Skills 的白名单。设置后，只有列表中的内置 Skills 才有资格（托管/工作区 Skills 不受影响）。
• load.extraDirs：要扫描的附加 Skills 目录（最低优先级）。
• load.watch：监视 Skills 文件夹并刷新 Skills 快照（默认：true）。
• load.watchDebounceMs：Skills 监视器事件的防抖时间（毫秒）（默认：250）。
• install.preferBrew：在可用时优先使用 brew 安装器（默认：true）。
• install.nodeManager：node 安装器偏好（npm | pnpm | yarn | bun，默认：npm）。这仅影响 Skills 安装；Gateway 网关运行时应仍为 Node（不推荐 Bun 用于 WhatsApp/Telegram）。
• entries.<skillKey>：单 Skills 覆盖。

单 Skills 字段：

• enabled：设置为 false 以禁用某个 Skills，即使它是内置/已安装的。
• env：为智能体运行注入的环境变量（仅在尚未设置时）。
• apiKey：可选的便捷字段，用于声明主环境变量的 Skills。

​

注意事项

• entries 下的键默认映射到 Skills 名称。如果 Skills 定义了 metadata.openclaw.skillKey，则使用该键。
• 启用监视器后，Skills 的更改会在下一个智能体轮次被获取。

​

沙箱隔离的 Skills + 环境变量

当会话处于沙箱隔离状态时，Skills 进程在 Docker 内运行。沙箱不会继承宿主机的 process.env。使用以下方式之一：

• agents.defaults.sandbox.docker.env（或单智能体的 agents.list[].sandbox.docker.env）
• 将环境变量烘焙到你的自定义沙箱镜像中

全局 env 和 skills.entries.<skill>.env/apiKey 仅适用于宿主机运行。

SkillsClawHub

Ctrl+I

技术支持 This documentation is built and hosted on Mintlify, a developer documentation platform