wednesdayai identity
Manage people and their linked accounts in the Gateway config (session.identityLinks).
Related:
- Concepts and flows: Identities
- Paired devices: devices
- Channel pairing: pairing
- QR setup codes: qr
Commands
wednesdayai identity list
List configured identities and their linked accounts.
Identity and Links columns. With --json, it returns { "persons": [ { "person": "<name>", "links": [ ... ] } ] }.
wednesdayai identity add <name>
Create a new identity (person) for device and account linking.
<name>: Identity name (letters, digits,.,_or-, max 64 characters).
Added identity <name>. on success, or <name> already exists. if the name is already configured. With --json, returns { "person": "<name>", "changed": <boolean> }.
The names prototype, constructor, and __proto__ are reserved and refused, as is the raw~ prefix.
wednesdayai identity link <name> [value]
Link an account to an identity, or issue a user-client QR and setup code.
Pass either a chat or account link value (e.g. telegram:123, slack:U061CR7GN) or --qr. Device values (device:<deviceId>) are refused here; link a paired device with wednesdayai devices link <deviceId> --identity <name>, from the Control UI v2 console’s Nodes & devices page (Fleet group), or pair it already bound with --qr:
--qr: Issue a user-client QR and setup code for this identity instead of passing a value (invokes the QR generator with--client openclaw-user-client --identity <name>).--qris local-only: it reads this host’s gateway config, so the shared gateway flags--url,--tokenand--passwordare rejected (--qr issues a setup code from this host's gateway config; drop --url/--token/--password (run it on the gateway host).).--setup-code-only: With--qr, print only the setup code.--no-ascii: With--qr, skip ASCII QR rendering.--json: Output JSON.
Linked <value> to <name>. on success or Already linked. if the value was already linked to that identity. With --json, returns { "person": "<name>", "value": "<value>", "changed": <boolean> }.
wednesdayai identity unlink <value>
Remove a link value from every identity that contains it.
<value>: Link value to remove (e.g.telegram:123,device:<deviceId>).
Unlinked <value> from <name1>, <name2>. on success, or <value> is not linked. if the value was not present on any identity. With --json, returns { "value": "<value>", "unlinkedFrom": [ ... ] }.
Shared Gateway options
Allidentity subcommands call Gateway RPC methods (identity.list, identity.add, identity.link, identity.unlink) and accept the standard Gateway connection flags:
--url <url>: Gateway WebSocket URL (defaults togateway.remote.urlwhen configured).--token <token>: Gateway token (if required).--timeout <ms>: Timeout in ms (defaults to30000).--expect-final: Wait for final response (agent).--json: Output JSON (available on all subcommands).