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

การกำหนดค่า Skills ส่วนใหญ่อยู่ภายใต้ skills ใน ~/.openclaw/openclaw.json ส่วนการมองเห็นเฉพาะเอเจนต์อยู่ภายใต้ agents.defaults.skills และ agents.list[].skills

{  skills: {    allowBundled: ["gemini", "peekaboo"],    load: {      extraDirs: ["~/Projects/agent-scripts/skills"],      allowSymlinkTargets: ["~/Projects/manager/skills"],      watch: true,      watchDebounceMs: 250,    },    install: {      preferBrew: true,      nodeManager: "npm",      allowUploadedArchives: false,    },    workshop: {      autonomous: { enabled: false },      allowSymlinkTargetWrites: false,      approvalPolicy: "auto",      maxPending: 50,      maxSkillBytes: 40000,    },    entries: {      "image-lab": {        enabled: true,        apiKey: { source: "env", provider: "default", id: "GEMINI_API_KEY" },        env: { GEMINI_API_KEY: "GEMINI_KEY_HERE" },      },      peekaboo: { enabled: true },      sag: { enabled: false },    },  },}

การโหลด (skills.load)

การติดตั้ง (skills.install)

นโยบายการติดตั้งของผู้ดำเนินการ (security.installPolicy)

ใช้ security.installPolicy เมื่อผู้ดำเนินการต้องการคำสั่งภายในเครื่องที่เชื่อถือได้เพื่อ อนุมัติหรือบล็อกการติดตั้ง Skill และ Plugin ด้วยนโยบายเฉพาะโฮสต์ นโยบายจะทำงานหลังจาก OpenClaw จัดเตรียมเนื้อหาต้นฉบับแล้ว และก่อนดำเนินการ ติดตั้งหรืออัปเดตต่อ โดยมีผลกับ Skills จาก ClawHub, Skills ที่อัปโหลด, Skills จาก Git/ภายในเครื่อง, ตัวติดตั้งการขึ้นต่อกันของ Skill และแหล่งที่มาสำหรับติดตั้ง/อัปเดต Plugin

