OpenClaw Démarrage rapide
Utilisez la commande suivante pour installer en un clic.
macOS/Linux:
curl -fsSL https://openclaw.ai/install.sh | bash
Windows(PowerShell):
iwr -useb https://openclaw.ai/install.ps1 | iex
Guide de démarrage
Après l'installation, exécutez Onboarding pour terminer la configuration initiale. C'est l'étape la plus critique :
openclaw onboard --install-daemon
L'assistant d'onboarding configure l'authentification, les paramètres Gateway et les canaux optionnels.:
- Configuration de l'authentification: Définissez un jeton ou un mot de passe Gateway pour protéger votre point de terminaison API
- Configuration du fournisseur de modèle: Sélectionnez et configurez votre LLM (par exemple, clé API Anthropic)
- Configuration des canaux (facultatif): Connecter des canaux de discussion tels que Telegram Bot et WhatsApp
- Installer le service système:
--install-daemonparamètre permettant à Gateway de se lancer au démarrage
Opérations de base de Gateway
Gateway est le processus central d’OpenClaw ; toutes les fonctionnalités dépendent de son exécution :
# 查看 Gateway 状态 openclaw gateway status # 在前台运行(适合调试) openclaw gateway --port 18789 # 详细日志模式 openclaw gateway --port 18789 --verbose # 强制占用端口并启动(解决端口冲突) openclaw gateway --force # 重启 Gateway openclaw gateway restart # 停止 Gateway openclaw gateway stop # 查看实时日志 openclaw logs --follow
Accéder à Control UI
Control UI est l’interface de gestion visuelle d’OpenClaw :
# 打开 Control UI(自动在浏览器中打开) openclaw dashboard

Ou accédez-y directement : http://127.0.0.1:18789/。

Principales fonctionnalités de Control UI :
- Interface de discussion: Aucun canal à configurer ; discutez avec l’IA directement dans le navigateur
- Surveillance de l’état: Consulter l’état de santé de Gateway et les conditions de connexion des canaux
- Gestion des sessions: Consulter et gérer l’historique des conversations sur les différents canaux
Nous pouvons maintenant commencer à discuter sur la page :

🚀 Parcours d'expérience le plus rapide
Ouvrez l'interface Control UI et commencez à discuter directement — nul besoin de configurer un Channel ! C'est le moyen le plus rapide de vérifier qu'OpenClaw fonctionne correctement.
Référence des commandes essentielles
| Commande | Description |
|---|---|
openclaw doctor |
Vérification complète de l'état de santé et tentative de correction des problèmes de configuration |
openclaw health |
Vérification rapide de l'état de santé |
openclaw status |
Afficher l'état global de Gateway et des canaux |
openclaw gateway status |
Afficher l'état du processus Gateway |
openclaw gateway status --deep |
Vérification approfondie de l'état (inclut les sondes RPC) |
openclaw gateway run |
Exécuter Gateway au premier plan |
openclaw gateway start |
Démarrer le service Gateway en arrière-plan |
openclaw gateway stop |
Arrêter le service Gateway |
openclaw gateway restart |
Redémarrer le service Gateway |
openclaw gateway probe |
Vérifier la connectivité et l'état de Gateway |
openclaw gateway discover |
Découvrir une Gateway sur le LAN ou à distance |
openclaw gateway call health |
Appeler l'endpoint de contrôle d'état de la Gateway |
openclaw channels status --probe |
Vérifier l'état de connexion de tous les canaux |
openclaw dashboard |
Ouvrir le panneau de contrôle du navigateur |
openclaw logs --follow |
Suivre en temps réel la sortie des logs |
openclaw onboard |
Relancer l'assistant de configuration initiale |
openclaw secrets reload |
Recharger à chaud la configuration Secrets |
Mécanisme de rechargement à chaud de la Gateway
OpenClaw prend en charge le rechargement à chaud de la configuration, la valeur par défaut esthybridModes :
gateway.reload.mode |
Description du comportement |
|---|---|
off |
Aucun rechargement automatique, redémarrage manuel requis |
hot |
Appliquer uniquement les changements sûrs (aucune interruption de connexion) |
restart |
Redémarrer le Gateway à chaque changement |
hybrid(par défaut) |
Appliquer à chaud ce qui peut l’être, redémarrer automatiquement ce qui nécessite un redémarrage |
TUI : interface de chat en terminal
En plus de l’interface de contrôle dans le navigateur, OpenClaw propose aussi une interface interactive qui s’exécute entièrement dans le terminal—TUI(Terminal UI)aucun navigateur nécessaire, vous pouvez discuter directement même lorsque vous êtes connecté en SSH au serveur.
Démarrage rapide
# 第一步:确保 Gateway 已运行 openclaw gateway # 第二步:打开 TUI openclaw tui

