การกำหนดค่า Skills

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

{
  skills: {
    allowBundled: ["gemini", "peekaboo"],
    load: {
      extraDirs: ["~/Projects/agent-scripts/skills", "~/Projects/oss/some-skill-pack/skills"],
      allowSymlinkTargets: ["~/Projects/manager/skills"],
      watch: true,
      watchDebounceMs: 250,
    },
    install: {
      preferBrew: true,
      nodeManager: "npm", // npm | pnpm | yarn | bun (Gateway runtime still Node; bun not recommended)
      allowUploadedArchives: false,
    },
    entries: {
      "image-lab": {
        enabled: true,
        apiKey: { source: "env", provider: "default", id: "GEMINI_API_KEY" }, // or plaintext string
        env: {
          GEMINI_API_KEY: "GEMINI_KEY_HERE",
        },
      },
      peekaboo: { enabled: true },
      sag: { enabled: false },
    },
  },
}

• การตั้งค่าสไตล์ Native Nano Banana Pro: agents.defaults.imageGenerationModel.primary: "google/gemini-3-pro-image-preview"
• การตั้งค่า native fal: agents.defaults.imageGenerationModel.primary: "fal/fal-ai/flux/dev"

​

allowlist ของ agent skill

{
  agents: {
    defaults: {
      skills: ["github", "weather"],
    },
    list: [
      { id: "writer" }, // inherits defaults -> github, weather
      { id: "docs", skills: ["docs-search"] }, // replaces defaults
      { id: "locked-down", skills: [] }, // no skills
    ],
  },
}

• agents.defaults.skills: allowlist พื้นฐานร่วมสำหรับ agent ที่ละเว้น agents.list[].skills
• ละเว้น agents.defaults.skills เพื่อให้ Skills ไม่ถูกจำกัดตามค่าเริ่มต้น
• agents.list[].skills: ชุด skill สุดท้ายที่ระบุอย่างชัดเจนสำหรับ agent นั้น โดยจะไม่รวมกับค่าเริ่มต้น
• agents.list[].skills: []: ไม่เปิดเผย skill ใด ๆ สำหรับ agent นั้น

​

ฟิลด์

• root ของ skill ในตัวจะรวม ~/.openclaw/skills, ~/.agents/skills, <workspace>/.agents/skills และ <workspace>/skills เสมอ
• allowBundled: allowlist ทางเลือกสำหรับ Skills แบบ bundled เท่านั้น เมื่อตั้งค่าแล้ว จะมีเพียง Skills แบบ bundled ในรายการเท่านั้นที่มีสิทธิ์ใช้งาน (Skills แบบ managed, agent และ workspace ไม่ได้รับผลกระทบ)
• load.extraDirs: ไดเรกทอรี skill เพิ่มเติมสำหรับสแกน (ลำดับความสำคัญต่ำสุด)
• load.allowSymlinkTargets: ไดเรกทอรีเป้าหมายจริงที่เชื่อถือ ซึ่งโฟลเดอร์ skill ที่เป็น symlink สามารถ resolve เข้าไปได้ แม้ symlink จะอยู่นอก root เป้าหมายนั้น ใช้สิ่งนี้สำหรับเลย์เอาต์ repo ข้างเคียงที่ตั้งใจไว้ เช่น ~/.agents/skills/manager -> ~/Projects/manager/skills
• load.watch: เฝ้าดูโฟลเดอร์ skill และรีเฟรช snapshot ของ Skills (ค่าเริ่มต้น: true)
• load.watchDebounceMs: debounce สำหรับเหตุการณ์ watcher ของ skill เป็นมิลลิวินาที (ค่าเริ่มต้น: 250)
• install.preferBrew: ใช้ตัวติดตั้ง brew เป็นหลักเมื่อมีให้ใช้ (ค่าเริ่มต้น: true)
• install.nodeManager: การตั้งค่าตัวติดตั้ง node ที่ต้องการ (npm | pnpm | yarn | bun, ค่าเริ่มต้น: npm) สิ่งนี้มีผลเฉพาะกับ การติดตั้ง skill เท่านั้น; runtime ของ Gateway ยังควรเป็น Node (ไม่แนะนำ Bun สำหรับ WhatsApp/Telegram)
  • openclaw setup --node-manager มีขอบเขตแคบกว่าและปัจจุบันรับ npm, pnpm หรือ bun ตั้งค่า skills.install.nodeManager: "yarn" ด้วยตนเองหากคุณต้องการการติดตั้ง skill ที่ใช้ Yarn เป็นฐาน
• install.allowUploadedArchives: อนุญาตให้ Gateway clients ที่เชื่อถือได้ระดับ operator.admin ติดตั้ง zip archive ส่วนตัวที่ staged ผ่าน skills.upload.* (ค่าเริ่มต้น: false) สิ่งนี้เปิดใช้เฉพาะเส้นทาง uploaded-archive; การติดตั้ง ClawHub ปกติไม่ต้องใช้
• entries.<skillKey>: การ override ราย skill
• agents.defaults.skills: allowlist ของ skill เริ่มต้นทางเลือกที่ agent ที่ละเว้น agents.list[].skills จะสืบทอด
• agents.list[].skills: allowlist สุดท้ายราย agent ทางเลือก; รายการที่ระบุอย่างชัดเจนจะแทนที่ค่าเริ่มต้นที่สืบทอดมาแทนที่จะรวมกัน

​

repo ข้างเคียงที่เป็น symlink

{
  skills: {
    load: {
      extraDirs: ["~/Projects/manager/skills"],
      allowSymlinkTargets: ["~/Projects/manager/skills"],
    },
  },
}

• enabled: ตั้งค่าเป็น false เพื่อปิดใช้งาน skill แม้ว่าจะเป็น bundled/installed อยู่ก็ตาม
• env: environment variables ที่ inject สำหรับการรัน agent (เฉพาะเมื่อยังไม่ได้ตั้งค่าไว้)
• apiKey: ความสะดวกทางเลือกสำหรับ Skills ที่ประกาศ env var หลัก รองรับสตริง plaintext หรืออ็อบเจ็กต์ SecretRef ({ source, provider, id })

​

หมายเหตุ

• key ภายใต้ entries จะ map ไปยังชื่อ skill ตามค่าเริ่มต้น หาก skill กำหนด metadata.openclaw.skillKey ให้ใช้ key นั้นแทน
• ลำดับความสำคัญในการโหลดคือ <workspace>/skills → <workspace>/.agents/skills → ~/.agents/skills → ~/.openclaw/skills → Skills แบบ bundled → skills.load.extraDirs
• การเปลี่ยนแปลงของ Skills จะถูกนำไปใช้ใน turn ถัดไปของ agent เมื่อ watcher เปิดใช้งานอยู่

​

Skills แบบ sandboxed และ env vars

• agents.defaults.sandbox.docker.env สำหรับ Docker backend (หรือ agents.list[].sandbox.docker.env ราย agent)
• ฝัง env ลงใน image sandbox ที่กำหนดเองหรือสภาพแวดล้อม sandbox ระยะไกลของคุณ

​

ที่เกี่ยวข้อง