openclaw users¶

通过 Gateway RPC API 管理持久化 Gateway 用户档案。这些用户档案用于标识人员；它们与 CLI 的 --profile 选项不同，后者用于选择一个隔离的 OpenClaw 配置和状态目录。

常用选项¶

• --url <url>: Gateway WebSocket URL；如果已配置，则默认为 gateway.remote.url。
• --token <token>: Gateway token，如需要。
• --timeout <ms>: RPC 超时时间（毫秒）；默认为 10000。
• --json: 以 JSON 格式打印 Gateway 结果。

将这些选项放在子命令之后。

列出用户档案¶

openclaw users list
openclaw users list --json

需要 operator.read。人类可读输出会列出每个用户档案的 ID、显示名称和电子邮件别名。在关联或合并用户档案时，请使用持久化 ID。

关联电子邮件别名¶

openclaw users link-email person@example.com --to <profile-id>

需要 operator.admin。调用 users.linkEmail 将一个电子邮件别名移动到目标用户档案。如果原用户档案失去其最后一个电子邮件，则会合并到目标用户档案中。否则，它将保留为独立的用户档案，并保留其其他别名。

合并重复用户档案¶

openclaw users merge <source-profile-id> --into <target-profile-id>
openclaw users merge <source-profile-id> --into <target-profile-id> --json

需要 operator.admin。使用 sourceProfileId 和 targetProfileId 调用 users.merge。当两个用户档案属于同一个人，并且整个源用户档案应退役（包括其没有电子邮件别名的情况）时，请使用此命令。

目标必须是一个已存在的、未合并的、与源不同的用户档案。共享的 Owner 用户档案不能在任何方向上合并。重复执行已完成的、指向同一目标的合并会成功。如果源指向另一个幸存用户档案，命令会失败并指明该当前用户档案。

人类可读输出会指明幸存用户档案和已退役 ID。JSON 返回 profile（幸存用户档案）和 movedAliasKinds（实际移动的别名类别）：email、provider 或 channel。未发生变化的重复操作返回空列表。

幸存用户档案保留其角色、显示名称、主要身份，以及冲突的偏好设置和账户选择。登录、渠道链接和个人账户按照现有合并规则跟随幸存用户档案。历史记录保留其原始归属；之前为已退役用户档案捕获的权限不会转移。有关转移规则和个人 USER.md 处理，请参阅 合并重复用户档案。