Skip to main content

wednesdayai identity

Manage people and their linked accounts in the Gateway config (session.identityLinks). Related:

Commands

wednesdayai identity list

List configured identities and their linked accounts.
If no identities exist yet, prints:
When identities exist, the command renders a table with 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.
Arguments:
  • <name>: Identity name (letters, digits, ., _ or -, max 64 characters).
Prints 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. 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:
Options:
  • --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>). --qr is local-only: it reads this host’s gateway config, so the shared gateway flags --url, --token and --password are 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.
When linking a value, prints 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> }. Remove a link value from every identity that contains it.
Arguments:
  • <value>: Link value to remove (e.g. telegram:123, device:<deviceId>).
Prints 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

All identity 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 to gateway.remote.url when configured).
  • --token <token>: Gateway token (if required).
  • --timeout <ms>: Timeout in ms (defaults to 30000).
  • --expect-final: Wait for final response (agent).
  • --json: Output JSON (available on all subcommands).