> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Інтеграції Gateway для зовнішніх застосунків

Зовнішні застосунки сьогодні мають взаємодіяти з OpenClaw через протокол Gateway. Використовуйте
Gateway WebSocket і методи RPC, коли скрипт, панель керування, завдання CI, розширення IDE
або інший процес хоче запускати виконання агентів, транслювати події, чекати на
результати, скасовувати роботу або перевіряти ресурси Gateway.

<Warning>
  Публічного клієнтського пакета npm ще немає. Не додавайте назви клієнтських пакетів OpenClaw
  як залежності застосунку, доки в примітках до випуску не буде оголошено опублікований
  пакет і ця сторінка не міститиме інструкцій зі встановлення.
</Warning>

<Note>
  Ця сторінка призначена для коду поза процесом OpenClaw. Код Plugin, що виконується
  всередині OpenClaw, натомість має використовувати документовані підшляхи `openclaw/plugin-sdk/*`.
</Note>

## Що доступно сьогодні

| Поверхня                                  | Стан   | Для чого використовувати                                                                                |
| ----------------------------------------- | ------ | ------------------------------------------------------------------------------------------------------- |
| [Протокол Gateway](/uk/gateway/protocol)  | Готово | Транспорт WebSocket, рукостискання підключення, області автентифікації, версіювання протоколу та події. |
| [Довідник RPC Gateway](/uk/reference/rpc) | Готово | Поточні методи Gateway для агентів, сеансів, завдань, моделей, інструментів, артефактів і затверджень.  |
| [`openclaw agent`](/uk/cli/agent)         | Готово | Одноразова інтеграція зі скриптом, коли достатньо виклику CLI через оболонку.                           |
| [`openclaw message`](/uk/cli/message)     | Готово | Надсилання повідомлень або дій каналу зі скриптів.                                                      |

Дерево вихідного коду містить внутрішню роботу над пакетом для майбутньої клієнтської бібліотеки, але
це не публічна поверхня встановлення. Вважайте це попередньою деталлю реалізації,
доки пакети не буде опубліковано та версіоновано.

## Рекомендований шлях

1. Запустіть або знайдіть Gateway.
2. Підключіться через [протокол Gateway](/uk/gateway/protocol).
3. Викликайте документовані методи RPC з [довідника RPC Gateway](/uk/reference/rpc).
4. Зафіксуйте версію OpenClaw, з якою тестуєте.
5. Повторно перевіряйте довідник RPC під час оновлення OpenClaw.

Для виконань агентів почніть з RPC `agent` і поєднуйте його з `agent.wait`, коли
потрібен кінцевий результат. Для тривалого стану розмови використовуйте методи `sessions.*`.
Для інтеграцій інтерфейсу підписуйтеся на події Gateway і відображайте лише ті
родини подій, які розуміє ваш застосунок.

## Код застосунку й код Plugin

Використовуйте Gateway RPC, коли код розташований поза OpenClaw:

* скрипти Node, які запускають або спостерігають виконання агентів
* завдання CI, які викликають Gateway
* панелі керування та адміністративні панелі
* розширення IDE
* зовнішні мости, яким не потрібно ставати Plugin каналів
* інтеграційні тести з підробленими або реальними транспортами Gateway

Використовуйте Plugin SDK, коли код виконується всередині OpenClaw:

* Plugin провайдерів
* Plugin каналів
* інструментальні або життєциклові хуки
* Plugin обв’язки агентів
* довірені допоміжні засоби середовища виконання

Зовнішні застосунки не повинні імпортувати `openclaw/plugin-sdk/*`; ці підшляхи призначені для
Plugin, які завантажує OpenClaw.

## Пов’язане

* [Протокол Gateway](/uk/gateway/protocol)
* [Довідник RPC Gateway](/uk/reference/rpc)
* [Команда CLI agent](/uk/cli/agent)
* [Команда CLI message](/uk/cli/message)
* [Цикл агента](/uk/concepts/agent-loop)
* [Середовища виконання агентів](/uk/concepts/agent-runtimes)
* [Сеанси](/uk/concepts/session)
* [Фонові завдання](/uk/automation/tasks)
* [Агенти ACP](/uk/tools/acp-agents)
* [Огляд Plugin SDK](/uk/plugins/sdk-overview)