---
read_when:
    - Вы создаете внешнее приложение, скрипт, панель мониторинга, задание CI или расширение IDE, которое взаимодействует с OpenClaw
    - Вы выбираете между Gateway RPC и Plugin SDK
    - Вы интегрируетесь с запусками агентов Gateway, сеансами, событиями, подтверждениями, моделями или инструментами
sidebarTitle: External apps
summary: Текущий путь интеграции для внешних приложений, скриптов, панелей мониторинга, заданий CI и расширений IDE
title: Интеграции Gateway для внешних приложений
x-i18n:
    generated_at: "2026-06-28T22:57:14Z"
    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](/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)