Comment installer NanoClaw sur un Mac mini

Ce qu’est NanoClaw

NanoClaw est un assistant IA open source que vous faites tourner sur votre propre ordinateur. Il est écrit en TypeScript, sous licence MIT. Son README le présente comme une alternative légère à OpenClaw (github.com/nanocoai/nanoclaw, lu le 2 octobre 2026). La dernière version était la 2.4.0, du 23 septembre 2026.

La grande différence, c’est l’isolation. Chaque agent tourne dans son propre conteneur Linux. Il ne voit que les dossiers que vous y montez. L’agent repose sur le Claude Agent SDK d’Anthropic. Vous le joignez depuis des apps de messagerie comme WhatsApp, Telegram, Discord, Slack, Teams ou iMessage. Chaque channel s’ajoute avec son propre skill de configuration.

Prérequis

Ils viennent de la documentation d’installation de NanoClaw (docs.nanoclaw.dev).

• macOS ou Linux, avec au moins 4 Go de mémoire. L’installeur affiche un avertissement en dessous de 3 700 Mo.
• Git, pour télécharger le code. L’installeur ne l’ajoute pas pour vous.
• Docker Desktop sur macOS. Les agents tournent dans des conteneurs Docker. L’installeur ajoute Docker Desktop avec Homebrew s’il manque.
• Node 22 ou plus récent et pnpm 10 ou plus récent. L’installeur ajoute les deux s’ils manquent.
• Claude Code sur le Mac. NanoClaw s’en sert pour corriger les étapes de configuration en échec et pour ajouter des channels.
• Un identifiant pour le modèle. La configuration propose Claude ou Codex. Ce guide utilise une clé API Anthropic, qu’Anthropic facture à l’usage.

L’installer

Vérifiez d’abord que Git est présent. Une ligne qui commence par git version le confirme.

git --version

Lancez ensuite ces quatre commandes du démarrage rapide officiel, une ligne à la fois.

cd ~
git clone https://github.com/nanocoai/nanoclaw.git
cd nanoclaw
bash nanoclaw.sh

Le script vérifie la machine et installe ce qui manque. Un assistant de configuration pose ensuite quelques questions. La documentation conseille Standard setup, puis Fresh agent. Elle prévoit 30 à 60 minutes pour l’ensemble.

• Image du sandbox. Fetch the hardened image demande un compte NanoClaw gratuit. Build it here ne demande aucun compte et prend plusieurs minutes.
• Service d’IA. Choisissez Claude, puis Paste an Anthropic API key. La configuration stocke la clé dans un coffre local appelé OneCLI. Elle n’entre jamais dans le conteneur de l’agent.
• Service. La configuration démarre NanoClaw en arrière-plan et envoie un message de test pour vérifier que l’agent répond.

La configuration propose aussi la connexion par abonnement. Si vous comptez l’utiliser, vérifiez d’abord les conditions de votre fournisseur sur les outils tiers.

Après la configuration, envoyez un message depuis le dossier nanoclaw. Le texte entre guillemets est votre message. Pour relancer la vérification complète, utilisez l’étape verify.

cd ~/nanoclaw
pnpm run chat "Help me plan one of those weekend ideas."
pnpm run setup -- --step verify

Nous n’avons pas encore lancé cette installation sur notre propre machine de test. Les commandes ci-dessus sont copiées de la documentation de NanoClaw au 2 octobre 2026. Vérifiez-les de nouveau avant de commencer.

Le faire tourner 24/7

La configuration installe un LaunchAgent dans le dossier LaunchAgents de la Library de votre dossier personnel. Son nom ressemble à com.nanoclaw-v2 suivi d’un code court propre à votre copie. RunAtLoad et KeepAlive y sont activés. Il démarre donc à l’ouverture de session et redémarre s’il plante. Voici les commandes documentées.

# Find your label
launchctl list | grep nanoclaw

# Restart
launchctl kickstart -k gui/$(id -u)/com.nanoclaw-v2-<slug>

