> ## 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

> Enregistrez Phaseo comme fournisseur de modèles OpenClaw, avec une clé lue depuis la CLI Phaseo.

Lancez `phaseo openclaw` pour enregistrer dans OpenClaw un fournisseur de modèles `phaseo` avec tous les modèles Phaseo compatibles, ou ajoutez vous-même le fournisseur avec `openclaw config set`.

## Configurer avec la CLI Phaseo

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

Si OpenClaw n’est pas installé, la CLI affiche la commande d’installation (`npm install -g openclaw@latest`, ou le même package avec pnpm, Yarn ou Bun) et demande confirmation avant de l’exécuter. La configuration exécute ensuite `openclaw config set` deux fois :

* **`secrets.providers.phaseo_cli`** : un fournisseur de secrets de type exec qui exécute `phaseo integrations credential openclaw` pour lire la clé. La clé n’est jamais écrite dans la configuration d’OpenClaw.
* **`models.providers.phaseo`** : un fournisseur avec la Base URL `https://api.phaseo.app/v1`, le type d’API `openai-completions` et la clé fournie par `phaseo_cli`. Il liste tous les modèles texte Phaseo actifs compatibles avec Chat Completions, en commençant par la valeur de `--model` (`anthropic/claude-sonnet-4.6` en son absence).

La clé est une `Phaseo CLI: OpenClaw API Key` qui expire au bout de 90 jours et dispose d’une limite de dépenses mensuelle de \$100. Lorsqu’OpenClaw demande la clé à la CLI après son expiration, la CLI en crée une nouvelle.

La configuration ne modifie pas le modèle par défaut d’OpenClaw. Sélectionnez le modèle Phaseo avec `openclaw models set` quand vous êtes prêt. Utilisez `--catalog default` pour n’enregistrer que le modèle sélectionné.

## Configurer OpenClaw manuellement

Enregistrez un fournisseur de secrets qui affiche votre clé, puis le fournisseur de modèles Phaseo :

```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
```

Chaque entrée de `models` prend un `id` (l’ID du modèle Phaseo), un `name`, `reasoning`, `input` (`text`, `image`) et un `contextWindow` facultatif. Ajoutez une entrée pour chaque modèle Phaseo que vous voulez voir listé dans OpenClaw.

## Vérifier que tout fonctionne

Exécutez `openclaw config get models.providers.phaseo --json` pour confirmer que le fournisseur est enregistré. Sélectionnez un modèle Phaseo avec `openclaw models set`, puis envoyez un court prompt. Vérifiez que la requête apparaît dans **Paramètres → Utilisation → Journaux**.

## Retirer Phaseo

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

Cette commande supprime `models.providers.phaseo` et `secrets.providers.phaseo_cli`, puis révoque la clé. Vos autres réglages OpenClaw restent en place. Redémarrez le gateway OpenClaw s’il est en cours d’exécution.

## Résoudre les problèmes courants

| Problème | Solution |
| - | - |
| `OpenClaw already defines models.providers.phaseo` | La configuration n’écrase pas un fournisseur `phaseo` existant. Supprimez-le ou renommez-le, ou exécutez `phaseo integrations remove openclaw`, puis relancez la configuration. |
| Les requêtes échouent après le déplacement ou la réinstallation de la CLI Phaseo ou de Node.js | La configuration enregistre les chemins exacts de Node.js et de la CLI dans `secrets.providers.phaseo_cli`. Exécutez `phaseo integrations remove openclaw`, puis relancez `phaseo openclaw`. |
| `OpenClaw is not installed or is not on PATH` | Installez OpenClaw ou ajoutez-le au `PATH`, puis relancez la configuration. |
| Un modèle est refusé | Vérifiez l’ID exact avec l’[endpoint Models](https://phaseo.app/docs/fr/v1/api-reference/endpoint/models.md). |

Pour les autres agents et les valeurs de fournisseur dont chaque agent a besoin, consultez [Agents de code](https://phaseo.app/docs/fr/v1/guides/integrations/coding-assistants.md).


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