Se connecter au Gateway distant :
openclaw tui --url ws://<host>:<port> --token <gateway-token> # 如果 Gateway 使用密码鉴权 openclaw tui --url ws://<host>:<port> --password <password>
Disposition de l’interface
Une fois la TUI démarrée, vous verrez quatre zones :
| Zone | Contenu |
|---|---|
| En-tête (barre supérieure) | URL de connexion, Agent actuel, Session actuelle |
| Journal de chat (zone de messages) | Messages utilisateur, réponses de l'IA, notifications système, cartes d'appel d'outil |
| Ligne d'état (ligne de statut) | État de connexion / d'exécution (connexion / exécution / streaming / inactif / erreur) |
| Pied de page (barre inférieure) | État de connexion + Agent + Session + modèle + nombre de jetons |
Zone d'en-tête :

Zone inférieure :

Raccourcis clavier
| Raccourcis | Fonctionnalités |
|---|---|
Enter |
Envoyer le message |
Esc |
Interrompre l'exécution en cours |
Ctrl+C |
Effacer la saisie (double appui pour quitter) |
Ctrl+D |
Quitter la TUI |
Ctrl+L |
Ouvrir le sélecteur de modèle |
Ctrl+G |
Ouvrir le sélecteur d'agent |
Ctrl+P |
Ouvrir le sélecteur de session |
Ctrl+O |
Basculer l'expansion / réduction de la sortie d'outil |
Ctrl+T |
Basculer l'affichage Thinking (recharge l'historique) |
Commandes slash courantes
Utilisation/Invoquer des commandes :

Commandes courantes :
/help # 查看帮助 /status # 查看连接状态 /agent <id> # 切换 Agent /session <key> # 切换 Session /model <provider/model> # 切换模型(如 /model anthropic/claude-sonnet-4-6) /think <off|minimal|low|medium|high> # 设置思考深度 /deliver <on|off> # 开启/关闭消息投递到 Provider /new # 重置当前 Session /abort # 中止当前运行 /exit # 退出 TUI
Commandes shell locales
Dans la zone de saisie, avec!en tant que préfixe, vous pouvez exécuter directement des commandes shell locales :
!ls -la # 列出当前目录 !cat log.txt # 查看文件内容
⚠️ TUI, lors de la première utilisation dans chaque session,
!demandera une confirmation d'autorisation ; après un refus, au cours de cette session!elle sera indisponible.
Options de démarrage
| Paramètre | Description | Valeur par défaut |
|---|---|---|
--url <url> |
Adresse WebSocket de la passerelle | Lire la configuration ouws://127.0.0.1:<port> |
--token <token> |
Authentification par jeton de la passerelle | — |
--password <password> |
Authentification par mot de passe de la passerelle | — |
--session <key> |
Spécifier la session | main |
--deliver |
Activer la livraison des messages au démarrage | Désactivé par défaut |
--thinking <level> |
Remplacer le niveau de réflexion | — |
--history-limit <n> |
Nombre d'entrées d'historique à charger | 200 |
--timeout-ms <ms> |
Délai d'attente de l'agent | Lit agents.defaults.timeoutSeconds |
Contenu associé
Les autres contenus associés sont les suivants :
Autres extensions