​

Cấu hình 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 runtime still Node; bun not recommended)
    },
    entries: {
      "nano-banana-pro": {
        enabled: true,
        apiKey: "GEMINI_KEY_HERE",
        env: {
          GEMINI_API_KEY: "GEMINI_KEY_HERE",
        },
      },
      peekaboo: { enabled: true },
      sag: { enabled: false },
    },
  },
}

​

Trường

• 50. allowBundled: danh sách cho phép tùy chọn chỉ dành cho các kỹ năng được đóng gói. When set, only bundled skills in the list are eligible (managed/workspace skills unaffected).
• load.extraDirs: các thư mục skill bổ sung để quét (độ ưu tiên thấp nhất).
• load.watch: theo dõi các thư mục skill và làm mới ảnh chụp skills (mặc định: true).
• load.watchDebounceMs: debounce cho các sự kiện watcher của skill tính bằng mili giây (mặc định: 250).
• install.preferBrew: ưu tiên trình cài đặt brew khi có sẵn (mặc định: true).
• install.nodeManager: node installer preference (npm | pnpm | yarn | bun, default: npm). This only affects skill installs; the Gateway runtime should still be Node (Bun not recommended for WhatsApp/Telegram).
• entries.<skillKey>: per-skill overrides.

• enabled: đặt false để vô hiệu hóa một skill ngay cả khi nó được gói sẵn/cài đặt.
• env: biến môi trường được chèn cho lần chạy tác tử (chỉ khi chưa được đặt).
• apiKey: tiện ích tùy chọn cho các skills khai báo một biến môi trường chính.

​

Ghi chú

• Keys under entries map to the skill name by default. If a skill defines metadata.openclaw.skillKey, use that key instead.
• Các thay đổi đối với skills sẽ được áp dụng ở lượt tác tử tiếp theo khi watcher được bật.

​

Skills sandboxed + biến môi trường

1. Khi một phiên làm việc được sandboxed, các tiến trình kỹ năng sẽ chạy bên trong Docker. 2. Sandbox không kế thừa process.env của máy chủ.

• agents.defaults.sandbox.docker.env (hoặc agents.list[].sandbox.docker.env theo từng tác tử)
• bake biến môi trường vào image sandbox tùy chỉnh của bạn

3. env toàn cục và skills.entries.<skill>
4. .env/apiKey chỉ áp dụng cho các lần chạy trên host.5. OpenClaw sử dụng các thư mục kỹ năng tương thích AgentSkills để dạy agent cách sử dụng công cụ.