open-index/open-npm huggingface dataset:
npm package: @rethinkingstudio/clawpilot
Description: ClawAI relay client for Mac mini
Latest version: 2.0.1

# ClawPilot

> OpenClaw relay client for macOS and Linux hosts — connects your gateway machine for iOS app communication.

## Installation

```bash
npm install -g @rethinkingstudio/clawpilot
```

### Beta Installation

For the Linux support test build:

```bash
npm install -g @rethinkingstudio/clawpilot@beta
```

## Usage

### Pair

Generate a QR code for iOS pairing:

```bash
clawpilot pair
```

Print only the pairing code without rendering a QR code:

```bash
clawpilot pair --code-only
```

Options:
- `-n, --name <name>` — Display name for this host
- `--code-only` — Print only the access code and skip QR code output

### Run

Start the relay client:

```bash
clawpilot run
```

### Check Status

Show pairing config and background service status:

```bash
clawpilot status
```

### Install Background Service

Install as a background service:

```bash
clawpilot install
```

- macOS: installs a `launchd` user agent
- Linux: prefers `systemd --user`, and falls back to `nohup` when `systemctl --user` is unavailable

On Linux hosts without `systemd --user`, `clawpilot install` will generate a fallback launcher at:

```bash
~/.clawai/clawpilot-start.sh
```

You can start it manually with:

```bash
bash ~/.clawai/clawpilot-start.sh
```

### Stop Service

Stop the relay client background service:

```bash
clawpilot stop
```

### Remove Service

Remove the background service (keeps config):

```bash
clawpilot uninstall
```

## How It Works

1. **Pair** — Generate a QR code
2. **Scan QR with iOS app** — iOS app pairs with your Mac
3. **Run** — Relay client stays connected
4. **Communicate** — iOS app sends commands to Mac

## Requirements

- macOS or Linux
- Node.js 18+

## License

MIT