Clawperator Docs
Clawperator is a deterministic actuator tool for LLM-driven Android automation. It acts as the "hand" for an LLM "brain," allowing agents to automate device control on a dedicated Android device.
Use this page as a technical map:
- start with setup if you are preparing a device or emulator
- start with the Node API guide if you are integrating an agent
- use the reference section for exact command, payload, and error semantics
Machine-facing routes
- llms.txt - compact machine-oriented docs entrypoint
- llms-full.txt - compiled full docs corpus on the docs host
- sitemap.xml - canonical crawl map for this docs host
Recommended paths
Start here if you are integrating an agent
- Node API - Agent Guide - Canonical CLI and HTTP API contract for agent builders
- Operator LLM Playbook - Practical operating rules for observation, action loops, and skill execution
- API Overview - Execution payload, action types, result envelope shape, and snapshot semantics
- CLI Reference - Command-line entrypoints and flags
Start here if you are preparing runtime infrastructure
- First-Time Setup - Install the CLI, choose an Android environment, and prepare the Clawperator Operator Android app
- Running Clawperator on Android - Canonical actuator model, physical device vs emulator, and user responsibilities
- OpenClaw First Run - Task-oriented runbook for installing Clawperator, preparing Android, and completing a first real skill run
- Clawperator Operator Android app - Package variants, installation, and permissions for Clawperator's Android app
Getting Started
- Running Clawperator on Android - Canonical actuator model, physical device vs emulator, and user responsibilities
- Clawperator Terminology - Canonical definitions for Android device, Operator app, user-installed Android apps, and other core terms
- First-Time Setup - Install the CLI, choose an Android environment, and prepare the Clawperator Operator Android app
- OpenClaw First Run - Task-oriented runbook for installing Clawperator, preparing Android, and completing a first real skill run
- Project Overview - Mission, architecture, and repository surfaces
- Clawperator Operator Android app - Package variants, installation, and permissions for Clawperator's Android app
For AI Agents
- Node API - Agent Guide - Canonical CLI and HTTP API reference for agents
- Operator LLM Playbook - Action contracts, runtime conventions, and skill packaging
- API Overview - Execution payload, action types, result envelopes, and snapshot delivery
- CLI Reference - Exact command surface for local and scripted integrations
Reference
- CLI Reference - Command-line usage and flags
- API Overview - Execution payload, action types, result envelopes, and snapshot semantics
- Error Codes - Structured runtime and API error code reference
- Doctor - Runtime readiness checks, exit behavior, and JSON report shape
Architecture
- System Overview - High-level architecture and execution flow
- Node Runtime and API Design - Detailed Node contract and runtime design