# Clawperator

Clawperator is a deterministic Android automation runtime for AI agents. It exposes a strict Node API and CLI that let an agent observe Android UI state, execute validated actions, and receive one structured result per command.

## Preferred starting points

- Homepage: https://clawperator.com/
- Docs: https://docs.clawperator.com/
- Agent guide: https://docs.clawperator.com/ai-agents/node-api-for-agents/
- API overview: https://docs.clawperator.com/reference/api-overview/
- CLI reference: https://docs.clawperator.com/reference/cli-reference/
- GitHub: https://github.com/clawpilled/clawperator

## Notes for agents

- The docs site contains the substantive technical documentation.
- Prefer the Node API and CLI docs over inferring behavior from marketing copy.
- Clawperator is an actuator, not an autonomous planner.
- Skills are distributed as a bundle at https://clawperator.com/install/clawperator-skills.bundle
- Install skills: run `clawperator skills install` after setup
- Skills registry: `~/.clawperator/skills/skills/skills-registry.json` (set via CLAWPERATOR_SKILLS_REGISTRY)
- Skill scripts are authored in Node.js; invoke with: `node ~/.clawperator/skills/skills/<id>/scripts/<name>.js <deviceId> [args]`