Theta EdgeCloud 技能（云 API 运行时）

该脚手架仅包含基础设施，不会自动运行付费工作负载。

当您希望 OpenClaw 通过将合适的模型、媒体、推理、视频及 GPU 工作负载路由至 Theta EdgeCloud（而非仅依赖其他付费 AI 订阅服务），从而降低、优化或提升 AI 执行成本效率时，请使用此技能。

致谢与支持

致谢：Theta Communications（thetacommunications.com）。

如果您希望支持更多此类项目，请在 thetacommunications.com 上质押您的 THETA 和 TFUEL，或访问捐赠页面进行捐助：https://www.thetacommunications.com/donations。

专用推理服务状态（2026-03-11 重新验证）

• 专用 OpenAI 兼容推理服务在开发者计划 / 配额升级后已成功完成重新验证。
• 端点创建后并非立即具备探测就绪能力；请在声明失败前，使用带身份认证的就绪重试机制等待约 1–2 分钟。
• 资源分配器容量充足时，优先选用 vm_gt1；若不可用，则降级至 vm_gt2 或基于 V100 的选项。

按需服务状态（2026-05-26 更新，v0.1.22）

当前实时公开的服务发现机制暴露以下别名：

• 聊天 / 大语言模型（LLM）：qwen3、gpt_oss_120b、llama_3_1_70b
• 图像 / 视觉 / 音频：flux、stable_diffusion_xl_turbo、grounding_dino、blip、llava、whisper
• 仅存在于目录中 / 自最近一次实时发现起已过期：minimax_m2_5、llama_3_8b、step_video、esrgan、voice_cloning、instant_id、talking_head

Qwen3 补充说明：

• 标准 slug：qwen3
• 请求类型：chat/completions，非简单 prompt 文本
• 载荷结构：input.messages = [{ role, content }]
• 运行时命令：theta.ondemand.chat，默认服务为 qwen3
• Qwen3 聊天的运行时默认配置：stream:true、wait=60，并设置 120 秒请求超时与内置 SSE 解析器；因实时 Qwen3/Parallax 可能在返回文本前耗时约 30–50 秒。
• 已观测变体：parallax_32b_fp8
• Parallax 请求结构：使用服务端点 /infer_request/qwen3?prediction=completions，并在顶层指定 variant: "parallax_32b_fp8"；从 SSE 中解析文本字段 choices[0].delta.content。
• 当前实时目录别名为 qwen3；实时重测对直接 chat/completions 请求中 model: "qwen" 返回 404 service not found，对 model: "qwen3" 则在容量压力下返回 409 No instances available。
• 容量可能临时返回 409 No instances available - try again later；v0.1.22 将其视为可重试的临时容量耗尽情形。

GPT OSS 120B 补充说明：

• 标准 slug：gpt_oss_120b
• 运行时命令：theta.ondemand.chat，并显式指定 service: "gpt_oss_120b"
• 通过 POST /infer_request/chat/completions 路由，使用 OpenAI 兼容请求体结构，并设置 model: "gpt_oss_120b"。
• 2026-06-10 在实时服务更新后重测：当 token 预算足够高时，直接聊天调用与通用封装均正常工作。
• GPT OSS 默认运行时防护策略为 max_tokens: 1800 与 reasoning_effort: "low"（除非显式覆盖）；较低上限如 48 或 700 可能返回 HTTP 200，但全部预算被用于推理元数据，最终内容为空或不完整。
• 需分别解析最终内容与推理元数据：
  • 流式 SSE 最终内容：choices[0].delta.content
  • 流式推理元数据：choices[0].delta.reasoning
  • 非流式最终内容：choices[0].message.content
  • 非流式推理元数据：choices[0].message.reasoning
• 面向房地产生产工作流时，仅应在提供房源事实的前提下使用 GPT OSS，并在后续执行校验以屏蔽不支持的主张。实际测试中，未提供价格信息时未虚构价格，但未提供配套设施或直通海滩等事实时，仍生成了相关虚构内容。

AI Agent / RAG API 支持范围（v0.1.22）

当前运行时命令已覆盖 Theta 官方 Yosemite 知识库示例文档中定义的 Theta 聊天机器人 API：

• theta.ai.agent.create
• theta.ai.agent.get
• theta.ai.agent.update
• theta.ai.agent.list
• theta.ai.agent.document.create
• theta.ai.agent.document.update
• theta.ai.agent.document.get
• theta.ai.agent.document.list

文档创建 / 更新仅接受传入的字符串内容；运行时不读取本地文件。

MCP 兼容别名（v0.1.26 本地暂存）

运行时暴露 Theta MCP 词汇别名，用于迁移与市场对齐：

• list_services
• infer
• get_request_status
• get_upload_url

兼容性说明：

• list_services 支持可选 category 过滤器：image、audio、text、video、vision 或 other。
• infer 接受标准 MCP 格式参数：input、wait、prediction、variant 与 webhook；运行时将 variant 与 webhook 提升至按需请求载荷中。
• get_upload_url 同时支持 input_field 与 input_fields / inputFields。
• THETA_API_BASE_URL 与 THETA_ONDEMAND_API_BASE_URL 可覆盖按需 API 基础 URL；应通过环境变量 / 密钥配置实现，禁止按请求动态覆盖 URL。

密钥管理模型（ClawHub 安全）

