Cấu hình Skills

Hầu hết cấu hình Skills nằm trong skills tại ~/.openclaw/openclaw.json. Phạm vi hiển thị dành riêng cho từng tác nhân 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: "pending",      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 theo chính sách dành riêng cho máy chủ. Chính sách chạy sau khi OpenClaw đã đưa vật 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 từ ClawHub, Skills được 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,      // Omit targets to cover every supported target.      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 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 đúng định dạng, 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 để bảo toàn an toàn.

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. Việc cài đặt và cập nhật sẽ đóng để bảo toàn an toàn khi 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ác lượt cập nhật hàng loạt áp dụng chính sách cho từng đích: một bản cập nhật Skills hoặc Plugin bị chặn sẽ làm đích đó thất bại mà không vô hiệu hóa chính sách hoặc bỏ qua các đích tiếp theo trong lô.

Ví dụ về 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: "local plugin paths are not approved on this host",      }),    );    return;  }  process.stdout.write(JSON.stringify({ protocolVersion: 1, decision: "allow" }));});

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

Các mục theo 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 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ó dấu ngoặc kép).

OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9InNraWxscy5lbnRyaWVzLjxrZXk .enabled" type="boolean"> false vô hiệu hóa Skills ngay cả khi được đi kèm hoặc đã cài đặt. Skills đi kèm coding-agent yêu cầu bật rõ ràng — hãy đặt thành true và bảo đảm một trong claude, codex, opencode hoặc một 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 tác nhân (agents)

Sử dụng cấu hình tác nhân khi bạn 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 có tập hợp Skills hiển thị khác nhau cho từng tác nhân.

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

Xưởng (skills.workshop)

Xem Skill Workshop để biết vòng đời đề xuất, các lệnh CLI, tham số công cụ của tác nhân và các phương thức Gateway do 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 giới hạn. Một thư mục skill dùng liên kết tượng trưng trong <workspace>/skills phân giải ra 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 được 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ữ ngang hàng; allowSymlinkTargets duy trì đường dẫn 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 trong những đích liên kết tượng trưng đã được tin cậy, hãy bật riêng tùy chọn:

{  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 đã 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 giới hạn 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 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/skillscác skill đ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