OpenClaw Composio Plugin

Gib jedem Benutzer in einem gemeinsamen Kanal seine eigenen authentifizierten Tools (Gmail, Outlook, Notion, GitHub, Sentry, …) über den Composio-Tool-Router – wobei das OAuth pro Benutzer vollständig im Chat abgewickelt wird.

Jeder vertrauenswürdige Nachrichtenabsender erhält eine dedizierte Composio-Tool-Router-Sitzung, die dem Agenten als anfragerspezifischer MCP-Server bereitgestellt wird. Die verbundenen Konten eines Benutzers sind von den Runden eines anderen Benutzers aus nie erreichbar; Ausführungen ohne verifizierten Absender (Cron, Subagenten, Heartbeats) erhalten überhaupt keine Composio-Tools.

Community-Plugin – kein offizielles @openclaw/*-Paket. Veröffentlicht auf ClawHub unter dem obviyus-Besitzerbereich.

Installation (Workspace-Administrator, einmalig)

openclaw plugins install clawhub:@obviyus/composio

Für die lokale Entwicklung laden Sie stattdessen per Side-Load: Zeigen Sie plugins.load.paths auf einen Klon dieses Repos und aktivieren Sie composio.

Stellen Sie dann Ihren Composio-API-Schlüssel auf Organisationsebene (vom Composio-Dashboard) entweder als Umgebungsvariable COMPOSIO_API_KEY oder in der Konfiguration bereit:

{
  "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

Verwendung (Endbenutzer, keine Konfiguration)

Fragen Sie den Agenten nach allem, was Composio erreichen kann: „prüfe meine Gmail“, „was ist in meiner Sentry-Warteschlange?“. Bei der ersten Verwendung antwortet der Agent mit einem persönlichen OAuth-Link; nach dem Verbinden funktionieren die Tools – nur an diesen Benutzer gebunden. Das Trennen eines Kontos (Composio-Dashboard oder im Chat) wird innerhalb von etwa fünf Minuten wirksam.

Von Composio zurückgegebene Dateien werden über den geschützten Medienspeicher von OpenClaw heruntergeladen, bevor ihre signierten URLs ablaufen oder redigiert werden. Der Agent erhält eine verwaltete MEDIA:-Referenz, die er an die Antwort anhängen kann.

Hinweise

• Der Organisations-API-Schlüssel erreicht niemals Endbenutzer oder den Chat; die Anmeldedaten pro Benutzer liegen in Composio und berühren niemals die OpenClaw-Konfiguration, Protokolle oder Transkripte.

• Erfordert eine OpenClaw-Version mit anfragerspezifischen MCP-Verbindungen (registerMcpServerConnectionResolver).

• Sitzungen pro Benutzer bleiben über Neustarts hinweg nur erhalten, wenn der Host dem Plugin den Schlüsselspeicher gewährt (gebündelte oder vertrauenswürdige offizielle Installation). Bei Side-Load fällt es auf einen In-Memory-Cache zurück – Sitzungen werden beim Neustart neu erstellt, Benutzer müssen sich nie erneut authentifizieren.

Entwicklung & Veröffentlichung

Der Quellcode befindet sich in index.ts + src/. Tests sind am selben Ort (*.test.ts). dist/ ist die Build-Ausgabe – gitignored; die npm-files-Whitelist liefert sie im veröffentlichten Artefakt aus. ClawHub verlangt diese kompilierte Ausgabe (rohes .ts wird abgelehnt), wobei openclaw/*-Importe extern bleiben (der Host stellt das Plugin-SDK zur Laufzeit bereit).

Veröffentlichen ist ein Tag-Push. Erhöhen Sie die Version, taggen Sie, pushen Sie – GitHub Actions (.github/workflows/publish.yml) baut dist/ und veröffentlicht auf ClawHub:

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

Einmalige Einrichtung: Fügen Sie ein CLAWHUB_TOKEN-Repo-Secret hinzu (ein ClawHub-API-Token – generieren Sie eines in den ClawHub-Einstellungen, oder clawhub token gibt Ihr aktuelles aus):

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

Um stattdessen von Hand zu veröffentlichen (baut auch lokal):

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)"

Hinweise für Maintainer:

• openclaw.compat.pluginApi begrenzt die minimale Host-Version – halten Sie sie bei der ersten OpenClaw-Version, die registerMcpServerConnectionResolver ausgeliefert hat.

• openclaw.build.openclawVersion und das kompilierte dist/ werden von der ClawHub-Veröffentlichungsvalidierung benötigt.

• Die Composio-Tool-Router-API ist versioniert (/api/v3.1/...); achten Sie auf bahnbrechende Änderungen in src/tool-router.ts, wenn Composio sie erhöht.