用途:只处理隐私号绑定关系的生命周期,即创建、解绑、查询;真实通话由 A → X → B 触发,本 Skill 不发起呼叫。适用于需要中间号做号码保护的场景。
鉴权与环境变量:按优先级解析。第一优先 ARK_SKILL_API_KEY + ARK_SKILL_API_BASE(火山引擎 arkclaw 企业版,先在火山后台页面配置好 AK/SK,由 arkclaw 注入,脚本以 Bearer 鉴权直连网关,无需本地签名);其次 VOLC_ACCESS_KEY + VOLC_SECRET_KEY(兼容 VOLCENGINE_ACCESS_KEY/VOLCENGINE_SECRET_KEY,适用于个人版 arkclaw、openclaw、coco、aime、claudecode 等,脚本本地做 HMAC-SHA256(Volc V4)签名);都没有则报错并提示填入 AK/SK。
主要命令:bind_axb(指定 X 号绑定,支持 --expire-time、--record-flag、--asr-flag)、select_and_bind_axb(平台选号并绑定,推荐,可带 --city-code)、bind_axn、select_and_bind_axn、bind_axne(带 --extension 分机号);解绑使用 unbind_axb / unbind_axn / unbind_axne,参数为 --sub-id 与 --number-pool-no;单条查询用 query_subscription --sub-id;批量列表用 query_subscription_list,--number-pool-no 必填,支持 --phone-a、--phone-b、--phone-x、--sub-type、--limit、--offset。
--expire-time 支持相对秒数(如 2592000 表示 30 天,默认 30 天)或绝对秒级 unix 时间戳(>= 1e9),Skill 自动归一化;TOP 要求最终时间至少比当前晚 60 秒,否则报错。用户未指定 X 号时默认走 select_and_bind_axb 由平台按同城选号;返回 SubId 与 PhoneNoX 供后续解绑或排查。仅给某号码(常见为 X)查绑定时,先调 byted-vms-number-pool 的 query_number --phone 反查 NumberPoolNo,再执行本 Skill。号码池需先申请,隐私号 SubServiceType 为 201~206,常用 201,号码池地址 https://console.volcengine.com/cloud_vms/number。错误时按鉴权、NOT_IN_NUMBER_POOL、QUALIFICATION_* 分别引导处理。其他参数规范见内置 references/vms-fundamentals.md。