OpenClaw Composio Plugin

Предоставьте каждому пользователю в общем канале собственные аутентифицированные инструменты (Gmail, Outlook, Notion, GitHub, Sentry, …) через Tool Router от Composio — с индивидуальным OAuth, полностью обрабатываемым в чате.

Каждый доверенный отправитель сообщения получает отдельную сессию Composio Tool Router, доставляемую агенту как MCP-сервер, привязанный к отправителю запроса. Подключённые аккаунты одного пользователя никогда не доступны из ходов другого пользователя; запуски без подтверждённого отправителя (cron-задания, субагенты, heartbeat-события) не получают инструменты Composio вообще.

Плагин сообщества — не официальный пакет @openclaw/*. Опубликован в ClawHub в области владельца obviyus.

Установка (администратор рабочего пространства, однократно)

openclaw plugins install clawhub:@obviyus/composio

Для локальной разработки вместо этого загрузите вручную: укажите plugins.load.paths на клон этого репозитория и включите composio.

Затем укажите ключ API Composio уровня организации (из панели управления Composio) либо в переменной окружения COMPOSIO_API_KEY, либо в конфигурации:

{
  "plugins": {
    "entries": {
      "composio": { "enabled": true, "config": { "apiKey": "ak_..." } }
    }
  },
  "mcp": {
    "servers": {
      // Identity declaration; the connection is resolved per user at run time.
      "composio": { "transport": "streamable-http", "url": "https://composio.invalid/unresolved" }
    }
  }
}

Related MCP server: Google Workspace MCP Server

Использование (конечные пользователи, без настройки)

Просите агента обо всём, что доступно через Composio: «проверь мою Gmail», «что в моей очереди Sentry?». При первом использовании агент отвечает персональной OAuth-ссылкой; после подключения инструменты работают — только для этого пользователя. Отключение аккаунта (в панели Composio или в чате) вступает в силу примерно через пять минут.

Файлы, возвращаемые Composio, загружаются через защищённое медиахранилище OpenClaw до истечения срока действия подписанных URL или их отзыва. Агент получает управляемую ссылку MEDIA:, которую агент может прикрепить к ответу.

Примечания

• Ключ API организации никогда не попадает к конечным пользователям или в чат; учётные данные пользователей хранятся в Composio и никогда не попадают в конфигурацию OpenClaw, логи или транскрипты.

• Требуется релиз OpenClaw с MCP-соединениями, привязанными к отправителю запроса (registerMcpServerConnectionResolver).

• Сеансы пользователей сохраняются между перезапусками, только если хост предоставляет плагину ключевое хранилище (встроенная или доверенная официальная установка). При ручной загрузке используется резервный кэш в памяти — сеансы пересоздаются при перезапуске, пользователям не нужно повторно авторизоваться.

Разработка и релиз

Исходный код находится в index.ts и src/. Тесты расположены рядом (*.test.ts). dist/ — результат сборки, игнорируемый git; белый список files в npm включает его в публикуемый артефакт. ClawHub требует скомпилированный результат (сырые .ts отклоняются) с оставленными внешними импортами openclaw/* (хост предоставляет SDK плагина во время выполнения).

Релиз — это пуш тега. Поднимите версию, создайте тег, запушьте — GitHub Actions (.github/workflows/publish.yml) соберёт dist/ и опубликует в ClawHub:

# bump "version" in package.json, commit
git tag v0.1.2 && git push origin v0.1.2

Разовая настройка: добавьте секрет репозитория CLAWHUB_TOKEN (токен API ClawHub — создайте его в настройках ClawHub, или clawhub token выведет ваш текущий):

gh secret set CLAWHUB_TOKEN --repo obviyus/openclaw-composio

Чтобы вместо этого опубликовать вручную (также выполняется локальная сборка):

bun build ./index.ts --outdir ./dist --target node --format esm --external 'openclaw/*'
clawhub package publish . --source-repo obviyus/openclaw-composio --source-commit "$(git rev-parse HEAD)" --dry-run
clawhub package publish . --source-repo obviyus/openclaw-composio --source-commit "$(git rev-parse HEAD)"

Примечания для мейнтейнеров:

• openclaw.compat.pluginApi задаёт минимальную версию хоста — оставьте её на первом релизе OpenClaw, в котором появился registerMcpServerConnectionResolver.

• openclaw.build.openclawVersion и скомпилированный dist/ требуются для валидации публикации ClawHub.

• API Composio Tool Router версионируется (/api/v3.1/...); следите за ломающими изменениями в src/tool-router.ts, когда Composio поднимает его версию.