Docs Home

Clawperator is a deterministic actuator tool for Android device automation.

Use this page as the routing index into the authored docs. The concrete machine entry points are llms.txt and llms-full.txt.

Current release: 0.5.2

Version Quick Reference

Check your CLI version:

clawperator version

Check CLI and APK compatibility:

clawperator version --check-compat --device <device_serial> --operator-package <package>

See Version Compatibility for detailed compatibility rules and recovery.

Agent Entry Points

Verification pattern:

curl -fsSL https://docs.clawperator.com/llms.txt
curl -fsSL https://docs.clawperator.com/llms-full.txt

Use:

  • llms.txt when you want the compact docs index
  • llms-full.txt when you want the full assembled documentation corpus

Setup

  • Setup - install the CLI, prepare a device, install the Operator APK, verify readiness, and run the first snapshot
  • Quickstart - the observe/decide/act loop: taking snapshots, reading the hierarchy, and sending actions

API

  • Overview - execution payload, result envelope, and branching model
  • CLI Reference - generated command and flag reference
  • Actions - canonical action types and parameter semantics
  • Selectors - NodeMatcher contract and CLI selector mapping
  • Snapshot Format - where snapshot_ui XML lives and how extraction works
  • Errors - public error-code contract and recovery patterns
  • Devices - device discovery and deterministic targeting
  • Doctor - doctor report contract and readiness checks
  • Timeouts - execution and action timeout budgeting
  • Environment Variables - current CLAWPERATOR_* and runtime environment controls
  • Serve API - local HTTP and SSE contract
  • MCP Server - stdio MCP server for MCP clients such as Claude Desktop
  • Navigation Patterns - composed navigation workflows for agents
  • Recording Format - raw NDJSON recording schema and parsed step log

Skills

Troubleshooting

Clawperator is open source. If these docs help, see the project on GitHub.