跳转到内容

API 令牌

Daemon 首次启动时会在 dataDir/api-token 自动生成一个管理员所有者令牌。运行在同一台设备上的 CLI 会默认自动读取使用。对于其他客户端或第三方系统,建议创建按需限定权限范围的独立令牌:

Terminal window
wx tokens create my-script --accounts ACCOUNT_ID --scopes read --scopes send
wx tokens list
wx tokens revoke TOKEN_ID

生成的全新令牌仅在创建时的 token 字段中展示一次,请妥善保存。

权限范围 (Scope)赋予的操作权限
read查阅会话、消息、联系人、群聊及事件流
media下载多媒体附件资源
send发送与撤回消息
read-state标记会话已读
login登录授权、连接与断开网络
admin管理令牌和账号体系,以及编辑群聊(只读群聊仅需 read)
calls查阅通话状态与事件、注册接听就绪状态、控制呼叫以及交换所属通话的音频流

OpenClaw 至少需要 read、media、send 与 login 权限;除非 readPolicy 设置为 never,否则还需要 read-state 权限。若使用通话功能,还需要补充 calls 权限。

如需创建专用于通话的独立令牌,可向选定账号授予 calls 作用域:

Terminal window
wx tokens create my-calls --accounts ACCOUNT_ID --scopes calls

向各通话命令传入 --account ACCOUNT_ID。即使该令牌允许通话控制,执行 wx calls status 与 wx calls monitor --json 仍保持被动监听模式。它们无需读取聊天历史或账号列表的权限。通话音频传输仍需要取得该通话的独占所有权。