---
x-i18n:
    generated_at: "2026-04-23T06:42:09Z"
    model: gpt-5.4
    provider: openai
    source_hash: 8b046833f9a15dc61894ab9e808a09a9fb055ef7ada5c3d4893fbe5f70dec126
    source_path: AGENTS.md
    workflow: 15
---

# Посібник з документації

Цей каталог відповідає за створення документації, правила посилань Mintlify та політику i18n для документації.

## Правила Mintlify

- Документація розміщена на Mintlify (`https://docs.openclaw.ai`).
- Внутрішні посилання на документацію в `docs/**/*.md` мають залишатися кореневими відносними без суфікса `.md` або `.mdx` (приклад: `[Config](/gateway/configuration)`).
- Перехресні посилання на розділи мають використовувати якорі на кореневих відносних шляхах (приклад: `[Hooks](/gateway/configuration-reference#hooks)`).
- У заголовках документації слід уникати довгих тире та апострофів, оскільки генерація якорів у Mintlify з ними працює нестабільно.
- README та інші документи, що відображаються на GitHub, мають зберігати абсолютні URL-адреси документації, щоб посилання працювали поза Mintlify.
- Вміст документації має залишатися загальним: без особистих назв пристроїв, хостів або локальних шляхів; використовуйте заповнювачі на кшталт `user@gateway-host`.

## Правила вмісту документації

- У документації, текстах інтерфейсу та списках вибору сервіси/провайдери слід упорядковувати за абеткою, якщо розділ явно не описує порядок виконання або порядок автовизначення під час виконання.
- Підтримуйте узгоджене найменування вбудованих plugin відповідно до загальних правил термінології plugin у кореневому `AGENTS.md`.

## I18n документації

- Документація іншими мовами не підтримується в цьому репозиторії. Згенерований вивід для публікації знаходиться в окремому репозиторії `openclaw/docs` (часто локально клонованому як `../openclaw-docs`).
- Не додавайте та не редагуйте локалізовану документацію в `docs/<locale>/**` тут.
- Вважайте англомовну документацію в цьому репозиторії разом із файлами глосарію єдиним джерелом істини.
- Конвеєр: оновіть англомовну документацію тут, за потреби оновіть `docs/.i18n/glossary.<locale>.json`, а потім дозвольте синхронізації репозиторію публікації та `scripts/docs-i18n` виконатися в `openclaw/docs`.
- Перед повторним запуском `scripts/docs-i18n` додайте записи до глосарію для будь-яких нових технічних термінів, заголовків сторінок або коротких навігаційних міток, які мають залишатися англійською або мати фіксований переклад.
- `pnpm docs:check-i18n-glossary` є перевіркою для змінених англомовних заголовків документації та коротких внутрішніх міток документації.
- Пам’ять перекладу зберігається у згенерованих файлах `docs/.i18n/*.tm.jsonl` у репозиторії публікації.
- Див. `docs/.i18n/README.md`.
