Guide d'installation et d'initialisation d'OpenFang : de zéro au premier agent

Slug : openfang-install-setup-guide Catégorie : usage-guides (Guides d'utilisation) Mots-clés cibles : Installation OpenFang, tutoriel configuration OpenFang, guide de démarrage OpenFang Intention de recherche : Informationnelle (l'utilisateur souhaite déployer OpenFang) Nombre de mots cible : ~1800 mots Langue : fr

Qu'est-ce qu'OpenFang ?

OpenFang est un système d'exploitation pour agents de qualité production basé sur Rust. Contrairement aux frameworks de chat IA traditionnels, OpenFang fournit un environnement d'exécution complet pour agents : démarrage à froid en 180 ms, empreinte mémoire de 40 Mo, 16 couches de protection de sécurité et 40 adaptateurs de canaux. Que vous souhaitiez exécuter une simple tâche d'automatisation en local ou construire un cluster d'agents autonomes 24h/24 et 7j/7 multiplateforme, OpenFang est à la hauteur.

Cet article vous accompagnera pas à pas dans l'installation, l'initialisation et l'exécution de votre premier agent OpenFang.

Prérequis système

Avant de commencer l'installation, assurez-vous que votre système répond aux exigences minimales suivantes :

La philosophie de conception d'OpenFang est "la légèreté avant tout" : même un Raspberry Pi 4 (version 4 Go) peut le faire fonctionner de manière fluide.

Étape 1 : Installer la chaîne d'outils Rust

OpenFang est écrit en Rust, vous devez donc d'abord installer la chaîne d'outils Rust :

# Installer Rustup (gestionnaire de chaîne d'outils Rust)curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh# Recharger les variables d'environnementsource "$HOME/.cargo/env"# Vérifier l'installationrustc --versioncargo --version

Si Rust est déjà installé, nous vous recommandons de le mettre à jour vers la dernière version stable :

rustup update stable

Étape 2 : Installer OpenFang

OpenFang propose plusieurs méthodes d'installation, l'utilisation de Cargo est recommandée :

# Installer la dernière version depuis crates.iocargo install openfang# Vérifier l'installationopenfang --version

Si vous préférez compiler à partir des sources (pour les utilisateurs avancés nécessitant une configuration personnalisée) :

git clone https://github.com/openfang/openfang.gitcd openfangcargo build --release./target/release/openfang --version

Les utilisateurs de Docker peuvent également utiliser l'image officielle :

docker pull openfang/openfang:latestdocker run -d --name openfang -v ./config:/app/config openfang/openfang

Étape 3 : Initialiser la configuration

Une fois l'installation terminée, exécutez la commande d'initialisation pour créer les fichiers de configuration :

# Créer le répertoire de configuration par défautopenfang init# Emplacement des fichiers de configuration# Linux/macOS: ~/.config/openfang/config.toml# Windows:     %APPDATA%\openfang\config.toml

Après l'initialisation, un fichier config.toml sera généré. Voici les paramètres clés :

[core]name = "my-first-agent"          # Nom de l'agentworkspace = "./workspace"         # Répertoire de travaillog_level = "info"                # Niveau de log : trace, debug, info, warn, error[claude]api_key = "${ANTHROPIC_API_KEY}"  # Lecture depuis les variables d'environnementmodel = "claude-sonnet-5"         # Modèle par défautmax_tokens = 4096[security]sandbox_mode = "strict"           # Mode bac à sable : off, basic, strictnetwork_policy = "allowlist"      # Politique réseauallowed_domains = ["api.anthropic.com"][channels]# Configurer au moins un adaptateur de canal

Notes sur la configuration :

• api_key : Prend en charge les références aux variables d'environnement (format ${VAR_NAME}), ne saisissez pas votre clé API directement dans le fichier de configuration.
• sandbox_mode : Le mode strict est recommandé pour les environnements de production.
• network_policy : Le mode allowlist n'autorise que les domaines sur liste blanche, le mode blocklist bloque les domaines sur liste noire.
• channels : Au moins un adaptateur de canal est requis, sinon l'agent ne pourra pas interagir avec l'extérieur.

Étape 4 : Configurer la clé API Anthropic

OpenFang dépend de l'API Claude (via Anthropic), vous devez donc configurer la clé API :

# Définir la variable d'environnementexport ANTHROPIC_API_KEY="sk-ant-..."# Recommandé : ajouter au fichier de configuration du shellecho 'export ANTHROPIC_API_KEY="sk-ant-..."' >> ~/.bashrcsource ~/.bashrc

Vous pouvez obtenir votre clé API depuis la console Anthropic.

Étape 5 : Choisir et configurer les adaptateurs de canaux

OpenFang prend en charge plus de 40 adaptateurs de canaux, permettant à l'agent d'interagir avec les utilisateurs via différentes plateformes. Voici les plus courants :

Exemple de configuration pour Telegram :

[channels.telegram]enabled = truebot_token = "${TELEGRAM_BOT_TOKEN}"allowed_users = ["@your_username"]

Étape 6 : Lancer votre premier agent

Une fois la configuration terminée, lancez l'agent :

# Lancement de baseopenfang start# Spécifier un fichier de configurationopenfang start --config ./my-config.toml# Exécution en arrière-planopenfang start --daemon# Voir les logs d'exécutionopenfang logs --follow

Une fois lancé, vous verrez ceci :

⚡ OpenFang v1.0.0├─ Agent: my-first-agent├─ Model: claude-sonnet-5├─ Sandbox: strict├─ Channels: cli└─ Ready. Type /help for commands.

Dans le canal CLI, vous pouvez discuter directement avec l'agent :

> /help> Vérifie la météo pour aujourd'hui> Analyse la structure du code de ce dépôt GitHub

Étape 7 : Vérifier l'installation

Exécutez la commande de diagnostic intégrée pour confirmer que tout fonctionne correctement :

# Vérification de santéopenfang doctor# Devrait afficher quelque chose comme :# ✅ Rust toolchain: 1.80.0# ✅ Config file: valid# ✅ API key: configured# ✅ Network: ok (latency 45ms)# ✅ Workspace: writable# All checks passed.

Foire aux questions

Prochaines étapes

Félicitations, vous avez terminé l'installation et l'initialisation d'OpenFang ! Nous vous recommandons de lire ensuite :

• Guide de configuration des capacités OpenFang : Apprenez à configurer les modules de capacités pour différents usages.
• Configuration des adaptateurs multi-canaux OpenFang : Configurez plusieurs canaux simultanément pour que votre agent soit partout.
• Meilleures pratiques de sécurité OpenFang : Protégez vos agents contre les attaques.