核心用法
Theta EdgeCloud Skill 是一套面向 Theta EdgeCloud 云平台的 API-key-first 运行时脚手架，采用命令级作用域认证模型，仅按需注入特定功能所需的凭证，而非全局暴露所有密钥。
功能覆盖四大领域：
1. 部署与资源管理：通过 theta.deployments.* 实现 VM/GPU 部署的创建、停止、删除与状态监控，支持 vm_gt1、vm_gt2 及 V100 等 GPU 机型；theta.ai.dedicatedDeployments.list 可列示专用推理端点，但需注意端点创建后的 1-2 分钟预热期（404→502→200 的典型模式）。
2. 专用推理服务：提供 OpenAI 兼容的 theta.inference.models 与 theta.inference.chat，需配置 THETA_INFERENCE_ENDPOINT 及基础认证（user/pass）或 Bearer Token。运行时禁止通过 args.endpoint 动态覆盖，强制使用环境变量注入以保障安全。
3. 按需 AI 模型服务：支持实时服务发现（theta.ondemand.listServices）与多模态推理，包括文本生成（qwen3、llama_3_1_70b、gpt_oss_120b 等）、图像/视频生成（flux、stable_diffusion_xl_turbo、step_video）、视觉理解（blip、grounding_dino、llava）及语音转录（whisper）。theta.ondemand.chat 默认启用 SSE 流式解析以适配 Qwen3 的实时响应特性。
4. 视频基础设施：通过 theta.video.* 提供上传、转码、流式播放、Ingestor 管理等完整视频生命周期操作，需单独的服务账户凭证（THETA_VIDEO_SA_ID / THETA_VIDEO_SA_SECRET）。
安全与可靠性机制：
- Dry-run 保护：设置
THETA_DRY_RUN=1即可在付费/变更操作前预览实际调用，避免误操作。 - 密钥解析层级：OpenClaw Secret Provider 优先于环境变量回退，敏感凭证（
THETA_ONDEMAND_API_TOKEN、THETA_INFERENCE_AUTH_TOKEN等）不落地本地文件。 - 沙箱约束：运行时命令处理器不执行本地 shell 命令、不读取本地文件上传、不调用 localhost RPC，攻击面显著收窄。
- 智能重试与超时：
step_video等长耗时服务具备自适应超时（根据帧率/分辨率动态计算），409容量耗尽错误被识别为可重试临时状态。
显著优点
- 细粒度命令级认证，避免凭证过度授权；OpenAI 兼容接口降低迁移成本；丰富的多模态模型生态（尤其
qwen3、flux、step_video已验证生产可用）；dry-run 机制为自动化流水线提供安全边际。
潜在缺点与局限性
- 专用推理端点存在非瞬时就绪特性，需实现重试逻辑；默认配额（尤其是 GPU 机型）可能为零，需预充 $20 进入 Developer Plan 并手动申请提额；
409容量错误需客户端处理；视频服务账户与主 API 密钥体系分离，增加凭证管理复杂度；org/project 成员管理等账户级操作仍需 Dashboard 会话认证，未纳入此运行时覆盖。
适合人群
- 需要 GPU 加速推理、视频处理或多模态生成能力的开发者；追求 OpenAI 兼容接口以降低 LLM 切换成本的技术团队；已将 Theta 作为唯一付费 AI 后端、希望统一 OpenClaw 执行路由的用户；对自动化安全有要求、需 dry-run 闸门保护的生产环境运维者。
常规风险
- 凭证配置错误导致命令家族不可用（可用
theta.auth.capabilities诊断）；配额不足导致部署失败或409容量耗尽；忽略端点预热期导致误判服务故障；余额不足触发服务降级；视频服务账户密钥泄露导致媒体资源被非法访问。