# tinypilot

Adopt this skill: https://proskills.md/skills/other/tiny-pilot-tinypilot-ai-agent-skills-openclaw-skills-tinypilot

Page: https://proskills.md/skills/other/tiny-pilot-tinypilot-ai-agent-skills-openclaw-skills-tinypilot
This document is the public skill bundle for that page. It contains SKILL.md and every helper file the catalog carries. No login is required.

## File: openclaw/skills/tinypilot/SKILL.md
size: 1786
upstream: https://github.com/tiny-pilot/tinypilot-ai-agent-skills/blob/main/openclaw/skills/tinypilot/SKILL.md

```text
---
name: tinypilot
description: Control a remote computer using the TinyPilot REST API for screenshots, keyboard input, mouse actions, and paste automation.
metadata:
  openclaw:
    requires:
      bins: [curl]
    os: [darwin, linux]
---

# TinyPilot Automation (OpenClaw)

Requires TinyPilot Pro **3.2.0+**, an Automation License, and an API key from **System → Automation**.

Use the TinyPilot REST API to control remote systems.

## Session setup

1. Confirm TinyPilot URL (default `https://tinypilot.local`).
2. Use an API key from System → Automation (`Authorization: Bearer`).
3. Capture screenshot to verify connection.

## Operational loop

Use **Screenshot → Act → Verify** for every action — no exceptions. One paste OR one keystroke per step; screenshot before and after.

- Prefer keyboard/terminal over mouse/GUI when possible.
- Add delays after actions (1-2s normal, 3-8s app launch).
- Do not commit API keys.
- Keep paste payloads short. One command at a time — chaining can cause multi-line input mode.

### ⚠️ Critical: paste timing

**Wait `(100ms × character count) + 1000ms` after paste before sending any keystroke.** The API returns immediately but characters are still being replayed. Sending Enter early splits the command mid-paste. See examples.md for the timing pattern.

## If something isn't working

**Do not retry the same approach.** Take a screenshot, reassess, and try something meaningfully different — a shorter command, a different tool, or mouse/GUI navigation as a fallback.

## Endpoints

- `GET /api/v1/screenshot`
- `POST /api/v1/keystroke`
- `POST /api/v1/mouseEvent`
- `POST /api/v1/paste`
- `GET /state` (unofficial)

## References

- [API reference](references/api-reference.md)
- [Examples](references/examples.md)
```

## File: README.md
upstream: https://github.com/tiny-pilot/tinypilot-ai-agent-skills/blob/main/README.md

```text
# TinyPilot AI Agent Skills

**Run AI agents on bare metal.**

This repository contains skills and configurations for using TinyPilot with AI agents such as Claude Code, OpenClaw, Cursor, Codex, and Devin.

TinyPilot enables AI agents to control real systems — including BIOS, boot menus, and operating systems — through keyboard, mouse, and screen access via the TinyPilot API.

---

## Supported Agents

- Claude Code
- OpenClaw
- Cursor
- Codex
- Devin

Each folder contains a version of the TinyPilot skill adapted for that specific environment.

---

## What This Enables

With TinyPilot and an AI agent, you can:

- Interact with systems at the BIOS or boot level  
- Recover machines when the OS is unavailable  
- Automate installation, monitoring, and setup workflows  
- Control remote or headless systems  
- Perform out-of-band troubleshooting  

---

## Getting Started

1. Choose your AI agent (Claude Code, OpenClaw, Cursor, etc.)
2. Download the corresponding skill/configuration from this repository
3. Install it according to your agent’s documentation
4. Connect to your TinyPilot device
5. Start automating

---

## Requirements

- A [TinyPilot device](https://tinypilotkvm.com/products/tinypilot-voyager-3) running TinyPilot Pro **3.2.0** or later
- Network access to the device
- A valid [TinyPilot Automation License](https://tinypilotkvm.com/pages/automation)
- An API key from **System → Automation** on the device

---

## Disclaimer

These skills were developed with the assistance of modern AI tools and reviewed for accuracy and usability.

They provide structured guidance for AI agents interacting with the TinyPilot API and are intended to be adapted to your specific environment and workflows.

_**Always validate behavior before using in production systems.**_

---

## About TinyPilot

TinyPilot provides simple, secure, and powerful out-of-band access to your systems.

With the Automation License, you can automate and control bare metal systems — or allow AI agents to programmatically control real machines, even when the operating system or network is down.

Learn more: [https://tinypilotkvm.com](https://tinypilotkvm.com/pages/about)
```
