Naar hoofdinhoud gaan

​
Pairing

“Pairing” is de expliciete stap voor goedkeuring door de eigenaar van OpenClaw. Deze wordt op twee plekken gebruikt:
  1. DM-pairing (wie met de bot mag praten)
  2. Node-pairing (welke apparaten/nodes mogen deelnemen aan het gateway-netwerk)
Beveiligingscontext: Security

​
1. DM-pairing (inkomende chattoegang)

Wanneer een kanaal is geconfigureerd met DM-beleid pairing, krijgen onbekende afzenders een korte code en wordt hun bericht niet verwerkt totdat je goedkeurt. Standaard DM-beleiden zijn gedocumenteerd in: Security Pairingcodes:
  • 8 tekens, hoofdletters, geen dubbelzinnige tekens (0O1I).
  • Verlopen na 1 uur. De bot stuurt het pairingbericht alleen wanneer een nieuw verzoek wordt aangemaakt (ongeveer één keer per uur per afzender).
  • Openstaande DM-pairingverzoeken zijn standaard beperkt tot 3 per kanaal; extra verzoeken worden genegeerd totdat er één verloopt of wordt goedgekeurd.

​
Een afzender goedkeuren

openclaw pairing list telegram
openclaw pairing approve telegram <CODE>
Ondersteunde kanalen: telegram, whatsapp, signal, imessage, discord, slack.

​
Waar de staat woont

Opgeslagen onder ~/.openclaw/credentials/:
  • Openstaande verzoeken: <channel>-pairing.json
  • Goedgekeurde toegestane lijst: <channel>-allowFrom.json
Behandel deze als gevoelig (ze bepalen de toegang tot je assistent).

​
2. Node-apparaatpairing (iOS/Android/macOS/headless nodes)

Nodes verbinden met de Gateway als apparaten met role: node. De Gateway maakt een apparaat-pairingverzoek aan dat moet worden goedgekeurd.

​
Koppelen via Telegram (aanbevolen voor iOS)

Als je de device-pair-plugin gebruikt, kun je de eerste apparaatkoppeling volledig vanuit Telegram doen:
  1. Stuur in Telegram een bericht naar je bot: /pair
  2. De bot antwoordt met twee berichten: een instructiebericht en een afzonderlijk bericht met de setupcode (makkelijk te kopiëren/plakken in Telegram).
  3. Open op je telefoon de OpenClaw iOS-app → Instellingen → Gateway.
  4. Plak de setupcode en maak verbinding.
  5. Terug in Telegram: /pair approve
De setupcode is een base64-gecodeerde JSON-payload die bevat:
  • url: de Gateway WebSocket-URL (ws://... of wss://...)
  • token: een kortlevende pairing-token
Behandel de setupcode als een wachtwoord zolang deze geldig is.

​
Keur een node apparaat goed

openclaw devices list
openclaw devices approve <requestId>
openclaw devices reject <requestId>

​
Opslag van node-pairingstatus

Opgeslagen onder ~/.openclaw/devices/:
  • pending.json (kortlevend; openstaande verzoeken verlopen)
  • paired.json (gekoppelde apparaten + tokens)

​
Notities

  • De legacy node.pair.*-API (CLI: openclaw nodes pending/approve) is een aparte, gateway-eigen pairingopslag. WS-nodes vereisen nog steeds apparaatpairing.

​
Gerelateerde documentatie