Create OpenClaw_HF_Manual.md

OpenClaw_HF_Manual.md

@@ -0,0 +1,67 @@
+🦞 Manuel de Déploiement : OpenClaw sur Hugging Face (Docker)
+
+Cible : Hugging Face Spaces (Docker SDK)
+Engine : Node.js 22
+Architecture : OmniGroup Cloud-Native
+
+1. Création du Space
+
+Sur Hugging Face, crée un New Space.
+
+Space SDK : Choisis Docker (Impératif, ne prends pas Static ou Gradio).
+
+Template : Blank.
+
+2. Installation des Fichiers
+
+Dans "Files", ajoute les deux fichiers générés par l'IA :
+
+Dockerfile (Construction de l'image).
+
+entrypoint.sh (Script de démarrage et d'injection de config).
+
+Important : Assure-toi que entrypoint.sh est exécutable. Sur ta machine locale avant upload : chmod +x entrypoint.sh. Si tu uploades via le web, Docker le gère généralement, mais surveille les logs "Permission denied".
+
+3. Configuration des Secrets (Vital)
+
+OpenClaw a besoin de clés pour fonctionner. Va dans Settings > Variables and secrets.
+
+Secrets (Clés privées)
+
+ANTHROPIC_API_KEY (ou OPENAI_API_KEY) : Ta clé LLM.
+
+TELEGRAM_TOKEN : Le token de ton bot Telegram (via BotFather).
+
+DISCORD_TOKEN : Le token de ton bot Discord.
+
+Variables (Configuration publique)
+
+LLM_MODEL : Par défaut anthropic/claude-3-5-sonnet-20240620. Tu peux changer pour openai/gpt-4o.
+
+4. Red Team / Limitations ⚠️
+
+A. Le Problème de la Mémoire (Amnésie)
+
+Les Spaces Docker gratuits sont éphémères. Si le Space redémarre (après 48h ou une mise à jour), le dossier ~/.openclaw est détruit.
+
+Impact : L'historique des conversations locales et les sessions sont perdus.
+
+Solution Gratuite : Le bot reste fonctionnel, mais il oubliera le contexte des conversations passées à chaque reboot.
+
+Solution Pro (OmniGroup Standard) : Il faudrait connecter une base de données externe ou monter un Volume Persistant (option payante sur HF).
+
+B. Le Keep-Alive
+
+Comme pour la version Python, le Space s'endort.
+
+Action : Configure UptimeRobot pour pinger https://huggingface.co/spaces/TON_USER/TON_SPACE sur le port 443 (HTTPS standard). HF redirige le 443 vers le 7860 interne.
+
+C. Sécurité
+
+L'interface WebChat d'OpenClaw sera exposée publiquement sur l'URL du Space.
+
+Risque : N'importe qui peut accéder au Gateway UI.
+
+Fix : Le fichier entrypoint.sh configure le port, mais pour sécuriser l'accès UI, il faudrait ajouter une couche d'auth (Basic Auth) ou utiliser les tokens d'accès OpenClaw. Pour l'instant, c'est ouvert.
+
+OmniGroup Infrastructure