Skip to content

feat(openclaw): add @ag-ui/openclaw AG-UI client integration#2155

Draft
lukasmoschitz wants to merge 6 commits into
mainfrom
openclaw-agent-integration
Draft

feat(openclaw): add @ag-ui/openclaw AG-UI client integration#2155
lukasmoschitz wants to merge 6 commits into
mainfrom
openclaw-agent-integration

Conversation

@lukasmoschitz

Copy link
Copy Markdown
Contributor

Summary

Adds @ag-ui/openclaw — the AG-UI protocol client integration for OpenClaw. OpenClawAgent is a thin HttpAgent subclass that connects an AG-UI / CopilotKit frontend to an OpenClaw gateway's clawg-ui operator route, adding a first-class gatewayToken convenience (sent as Authorization: Bearer <token>, authoritative over any Authorization passed in headers).

Includes:

  • OpenClawAgent + OpenClawAgentConfig (integrations/openclaw/typescript/src/index.ts)
  • README (features / usage / prerequisites) — the usage example is verified end-to-end against a live gateway
  • Vitest tests (subclass sanity + gatewayToken → header mapping) and a build/exports gate (publint + attw green)
  • package.json aligned with sibling integrations (license, coverage, link scripts)
  • Listed in docs/integrations.mdx

How it's consumed today

Not yet published to npm. The CopilotKit OpenClaw showcase consumes it via a pkg.pr.new preview package built from this branch:
https://pkg.pr.new/ag-ui-protocol/ag-ui/@ag-ui/openclaw@40533a7b

Server-side note (the clawg-ui situation)

This is the client half. The server half is the clawg-ui OpenClaw gateway plugin (fork: lukasmoschitz/clawg-ui@rd-53-showcase-fork), which the showcase currently vendors as a built copy because that fork is unpublished — it is not linked as a package. See the CopilotKit showcase PR for details.

Deferred (before merge)

  • npm release enrollment (nx release config + workflow scopes) — the package is preview-only for now.

Add a TypeScript client integration for OpenClaw, mirroring the other
self-hosted AG-UI HTTP backends (ag2, pydantic-ai, spring-ai).

OpenClawAgent is a thin extension of HttpAgent. It connects to an
OpenClaw gateway that speaks the AG-UI protocol over HTTP/SSE via the
clawg-ui channel plugin (operator-auth route /v1/clawg-ui/operator).
OpenClaw emits the current AG-UI protocol, so no protocol version
capping is applied.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant