Перейти к основному содержанию
Внешние приложения сегодня должны взаимодействовать с OpenClaw через протокол Gateway. Используйте Gateway WebSocket и методы RPC, когда скрипту, панели мониторинга, заданию CI, расширению IDE или другому процессу нужно запускать выполнения агентов, передавать поток событий, ждать результатов, отменять работу или проверять ресурсы Gateway.
Публичного клиентского npm-пакета пока нет. Не добавляйте имена клиентских пакетов OpenClaw в зависимости приложений, пока в примечаниях к выпуску не будет объявлен опубликованный пакет и на этой странице не появятся инструкции по установке.
Эта страница предназначена для кода вне процесса OpenClaw. Код Plugin, который выполняется внутри OpenClaw, должен вместо этого использовать документированные подпути openclaw/plugin-sdk/*.

​
Что доступно сегодня

ПоверхностьСтатусДля чего использовать
протокол GatewayГотовоТранспорт WebSocket, рукопожатие подключения, области авторизации, версионирование протокола и события.
справочник Gateway RPCГотовоТекущие методы Gateway для агентов, сеансов, задач, моделей, инструментов, артефактов и подтверждений.
openclaw agentГотовоОдноразовая интеграция со скриптами, когда достаточно запуска через CLI.
openclaw messageГотовоОтправка сообщений или действий каналов из скриптов.
Дерево исходного кода содержит внутреннюю работу над пакетами для будущей клиентской библиотеки, но это не публичная поверхность установки. Считайте это предварительной деталью реализации, пока пакеты не будут опубликованы и версионированы.

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

  1. Запустите или обнаружьте Gateway.
  2. Подключитесь через протокол Gateway.
  3. Вызывайте документированные методы RPC из справочника Gateway 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.

​
Связанное