用途:在域名已通过 Eliza Cloud 购买(eliza-cloud-buy-domain)或以外部方式绑定到应用后,用于查看、编辑、刷新状态或从应用移除域名。不注册新域名,不修改外部域名的 DNS。
主要能力:列出组织内全部域名(GET /api/v1/domains);列出某应用的域名(GET /api/v1/apps/{appId}/domains);查询单个已绑定域名的实时注册商状态(POST /api/v1/apps/{appId}/domains/status);对 Cloudflare 托管区域读取、新增、修改、删除 DNS 记录(GET/POST/PATCH/DELETE .../dns,PATCH/DELETE 需先取 recordId);同步刷新所有已绑定的 Cloudflare 域名(POST .../domains/sync);对外部域名重新校验 TXT 挑战(POST .../domains/verify);从应用解绑域名(DELETE /api/v1/apps/{appId}/domains,仅解绑,Cloudflare 注册保留至到期)。
使用方式:在对话式智能体中使用 @elizaos/plugin-cloud-apps 时,读取路径优先用 LIST_APP_DOMAINS 动作;DNS 记录增删改、校验、同步、解绑通过 SDK 或技能完成。SDK 示例:new ElizaCloudClient({ apiKey: process.env.ELIZAOS_CLOUD_API_KEY, baseUrl: process.env.ELIZA_CLOUD_BASE_URL }),再调用 cloud.routes 下对应方法。编排 worker 中不要请求父级 Cloud API key,改用 USE_SKILL parent-agent 的 cloud-command(如 domains.app.list、domains.dns.list)。实时状态应通过 Cloud API 加直接 HTTP/DNS/RDAP 请求判断,不要依赖网页搜索片段或注册商搜索页。
适用场景与限制:Cloudflare 注册域名可对 A、AAAA、CNAME、TXT、MX、SRV、CAA 全量增删改,变更约数分钟生效;外部域名只读,需在原 DNS 提供商处修改,DNS 端点会返回 409。删除记录不可逆,需提醒用户。不负责购买、转入、续费,续费由云端 cron 处理,续费设置请引导用户到控制台;DNS 编辑免费,不扣积分。可参考 references/api-shape.md、references/dns-records.md、references/failure-modes.md。