Nanoclaw : Le Clone Open Source d'OpenClaw - Comparaison, Installation et Utilité

OpenClaw a popularisé le concept d’assistant AI avec opinions et sandboxing. Mais son code source n’est pas entièrement open. Entrez Nanoclaw, un fork communautaire qui reprend les concepts en les rendant plus accessibles et modifiables. Valeur ajoutée ? Liberté totale.

Nanoclaw vs OpenClaw : tableau comparatif

En résumé : Nanoclaw est pour ceux qui veulent contrôle total, transparence, et la possibilité de forker et adapter.

Installation de Nanoclaw

Nanoclaw se déploie comme une application Node.js classique.

Prérequis

• Node.js 22+
• Docker (pour le sandbox)
• Git

Étapes

# 1. Cloner le repo
git clone https://github.com/nanoc/nanoclaw.git
cd nanoclaw

# 2. Installer les dépendances
pnpm install  # ou npm install

# 3. Builder
pnpm build

# 4. Configurer (copier le config exemple)
cp .env.example .env
# Éditer .env avec ta clé API OpenRouter

# 5. Démarrer le gateway
pnpm gateway:start

Le gateway écoute par défaut sur ws://localhost:18789.

Configuration de base

nanoclaw.json (à la racine) ressemble à celui d’OpenClaw mais avec des options supplémentaires :

1
{
2
  "gateway": {
3
    "port": 18789,
4
    "auth": { "mode": "token", "token": "UN_TOKEN" }
5
  },
6
  "agents": {
7
    "defaults": {
8
      "model": "openrouter/stepfun/step-3.5-flash:free",
9
      "sandbox": {
10
        "mode": "non-main",
11
        "docker": { "image": "nanoclaw-sandbox:latest" }
12
      }
13
    }
14
  },
15
  "plugins": {
16
    "enabled": ["logger", "metrics", "custom-hooks"]
17
  }
18
}

Créer un plugin personnalisé

Nanoclaw permet d’écrire des plugins en TypeScript. Exemple simple : un plugin qui log toutes les requêtes.

1
import { Hook } from 'nanoclaw'
2

3
export default {
4
  name: 'logger',
5
  hooks: {
6
    'agent:before': async (ctx) => {
7
      console.log(`[LOG] Agent ${ctx.agentId} reçoit: ${ctx.input.slice(0,50)}...`)
8
    },
9
    'agent:after': async (ctx) => {
10
      console.log(`[LOG] Agent ${ctx.agentId} a répondu en ${ctx.duration}ms`)
11
    }
12
  }
13
}

Active-le dans nanoclaw.json :

1
{
2
  "plugins": {
3
    "enabled": ["logger"]
4
  }
5
}

Pourquoi choisir Nanoclaw ?

• Transparence : tu audit le code, tu sais exactement ce qui se passe
• Souveraineté : pas de dépendance à un service SaaS
• Extensibilité : forks possibles, ajout de features maison
• Coût : tu ne paies que l’infrastructure (pas de licence)

Inconvénients :

• Maintenance manuelle (mises à jour à tracker)
• Support communautaire (pas de SLA)
• Configuration plus technique

Cas d’usage typique

• Entreprises voulant héberger leur assistant en interne sans dépendance externe
• Chercheurs qui besoin de modifier le comportement du modèle
• Développeurs voulant intégrer OpenClaw-like dans leur propre produit
• Privacy-first : données ne quittent pas ton infra

Conclusion

Nanoclaw est une excellente alternative open source à OpenClaw. Si tu es à l’aise avec Node/Docker et que tu veux garder le contrôle total, c’est le choix évident. La communauté est active, les plugins apparaissent régulièrement. Teste-le, fork-le, adapte-le à tes besoins.

Tags : openclaw, ia, code
ReadingTime : 6 min