用途:为 OKX CLI 完成账户认证,包括首次设置、会话过期后重新认证和退出登录。支持站点 global(www.okx.com)、eea(my.okx.com)、us(app.okx.com)、tr(tr.okx.com)。
前置:未安装 CLI 时执行 npm install -g @okx_ai/okx-trade-cli。
主要能力与用法:先运行 okx config show --json 和 okx auth status --json 做预检:确认站点、检查是否已有 api_key、查看登录状态。站点未选定必须先让用户选择,不能静默默认 global。若已有 api_key,则应停止登录流程。AI 代理须用 okx auth login --manual --site <global|eea|us|tr>,它会返回 verificationUri、userCode 等 JSON 后立即退出,不阻塞;代理须把链接、验证码等字段以纯文本回复给用户,等待用户确认后再运行 okx auth status --json 校验。用户直接在终端操作时可用 okx auth login。凭据向导 okx config init 只配置 API-key,不执行 OAuth。二进制可用 okx auth install、okx auth install-status、okx auth remove 管理;退出用 okx auth logout。
适用场景:需要以 OAuth 方式连接 OKX 账户、重新认证或登出,以及区分站点与认证方式的设置流程。
限制:站点选择必须由用户完成且不能独立持久化配置;无 okx config set-site 命令;已有 api_key 时 OAuth 会被跳过;代理不应自动轮询、不应在等待授权时运行其他 okx 命令;区域限制、超时、拒绝授权等错误有对应处理方式。其余收费、价格等细节资料未提供。