Avant de commencer
- Créez une clé API. Dans le portail, ouvrez Clés API et cliquez sur Créer la clé. Votre clé commence par
ni_live_. - Ajoutez des crédits. Les nouveaux comptes démarrent avec un solde de 0 $, et chaque requête est refusée tant que vous n'ajoutez pas de crédits. Ouvrez Facturation et cliquez sur Acheter des crédits.
- Choisissez un modèle. Les noms de modèles d'Inférence Nordique se terminent par une étiquette de niveau, par exemple
claude-sonnet-4-6-t4. Vous les trouverez tous sur la page Modèles.
Installer OpenClaw
Mac, Linux et WSL2 :
curl -fsSL https://openclaw.ai/install.sh | bash
Windows PowerShell :
iwr -useb https://openclaw.ai/install.ps1 | iex
Sous Windows, vous pouvez aussi installer l'application de bureau OpenClaw depuis openclaw.ai. À la fin, l'installateur lance la configuration d'OpenClaw (onboarding).
Connecter OpenClaw à Inférence Nordique
Quand l'onboarding demande un fournisseur de modèles, choisissez le point de terminaison personnalisé compatible OpenAI et saisissez :
| Paramètre | Valeur |
|---|---|
| Base URL | https://northerninference.ca/v1 |
| Model ID | claude-sonnet-4-6-t4 |
| Clé API | votre clé ni_live_ |
| Compatibility | OpenAI (chat completions) |
Pour faire la même chose en ligne de commande, exécutez :
openclaw onboard --auth-choice custom-api-key --custom-base-url https://northerninference.ca/v1 --custom-model-id claude-sonnet-4-6-t4 --custom-compatibility openai --custom-api-key ni_live_YOUR_KEY_HERE
Envoyez un message et vérifiez que la requête apparaît dans le portail sous Utilisation en quelques secondes.
Ou modifier le fichier de configuration
Si vous préférez écrire la configuration vous-même, mettez votre clé dans ~/.openclaw/.env (sous Windows, C:\Users\you\.openclaw\.env) :
NI_API_KEY=ni_live_YOUR_KEY_HERE
Mettez ensuite ceci dans ~/.openclaw/openclaw.json (sous Windows, C:\Users\you\.openclaw\openclaw.json). Si le fichier existe déjà, ajoutez le fournisseur northerninference et la valeur par défaut agents à ce qui s'y trouve au lieu de remplacer le fichier.
{
models: {
providers: {
northerninference: {
baseUrl: "https://northerninference.ca/v1",
apiKey: "${NI_API_KEY}",
api: "openai-completions",
models: [
{
id: "claude-sonnet-4-6-t4",
name: "Claude Sonnet 4.6 (Northern Inference)",
input: ["text"],
contextWindow: 128000,
maxTokens: 16384,
// USD per 1M tokens, from https://northerninference.ca/api/billing/models
cost: { input: 3, output: 15, cacheRead: 0.3, cacheWrite: 3.75 },
},
],
},
},
},
agents: {
defaults: {
model: { primary: "northerninference/claude-sonnet-4-6-t4" },
},
},
}
Pour ajouter un autre modèle, ajoutez une entrée à models avec son nom exact tiré de la page Modèles, par exemple DeepSeek-V4-Pro-t4.
Afficher les comptes de jetons et le coût dans OpenClaw (facultatif)
Inférence Nordique facture dans les deux cas les comptes exacts du fournisseur, et le portail les affiche toujours. Pour les voir aussi dans OpenClaw :
- Dans le portail, ouvrez votre clé API et activez Toujours envoyer les comptes de jetons en continu. OpenClaw diffuse chaque requête en continu, mais ne demande pas les comptes de jetons ; Inférence Nordique ne les envoie donc que si cette option est activée.
- Gardez le bloc
costsur chaque entrée de modèle. OpenClaw en calcule lui-même le coût, en dollars américains par million de jetons. Les chiffres ci-dessus changent quand les fournisseurs modifient leurs prix ; les prix actuels figurent sur la page Modèles.
Si un nom de modèle n'est pas reconnu
Inférence Nordique répond par un HTTP 404 et Model 'X' is not a route this key can call. Elle ne remplace jamais le modèle par un autre. Utilisez le nom exact de la page Modèles, y compris la casse, ou tapez ni-models comme message de clavardage pour lister les modèles que votre clé peut appeler.
Dépannage
| Ce que vous voyez | Ce qu'il faut faire |
|---|---|
| 401 | La clé est incorrecte ou a été révoquée. Copiez-la de nouveau depuis le portail, sous Clés API. |
402 Insufficient credits. Add credits in the portal under Billing (https://northerninference.ca/portal/?page=billing) to continue. | Ajoutez des crédits dans le portail, sous Facturation. |
403 privacy_tier_not_allowed | Votre clé est limitée à certains niveaux, et ce modèle se trouve dans un autre. Choisissez un modèle que votre clé autorise, ou modifiez les niveaux autorisés de la clé dans le portail. |
404 Model 'X' is not a route this key can call. | Utilisez un nom de la page Modèles, ou tapez ni-models. |
| OpenClaw affiche zéro jeton | Activez Toujours envoyer les comptes de jetons en continu sur la clé (voir plus haut). |