跳转至

openclaw users

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

常用选项

  • --url <url>: Gateway WebSocket URL;如果已配置,则默认为 gateway.remote.url。
  • --token <token>: Gateway 令牌(如需要)。
  • --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 处理,请参阅 合并重复档案。

本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 cl/openclaw