Agent Relay
Agent Relay is the recommended way to connect a local agent to live AgentLine calls. The agent makes an outbound WebSocket connection, so it does not need a public URL or an inbound firewall rule.Install
AGENTLINE_API_KEY, detects the local runtime, creates an
isolated connector environment, verifies runtime readiness, preserves sessions,
and installs a persistent user service. It supports Hermes, OpenClaw, Claude
Code, Codex, and a custom stdin/stdout handler.
Installing a package, gateway, or OS service may trigger the runtime’s safety
approval. Approve it explicitly; the connector must not bypass that approval.
Protocol
The connector connects to:runtime to hermes, openclaw, claude-code, codex, or custom.
AgentLine sends events as durable frames. They remain available until ACKed.
For a live caller turn:
turn_id. A late or cancelled result returns 409 and
must not be applied to another caller question. Reconnects replay unacknowledged
events, and the connector deduplicates completed work by event_id.
context is short facts, not a script. The hosted voice does not speak that
text aloud.
Runtime behavior
- Hermes uses its local Responses API with a named conversation and session key.
- OpenClaw uses its Gateway-backed session-key interface.
- Claude Code captures and resumes its CLI
session_id. - Codex captures and resumes its
codex execthread ID. - Non-live SMS, completion, and owner-task events are stored in the connector’s private local inbox instead of automatically executing untrusted content.
Remember an answer
When the knowledge store is on for the agent, each task offers this: the agent can end an answer that will still be true for the next caller with one line:"remember":"everyone static" with the
done push.