API 令牌
Daemon 首次启动时会在 dataDir/api-token 自动生成一个管理员所有者令牌。运行在同一台设备上的 CLI 会默认自动读取使用。对于其他客户端或第三方系统,建议创建按需限定权限范围的独立令牌:
wx tokens create my-script --accounts ACCOUNT_ID --scopes read --scopes sendwx tokens listwx 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 作用域:
wx tokens create my-calls --accounts ACCOUNT_ID --scopes calls向各通话命令传入 --account ACCOUNT_ID。即使该令牌允许通话控制,执行 wx calls status 与 wx calls monitor --json 仍保持被动监听模式。它们无需读取聊天历史或账号列表的权限。通话音频传输仍需要取得该通话的独占所有权。