{
  "schemaVersion": "1.0",
  "item": {
    "slug": "cloudphone",
    "name": "Cloud Phone Agent",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/sav7ng/cloudphone",
    "canonicalUrl": "https://clawhub.ai/sav7ng/cloudphone",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/cloudphone",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=cloudphone",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "mcporter-readme.md",
      "SKILL.md"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "Download the package from Yavira.",
        "Extract it into a folder your agent can access.",
        "Paste one of the prompts below and point your agent at the extracted folder."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
        },
        {
          "label": "Upgrade existing",
          "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "slug": "cloudphone",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-01T21:30:16.178Z",
      "expiresAt": "2026-05-08T21:30:16.178Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=cloudphone",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=cloudphone",
        "contentDisposition": "attachment; filename=\"cloudphone-0.0.2.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "cloudphone"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/cloudphone"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/cloudphone",
    "agentPageUrl": "https://openagent3.xyz/skills/cloudphone/agent",
    "manifestUrl": "https://openagent3.xyz/skills/cloudphone/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/cloudphone/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "Download the package from Yavira.",
      "Extract it into a folder your agent can access.",
      "Paste one of the prompts below and point your agent at the extracted folder."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
      },
      {
        "label": "Upgrade existing",
        "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "What this skill does",
        "body": "cloudphone guides the agent to run Android automation tasks in a cloud phone environment by calling cpc-mcp-server tools through mcporter.\n\nIt is designed for:\n\nAutoJS-based cloud phone automation\nApp regression / smoke test execution\nRemote batch operation workflows\nScripted interaction on cloud Android devices"
      },
      {
        "title": "When to use this skill",
        "body": "Use this skill when the user asks for actions such as:\n\n“Run a script on a cloud phone”\n“Use AutoJS to automate this app flow”\n“Execute Android UI steps remotely and return screenshots/logs”\n“Use cpc-mcp-server for cloud-device automation”"
      },
      {
        "title": "When NOT to use this skill",
        "body": "Do not use this skill for:\n\nLocal ADB/emulator automation (non-cloud devices)\niOS automation (e.g., XCUITest)\nStatic script/code review without real device execution\nPure consulting requests without executable task goals"
      },
      {
        "title": "Required prerequisites (must pass before execution)",
        "body": "Before any call, ensure authentication is configured correctly.\n\ncpc-mcp-server requires:\n\nAuthorization: Bearer <API_KEY>\n\nThis skill standardizes the API key through:\n\nCLOUDPHONE_API_KEY (required)"
      },
      {
        "title": "Requirements",
        "body": "Set environment variable CLOUDPHONE_API_KEY.\nEnsure MCP server header injection is active before execution:\n\nAuthorization: Bearer $CLOUDPHONE_API_KEY\n\n\nNever hardcode or commit real keys in repo files, SKILL.md, or config JSON.\n\nThis skill defines naming and preconditions only.\nSecret injection implementation is handled by runtime/environment config."
      },
      {
        "title": "Invocation model (via mcporter)",
        "body": "This skill does not call MCP tools directly. It uses mcporter CLI to invoke tools on cpc-mcp-server.\n\nCommon command patterns:\n\nList configured MCP servers:\n\nmcporter list\n\n\nInspect server schema:\n\nmcporter list cpc-mcp-server --schema\n\n\nCall tool with JSON args (recommended):\n\nmcporter call cpc-mcp-server.<tool> --args '<json>'\n\nPrefer --args JSON for long instructions, multilingual text, and special characters."
      },
      {
        "title": "Minimal input checklist (before creating tasks)",
        "body": "Collect these fields first (ask follow-up only if missing):\n\nTarget app (name/package)\nIntended action (what to do)\nSuccess criteria (what counts as done)\nExpected output type (screenshot/log/text result)"
      },
      {
        "title": "Goal",
        "body": "Create and dispatch an AutoJS Agent task, then obtain taskId (and possibly sessionId)."
      },
      {
        "title": "Recommended call",
        "body": "mcporter call cpc-mcp-server.createAutoJsAgentTask --args '{\n  \"instruction\": \"Open <APP_NAME> on cloud phone, log in with test account, navigate to Orders page, capture a screenshot, and return order count.\",\n  \"lang\": \"en\"\n}'"
      }
    ],
    "body": "What this skill does\n\ncloudphone guides the agent to run Android automation tasks in a cloud phone environment by calling cpc-mcp-server tools through mcporter.\n\nIt is designed for:\n\nAutoJS-based cloud phone automation\nApp regression / smoke test execution\nRemote batch operation workflows\nScripted interaction on cloud Android devices\nWhen to use this skill\n\nUse this skill when the user asks for actions such as:\n\n“Run a script on a cloud phone”\n“Use AutoJS to automate this app flow”\n“Execute Android UI steps remotely and return screenshots/logs”\n“Use cpc-mcp-server for cloud-device automation”\nWhen NOT to use this skill\n\nDo not use this skill for:\n\nLocal ADB/emulator automation (non-cloud devices)\niOS automation (e.g., XCUITest)\nStatic script/code review without real device execution\nPure consulting requests without executable task goals\nRequired prerequisites (must pass before execution)\n\nBefore any call, ensure authentication is configured correctly.\n\ncpc-mcp-server requires:\n\nAuthorization: Bearer <API_KEY>\n\nThis skill standardizes the API key through:\n\nCLOUDPHONE_API_KEY (required)\nRequirements\nSet environment variable CLOUDPHONE_API_KEY.\nEnsure MCP server header injection is active before execution:\nAuthorization: Bearer $CLOUDPHONE_API_KEY\nNever hardcode or commit real keys in repo files, SKILL.md, or config JSON.\n\nThis skill defines naming and preconditions only.\nSecret injection implementation is handled by runtime/environment config.\n\nInvocation model (via mcporter)\n\nThis skill does not call MCP tools directly. It uses mcporter CLI to invoke tools on cpc-mcp-server.\n\nCommon command patterns:\n\nList configured MCP servers:\nmcporter list\nInspect server schema:\nmcporter list cpc-mcp-server --schema\nCall tool with JSON args (recommended):\nmcporter call cpc-mcp-server.<tool> --args '<json>'\n\nPrefer --args JSON for long instructions, multilingual text, and special characters.\n\nMinimal input checklist (before creating tasks)\n\nCollect these fields first (ask follow-up only if missing):\n\nTarget app (name/package)\nIntended action (what to do)\nSuccess criteria (what counts as done)\nExpected output type (screenshot/log/text result)\nTool 1: Create task (createAutoJsAgentTask)\nGoal\n\nCreate and dispatch an AutoJS Agent task, then obtain taskId (and possibly sessionId).\n\nRecommended call\nmcporter call cpc-mcp-server.createAutoJsAgentTask --args '{\n  \"instruction\": \"Open <APP_NAME> on cloud phone, log in with test account, navigate to Orders page, capture a screenshot, and return order count.\",\n  \"lang\": \"en\"\n}'"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/sav7ng/cloudphone",
    "publisherUrl": "https://clawhub.ai/sav7ng/cloudphone",
    "owner": "sav7ng",
    "version": "0.0.2",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/cloudphone",
    "downloadUrl": "https://openagent3.xyz/downloads/cloudphone",
    "agentUrl": "https://openagent3.xyz/skills/cloudphone/agent",
    "manifestUrl": "https://openagent3.xyz/skills/cloudphone/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/cloudphone/agent.md"
  }
}