> ## 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](/ru/gateway/protocol)    | Готово | Транспорт WebSocket, рукопожатие подключения, области авторизации, версионирование протокола и события. |
| [справочник Gateway RPC](/ru/reference/rpc) | Готово | Текущие методы Gateway для агентов, сеансов, задач, моделей, инструментов, артефактов и подтверждений.  |
| [`openclaw agent`](/ru/cli/agent)           | Готово | Одноразовая интеграция со скриптами, когда достаточно запуска через CLI.                                |
| [`openclaw message`](/ru/cli/message)       | Готово | Отправка сообщений или действий каналов из скриптов.                                                    |

Дерево исходного кода содержит внутреннюю работу над пакетами для будущей клиентской библиотеки, но
это не публичная поверхность установки. Считайте это предварительной деталью реализации,
пока пакеты не будут опубликованы и версионированы.

## Рекомендуемый путь

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

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

## Код приложения и код Plugin

Используйте Gateway RPC, когда код находится вне OpenClaw:

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

Используйте Plugin SDK, когда код выполняется внутри OpenClaw:

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

Внешние приложения не должны импортировать `openclaw/plugin-sdk/*`; эти подпути предназначены для
Plugin, загружаемых OpenClaw.

## Связанное

* [протокол Gateway](/ru/gateway/protocol)
* [справочник Gateway RPC](/ru/reference/rpc)
* [команда CLI agent](/ru/cli/agent)
* [команда CLI message](/ru/cli/message)
* [цикл агента](/ru/concepts/agent-loop)
* [среды выполнения агентов](/ru/concepts/agent-runtimes)
* [сеансы](/ru/concepts/session)
* [фоновые задачи](/ru/automation/tasks)
* [агенты ACP](/ru/tools/acp-agents)
* [обзор Plugin SDK](/ru/plugins/sdk-overview)