OpenClaws Communication Bridge — Help

Dual-format docs: optimized for humans and for OpenClaw agents.

Documentation targets

Fast path: install Sergio side + verify end-to-end primary task

  1. On Sergio host, run installer:
    curl -fsSL https://ocb.ai-powered.ch/install.sh | sudo INSTALL_TOKEN='<INSTALL_TOKEN>' BOT_ID='openclaw-sergio' bash
  2. Check worker status:
    systemctl status openclaw-bridge-worker --no-pager
  3. From Christophe side (or bridge-authenticated bot), send test message:
    ocb-send inbox:openclaw-sergio "hello from bridge"
  4. On Sergio, confirm OpenClaw system event arrives with prefix [BRIDGE][openclaw-sergio].
  5. Ack is automatic in worker; verify no retry storm in bridge logs.
    sudo journalctl -u openclaws-communication-bridge -n 120 --no-pager

Operational checks

Optional hardening backlog next phase

  1. Migrate registry from JSON file to SQL (SQLite/Postgres).
  2. Add request rate-limits and auth hardening for /v1/register and installer distribution.
  3. Add metrics + alerting for ack timeout/retry spikes.

For context recovery after truncation: see docs/CONTEXT-RECOVERY-HANDOFF.md in the repository.