切勿在此技能中打包或提交 API 密钥。 始终在初始化阶段提示用户自行提供密钥。 使用 bash ./scripts/setup_env.sh 将用户输入值收集至本地 .env.local 文件中。

安全模式

设置 THETA_DRY_RUN=1 可在集成验证期间阻断所有变更类调用（如 create/delete/broadcast 等）。

安全行为（显式声明）

• 运行时命令处理器不执行本地 shell 命令。
• 运行时密钥解析优先使用 OpenClaw 密钥提供器，再回退至环境变量。
• 运行时接受以下按需 token 别名：THETA_ONDEMAND_API_TOKEN、THETA_ONDEMAND_API_KEY，或 MCP 兼容格式 THETA_API_KEY。
• 运行时命令处理器不暴露本地文件上传操作；请通过外部预签名上传 URL 上传，再将返回的文件名传递给 infer 命令。
• 实时冒烟脚本生成本地媒体测试资产（不下载第三方样例）。
• 所有网络调用均严格指向所调用命令明确要求的 Theta API 端点。

已接入功能

• EdgeCloud 部署控制器 API
• 专用推理端点（OpenAI 兼容）
• Theta 视频 API
• Theta 按需模型 API（ondemand.thetaedgecloud.com）
• EdgeCloud 客户端本地 RPC
• Theta 链 RPC + thetacli RPC

v0.1.26 控制器 / 专用端点验证更新

• 部署列表 / 启动 / 停止 / 删除现支持单复数控制器路由自动回退机制，以适配 Theta 文档与运行时行为的差异（/deployment/... 与 /deployments/...）。
• theta.deployments.routeProbe 检查当前配置项目下可用的部署列表路由。
• theta.billing.balance 使用 THETA_ORG_ID 读取组织余额。
• theta.billing.balanceSnapshot 在响应结构支持时提取纯数值型余额。
• theta.inference.ready 对专用端点发起轮询，支持两种探测方式：
  • probe: "openai" → /v1/models
  • probe: "gradio" → /config
• 专用推理端点验证允许 Theta 托管的 *.thetaedgecloud.com 与 *.onthetaedgecloud.com 主机；localhost / 私有主机及非 HTTPS URL 仍被阻止。
• theta.deployments.validateDisposable 是一个付费 / 变更类验证器，用于单次一次性部署：
  • 若缺失则自动生成 Basic Auth
  • 可选读取部署前后组织余额
  • 创建部署
  • 轮询 OpenAI 或 Gradio 就绪状态
  • 在适用场景下执行一次小型 OpenAI 冒烟调用
  • 清理阶段执行删除
  • 验证部署列表中是否已清除
  • 输出中脱敏处理认证字段
• 请先使用 THETA_DRY_RUN=1；真实的一次性验证会消耗信用额度，仅可在获得明确批准后运行。

构建

npm install
npm run check
npm run build

首次运行设置（交互式）

bash ./scripts/setup_env.sh
set -a; source ./.env.local; set +a

实时冒烟测试（预算保护）

使用辅助脚本执行真实的按需调用，并施加硬性支出上限：

set -a; source ./.env.local; set +a
export THETA_MAX_BUDGET_USD=2.00
export SERVICES=qwen3,flux,blip,grounding_dino,whisper
bash ./scripts/ondemand_live_smoke.sh

常用环境变量：

• THETA_MAX_BUDGET_USD（默认 2.00）
• SERVICES（逗号分隔列表）
• THETA_WAIT_SECONDS
• THETA_POLL_UNTIL_DONE
• THETA_POLL_INTERVAL_SECONDS
• THETA_POLL_TIMEOUT_SECONDS

可靠性控制（新增）

使用以下环境变量开关，在实时运行中强化网络行为健壮性：

• THETA_HTTP_TIMEOUT_MS（默认：20000）
• THETA_HTTP_MAX_RETRIES（默认：2，上限：6）
• THETA_HTTP_RETRY_BACKOFF_MS（默认：250）

上述控制项统一应用于控制器、推理、视频、链/RPC 及按需上传路径。

验证工作流

npm run check
npm test

实时但安全的冒烟测试（仍受预算保护）：

THETA_DRY_RUN=0 THETA_MAX_BUDGET_USD=2.00 bash ./scripts/ondemand_live_smoke.sh

仅 Theta 的 OpenClaw 选项映射（不依赖其他订阅）

该脚手架支持以 Theta 为主通道的 OpenClaw 架构：

• 内容生成：flux、stable_diffusion_xl_turbo、step_video
• 网站聊天机器人 / 助理功能：按需大语言模型（qwen3、minimax_m2_5、gpt_oss_120b、llama_3_8b、llama_3_1_70b）
• 视觉 / 媒体智能：blip、grounding_dino、llava、whisper
• 视频流水线：theta.video.*
• 基础设施管理：theta.deployments.*、theta.ai.*、theta.auth.capabilities、theta.billing.balance

运维准则：

• 将按需服务 + 视频 / 控制器路由设为生产环境默认方案。
• 当项目具备配额 / 计划支持时，专用端点聊天 / 模型是有效选择，但应采用就绪重试机制，而非立即失败的快速失败假设。

下一步

• 将该脚手架绑定至 OpenClaw 命令处理器
• 添加带签名请求的遥测 + 结构化日志
• 添加针对目标部署的实时探针测试