Hoppa till huvudinnehåll

​
Parning

“Parning” är OpenClaws explicita ägargodkännande steg. Den används på två ställen:
  1. DM-parning (vem som får prata med boten)
  2. Nodparning (vilka enheter/noder som får ansluta till gateway-nätverket)
Säkerhetskontext: Security

​
1. DM-parning (inkommande chattåtkomst)

När en kanal är konfigurerad med DM-policy pairing får okända avsändare en kort kod och deras meddelande behandlas inte förrän du godkänner. Standard-DM-policyer dokumenteras i: Security Parningskoder:
  • 8 tecken, versaler, inga tvetydiga tecken (0O1I).
  • Förfaller efter 1 timme. Botten skickar bara ett parningsmeddelande när en ny begäran skapas (ungefär en gång per timme per avsändare).
  • Väntande DM-parningsbegäranden är som standard begränsade till 3 per kanal; ytterligare begäranden ignoreras tills en går ut eller godkänns.

​
Godkänn en avsändare

openclaw pairing list telegram
openclaw pairing approve telegram <CODE>
Stödda kanaler: telegram, whatsapp, signal, imessage, discord, slack.

​
Var tillståndet lagras

Lagring under ~/.openclaw/credentials/:
  • Väntande begäranden: <channel>-pairing.json
  • Godkänd tillåtelselista: <channel>-allowFrom.json
Behandla dessa som känsliga (de styr åtkomsten till din assistent).

​
2. Nod-/enhetsparning (iOS/Android/macOS/headless-noder)

Noder ansluter till Gateway som enheter med roll: node. Gateway skapar en anordning parningsbegäran som måste godkännas.

​
Para via Telegram (rekommenderas för iOS)

Om du använder pluginet device-pair kan du göra den första enhetsparkopplingen helt via Telegram:
  1. I Telegram, skicka till din bot: /pair
  2. Boten svarar med två meddelanden: ett instruktionsmeddelande och ett separat installationskod-meddelande (enkelt att kopiera/klistra in i Telegram).
  3. På din telefon, öppna OpenClaw iOS-appen → Inställningar → Gateway.
  4. Klistra in installationskoden och anslut.
  5. Tillbaka i Telegram: /pair approve
Installationskoden är en base64-kodad JSON-nyttolast som innehåller:
  • url: Gateway WebSocket-URL:en (ws://... eller wss://...)
  • token: en kortlivad parkopplingstoken
Treat the setup code like a password while it is valid.

​
Godkänn en nodenhet

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

​
Lagring av nodparningstillstånd

Lagring under ~/.openclaw/devices/:
  • pending.json (kortlivad; väntande begäranden går ut)
  • paired.json (parade enheter + token)

​
Noteringar

  • Den äldre node.pair.* API (CLI: openclaw noder väntande/godkänna) är en separat gateway-ägda parbutik. WS-noder kräver fortfarande enhet parning.

​
Relaterad dokumentation