Gateway Hot-Reload

The gateway diffs gateway.yaml against the running config and restarts only affected agents or channels. The WebSocket server keeps running.

Quick Start

Run the gateway

praisonai gateway run gateway.yaml

Edit live

Change agent instructions or a single channel token in gateway.yaml and save. The watcher applies a selective reload within ~5 seconds (1s debounce).

Restart Scope

Changed section	Effect
`agents.*`	Recreate agents only — channels keep running
`channels.<name>.*`	Restart only that channel
`provider.`, `guardrails.`	Recreate agents
`scheduler.`, `routes.`, `routing.*`	Full channel restart
Entire `channels` section	Full channel restart
Invalid YAML on save	Keep last-known-good config

Full restart stops and starts all channels but does not restart the WebSocket server — connected clients stay connected.

Tuning

Setting	Default	Description
Poll interval	`5.0`s	How often the watcher checks the file
Debounce	`1.0`s	Wait after last write before applying

Best Practices

Prefer agent-only edits for prompt tweaks

Changing agents.* avoids dropping live Telegram/Discord sessions.

Scope channel edits narrowly

Edit one channel block to restart only that platform.

Validate YAML before saving

Invalid saves are ignored — the previous config keeps running.

Bot Gateway

Gateway server overview

Gateway Channel Supervision

Self-healing channels

Gateway OverviewWebSocket gateway for multi-channel agent coordination and communication

​Quick Start

​Restart Scope

​Tuning

​Best Practices

​Related