OpenClaw从入门到应用——工具（Tools）：技能配置

通过OpenClaw实现副业收入《OpenClaw赚钱实录从“养龙虾“到可持续变现的实践指南》所有与技能相关的配置都位于~/.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 (网关运行时仍为 Node不推荐使用 bun) }, entries: { nano-banana-pro: { enabled: true, apiKey: { source: env, provider: default, id: GEMINI_API_KEY }, // 或纯文本字符串 env: { GEMINI_API_KEY: GEMINI_KEY_HERE, }, }, peekaboo: { enabled: true }, sag: { enabled: false }, }, }, }字段说明allowBundled: 仅针对内置技能的可选允许列表。设置后只有列表中的内置技能可用受管/工作区技能不受影响。load.extraDirs: 要扫描的额外技能目录优先级最低。load.watch: 监听技能文件夹并刷新技能快照默认true。load.watchDebounceMs: 技能监听器事件的防抖时间以毫秒为单位默认250。install.preferBrew: 可用时优先使用 brew 安装器默认true。install.nodeManager: Node 安装器偏好npm|pnpm|yarn|bun默认npm。这仅影响技能安装网关运行时仍应使用 Node对于 WhatsApp/Telegram 不推荐使用 Bun。entries.skillKey: 每个技能的单独覆盖配置。每个技能的字段enabled: 设置为false可禁用某个技能即使该技能是内置/已安装的。env: 为代理运行注入的环境变量仅在尚未设置时生效。apiKey: 为声明了主环境变量的技能提供的可选便捷配置。支持纯文本字符串或 SecretRef 对象{ source, provider, id }。注意事项entries下的键默认映射到技能名称。如果技能定义了metadata.openclaw.skillKey请改用该键。当监听器启用时对技能的更改将在下一个代理回合中被获取。沙盒技能与环境变量当会话处于沙盒模式时技能进程在 Docker 内部运行。沙盒不会继承主机的process.env。请使用以下方式之一agents.defaults.sandbox.docker.env或针对每个代理的agents.list[].sandbox.docker.env将环境变量烘焙到您的自定义沙盒镜像中全局env和skills.entries.skill.env/apiKey配置仅适用于主机运行环境。