Selig
4c966a3ad2
6 custom skills (assign-task, dispatch-webhook, daily-briefing, task-capture, qmd-brain, tts-voice) with technical documentation. Compatible with Claude Code, OpenClaw, Codex CLI, and OpenCode.
39 lines
1.4 KiB
Markdown
39 lines
1.4 KiB
Markdown
# iOS App (Node)
|
|
|
|
## Overview
|
|
|
|
The iOS app connects to a Gateway via WebSocket, exposing node capabilities including Canvas rendering, screen snapshots, camera capture, location access, and voice features.
|
|
|
|
## Key Requirements
|
|
|
|
A Gateway must run on a separate device (macOS, Linux, or Windows via WSL2). Connection options include same-network Bonjour discovery, Tailnet via DNS-SD, or manual host/port entry.
|
|
|
|
## Setup Process
|
|
|
|
Users start the Gateway on port 18789, select it in iOS Settings, then approve the pairing request via command line. The `openclaw nodes status` command verifies successful connection.
|
|
|
|
## Discovery Methods
|
|
|
|
The system supports three connection approaches:
|
|
|
|
- **Bonjour**: Advertises `_openclaw-gw._tcp` on `local.` for LAN environments
|
|
- **Tailnet**: Uses unicast DNS-SD for cross-network scenarios
|
|
- **Manual**: Configuration as a fallback
|
|
|
|
## Canvas Functionality
|
|
|
|
The iOS node uses WKWebView for rendering. Users can navigate to URLs, execute JavaScript through `canvas.eval`, and capture snapshots using the node invocation system.
|
|
|
|
## Voice Capabilities
|
|
|
|
Voice wake and talk mode options appear in Settings, though background audio suspension may limit reliability when the app isn't active.
|
|
|
|
## Troubleshooting
|
|
|
|
Common issues include:
|
|
|
|
- `NODE_BACKGROUND_UNAVAILABLE` - Requires foreground app status
|
|
- Missing canvas host configuration
|
|
- Pairing prompts not appearing
|
|
- Reconnection failures after reinstall due to cleared Keychain tokens
|