English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiفارسیไทย

CLI commands

Journaux

openclaw logs

Affiche la fin des journaux de fichier du Gateway via RPC (fonctionne en mode distant).

Associé :

Options

  • --limit <n> : nombre maximal de lignes de journal à renvoyer (par défaut 200)
  • --max-bytes <n> : nombre maximal d’octets à lire depuis le fichier journal (par défaut 250000)
  • --follow : suivre le flux de journaux
  • --interval <ms> : intervalle d’interrogation pendant le suivi (par défaut 1000)
  • --json : émettre des événements JSON délimités par ligne
  • --plain : sortie en texte brut sans mise en forme stylisée
  • --no-color : désactiver les couleurs ANSI
  • --local-time : afficher les horodatages dans votre fuseau horaire local

Options RPC partagées du Gateway

openclaw logs accepte aussi les indicateurs client standard du Gateway :

  • --url <url> : URL WebSocket du Gateway
  • --token <token> : jeton du Gateway
  • --timeout <ms> : délai d’expiration en ms (par défaut 30000)
  • --expect-final : attendre une réponse finale lorsque l’appel au Gateway est adossé à un agent

Lorsque vous passez --url, la CLI n’applique pas automatiquement la configuration ni les identifiants d’environnement. Incluez explicitement --token si le Gateway cible exige une authentification.

Exemples

openclaw logs
openclaw logs --follow
openclaw logs --follow --interval 2000
openclaw logs --limit 500 --max-bytes 500000
openclaw logs --json
openclaw logs --plain
openclaw logs --no-color
openclaw logs --limit 500
openclaw logs --local-time
openclaw logs --follow --local-time
openclaw logs --url ws://127.0.0.1:18789 --token "$OPENCLAW_GATEWAY_TOKEN"

Notes

  • Utilisez --local-time pour afficher les horodatages dans votre fuseau horaire local.
  • Si le Gateway local loopback implicite demande un appairage, se ferme pendant la connexion ou expire avant que logs.tail ne réponde, openclaw logs se rabat automatiquement sur le journal de fichier configuré du Gateway. Les cibles --url explicites n’utilisent pas ce repli.
  • Lorsque vous utilisez --follow, les déconnexions transitoires du gateway (fermeture WebSocket, délai d’expiration, perte de connexion) déclenchent une reconnexion automatique avec backoff exponentiel (jusqu’à 8 tentatives, plafonnées à 30 s entre les tentatives). Un avertissement est imprimé sur stderr à chaque nouvelle tentative, et un avis [logs] gateway reconnected est imprimé dès qu’une interrogation réussit. En mode --json, l’avertissement de nouvelle tentative et la transition de reconnexion sont tous deux émis sous forme d’enregistrements {"type":"notice"} sur stderr. Les erreurs non récupérables (échec d’authentification, mauvaise configuration) provoquent toujours une sortie immédiate.

Associé