Quickstart

Quickstart

1. Run it

phoenix

That is genuinely it. First flight scans your machine for API keys in the environment, an old OpenClaw setup, or a local Ollama, probes real models until one answers, and writes the config for you. It only asks questions when it truly needs an answer.

🔥 openphoenix 0.0.1 - first flight

scanning the nest...
  keys found: anthropic (1), openrouter (11)
probing for a live model...
  ✓ anthropic/claude-sonnet-5 (3.0s)

Reborn. ~/.openphoenix/config.toml (mode 600)
  model     anthropic/claude-sonnet-5

Already running OpenClaw? Phoenix notices and asks first:

Found an existing OpenClaw setup at ~/.openclaw/openclaw.json
Migrating would carry over: 13 API key(s), the Telegram bot token, 5 persona file(s).
Starting fresh leaves OpenClaw untouched and sets up new.
Migrate it? [Y/n]

Press Enter to bring it across, or n to start clean. Saying no changes nothing about your OpenClaw install. Details: Migration.

2. Talk

you › summarize this folder
phoenix › ...

Type /help any time to switch models, privacy, thinking effort and more. See Chat-Commands.

3. Put it in your pocket (optional)

Add a Telegram bot token to the config (Channels) and run:

phoenix service install

Phoenix now runs in the background, starts at boot, and answers your Telegram. Photos, voice notes and PDFs work too.

Worried about privacy? Ghost mode leaves nothing behind: Memory.