Koppeling

“Koppeling” is de expliciete eigenaargoedkeuring van OpenClaw. Het wordt op twee plaatsen gebruikt:

  1. DM-koppeling (wie mag er met de bot praten)
  2. Node-koppeling (welke apparaten/nodes mogen deelnemen aan het gateway-netwerk)

Beveiligingscontext: Beveiliging

1) DM-koppeling (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 het goedkeurt.

Standaard DM-beleidsregels zijn gedocumenteerd in: Beveiliging

Koppelingscodes:

  • 8 tekens, hoofdletters, geen onduidelijke tekens (0O1I).
  • Verlopen na 1 uur. De bot stuurt het koppelingsbericht alleen wanneer een nieuw verzoek wordt aangemaakt (ongeveer één keer per uur per afzender).
  • Lopende DM-koppelingsverzoeken 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, feishu.

Waar de status wordt opgeslagen

Opgeslagen onder ~/.openclaw/credentials/:

  • Lopende verzoeken: <channel>-pairing.json
  • Goedgekeurde allowlist-opslag:
    • Standaardaccount: <channel>-allowFrom.json
    • Niet-standaardaccount: <channel>-<accountId>-allowFrom.json

Accountscoping-gedrag:

  • Niet-standaardaccounts lezen/schrijven alleen hun account-specifieke allowlist-bestand.
  • Standaardaccount gebruikt het kanaal-specifieke niet-account-specifieke allowlist-bestand.

Behandel deze als gevoelig (ze bepalen de toegang tot je assistent).

2) Node-apparaatkoppeling (iOS/Android/macOS/headless nodes)

Nodes verbinden met de Gateway als apparaten met role: node. De Gateway maakt een apparaatkoppelingsverzoek 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 apart installatiecodesbericht (gemakkelijk te kopiëren/plakken in Telegram).
  3. Open op je telefoon de OpenClaw iOS-app → Instellingen → Gateway.
  4. Plak de installatiecode en maak verbinding.
  5. Terug in Telegram: /pair approve

De installatiecode is een base64-gecodeerde JSON-payload die bevat:

  • url: de Gateway WebSocket URL (ws://... of wss://...)
  • bootstrapToken: een kortdurend single-device bootstraptoken dat wordt gebruikt voor de initiële koppelingshandshake

Behandel de installatiecode als een wachtwoord zolang deze geldig is.

Een node-apparaat goedkeuren

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

Opslaglocatie node-koppeling

Opgeslagen onder ~/.openclaw/devices/:

  • pending.json (kortdurend; lopende verzoeken verlopen)
  • paired.json (gekoppelde apparaten + tokens)

Opmerkingen

  • De verouderde node.pair.* API (CLI: openclaw nodes pending/approve) is een aparte gateway-beheerde koppelingsopslag. WS-nodes vereisen nog steeds apparaatkoppeling.

Gerelateerde documentatie

arrow_back
Vorige
Zalouser
Volgende
Group Messages
arrow_forward