Agent ready
Ce qui se passe entre le demarrage d'un bureau et le moment ou l'agent IA est disponible.
Pourquoi l'agent n'est pas pret tout de suite
Quand vous demarrez un bureau Le Bureau, l'agent IA n'est pas disponible des que la VM s'allume. Plusieurs phases de demarrage doivent d'abord se terminer. Connaitre cette sequence permet de comprendre pourquoi le chat ne fonctionne pas immediatement.
Phases de demarrage
Phase 1 : demarrage VM (0-15 secondes)
La machine virtuelle demarre, charge l'OS et lance les services de base. A la fin de cette phase, la VM a une adresse IP et une connectivite reseau.
Ce qui fonctionne : le viewer VNC affiche l'ecran de demarrage.
Ce qui ne fonctionne pas encore : terminal, chat, transferts de fichiers.
Phase 2 : cloud-init (15-45 secondes)
Cloud-init execute les scripts d'initialisation du bureau :
- Configure l'utilisateur
agent - Ecrit la configuration OpenClaw (
openclaw.json) - Installe les plugins actives
- Configure le workspace (soul file, fichier agents, repertoire memoire)
- Demarre les services en arriere-plan (ttyd, OpenClaw)
Ce qui fonctionne : le viewer VNC montre le bureau en chargement. Le terminal devient disponible vers la fin.
Ce qui ne fonctionne pas encore : le chat, car le gateway OpenClaw est encore en train de demarrer.
Phase 3 : demarrage du gateway (45-90 secondes)
Le gateway OpenClaw demarre, charge sa configuration et commence a ecouter sur le port 18789. Le Bureau interroge le port pour confirmer qu'il accepte les connexions.
Ce qui fonctionne : tout. VNC, terminal, transferts de fichiers et chat.
agentReady = true
Le bureau est marque agentReady uniquement apres que Le Bureau confirme que le port 18789 ecoute. Cela signifie que l'agent IA est initialise et pret a recevoir des messages.
Dans le dashboard, le panneau de chat devient actif quand agentReady est vrai.
Pourquoi le chat echoue avant agentReady
Si vous essayez d'envoyer un message avant que l'agent soit pret, vous obtiendrez une erreur 503 ou un message "not ready". C'est voulu : envoyer des messages a un gateway qui n'a pas demarre provoquerait des echecs silencieux ou des erreurs incomprehensibles.
Le dashboard bloque l'envoi de messages tant que agentReady n'est pas confirme.
Chronologie typique du demarrage
| Temps | Phase | Ce qui se passe |
|---|---|---|
| 0-15s | Demarrage VM | L'OS demarre, le reseau s'active, IP assignee |
| 15-45s | Cloud-init | Config utilisateur, plugins, setup workspace |
| 45-90s | Gateway | OpenClaw demarre, port 18789 ecoute |
| ~90s | Pret | agentReady=true, chat disponible |
Ces temps sont approximatifs. Ils varient selon le nombre de plugins actives et la charge de l'infrastructure.
Verifier le statut de l'agent
Depuis le terminal, vous pouvez verifier que le gateway tourne :
# Verifier si le port du gateway ecoute
ss -tln sport = :18789
# Verifier le statut du service OpenClaw
systemctl status openclaw
Et si l'agent ne devient jamais pret ?
Si le bureau atteint le statut running mais que agentReady reste faux pendant plus de 3 minutes :
- Verifiez les erreurs dans le terminal :
journalctl -u openclaw -f - Verifiez la configuration du provider :
cat ~/.openclaw/openclaw.json | jq '.provider' - Assurez-vous d'avoir saisi une cle API valide lors de la creation du bureau.
- Essayez de redemarrer le bureau.
Si le probleme persiste, consultez le guide de depannage.