# OpenClaw Mobile

A cross-platform mobile app (iOS and Android) that completely replaces the [OpenClaw](https://docs.openclaw.ai/) Gateway web-based Control UI. Built with React Native and Expo.

## Features

**Core Communication**

- WebSocket-based Gateway Protocol with JSON framing
- Token and Password authentication methods
- Device pairing flow support
- Auto-reconnect with exponential backoff
- Secure credential storage via SecureStore

**Chat**

- Real-time streaming AI chat with the Gateway agent
- Tool call cards with live output rendering
- Abort (stop) generation support
- Model picker and thinking toggle
- Markdown message rendering

**Session Management**

- List, create, archive, and delete sessions
- Per-session configuration overrides (model, temperature, system prompt)
- Session search and filtering

**Channel Dashboard**

- View all connected channels and their status
- QR login flow for web channels
- Channel type indicators (Telegram, Discord, Slack, WhatsApp, Web, etc.)

**Administration (More Tab)**

- **Nodes** — View connected node devices and their capabilities
- **Cron Jobs** — List, create, edit, and toggle scheduled tasks
- **Skills** — Manage agent skills with enable/disable toggles
- **Config Editor** — Form-based and raw JSON configuration editing
- **Logs** — Live tail log viewer with level filtering and search
- **Debug** — Health checks, system status, model listing, and interactive RPC console
- **TTS Settings** — Voice selection and speech configuration
- **Exec Approvals** — Approve or deny pending execution requests
- **Dreams** — View and manage agent dream entries
- **Usage** — Provider cost tracking and token usage analytics

## Tech Stack

| Technology | Version |
|---|---|
| React Native | 0.81 |
| Expo SDK | 54 |
| Expo Router | 6 |
| NativeWind (Tailwind CSS) | 4 |
| TypeScript | 5.9 |

## Getting Started

### Prerequisites

- Node.js 22+
- pnpm 9+
- Expo Go app on your iOS/Android device

### Installation

```bash
# Clone the repository
git clone https://github.com/trigold786/openclaw-mobile.git
cd openclaw-mobile

# Install dependencies
pnpm install

# Start the development server
pnpm dev
```

### Connecting to Your Gateway

1. Open the app on your device via Expo Go
2. Enter your OpenClaw Gateway URL (e.g., `192.168.1.5:18789`)
3. Choose your authentication method (Token or Password)
4. Enter your credentials and tap **Connect**

## Project Structure

```
app/
  connect.tsx          ← Gateway connection/auth screen
  (tabs)/
    _layout.tsx        ← Tab bar with 4 tabs
    index.tsx          ← Chat screen (main)
    sessions.tsx       ← Sessions management
    channels.tsx       ← Channels dashboard
    more.tsx           ← More menu (admin tools)
  more/
    nodes.tsx          ← Connected nodes
    cron.tsx           ← Cron job management
    skills.tsx         ← Skills management
    config.tsx         ← Configuration editor
    logs.tsx           ← Live log viewer
    debug.tsx          ← Debug and diagnostics
    tts.tsx            ← TTS settings
    exec-approvals.tsx ← Execution approvals
    dreams.tsx         ← Dreams viewer
    usage.tsx          ← Usage analytics
lib/
  gateway-ws.ts        ← WebSocket service (Gateway Protocol)
  gateway-context.tsx  ← React context provider
```

## License

MIT