Skills

• Не вказуйте agents.defaults.skills, щоб за замовчуванням не обмежувати жодні навички.
• Не вказуйте agents.list[].skills, щоб успадкувати agents.defaults.skills.
• Установіть agents.list[].skills: [], щоб не надавати цьому агенту жодних навичок.
• Непорожній список agents.list[].skills є остаточним набором — він не об’єднується зі значеннями за замовчуванням.
• Чинний список дозволів застосовується під час формування промпту, виявлення команд із косою рискою, синхронізації пісочниці та створення знімків навичок.
• Це не межа авторизації оболонки хоста. Якщо той самий агент може використовувати exec, окремо обмежте цю оболонку за допомогою пісочниці, ізоляції користувача ОС, списків заборон і дозволів для exec та облікових даних для окремих ресурсів.

openclaw skills install за замовчуванням установлює навички до каталогу skills/ активного робочого простору. Додайте --global, щоб установити їх до спільного каталогу ~/.openclaw/skills, видимого всім локальним агентам, якщо списки дозволів агентів не звужують цю видимість.

Для встановлення з Git і локальних джерел файл SKILL.md має бути в корені джерела. Ідентифікатор береться з поля name у frontmatter SKILL.md, якщо воно коректне, а інакше — з назви каталогу або репозиторію. Скористайтеся --as <slug>, щоб перевизначити його. openclaw skills update відстежує лише встановлення з ClawHub — щоб оновити джерела Git або локальні джерела, установіть їх повторно.

openclaw skills verify @owner/<slug> запитує в ClawHub конверт довіри навички clawhub.skill.verify.v1. Установлені навички ClawHub перевіряються за версією та реєстром, записаними в .clawhub/origin.json. Ідентифікатори без власника й надалі приймаються для вже встановлених або однозначно визначених навичок, але посилання з указаним власником усувають неоднозначність щодо видавця.

На сторінках навичок ClawHub перед установленням відображається стан останнього сканування безпеки, а також доступні сторінки з докладними результатами VirusTotal, ClawScan і статичного аналізу. Команда завершується з ненульовим кодом, коли ClawHub позначає перевірку як невдалу. Видавці можуть усунути хибнопозитивні результати через панель керування ClawHub або команду clawhub skill rescan @owner/<slug>.

Клієнти Gateway, яким потрібна доставка не через ClawHub, можуть підготувати ZIP-архів навички за допомогою skills.upload.begin, skills.upload.chunk і skills.upload.commit, а потім установити його через skills.install({ source: "upload", ... }). Цей шлях за замовчуванням вимкнений і потребує skills.install.allowUploadedArchives: true у openclaw.json. Для звичайних установлень із ClawHub це налаштування не потрібне.

Під час виявлення навичок у робочому просторі, в агента проєкту й у додаткових каталогах приймаються лише такі кореневі каталоги навичок, реальний розв’язаний шлях яких залишається всередині налаштованого кореневого каталогу, якщо тільки skills.load.allowSymlinkTargets явно не позначає цільовий кореневий каталог як довірений. Майстерня навичок записує дані через такі довірені цільові каталоги лише тоді, коли ввімкнено skills.workshop.allowSymlinkTargetWrites. Керований каталог ~/.openclaw/skills і особистий каталог ~/.agents/skills можуть містити папки навичок із символічними посиланнями, але реальний шлях кожного SKILL.md усе одно має залишатися всередині розв’язаного каталогу відповідної навички.

Налаштуйте security.installPolicy, щоб перед продовженням установлення навичок виконувалася довірена локальна команда політики. Політика отримує метадані й шлях до підготовленого джерела, застосовується до ClawHub, завантажених архівів, Git, локальних джерел, оновлень і шляхів установлення залежностей та забороняє операцію, якщо команда не може повернути коректне рішення.

skills.entries.*.env і skills.entries.*.apiKey впроваджують секрети в процес хоста лише на час цього ходу агента — не в пісочницю. Не додавайте секрети до промптів і журналів.

• Якщо вказано кілька інсталяторів, Gateway вибирає один пріоритетний варіант (brew, якщо доступний, інакше node).
• Якщо всі інсталятори мають тип download, OpenClaw показує кожен запис, щоб ви могли бачити всі доступні артефакти.
• Специфікації можуть містити os: ["darwin"|"linux"|"win32"] для фільтрування за платформою.
• Інсталяції Node враховують skills.install.nodeManager у openclaw.json (типове значення: npm; варіанти: npm / pnpm / yarn / bun). Це впливає лише на встановлення Skills; середовищем виконання Gateway усе одно має бути Node.
• Порядок пріоритету інсталяторів Gateway: Homebrew → uv → налаштований менеджер node → go → download.

• Homebrew: OpenClaw не встановлює Homebrew автоматично й не перетворює формули brew на команди системного менеджера пакетів. У контейнерах Linux без brew інсталятори, що підтримують лише brew, приховані; використовуйте власний образ або встановіть залежність вручну.
• Go: Для автоматичного встановлення Skills OpenClaw потребує Go 1.21 або новішої версії. Якщо go відсутній, а Homebrew доступний, OpenClaw спочатку встановлює Go через Homebrew; у Linux без Homebrew натомість можна використати apt-get від імені root або через sudo без пароля, якщо оновлений кандидат golang-go відповідає вимогам до мінімальної версії. Фактична команда go install для залежності завжди використовує окремий каталог виконуваних файлів, яким керує OpenClaw (bin Homebrew для нової інсталяції, інакше ~/.local/bin), а не налаштований вами GOBIN — ваші власні змінні середовища GOBIN, GOPATH і GOTOOLCHAIN зчитуються, але ніколи не перезаписуються.
• Завантаження: url (обов’язково), archive (tar.gz | tar.bz2 | zip), extract (типове значення: автоматично, якщо виявлено архів), stripComponents, targetDir (типове значення: ~/.openclaw/tools/<skillKey>).

requires.bins перевіряється на хості під час завантаження Skills. Якщо агент працює в ізольованому середовищі, виконуваний файл також має існувати всередині контейнера. Установіть його через agents.defaults.sandbox.docker.setupCommand або власний образ. setupCommand виконується один раз після створення контейнера й потребує вихідного доступу до мережі, кореневої файлової системи з правом запису та користувача root в ізольованому середовищі.

Типово OpenClaw стежить за папками Skills і оновлює знімок, коли змінюються файли SKILL.md. Налаштування містяться в skills.load:

{  skills: {    load: {      extraDirs: ["~/Projects/agent-scripts/skills"],      allowSymlinkTargets: ["~/Projects/manager/skills"],      watch: true, // default      watchDebounceMs: 250, // default    },  },}

Використовуйте allowSymlinkTargets для навмисних структур із символічними посиланнями, у яких символічне посилання кореня Skills указує за межі налаштованого кореня, наприклад <workspace>/skills/manager -> ~/Projects/manager/skills. Вмикайте skills.workshop.allowSymlinkTargetWrites лише тоді, коли Майстерня Skills також має застосовувати пропозиції через ці довірені шляхи із символічними посиланнями.

Якщо Gateway працює в Linux, але підключено вузол macOS із дозволеним system.run, OpenClaw може вважати Skills лише для macOS доступними, коли потрібні виконувані файли присутні на цьому вузлі. Агент має запускати ці Skills через інструмент exec із host=node.

Вузли не в мережі не роблять видимими Skills, доступні лише віддалено. Якщо вузол перестає відповідати на перевірки виконуваних файлів, OpenClaw очищає кешовані збіги виконуваних файлів.