# Unclaw — integration facts for AI agents

Unclaw (by Foton Labs, https://unclaw.io) is a desktop AI companion: a
photoreal 3D character rendered in real time on the user's machine, with
voice, lipsync, and expression. Everything below is local (loopback) on the
machine where the Unclaw app is installed.

## Discover the running app
GET http://127.0.0.1:8973/
-> {"app":"unclaw-soul","http":<port>,"signalling_player":<port>}
Only answers while Unclaw runs. CORS: *. Other ports change per launch;
always discover, never hardcode.

## Speak through the companion (MCP)
Stdio MCP server: `node ~/.unclaw/bin/unclaw-speak.mjs --mcp`
Tools:
- speak(text, mood?, action?): say the line aloud with lipsync + expression.
  Launches Unclaw on first use. mood examples: joyful, tender, thoughtful.
  action examples: celebrate, do_dance.
- launch_unclaw(): start the app in passthrough mode without speaking.
- unclaw_status(): is the app up and ready.
Rules: keep spoken lines short and conversational; never speak code, logs,
or paths; honor the verbosity/muted hints echoed on each speak response.

## Install for a coding agent
npx unclaw-cli install            # all detected agents
npx unclaw-cli install antigravity claude   # specific ones
Supported: Claude Code, Codex CLI, opencode, OpenClaw, Gemini CLI,
Antigravity (agy CLI + IDE), Cursor, Cline, Roo Code, Windsurf.
Installs the MCP entry per agent plus a /unclaw skill (AgentSkills-standard
SKILL.md) where the agent supports skills.

## View the live character (WebRTC)
ws://127.0.0.1:<signalling_player>/?viewer=<tag>
Browser-as-offerer Pixel Streaming contract: recvonly video+audio
transceivers, data channel "cirrus", send {type:"offer",sdp}; handle
answer/iceCandidate; config carries iceServers. A ?viewer= tag takes the
render lease (desktop shows a "playing elsewhere" overlay; auto-reclaims on
disconnect). Send your surface size over the data channel to set render
resolution while you hold the lease. One viewer at a time by design.

## Stability
Stable: discovery :8973, speak MCP tools, SKILL.md convention.
Working but evolving: player signalling + lease.
Everything else in soul's HTTP surface: internal.
Docs: https://docs.unclaw.io  Contact: aryan@fotonlabs.com