openclaw-core

Generated: 2026-06-16

OVERVIEW

Package: @oh-my-opencode/openclaw-core. Harness-neutral Core for OpenClaw bidirectional integration. Outbound dispatch fires HTTP webhooks or shell commands on session events; inbound reply-listener daemon polls Discord/Telegram and injects replies into tracked tmux panes. Consumed by the OpenCode adapter at packages/omo-opencode/src/openclaw/ via re-export shims.

KEY FILES

File	Role
src/index.ts	Barrel: wakeOpenClaw(), initializeOpenClaw(), startReplyListener, stopReplyListener
src/types.ts	OpenClawConfig, OpenClawPayload, WakeResult
src/config.ts	Gateway resolution + reply listener config normalization
src/dispatcher.ts	HTTP POST + shell command execution with variable interpolation
src/runtime-dispatch.ts	Maps harness events to OpenClaw events; orchestrates dispatch
src/session-registry.ts	JSONL registry correlating message IDs to sessions and panes (file-locked)
src/reply-listener.ts	Daemon lifecycle barrel (start/stop/poll loop/status/log)
src/reply-listener-start.ts	Spawns the daemon as a detached Bun process
src/reply-listener-poll-loop.ts	Polls Discord/Telegram every 3s, prunes stale registry entries hourly
src/reply-listener-injection.ts	Injects received replies into tmux panes with rate limiting
src/tmux.ts	captureTmuxPane(), sendToPane(), analyzePaneContent()
src/daemon.ts	Entry point for the detached daemon process

FLOW

Discord/Telegram API → reply-listener-poll-loop.ts
  → session-registry.ts: lookup tmux pane by message ID
  → reply-listener-injection.ts: rate limit check → sanitize → send-keys into pane

NOTES

• URL validation requires HTTPS except localhost (gateway-url-validation.ts).
• Session registry is a file-locked JSONL written via session-registry-storage.ts.
• Daemon state persists to disk via reply-listener-state.ts (PID, config signature, poll tracking).
• Rate limiter defaults to 10 injections per minute per pane.
• tmux.ts pane confidence check skips injection if analyzePaneContent() returns below 0.3.

Parent: packages/AGENTS.md