cloudphone

What This Skill Does

The cloudphone skill serves as a robust bridge between the OpenClaw agent and remote Android cloud phone environments. By leveraging mcporter as an orchestration layer to interface with cpc-mcp-server, it allows agents to perform complex, scripted automation tasks on virtualized Android devices. Instead of relying on local device farms or fragile physical setups, users can orchestrate UI interactions, app testing, and log retrieval through standardized JSON-based instructions. This skill abstracts the complexity of AutoJS automation, enabling developers and QA engineers to trigger cloud-native device operations seamlessly.

Installation

To install this skill, run the following command in your terminal within the OpenClaw environment: clawhub install openclaw/skills/skills/sav7ng/cloudphone

Once installed, ensure the CLOUDPHONE_API_KEY environment variable is correctly configured in your system. The skill requires an active Authorization: Bearer <API_KEY> header to communicate with the cpc-mcp-server. Verify connectivity by executing mcporter list to ensure the server is discoverable.

Use Cases

This skill is ideal for teams needing to scale their mobile testing infrastructure. Common scenarios include:

• Automated Regression Testing: Ensuring app stability across various cloud Android build versions without manual intervention.
• Performance Benchmarking: Executing scripted user journeys on cloud devices and extracting log outputs for data analysis.
• Remote Workflow Validation: Automating complex UI interactions, such as multi-step sign-ups or payment flows, directly on cloud-hosted devices.
• UI Consistency Monitoring: Taking programmatic screenshots after specific navigation paths to verify visual assets and layout integrity across different screen resolutions.

Example Prompts

1. "Use the cloudphone skill to open the Spotify app, verify the login screen appears, and return a screenshot of the landing page."
2. "Can you run an AutoJS task on the remote device to navigate to the settings menu and export the current system logs?"
3. "Start a cloud automation session for the 'OrderPro' app; perform a dummy checkout sequence and confirm if the order confirmation toast message is displayed."

Tips & Limitations

• Security First: Never hardcode your API keys. Always use secure vault management or environment injection for CLOUDPHONE_API_KEY.
• JSON Args: For complex tasks, always use the --args flag with JSON formatting to avoid escaping issues with special characters.
• Limitations: This skill is strictly for cloud-based Android devices. It cannot control local emulators, hardware-connected devices, or iOS platforms. If an AutoJS script fails, check the returned taskId status in the MCP server logs to debug execution errors.