> ## Documentation Index
> Fetch the complete documentation index at: https://phaseo.app/docs/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Phaseo Gateway base URL: https://api.phaseo.app/v1. Send `Authorization: Bearer $PHASEO_API_KEY` with every request.
> Model IDs look like `provider/model`, for example `openai/gpt-6-astra`. Do not guess IDs: list them with `GET /v1/models` or check https://phaseo.app/models. `phaseo/free` routes to an available free model and needs no wallet balance.
> For new text integrations prefer `POST /v1/responses`. `POST /v1/chat/completions` (OpenAI format) and `POST /v1/messages` (Anthropic format) suit existing code.
> The full API contract is https://phaseo.app/docs/openapi/v1/openapi.yaml. Official SDKs: `@phaseo/sdk` (TypeScript) and `phaseo` (Python), plus Go, C#, PHP, Ruby and Rust.
> Search these docs over MCP at https://phaseo.app/docs/mcp, and install Phaseo skills with `npx skills add https://phaseo.app/docs`. If a page is wrong or out of date, report it with the MCP `submit_feedback` tool.
> Manage Phaseo accounts with the `phaseo` CLI (`npm install -g @phaseo/cli`, then `phaseo login` or `phaseo login --device-code`), the `/v1` Management API or the MCP server at `https://mcp.phaseo.app/mcp?access=manage`. Do not send users to the dashboard for account tasks. A person is still needed for sign-up, approving a sign-in, paying the first top-up on the checkout link that `phaseo credits add` returns when no card is saved, confirming each saved-card top-up from the emailed link, and account security (password, MFA, passkeys). Create API keys with `phaseo keys create --name <name> --json`; never guess one. Credit top-ups need `phaseo login --scopes billing:write` first. Task map: https://phaseo.app/docs/v1/developers/manage-from-an-agent.md.

# OpenClaw

> Registriere Phaseo als Modellanbieter in OpenClaw, wobei der Schlüssel aus der Phaseo CLI gelesen wird.

Führe `phaseo openclaw` aus, um in OpenClaw einen `phaseo`-Modellanbieter mit jedem kompatiblen Phaseo-Modell zu registrieren, oder füge den Anbieter selbst mit `openclaw config set` hinzu.

## Mit der Phaseo CLI einrichten

```bash theme={null}
phaseo login
phaseo openclaw --model openai/gpt-6-astra
```

Fehlt OpenClaw, zeigt die CLI den Installationsbefehl an (`npm install -g openclaw@latest` oder dasselbe Paket mit pnpm, Yarn oder Bun) und fragt nach, bevor sie ihn ausführt. Danach führt die Einrichtung `openclaw config set` zweimal aus:

* **`secrets.providers.phaseo_cli`**: ein Exec-Secret-Provider, der `phaseo integrations credential openclaw` ausführt, um den Schlüssel zu lesen. Der Schlüssel wird nie in die Konfiguration von OpenClaw geschrieben.
* **`models.providers.phaseo`**: ein Anbieter mit der Base URL `https://api.phaseo.app/v1`, dem API-Typ `openai-completions` und dem Schlüssel aus `phaseo_cli`. Er listet jedes aktive Phaseo-Textmodell auf, das mit Chat Completions funktioniert, mit dem Wert von `--model` an erster Stelle (ohne ihn `anthropic/claude-sonnet-4.6`).

Der Schlüssel ist ein `Phaseo CLI: OpenClaw API Key`, der nach 90 Tagen abläuft und ein monatliches Ausgabenlimit von \$100 hat. Fragt OpenClaw die CLI nach dem Ablauf nach dem Schlüssel, erstellt die CLI einen neuen.

Die Einrichtung ändert das Standardmodell von OpenClaw nicht. Wähle das Phaseo-Modell mit `openclaw models set`, wenn du so weit bist. Mit `--catalog default` wird nur das ausgewählte Modell registriert.

## OpenClaw manuell konfigurieren

Registriere einen Secret-Provider, der deinen Schlüssel ausgibt, und dann den Phaseo-Modellanbieter:

```bash theme={null}
openclaw config set secrets.providers.phaseo_cli \
  '{"source":"exec","command":"phaseo","args":["integrations","credential","openclaw"],"jsonOnly":false}' \
  --strict-json

openclaw config set models.providers.phaseo '{
  "baseUrl": "https://api.phaseo.app/v1",
  "apiKey": { "source": "exec", "provider": "phaseo_cli", "id": "value" },
  "api": "openai-completions",
  "models": [
    { "id": "openai/gpt-6-astra", "name": "openai/gpt-6-astra via Phaseo", "reasoning": false, "input": ["text"] }
  ]
}' --strict-json
```

Jeder Eintrag in `models` nimmt eine `id` (die Phaseo-Modell-ID), einen `name`, `reasoning`, `input` (`text`, `image`) und optional ein `contextWindow`. Füge einen Eintrag für jedes Phaseo-Modell hinzu, das OpenClaw auflisten soll.

## Prüfen, ob es funktioniert

Führe `openclaw config get models.providers.phaseo --json` aus, um zu bestätigen, dass der Anbieter registriert ist. Wähle ein Phaseo-Modell mit `openclaw models set` und sende einen kurzen Prompt. Prüfe, ob die Anfrage unter **Einstellungen → Nutzung → Protokolle** erscheint.

## Phaseo entfernen

```bash theme={null}
phaseo integrations remove openclaw
```

Damit werden `models.providers.phaseo` und `secrets.providers.phaseo_cli` entfernt und anschließend der Schlüssel widerrufen. Deine anderen OpenClaw-Einstellungen bleiben erhalten. Starte das OpenClaw-Gateway neu, falls es läuft.

## Häufige Probleme beheben

| Problem | Lösung |
| - | - |
| `OpenClaw already defines models.providers.phaseo` | Die Einrichtung überschreibt keinen bestehenden `phaseo`-Anbieter. Entferne oder benenne ihn um, oder führe `phaseo integrations remove openclaw` aus, und richte dann erneut ein. |
| Anfragen schlagen fehl, nachdem du die Phaseo CLI oder Node.js verschoben oder neu installiert hast | Die Einrichtung speichert die genauen Pfade zu Node.js und zur CLI in `secrets.providers.phaseo_cli`. Führe `phaseo integrations remove openclaw` und dann erneut `phaseo openclaw` aus. |
| `OpenClaw is not installed or is not on PATH` | Installiere OpenClaw oder füge es zu `PATH` hinzu und führe die Einrichtung erneut aus. |
| Ein Modell wird abgelehnt | Prüfe die exakte ID mit dem [Models-Endpunkt](https://phaseo.app/docs/de/v1/api-reference/endpoint/models.md). |

Andere Agents und die Anbieterwerte, die jeder Agent braucht, findest du unter [Coding-Agents](https://phaseo.app/docs/de/v1/guides/integrations/coding-assistants.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.