Project Docs

Max Bridge

Max Bridge is a tiny HTTP bridge between a Max bot webhook and OpenClaw. It accepts incoming webhook requests, forwards them to OpenClaw, and returns the assistant reply directly.

Design goal: keep it boring in the best way — one Node service, minimal moving parts, easy deployment.

Environment

BRIDGE_PORT=7734
BRIDGE_TOKEN=replace-me
OPENCLAW_TARGET=replace-with-your-target

# Optional
OPENCLAW_BIN=openclaw
REQUEST_TIMEOUT=120000
OWNER_NAME=

Local run

npm install
cp .env.example .env
npm start

systemd

Install the included max-bridge.service unit and point it at the repo checkout.

API

`POST /webhook/incoming`

Send webhook requests with a bearer token and JSON body:

{
  "message_id": "msg_123",
  "sender_id": "user_456",
  "sender_name": "User Name",
  "sender_username": "username",
  "chat_id": "chat_789",
  "text": "Hello!",
  "reply_to": null
}

Possible responses:

200 OK with a direct reply
204 No Content when OpenClaw returns no reply
401 Unauthorized
429 Too Many Requests
502 Bad Gateway

`GET /health`

Returns service health info.