Cấu hình Skills

Phần lớn cấu hình Skills nằm dưới skills trong ~/.openclaw/openclaw.json. Khả năng hiển thị theo từng tác nhân nằm dưới 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)

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 Skill và Plugin bằng chính sách theo từng máy chủ. Chính sách chạy sau khi OpenClaw đã chuẩn bị tài liệu nguồn và trước khi việc 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ụ thuộc của Skill, và 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. Nó phải ghi một đối tượng JSON trên stdout: { "protocolVersion": 1, "decision": "allow" } hoặc { "protocolVersion": 1, "decision": "block", "reason": "..." }. Thoát khác 0, hết thời gian chờ, JSON sai định dạng, thiếu trường, hoặc phiên bản giao thức không được hỗ trợ đều thất bại theo hướng đóng.

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 cài đặt và cập nhật thất bại theo hướng đóng 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, và openclaw doctor --deep thực thi một phép kiểm tra cài đặt tổng hợp đối với lệnh đã cấu hình.

Cập nhật hàng loạt áp dụng chính sách theo từng mục tiêu: bản cập nhật Skill hoặc Plugin bị chặn sẽ thất bại cho mục tiêu đó 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 giản:

#!/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 Skill đóng gói

Mục nhập theo từng Skill (skills.entries)

Các khóa dưới entries mặc định khớp với name của Skill. Nếu một Skill đị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 trích dẫn).

OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9InNraWxscy5lbnRyaWVzLjxrZXk .enabled" type="boolean"> false vô hiệu hóa Skill ngay cả khi được đóng gói hoặc đã cài đặt. Skill đóng gói coding-agent là opt-in — đặt nó thành true và bảo đảm đã cài đặt và xác thực một trong claude, codex, opencode, hoặc CLI được hỗ trợ khác.

OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9InNraWxscy5lbnRyaWVzLjxrZXk .apiKey" type='string | { source, provider, id }'> Trường tiện ích 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 tác nhân (agents)

Dùng cấu hình tác nhân khi bạn muốn dùng cùng gốc Skill của máy/workspace nhưng có một tập Skill 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    ],  },}

Workshop (skills.workshop)

Các gốc skill được symlink

Theo mặc định, các gốc skill của không gian làm việc, project-agent, extra-dir và gói kèm là ranh giới chứa. Một thư mục skill được symlink trong <workspace>/skills mà phân giải ra ngoài gốc sẽ bị bỏ qua kèm một thông báo nhật ký.

Để cho phép bố cục symlink có chủ ý, hãy khai báo đích 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 realpath. extraDirs quét trực tiếp repo cùng cấp; allowSymlinkTargets giữ nguyên đường dẫn symlink 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 qua các symlink đó. Để cho phép Workshop áp dụng thay đổi skills dưới các đích symlink đã được tin cậy, hãy bật riêng:

{  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 symlink thư mục skill (việc chứa SKILL.md theo từng skill vẫn được áp dụng).

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

Truyền 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/skillsskills gói kèmskills.load.extraDirs (thấp nhất)

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

Liên quan