OpenClaw API — интеграции, MCP и веб-поиск

OpenClaw предоставляет API для взаимодействия с агентом и поддерживает интеграции с внешними сервисами через протокол MCP, веб-поиск и прямые HTTP-запросы.

API OpenClaw

Gateway OpenClaw предоставляет WebSocket API для подключения клиентов. Через этот API работают Telegram-бот, веб-интерфейс и другие клиенты.

Возможности API:

Отправка сообщений агенту
Получение ответов (включая потоковый вывод)
Управление сессиями
Мониторинг статуса

На нашей платформе API проксируется автоматически — вам не нужно настраивать API-ключи для моделей и поиска. Всё работает из коробки.

MCP (Model Context Protocol)

MCP — это протокол, позволяющий подключать к агенту внешние источники данных и инструменты. С помощью MCP агент получает доступ к:

Базам данных — чтение и запись данных
Файловым системам — доступ к удалённым файлам
API сервисов — интеграция с внешними системами
Кастомным инструментам — любые функции, обёрнутые в MCP-сервер

Подключение MCP-сервера

Для подключения MCP-сервера к OpenClaw добавьте его в конфигурацию openclaw.json:

{
  "mcpServers": {
    "my-server": {
      "command": "npx",
      "args": ["-y", "my-mcp-server"]
    }
  }
}

Популярные MCP-серверы:

@modelcontextprotocol/server-filesystem — доступ к файлам
@modelcontextprotocol/server-github — работа с GitHub
@modelcontextprotocol/server-postgres — запросы к PostgreSQL

Веб-поиск

OpenClaw поддерживает несколько провайдеров веб-поиска:

Brave Search

Быстрый и приватный поисковый движок. Используется по умолчанию на нашей платформе. Поддерживает поиск по вебу и новостям.

Tavily

Поисковый API, оптимизированный для AI-агентов. Возвращает структурированные результаты с извлечённым контентом.

Perplexity

AI-поисковик, который не просто находит ссылки, а формирует ответ на основе найденной информации.

Для самостоятельной установки выбор провайдера настраивается в конфигурации. На нашей платформе веб-поиск работает из коробки.

Streaming (потоковый вывод)

OpenClaw поддерживает потоковый вывод ответов — вы видите текст по мере его генерации, а не ждёте полного ответа. Streaming работает и в Telegram, и в веб-интерфейсе.

Как это работает:

Агент отправляет ответ по токенам через WebSocket
В Telegram сообщение обновляется по мере генерации
В веб-интерфейсе текст появляется в реальном времени

Proxy (проксирование)

На нашей платформе запросы к языковым моделям и поисковым API проксируются через сервер. Это даёт несколько преимуществ:

Не нужны свои API-ключи — используются общие ключи платформы
Доступность — работает даже если прямой доступ к провайдеру ограничен
Контроль расходов — платформа управляет лимитами и квотами

Relay

Relay — это механизм удалённого подключения к агенту. Через relay можно управлять агентом с любого устройства, даже если он запущен в локальной сети. На нашей платформе relay не нужен — агент доступен через Telegram и веб-интерфейс напрямую.

Что дальше

Gateway и CLI — управление gateway и команды
Модели и провайдеры — доступные языковые модели
Настройки агента — конфигурация openclaw.json и MCP
Веб-чат — общение с агентом через браузер
Локальные модели — подключение Ollama и LM Studio