Naar hoofdinhoud gaan
Externe apps moeten vandaag via het Gateway-protocol met OpenClaw communiceren. Gebruik Gateway WebSocket- en RPC-methoden wanneer een script, dashboard, CI-taak, IDE- extensie of een ander proces agent-runs wil starten, gebeurtenissen wil streamen, op resultaten wil wachten, werk wil annuleren of Gateway-resources wil inspecteren.
Er is nog geen openbaar npm-clientpakket. Voeg geen pakketnamen voor OpenClaw-clients toe als applicatie-afhankelijkheden totdat releaseopmerkingen een gepubliceerd pakket aankondigen en deze pagina installatie-instructies bevat.
Deze pagina is bedoeld voor code buiten het OpenClaw-proces. Plugin-code die binnen OpenClaw draait, moet in plaats daarvan gedocumenteerde openclaw/plugin-sdk/*-subpaden gebruiken.

Wat vandaag beschikbaar is

OppervlakStatusGebruik het voor
Gateway-protocolGereedWebSocket-transport, connect-handshake, auth-scopes, protocolversionering en gebeurtenissen.
Gateway RPC-referentieGereedHuidige Gateway-methoden voor agents, sessies, taken, modellen, tools, artefacten en goedkeuringen.
openclaw agentGereedEenmalige scriptintegratie wanneer shellen naar de CLI voldoende is.
openclaw messageGereedBerichten of kanaalacties verzenden vanuit scripts.
De broncodeboom bevat intern pakketwerk voor een toekomstige clientbibliotheek, maar dat is geen openbaar installatieoppervlak. Behandel het als preview-implementatiedetail totdat de pakketten zijn gepubliceerd en geversioneerd.

Aanbevolen pad

  1. Start of ontdek een Gateway.
  2. Maak verbinding via het Gateway-protocol.
  3. Roep gedocumenteerde RPC-methoden aan uit de Gateway RPC-referentie.
  4. Pin de OpenClaw-versie waartegen je test.
  5. Controleer de RPC-referentie opnieuw wanneer je OpenClaw upgradet.
Begin voor agent-runs met de agent-RPC en combineer die met agent.wait wanneer je een terminaal resultaat nodig hebt. Gebruik voor duurzame gespreksstatus de sessions.*- methoden. Abonneer je voor UI-integraties op Gateway-gebeurtenissen en render alleen de gebeurtenisfamilies die je app begrijpt.

App-code versus Plugin-code

Gebruik Gateway RPC wanneer code buiten OpenClaw leeft:
  • Node-scripts die agent-runs starten of observeren
  • CI-taken die een Gateway aanroepen
  • dashboards en beheerderspanelen
  • IDE-extensies
  • externe bridges die geen kanaalplugins hoeven te worden
  • integratietests met nep- of echte Gateway-transporten
Gebruik de Plugin SDK wanneer code binnen OpenClaw draait:
  • providerplugins
  • kanaalplugins
  • tool- of lifecycle-hooks
  • agent-harnessplugins
  • vertrouwde runtimehelpers
Externe apps moeten openclaw/plugin-sdk/* niet importeren; die subpaden zijn voor plugins die door OpenClaw worden geladen.

Gerelateerd