ChatClaw

ChatClaw is a native SwiftUI client for OpenClaw. It provides pairing, chat streaming, and tool-call visibility in a lightweight iOS/macOS app.

Features

• Native SwiftUI chat UI (iPhone, iPad, macOS Catalyst)
• Pairing flow with setup code import and Telegram approval guidance
• Streaming responses with partial rendering
• Slash command discovery (/commands) and quick insert
• Tool-call timeline cards (running/completed + args/result preview)
• Local conversation persistence and pending-run resume after app relaunch

Requirements

• Xcode 26.2+
• Swift 5.0+
• An available OpenClaw gateway endpoint

Quick Start

1. Clone this repository.
2. Open ChatClaw.xcodeproj in Xcode.
3. Select the ChatClaw target and a simulator/device.
4. Run the app.
5. In Settings -> Pair OpenClaw, paste your setup code.
6. Approve pairing in Telegram (/pair approve or /pair approve <request-id>).
7. Return to ChatClaw and finish pairing.

Project Structure

• ChatClaw/ContentView.swift: Main chat UI and interaction components
• ChatClaw/ChatViewModel.swift: Conversation state, streaming updates, persistence
• ChatClaw/OpenClawService.swift: Gateway WebSocket protocol and chat APIs
• ChatClaw/PairingService.swift: Pairing handshake and device identity signing
• ChatClaw/ChatModels.swift: Shared models, settings, pairing-code parsing
• ChatClaw/SettingsView.swift: Connection and pairing settings flow

Privacy and Security Notes

• Pairing token and chat state are stored locally via UserDefaults.
• Do not commit personal setup codes, tokens, or private logs.
• For security reporting, see SECURITY.md.

Open Source

• License: MIT (LICENSE)
• Contributions: welcome (CONTRIBUTING.md)