# Stop / start
launchctl unload ~/Library/LaunchAgents/com.nanoclaw-v2-<slug>.plist
launchctl load   ~/Library/LaunchAgents/com.nanoclaw-v2-<slug>.plist

# Logs (stdout and stderr go to files, not the system log)
tail -f logs/nanoclaw.log logs/nanoclaw.error.log

Docker doit aussi tourner. Sinon, aucun agent ne peut démarrer. La documentation de dépannage dit de démarrer Docker Desktop, de vérifier que docker info fonctionne, puis de redémarrer NanoClaw. Dans les réglages de Docker Desktop, activez l’option qui le lance à l’ouverture de session.

Un LaunchAgent ne tourne que si un utilisateur a ouvert sa session. Après un redémarrage, rien ne démarre tant que personne ne se connecte. Sur un Mac sans surveillance, activez l’ouverture de session automatique pour le compte qui fait tourner NanoClaw. Empêchez ensuite le Mac de se mettre en veille. La veille met Docker en pause et coupe toutes les connexions de messagerie.

sudo pmset -a sleep 0
sudo pmset -a disksleep 0
sudo pmset -a displaysleep 10

Les raisons sont dans ce qui se passe quand un Mac se met en veille. La liste complète, coupures de courant comprises, est dans le guide du Mac toujours allumé.

Notes de sécurité

• Les agents ne voient que les dossiers que vous autorisez. Le fichier de la liste est mount-allowlist.json dans ~/.config/nanoclaw, hors du checkout. Sur une installation neuve, il est vide.
• Les agents ne détiennent jamais votre clé API en clair. Les requêtes sortantes passent par le coffre, qui ajoute la clé au moment de la requête.
• La configuration envoie des diagnostics anonymes. Définissez NANOCLAW_NO_DIAGNOSTICS=1 pour les désactiver.
• La documentation a une page de durcissement pour les configurations plus strictes. Elle couvre les limites d’accès réseau, qui peut écrire à l’agent, et quelles commandes il peut lancer.

Les conteneurs aident, mais une machine dédiée aide davantage. Faites tourner NanoClaw sur un Mac qui ne contient rien d’autre à vous. Si l’agent fait quelque chose d’étrange, les dégâts s’arrêtent à cette machine. Pour le supprimer plus tard, la documentation donne une option de désinstallation. Ajoutez --dry-run pour voir à l’avance ce qu’elle supprimerait.

bash nanoclaw.sh --uninstall

Le faire tourner sur un Mac MacRun

Notre offre Agent est un Mac mini dédié qui ne se met jamais en veille. Il est installé dans notre propre site privé dans le New Jersey. Sa session revient toute seule après un redémarrage, donc les LaunchAgents redémarrent aussi. Claude Code et Codex sont préinstallés, ce qui couvre le besoin de Claude Code de NanoClaw. NanoClaw et Docker Desktop ne sont pas préinstallés. Vous les installez vous-même, car vous avez tous les droits administrateur.

Le M6 de base a 16 Go de mémoire, bien au-dessus du minimum de 4 Go. L’offre Agent coûte $169 par mois. MacRun ne vend pas de clés API. Utilisez une clé API de votre fournisseur de modèle, qui vous facture l’usage selon ses propres conditions.

Quand vous n’avez pas besoin de MacRun

Si vous avez déjà un Mac qui reste allumé avec une session ouverte, utilisez-le. Les étapes ci-dessus sont les mêmes. NanoClaw tourne aussi sous Linux avec Docker Engine. Si vous n’avez besoin de rien de macOS, un petit serveur Linux coûte moins cher que n’importe quel Mac.

MacRun sert aussi au travail de développement, selon notre politique d’utilisation acceptable. Un NanoClaw qui relit du code, surveille la CI ou rédige des notes de version a sa place. Un NanoClaw qui gère le chat familial ne l’a pas. Prêt à l’essayer sur une machine qui reste allumée ? Consultez la page du Mac pour agents.