Configurer
OpenClaw
via CoreAPI
Utilisez CoreAPI comme fournisseur de modèles personnalisés pour OpenClaw: une API, de nombreux modèles aux prix catalogue officiels. Ce guide suit le flux d'intégration actuel d'OpenClaw (2026.3.8+) et couvre l'installation, la configuration du fournisseur, la vérification et le changement de modèle.
# Exemple uniquement—à vérifier avec votre version OpenClaw avant la production
{
"agents": {
"defaults": {
"model": {
"primary": "coreapi-claude/claude-sonnet-4-5-20250929"
}
}
},
"models": {
"mode": "merge",
"providers": {
"coreapi-openai": {
"baseUrl": "https://unixcore.io/v1",
"apiKey": "${COREAPI_KEY}",
"api": "openai-completions",
"models": [{ "id": "deepseek-flash", "name": "DeepSeek Flash" }]
},
"coreapi-claude": {
"baseUrl": "https://unixcore.io",
"apiKey": "${COREAPI_KEY}",
"api": "anthropic-messages",
"models": [{ "id": "claude-sonnet-4-5-20250929", "name": "Claude Sonnet 4.5" }]
}
}
}
}Périmètre du guide
et prérequis
Configurer OpenClaw avec CoreAPI
Utilisez CoreAPI en tant que fournisseur de modèles personnalisés pour OpenClaw afin d'accéder à de nombreux modèles dans une seule API aux prix catalogue officiels. Cette page suit le flux d'intégration actuel d'OpenClaw (2026.3.8+).
Prérequis
Node.js >= 22 et une clé API CoreAPI sont requis. Pour les installations daemon, stockez COREAPI_KEY dans ~/.openclaw/.env afin qu'openclaw.json puisse y faire référence via $COREAPI_KEY sans coder en dur les secrets.
openclaw onboard --install-daemon openclaw gateway status openclaw dashboard printf 'COREAPI_KEY=%s\n' 'your_coreapi_key' >> ~/.openclaw/.env chmod 600 ~/.openclaw/.env
Après avoir ajouté ~/.openclaw/.env ou modifié la configuration du fournisseur, redémarrez une fois avec openclaw gateway restart, puis lancez les diagnostics. Utiliser des références complètes provider/model dans toutes les commandes et sessions. En cas de dérive de version, re-vérifier la Référence de configuration.
Pourquoi deux fournisseurs
pour une clé CoreAPI
Installer, intégrer, configurer,
vérifier, changer
OpenClaw utilise ~/.openclaw/openclaw.json comme configuration source que vous modifiez. Les fournisseurs personnalisés sont matérialisés dans des fichiers models.json par agent sous ~/.openclaw/agents/<agentId>/. Re-vérifier les clés et comportements après les mises à niveau en utilisant les guides Référence de configuration et Variables d'environnement . Traiter les URL de base CoreAPI uniquement telles que définies dans la documentation en direct.
{
"agents": {
"defaults": {
"model": {
"primary": "coreapi-claude/claude-sonnet-4-5-20250929"
}
}
},
"models": {
"mode": "merge",
"providers": {
"coreapi-openai": {
"baseUrl": "https://unixcore.io/v1",
"apiKey": "${COREAPI_KEY}",
"api": "openai-completions",
"models": [{ "id": "deepseek-flash", "name": "DeepSeek Flash" }]
},
"coreapi-claude": {
"baseUrl": "https://unixcore.io",
"apiKey": "${COREAPI_KEY}",
"api": "anthropic-messages",
"models": [{ "id": "claude-sonnet-4-5-20250929", "name": "Claude Sonnet 4.5" }]
}
}
}
}La configuration de base ne nécessite pas de créer manuellement auth-profiles.json. Utiliser ${COREAPI_KEY} dans les fournisseurs et injecter la variable via ~/.openclaw/.env, le shell ou le gestionnaire de services.
Les tarifs en direct
sur le site CoreAPI
Le tableau ci-dessous utilise des chiffres illustratifs par million de jetons. Le catalogue de modèles, les tarifs et les SLA suivent les conditions actuelles de CoreAPI. Documentation et console CoreAPI affiche actuellement.
Vérifier ceci
avant d'intégrer
Ai-je besoin d'auth-profiles.json pour cette configuration?
Non pour la configuration de base. OpenClaw peut résoudre le apiKey du fournisseur depuis models.providers.*.apiKey via $COREAPI_KEY. Utiliser auth-profiles.json uniquement pour les secrets stockés par profil ou la rotation.
Pourquoi y a-t-il 2 entrées de fournisseur pour un seul fournisseur?
OpenClaw route par compatibilité de format API. Conserver des entrées séparées pour openai-completions et anthropic-messages.
Où la configuration est-elle réellement modifiée et matérialisée?
Modifier ~/.openclaw/openclaw.json. Les fournisseurs personnalisés sont matérialisés dans models.json par agent sous ~/.openclaw/agents/<agentId>/ après synchronisation/chargement.
Quels identifiants de modèle sont utilisés dans ce guide?
deepseek-flash, claude-sonnet-4-5-20250929. N'importe quel modèle de la page des modèles CoreAPI peut être ajouté au bloc de fournisseur correspondant.