zhi
8c8386f838
Both submodules patched with the fixes discovered during laptop integration testing (PTY for dev-channels dialog, sessionKey-based ready signaling, first-inbound race delay, etc.). Verified twice on hzhang's laptop: curl POST /v1/chat/completions -> SSE delta with model's reply text.
SynthesisAgent
Bridge between OpenClaw (multi-channel hub) and Claude Code (interactive Claude session), letting OpenClaw drive Claude Code as an autonomous worker without using claude -p or the Agent SDK — so all usage stays on the interactive subscription quota.
Motivation
Starting 2026-06-15, Claude Agent SDK and claude -p usage on Max plans draws from a separate $100 monthly credit pool. Interactive Claude Code usage continues to draw from the subscription. Today OpenClaw's contractor agents spawn a fresh claude -p per external event, which after the cutover will consume credit instead of subscription.
SynthesisAgent moves contractor agents to a model where:
- A long-lived interactive
claudeprocess serves each OpenClaw session. - External events (Discord, Telegram, Slack…) flow into that process via the official
notifications/claude/channelMCP notification protocol, the same one Anthropic's owndiscord@claude-plugins-officialplugin uses. - The process exposes OpenClaw's tool surface (pcexec, sessions_, memory_, wiki_*, canvas, …) back to the model.
Architecture
Discord / Telegram / Slack / ...
│
▼
OpenClaw Gateway (existing)
│
▼
┌──────────────────────────────────────┐
│ SynthesisAgent.OpenclawPlugin │
│ - Process Manager (spawn / resume) │
│ - Session Mapping DB │
│ - Bridge WebSocket Server │
└──────────────────────────────────────┘
│ ▲
│ spawn │ WebSocket
▼ │
┌──────────────────────────────────────┐
│ claude --channels plugin:synthesis │ (one per OpenClaw session)
│ ├─ Claude Code (interactive) │
│ └─ SynthesisAgent.ClaudePlugin │
│ (MCP stdio server) │
│ - notifications/claude/channel │
│ - tool proxy → OpenClaw │
│ - permission bridge │
└──────────────────────────────────────┘
Submodules
| Module | Lives in | Role |
|---|---|---|
SynthesisAgent.OpenclawPlugin |
OpenClaw process | Spawns/manages Claude processes per session; bridges Claude ↔ OpenClaw event bus |
SynthesisAgent.ClaudePlugin |
Each Claude process | MCP stdio server registered as a --channels plugin; receives events from OpenclawPlugin bridge, proxies tool calls back |
Wire protocol
See docs/wire-protocol.md for the message schema between the two plugins.
Status
Scaffolding only. Nothing wired up. See each submodule's TODO list.
License
Apache-2.0 (matches the upstream Anthropic Discord channel plugin this work is modeled after).