---
read_when:
    - Ви створюєте зовнішній застосунок, скрипт, панель керування, завдання CI або розширення IDE, яке взаємодіє з OpenClaw
    - Ви обираєте між Gateway RPC і Plugin SDK
    - Ви інтегруєтеся із запусками агентів Gateway, сеансами, подіями, схваленнями, моделями або інструментами
sidebarTitle: External apps
summary: Поточний шлях інтеграції для зовнішніх застосунків, скриптів, панелей моніторингу, завдань CI та розширень IDE
title: Інтеграції Gateway для зовнішніх застосунків
x-i18n:
    generated_at: "2026-06-27T17:33:05Z"
    model: gpt-5.5
    postprocess_version: locale-links-v1
    provider: openai
    source_hash: 69a1bee50620326e68d40c821d36c0e321fced755a2b3904d77e55624117cbff
    source_path: gateway/external-apps.md
    workflow: 16
---

Зовнішні застосунки сьогодні мають взаємодіяти з 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)