Passer au contenu principal
NanoClaw est un agent IA personnel léger et conteneurisé, version allégée d’OpenClaw, capable de se connecter à WhatsApp, Telegram, Slack, Discord et au courrier électronique, tout en gérant la mémoire et les tâches planifiées. Il fonctionne grâce au SDK Claude Agent d’Anthropic, et se connecte à Tokios via l’interface compatible Anthropic : il suffit de définir ANTHROPIC_BASE_URL sur https://api.tokios.com pour que l’agent s’exécute sur un modèle local.
NanoClaw utilise l’interface API d’Anthropic, de sorte que l’URL de base correspond simplement à l’hôte https://api.tokios.com sans mentionner aucun /v1 — exactement comme pour Claude Code. Cela diffère des clients de type OpenAI qui requièrent l’ajout de /v1.

​
Prérequis

Connecteur appairé

Installez et appairez tokios-connector à côté du modèle que vous souhaitez rendre accessible à NanoClaw.

Modèle enregistré

Enregistrez un déploiement (nom public) pour ce modèle.

Clé API créée

Générez une clé sk-tok-…, éventuellement limitée à ce déploiement spécifique.

Backends pris en charge

Vérifiez que le connecteur local (Ollama, llama.cpp, vLLM ou LM Studio) est bien en cours d’exécution.

​
Indiquez à NanoClaw que le connecteur amont est Tokios.

1

Ouvrez le fichier .env de NanoClaw.

Modifiez le fichier .env situé dans le répertoire d’installation de NanoClaw.
2

Définissez l’URL de base d’Anthropic ainsi que la clé API correspondante.

Configurez le connecteur du SDK Claude Agent pour qu’il utilise Tokios :
.env
La valeur de la clé sk-tok-… doit être insérée dans ANTHROPIC_AUTH_TOKEN, qui représente le jeton d’authentification transmis par le SDK. Il ne faut pas ajouter de /v1 dans l’URL de base.
3

Sélectionnez le déploiement que vous souhaitez utiliser comme modèle.

Indiquez à l’agent le nom de déploiement public que vous avez enregistré dans l’onglet Models, par exemple gemma-tunnel. Par défaut, NanoClaw utilise des noms de modèles Claude ; lorsqu’il se connecte à Tokios, il doit demander le nom de votre déploiement. Les paramètres exacts varient selon la version de NanoClaw — renseignez-vous sur la vôtre.
4

Redémarrez NanoClaw.

Redémarrez NanoClaw (ou son conteneur) afin qu’il recharge le fichier .env. Votre agent pourra désormais fonctionner avec votre modèle via Tokios.
NanoClaw peut également utiliser des backends compatibles avec OpenAI ou locaux grâce à des compétences optionnelles (par exemple /add-opencode pour OpenAI/OpenRouter, ou /add-ollama-provider). Dans ces cas, il convient d’utiliser le base URL OpenAI https://api.tokios.com/v1. Il ne faut jamais enregistrer une clé API sk-tok-… réelle dans le système de gestion de versions.

​
Un agent privé fonctionnant sur un modèle privé

NanoClaw héberge ses agents Claude dans des conteneurs isolés sur votre propre machine ; Tokios fournit un point de terminaison sécurisé et authentifié pour tout modèle que vous exécutez. Le connecteur associé au modèle communique avec Tokios, et NanoClaw y accède via https://api.tokios.com en utilisant votre token — un assistant auto-hébergé fonctionnant sur un modèle auto-hébergé, sans besoin de port entrant ni de VPN.

​
Résolution de problèmes

Le token envoyé par NanoClaw est absent, mal formaté ou a été révoqué. Vérifiez que ANTHROPIC_AUTH_TOKEN contient bien la clé API sk-tok-… complète sans espaces supplémentaires, puis consultez son statut dans l’onglet Keys.
Le modèle ne correspond à aucun déploiement enregistré, ou un caractère /v1 s’est glissé dans l’URL de base. Assurez-vous que le nom du modèle correspond à celui figurant dans l’onglet Models, et que ANTHROPIC_BASE_URL représente uniquement le https://api.tokios.com sans aucun /v1.
Le connecteur destiné à ce déploiement est hors ligne ou a atteint sa limite de concurrence. Consultez l’onglet Connectors : le connecteur doit afficher l’état Online, et la machine l’exécutant doit rester opérationnelle et accessible.

​
Prochaines étapes

Utilisez Claude Code

Le même modèle d’URL de base et de clé API compatible avec Anthropic est utilisé pour la CLI de Claude Code.

Les clés API

Il est possible de créer, de définir les autorisations et de renouveler les clés sk-tok-… destinées aux membres de l’équipe et aux agents.