Sophon

Quickstart

The five-minute path: iOS app on your phone, OpenClaw running on your Mac, paired and chatting. No code to write, no SDK to install.

What you need

  • An iPhone running iOS 17 or later.
  • A Mac (or Linux box reachable on the same network) where OpenClaw can run.
  • Node 22+ on that machine — the bridge ships as npx @sophonai/openclaw.

1. Install the iOS app

Grab the build from TestFlight (link coming with v0.2 — for now, build from s-chat/Sophon.xcodeproj in Xcode and run on a paired iPhone).

Open the app, sign in with Google. You'll land on the chat list, empty.

2. Run OpenClaw on your Mac

npx @sophonai/openclaw

The CLI does three things, in order:

  1. Connects to your local OpenClaw gateway on ws://localhost:18789 (override with --openclaw-url).
  2. Asks Sophon Cloud for a 7-letter pairing code.
  3. Prints the code and waits.

Output looks like:

✓ connected to OpenClaw at ws://localhost:18789
→ pairing code: 9FP9SVT  (valid 120s)
  enter it in the iOS app: Settings → Pair another agent

3. Pair from the phone

In the iOS app: Settings → Pair another agent → enter the 7 letters → tap Pair.

The bridge prints ✓ paired — installation inst_… and stays running. iOS adds My OpenClaw to your chat list.

4. First chat

Tap the compose pencil → pick My OpenClaw from the chip strip → send "list my recent files".

You should see, in order:

  • Your message bubble appears immediately.
  • A "Thinking…" placeholder bubble for the agent.
  • A live tool card: "Running ls -la".
  • An approval prompt if OpenClaw is in restricted mode — tap Allow once.
  • The reply streams in token by token.
  • The chat list lights up the new chat with the latest snippet.

Kill the app, reopen it. The chat is still there, the bubble is fully reconstructed including the tool card.

What just happened

iOS  ──HTTPS──▶  /v1/me/sessions/:id/send         (your message)
                   │
                   │  push to bridge bus
                   ▼
            api.sophon.at  ──WS──▶  npx @sophonai/openclaw
                                          │
                                          ▼
                                     OpenClaw gateway
                                     (chat.send RPC)
                                          │
                                          │  stream:'assistant' deltas
                                          ▼
                ◀──/v1/bridge/sendMessageDelta──
                                          │
                ◀──/v1/bridge/sendMessageEnd──
                   │
                   │  SSE message_delta + message_finalized
                   ▼
                 iOS UI

Everything you saw is documented field-by-field in the Wire reference.

What's next?

  • Read Concepts to internalise the eight nouns (installation, session, interaction, tool call, approval, …) the rest of the docs lean on.
  • Read Write your own connector when you're ready to wire your own agent — anything you can hold a WebSocket from will work.
  • Skim the Protocol overview for the full picture.