Cấu hình Skills

Hầu hết cấu hình Skills nằm trong skills tại ~/.openclaw/openclaw.json. Khả năng hiển thị dành riêng cho từng agent nằm trong agents.defaults.skills và 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 },    },  },}

Tải (skills.load)

Cài đặt (skills.install)

Chính sách cài đặt của người vận hành (security.installPolicy)

Sử dụng security.installPolicy khi người vận hành cần một lệnh cục bộ đáng tin cậy để phê duyệt hoặc chặn việc cài đặt Skills và Plugin bằng chính sách dành riêng cho máy chủ. Chính sách chạy sau khi OpenClaw đã đưa tài liệu nguồn vào vùng tạm và trước khi quá trình cài đặt hoặc cập nhật tiếp tục. Chính sách áp dụng cho Skills ClawHub, Skills đã tải lên, Skills từ Git/cục bộ, trình cài đặt phần phụ thuộc của Skills và các nguồn cài đặt/cập nhật Plugin.

{  security: {    installPolicy: {      enabled: true,      // Bỏ qua targets để áp dụng cho mọi mục tiêu được hỗ trợ.      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"],      },    },  },}

Chính sách nhận một đối tượng JSON trên stdin với protocolVersion: 1, openclawVersion, targetType, targetName, sourcePath, sourcePathKind, source có cấu trúc và tùy chọn, origin có cấu trúc và request. Chính sách phải ghi một đối tượng JSON trên stdout: { "protocolVersion": 1, "decision": "allow" } hoặc { "protocolVersion": 1, "decision": "block", "reason": "..." }. Mã thoát khác 0, hết thời gian chờ, JSON không hợp lệ, thiếu trường hoặc phiên bản giao thức không được hỗ trợ đều khiến hệ thống đóng khi lỗi.

OpenClaw không thực thi chính sách cài đặt trong quá trình khởi động Gateway thông thường. Các lượt cài đặt và cập nhật sẽ đóng khi lỗi nếu chính sách được bật nhưng không khả dụng. openclaw doctor thực hiện xác thực tĩnh; openclaw doctor --deep thực thi một phép thăm dò cài đặt mô phỏng đối với lệnh đã cấu hình.

Cập nhật hàng loạt áp dụng chính sách cho từng mục tiêu: một bản cập nhật Skills hoặc Plugin bị chặn sẽ làm mục tiêu đó thất bại mà không vô hiệu hóa chính sách hoặc bỏ qua các mục tiêu sau trong lô.

Ví dụ 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"  }}

Lệnh chính sách tối thiểu:

#!/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: "đường dẫn plugin cục bộ không được phê duyệt trên máy chủ này",      }),    );    return;  }  process.stdout.write(JSON.stringify({ protocolVersion: 1, decision: "allow" }));});

Danh sách cho phép Skills đi kèm

Mục dành cho từng Skills (skills.entries)

Theo mặc định, các khóa trong entries khớp với name của Skills. Nếu một Skills định nghĩa metadata.openclaw.skillKey, hãy sử dụng khóa đó thay thế. Đặt tên có dấu gạch nối trong dấu ngoặc kép (JSON5 cho phép khóa được đặt trong dấu ngoặc kép).

OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9InNraWxscy5lbnRyaWVzLjxrZXk .enabled" type="boolean"> false vô hiệu hóa Skills ngay cả khi đi kèm hoặc đã cài đặt. Skills đi kèm coding-agent yêu cầu chủ động bật — đặt thành true và bảo đảm một trong claude, codex, opencode hoặc CLI được hỗ trợ khác đã được cài đặt và xác thực.

OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9InNraWxscy5lbnRyaWVzLjxrZXk .apiKey" type='string | { source, provider, id }'> Trường tiện ích dành cho Skills khai báo metadata.openclaw.primaryEnv. Hỗ trợ chuỗi văn bản thuần hoặc SecretRef: { source: "env", provider: "default", id: "VAR_NAME" }.

Danh sách cho phép của agent (agents)

Sử dụng cấu hình agent khi muốn dùng cùng các thư mục gốc Skills của máy/không gian làm việc nhưng mỗi agent có một tập Skills hiển thị khác nhau.

{  agents: {    defaults: {      skills: ["github", "weather"], // đường cơ sở dùng chung    },    list: [      { id: "writer" }, // kế thừa github, weather      { id: "docs", skills: ["docs-search"] }, // thay thế hoàn toàn giá trị mặc định      { id: "locked-down", skills: [] }, // không có Skills    ],  },}

Workshop (skills.workshop)

Xem Tự học để biết điều kiện đủ, quyền riêng tư, chi phí, quyền chỉ dành cho đề xuất và cách khắc phục sự cố.

Xem Skill Workshop để biết vòng đời đề xuất, các lệnh CLI, tham số công cụ tác nhân và các phương thức Gateway mà cấu hình này kiểm soát.

Thư mục gốc skill dùng liên kết tượng trưng

Theo mặc định, các thư mục gốc skill của không gian làm việc, tác nhân dự án, thư mục bổ sung và skill đi kèm là các ranh giới bao chứa. Một thư mục skill dùng liên kết tượng trưng bên dưới <workspace>/skills mà phân giải ra bên ngoài thư mục gốc sẽ bị bỏ qua kèm theo thông báo nhật ký.

Để cho phép một bố cục liên kết tượng trưng có chủ đích, hãy khai báo đích đáng tin cậy:

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

Với cấu hình này, <workspace>/skills/manager -> ~/Projects/manager/skills được chấp nhận sau khi phân giải đường dẫn thực. extraDirs quét trực tiếp kho lưu trữ cùng cấp; allowSymlinkTargets giữ nguyên đường dẫn dùng liên kết tượng trưng cho các bố cục hiện có.

Theo mặc định, thao tác áp dụng của Skill Workshop không ghi thông qua các liên kết tượng trưng đó. Để cho phép thao tác áp dụng của Workshop sửa đổi các skill bên dưới các đích liên kết tượng trưng đã được tin cậy, hãy bật riêng tùy chọn này:

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

Các thư mục ~/.openclaw/skills được quản lý và ~/.agents/skills cá nhân đã luôn chấp nhận vô điều kiện các liên kết tượng trưng đến thư mục skill (quy tắc bao chứa SKILL.md theo từng skill vẫn được áp dụng) — allowSymlinkTargets chỉ cần thiết cho các thư mục gốc của không gian làm việc, thư mục bổ sung và tác nhân dự án (<workspace>/.agents/skills).

Skill trong sandbox và biến môi trường

Truyền các thông tin bí mật vào sandbox Docker bằng:

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

Nhắc lại thứ tự tải

workspace/skills      (cao nhất)workspace/.agents/skills~/.agents/skills~/.openclaw/skillsskill đi kèmskills.load.extraDirs (thấp nhất)

Các thay đổi đối với skill và cấu hình có hiệu lực trong phiên mới tiếp theo khi trình theo dõi được bật, hoặc trong lượt tác nhân tiếp theo khi trình theo dõi phát hiện thay đổi.

Liên quan