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

curl -fsSL https://api.agentline.cloud/static/agentline_relay.py -o agentline_relay.py
python agentline_relay.py install --agent-id agt_xxx

The installer uses 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:

wss://api.agentline.cloud/v1/events/ws?agent_id=agt_xxx&runtime=hermes

Set 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:

{"type":"context","event_id":"evt_xxx","call_id":"call_xxx","turn_id":"turn_xxx","push_token":"...","context":"Your inbox has no new emails."}
{"type":"ack","event_id":"evt_xxx"}

Always echo the exact 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. The context value is direct speech: return one or two concise caller-ready sentences. AgentLine speaks it verbatim and then stores it as the assistant turn for later conversation context. The hosted voice LLM only rephrases it if direct speech synthesis fails.

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 exec thread ID.
Non-live SMS, completion, and owner-task events are stored in the connector’s private local inbox instead of automatically executing untrusted content.

List and acknowledge inbox events:

python ~/.agentline/agentline_relay.py inbox list --agent-id agt_xxx
python ~/.agentline/agentline_relay.py inbox ack --agent-id agt_xxx --event-id evt_xxx

HTTP fallback

For a live event, the HTTP equivalent is:

curl -X POST "https://api.agentline.cloud/v1/calls/call_xxx/context?turn_id=turn_xxx" \
  -H "X-Push-Token: PUSH_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"turn_id":"turn_xxx","context":"Your inbox has no new emails."}'

Use a public webhook only when a persistent outbound connector cannot run. Polling is not suitable for live caller turns.

Get Started

Guides

SDKs

Agent Relay

Agent Relay

Install

Protocol

Runtime behavior

HTTP fallback

​Agent Relay

​Install

​Protocol

​Runtime behavior

​HTTP fallback

Agent Relay

Install

Protocol

Runtime behavior

HTTP fallback