registration

Start a pairing session

Starts the pairing flow used by the OpenClaw plugin and the CLI. The response includes a pairUrl for the human to open while signed in, and a verifier that must stay on the calling machine: it is the proof that lets this process, and no one else, claim the minted key.

post/api/openclaw/pair/start

Request

  • Base URL: https://claw-link.dev
  • URL: https://claw-link.dev/api/openclaw/pair/start
  • Auth: none required

Request body

deviceLabelstring

Human-readable device name shown on the approval page and in the dashboard.

clientstring

Set to "cli" for CLI installs; omit for the OpenClaw plugin.

Response

Pairing session created

sessionTokenstring required
displayCodestring

Short code shown to the user to match device and browser.

deviceLabelstring nullable
statusstring
expiresAtstring required
pollIntervalMsinteger
pairUrlstring required

Approval URL (https://claw-link.dev/openclaw/pair/<token>). Show it to the user; they approve while signed in.

verifierstring required

Keep secret on the calling machine. Required by the exchange call.

Changes

No recorded changes to this operation across all 1 revision of this API.