OpenClaw sur Bun

La documentation ouvre la page Bun par un avertissement plutôt qu’un argumentaire : Node reste l’environnement d’exécution principal, par défaut et recommandé d’OpenClaw, et les builds Bun 1.4 qui fournissent une liaison SQLite sûre pour le journal d’écriture anticipée peuvent faire tourner la CLI, la passerelle et l’hôte de nœud géré sur adhésion explicite. Les versions plus anciennes de Bun et les builds au SQLite non sûr sont rejetés. Voici ce que couvre l’adhésion, les règles SQLite, les réserves d’installation et de cycle de vie, les limites connues, et l’historique qui explique pourquoi la page se lit ainsi.

Ce que couvre l’adhésion

• Bun 1.4.0 ou plus récent, une API SQLite de style Node disponible, et le même plancher SQLite sûr pour le journal d’écriture anticipée que Node : 3.51.3 ou plus récent, ou les planchers corrigés dans les lignées 3.50 et 3.44.
• Faire tourner OpenClaw sous Bun est une option à l’assistant de démarrage, qui installe la passerelle gérée avec l’environnement de démon Bun, et une option distincte pour un hôte de nœud géré ; les commandes qui lancent OpenClaw utilisent sinon Node par défaut.
• Comme exécuteur de scripts de paquet, Bun reste utilisable pour les scripts de compilation et de test, mais le gestionnaire de paquets par défaut reste pnpm : Bun ne peut pas utiliser le fichier de verrouillage de pnpm et n’arrive pas à résoudre la disposition d’espace de travail du dépôt, donc les installations de dépendances passent par pnpm.
• Bun bloque les scripts de cycle de vie des dépendances sauf confiance explicite ; ceux couramment bloqués ici, une vérification de version majeure de Node et une post-installation qui n’émet que des avertissements, ne sont pas requis, et la commande de confiance existe si un problème d’exécution en a besoin.

Node reste l’environnement d’exécution principal, par défaut et recommandé d’OpenClaw.

SQLite sur chaque plateforme

Sous Linux et Windows, Bun livre un SQLite lié statiquement avec chargement d’extensions, donc rien d’autre n’est nécessaire. Sous macOS, Bun utilise par défaut le SQLite système d’Apple, dont le chargement d’extensions est indisponible, donc OpenClaw choisit une bibliothèque adaptée avant d’ouvrir les bases : une variable de bibliothèque explicite d’abord, puis le préfixe Homebrew, les chemins Homebrew pour Apple Silicon et Intel, et MacPorts, chaque candidate devant respecter le plancher de sûreté et prendre en charge le chargement d’extensions. Installer le SQLite de Homebrew est la correction en une ligne de la documentation pour la recherche vectorielle native. Les services Bun gérés sous macOS conservent la variable de bibliothèque et le préfixe Homebrew du shell d’installation, une réinstallation forcée les change, le démarrage journalise la bibliothèque choisie, et le docteur rapporte la sélection. Quand le processus enfant de recherche de mémoire ne peut pas charger d’extensions, la recherche retombe sur un balayage d’embeddings par lots qui garde les filtres mais peut être plus lent sur de grands index.

Limites connues

• Les flux WebSocket de bureau utilisent le transport installé plutôt que l’adaptateur intégré de Bun, auquel manquent la pause, la reprise et le pont de flux qui préserve la contre-pression et le nettoyage.
• Bun 1.4.2 peut conserver des descripteurs d’instructions SQLite et des fichiers de journal d’écriture anticipée après fermeture, ce qu’OpenClaw ne peut pas finaliser par l’API publique ; la documentation dit d’utiliser Node quand la libération rapide des fichiers compte. Les workers de stockage sont un par base distincte avec au plus quatre ouvertes, et une cinquième échoue sans perturber les autres.
• Certains scripts de paquet codent pnpm en dur et l’appellent même sous Bun, et la limite d’installation de l’espace de travail demeure.

La configuration requise pour OpenClaw porte les planchers Node et SQLite dont hérite cette page, et Installer OpenClaw sur un Mac l’installation classique sur la plateforme où la règle de bibliothèque compte.

L’histoire derrière l’avertissement

Le tableau des versions explique le ton : début 2026, Bun est documenté comme exécuteur de scripts facultatif, puis un environnement de démon Bun est introduit seulement avec WhatsApp désactivé parce qu’un chemin de reconnexion WebSocket pouvait corrompre la mémoire, puis l’usage en passerelle est étiqueté expérimental après des bogues WhatsApp et Telegram, puis Bun est retiré du sélecteur d’environnement ; au milieu de l’année, Bun est rejeté d’emblée quand la liaison SQLite est indisponible, et la v2026.8.1 restaure la sélection explicite de service géré avec les exigences actuelles, suivie d’une réparation de compatibilité WebSocket en v2026.8.2. La mémoire d’OpenClaw expliquée explique la recherche vectorielle pour laquelle la règle de bibliothèque macOS existe.

Sur Diali

Sur Diali, l’environnement est Node, épinglé par release et exercé sur nos propres assistants avant déploiement, si bien que la question de Bun ne vous atteint jamais. OpenClaw hébergé sur Diali est l’assistant et Nous faisons tourner chaque release sur nos propres agents d’abord décrit le train de releases.

• Node par défaut ; Bun par option explicite en 1.4 avec un SQLite sûr.
• macOS a besoin d’une bibliothèque SQLite capable de charger des extensions.
• Installez avec pnpm ; Bun ne sait pas lire l’espace de travail.