{  security: {    installPolicy: {      enabled: true,      // ไม่ระบุ targets เพื่อให้ครอบคลุมทุกเป้าหมายที่รองรับ      targets: ["skill", "plugin"],      exec: {        source: "exec",        command: "/usr/local/bin/openclaw-install-policy",        args: ["--json"],        timeoutMs: 10000,        noOutputTimeoutMs: 10000,        maxOutputBytes: 1048576,        passEnv: ["OPENCLAW_STATE_DIR", "PATH"],        env: { POLICY_MODE: "strict" },        trustedDirs: ["/usr/local/bin"],      },    },  },}

นโยบายจะได้รับออบเจ็กต์ JSON หนึ่งรายการทาง stdin ซึ่งมี protocolVersion: 1, openclawVersion, targetType, targetName, sourcePath, sourcePathKind, source แบบมีโครงสร้างซึ่งเป็นทางเลือก, origin แบบมีโครงสร้าง และ request โดยต้อง เขียนออบเจ็กต์ JSON หนึ่งรายการไปยัง stdout: { "protocolVersion": 1, "decision": "allow" } หรือ { "protocolVersion": 1, "decision": "block", "reason": "..." } การออกด้วยรหัสที่ไม่ใช่ศูนย์, หมดเวลา, JSON ผิดรูปแบบ, ไม่มีฟิลด์ หรือเวอร์ชันโปรโตคอลที่ไม่รองรับ จะทำให้ปิดกั้นเมื่อเกิดข้อผิดพลาด

OpenClaw จะไม่เรียกใช้นโยบายการติดตั้งระหว่างการเริ่มต้น Gateway ตามปกติ การติดตั้งและการอัปเดตจะปิดกั้นเมื่อเกิดข้อผิดพลาด หากเปิดใช้นโยบายแต่ไม่พร้อมใช้งาน openclaw doctor ทำการตรวจสอบแบบสถิต ส่วน openclaw doctor --deep เรียกใช้โพรบจำลองการติดตั้งกับคำสั่งที่กำหนดค่าไว้

การอัปเดตแบบกลุ่มจะใช้นโยบายแยกตามแต่ละเป้าหมาย โดยการอัปเดต Skill หรือ Plugin ที่ถูกบล็อกจะล้มเหลวเฉพาะเป้าหมายนั้น โดยไม่ปิดใช้นโยบายหรือข้ามเป้าหมายถัดไป ในชุด

ตัวอย่าง stdin:

{  "protocolVersion": 1,  "openclawVersion": "2026.6.1",  "targetType": "skill",  "targetName": "weather",  "sourcePath": "/var/folders/.../openclaw-skill-clawhub/root",  "sourcePathKind": "directory",  "source": {    "kind": "clawhub",    "authority": "openclaw",    "mutable": false,    "network": true  },  "origin": {    "type": "clawhub",    "registry": "https://clawhub.openclaw.ai",    "slug": "weather",    "version": "1.0.0"  },  "request": {    "kind": "skill-install",    "mode": "install",    "requestedSpecifier": "clawhub:weather@1.0.0"  },  "skill": {    "installId": "clawhub"  }}

คำสั่งนโยบายขั้นต่ำ:

#!/usr/bin/env node let input = "";process.stdin.setEncoding("utf8");process.stdin.on("data", (chunk) => {  input += chunk;});process.stdin.on("end", () => {  const request = JSON.parse(input);  if (request.targetType === "plugin" && request.source?.kind === "local-path") {    process.stdout.write(      JSON.stringify({        protocolVersion: 1,        decision: "block",        reason: "พาธ Plugin ภายในเครื่องไม่ได้รับการอนุมัติบนโฮสต์นี้",      }),    );    return;  }  process.stdout.write(JSON.stringify({ protocolVersion: 1, decision: "allow" }));});

รายการอนุญาตของ Skill ที่มาพร้อมระบบ

รายการต่อ Skill (skills.entries)

โดยค่าเริ่มต้น คีย์ภายใต้ entries จะตรงกับ name ของ Skill หาก Skill กำหนด metadata.openclaw.skillKey ให้ใช้คีย์นั้นแทน ชื่อที่มีเครื่องหมายยัติภังค์ต้องใส่เครื่องหมายอัญประกาศ (JSON5 อนุญาตคีย์ที่ใส่เครื่องหมายอัญประกาศ)

OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9InNraWxscy5lbnRyaWVzLjxrZXk .enabled" type="boolean"> false จะปิดใช้งาน Skill แม้จะมาพร้อมระบบหรือติดตั้งแล้วก็ตาม Skill ที่มาพร้อมระบบ coding-agent ต้องเปิดใช้เอง โดยกำหนดเป็น true และตรวจสอบให้แน่ใจว่า มีการติดตั้งและยืนยันตัวตนของ claude, codex, opencode หรือ CLI อื่นที่รองรับ

OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9InNraWxscy5lbnRyaWVzLjxrZXk .apiKey" type='string | { source, provider, id }'> ฟิลด์อำนวยความสะดวกสำหรับ Skills ที่ประกาศ metadata.openclaw.primaryEnv รองรับสตริงข้อความธรรมดาหรือ SecretRef: { source: "env", provider: "default", id: "VAR_NAME" }

รายการอนุญาตของเอเจนต์ (agents)

ใช้การกำหนดค่าเอเจนต์เมื่อต้องการใช้ราก Skill ของเครื่อง/พื้นที่ทำงานเดียวกัน แต่มี ชุด Skill ที่มองเห็นได้แตกต่างกันสำหรับแต่ละเอเจนต์

{  agents: {    defaults: {      skills: ["github", "weather"], // ค่าพื้นฐานที่ใช้ร่วมกัน    },    list: [      { id: "writer" }, // สืบทอด github, weather      { id: "docs", skills: ["docs-search"] }, // แทนที่ค่าเริ่มต้นทั้งหมด      { id: "locked-down", skills: [] }, // ไม่มี Skills    ],  },}

Workshop (skills.workshop)

ดูการเรียนรู้ด้วยตนเองสำหรับเกณฑ์คุณสมบัติ ความเป็นส่วนตัว ค่าใช้จ่าย สิทธิ์ที่จำกัดเฉพาะข้อเสนอ และการแก้ไขปัญหา

ดู Skill Workshop สำหรับวงจรชีวิตของข้อเสนอ คำสั่ง CLI พารามิเตอร์เครื่องมือของเอเจนต์ และเมธอด Gateway ที่การกำหนดค่านี้ควบคุม

รูทสกิลแบบ symlink

โดยค่าเริ่มต้น รูทสกิลของพื้นที่ทำงาน เอเจนต์โครงการ ไดเรกทอรีเพิ่มเติม และสกิลที่รวมมาให้ เป็นขอบเขตการกักเก็บ โฟลเดอร์สกิลแบบ symlink ภายใต้ <workspace>/skills ที่แก้ไขแล้วอยู่นอกรูทจะถูกข้ามพร้อมข้อความบันทึก

หากต้องการอนุญาตรูปแบบ symlink โดยเจตนา ให้ประกาศเป้าหมายที่เชื่อถือได้:

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

ด้วยการกำหนดค่านี้ <workspace>/skills/manager -> ~/Projects/manager/skills จะได้รับการยอมรับหลังการแก้ไข realpath โดย extraDirs จะสแกนรีโพซิทอรีข้างเคียง โดยตรง ส่วน allowSymlinkTargets จะคงเส้นทางแบบ symlink ไว้สำหรับรูปแบบ ที่มีอยู่

โดยค่าเริ่มต้น การใช้ข้อเสนอของ Skill Workshop จะไม่เขียนผ่าน symlink เหล่านั้น หากต้องการ ให้การใช้ข้อเสนอของ Workshop แก้ไขสกิลภายใต้เป้าหมาย symlink ที่เชื่อถืออยู่แล้ว ให้เลือก เข้าร่วมแยกต่างหาก:

{  skills: {    load: {      allowSymlinkTargets: ["~/Projects/manager/skills"],    },    workshop: {      allowSymlinkTargetWrites: true,    },  },}

ไดเรกทอรี ~/.openclaw/skills ที่มีการจัดการและไดเรกทอรี ~/.agents/skills ส่วนบุคคล ยอมรับ symlink ของไดเรกทอรีสกิลโดยไม่มีเงื่อนไขอยู่แล้ว (การกักเก็บ SKILL.md ต่อสกิลยังคงมีผล) — จำเป็นต้องใช้ allowSymlinkTargets เฉพาะกับรูท พื้นที่ทำงาน ไดเรกทอรีเพิ่มเติม และเอเจนต์โครงการ (<workspace>/.agents/skills) เท่านั้น

สกิลในแซนด์บ็อกซ์และตัวแปรสภาพแวดล้อม

ส่งข้อมูลลับเข้าสู่แซนด์บ็อกซ์ Docker ด้วย:

{  agents: {    defaults: {      sandbox: {        docker: {          env: { GEMINI_API_KEY: "your-key-here" },        },      },    },  },}

ข้อควรจำเกี่ยวกับลำดับการโหลด

workspace/skills      (สูงสุด)workspace/.agents/skills~/.agents/skills~/.openclaw/skillsสกิลที่รวมมาให้skills.load.extraDirs (ต่ำสุด)

การเปลี่ยนแปลงสกิลและการกำหนดค่าจะมีผลในเซสชันใหม่ถัดไปเมื่อเปิดใช้ ตัวเฝ้าดู หรือในรอบเอเจนต์ถัดไปเมื่อตัวเฝ้าดูตรวจพบ การเปลี่ยนแปลง

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