Voir la source de Utiliser les chats Hermes et OpenClaw en ligne de commande

{{DISPLAYTITLE:Utiliser les chats Hermes et OpenClaw en ligne de commande}}

Ce guide décrit les commandes de consultation et de reprise de conversation pour Hermes Agent et OpenClaw sur la machine ''tas''.

Dernière vérification : 16 juillet 2026, avec Hermes dans le conteneur Podman <code>hermes</code> et OpenClaw 2026.7.1.

__TOC__

== Différence entre <code>hermes -z</code> et <code>hermes chat</code> ==

Hermes propose deux modes non interactifs principaux :

* <code>hermes -z "..."</code> : appel ponctuel destiné aux scripts, avec uniquement la réponse finale sur la sortie standard ;
* <code>hermes chat -q "..."</code> : tour de chat complet, capable de créer ou reprendre une session et offrant davantage de contrôles.

L'option <code>-z</code> contourne automatiquement les demandes d'approbation. Elle doit donc rester réservée aux demandes textuelles bornées, sans action sensible. Pour utiliser des outils, conserver un historique ou reprendre une conversation, préférer <code>hermes chat</code>.

== Requêter Hermes ==

=== Question ponctuelle sans action ===

<syntaxhighlight lang="bash">
podman exec hermes hermes -z \
  "Définis Podman Quadlet en trois phrases, sans utiliser d'outil."
</syntaxhighlight>

Ne pas employer cette forme pour une consigne susceptible de modifier des fichiers, d'exécuter une commande dangereuse ou d'envoyer un message.

=== Requête contrôlée dans une session distincte ===

<syntaxhighlight lang="bash">
podman exec hermes hermes chat \
  --query "Analyse cette architecture sans rien modifier." \
  --quiet \
  --source tool \
  --max-turns 5
</syntaxhighlight>

* <code>--quiet</code> réduit l'affichage aux résultats utiles ;
* <code>--source tool</code> identifie la session comme un appel programmatique ;
* <code>--max-turns 5</code> borne le nombre d'itérations de l'agent.

=== Conversation interactive dans le terminal ===

<syntaxhighlight lang="bash">
podman exec -it hermes hermes chat --cli
</syntaxhighlight>

Pour utiliser l'interface moderne, remplacer <code>--cli</code> par <code>--tui</code>.

=== Choisir explicitement un modèle Hermes ===

L'exemple suivant force <code>gpt-5.6-sol</code> via le provider <code>openai-codex</code> uniquement pour cet appel :

<syntaxhighlight lang="bash">
podman exec hermes hermes chat \
  --provider openai-codex \
  --model 'gpt-5.6-sol' \
  --query "Compare Docker et Podman, sans effectuer d'action." \
  --quiet \
  --source tool
</syntaxhighlight>

Pour forcer à la place le modèle Ollama local de secours :

<syntaxhighlight lang="bash">
podman exec hermes hermes chat \
  --provider custom \
  --model 'gemma4:e4b-it-q8_0_128k' \
  --query "Compare Docker et Podman, sans effectuer d'action." \
  --quiet \
  --source tool
</syntaxhighlight>

Ces choix temporaires ne modifient pas le modèle configuré par défaut.

== Reprendre le chat Hermes utilisé par Telegram ==

=== Retrouver la session Telegram ===

<syntaxhighlight lang="bash">
podman exec hermes hermes sessions list --source telegram --limit 10
</syntaxhighlight>

La colonne <code>ID</code> fournit l'identifiant à passer à <code>--resume</code>. Toujours relire la liste avant usage afin de sélectionner la bonne conversation.

=== Reprendre le contexte depuis le terminal ===

Mode interactif :

<syntaxhighlight lang="bash">
podman exec -it hermes hermes chat \
  --resume ID_DE_SESSION \
  --cli
</syntaxhighlight>

Tour unique :

<syntaxhighlight lang="bash">
podman exec hermes hermes chat \
  --resume ID_DE_SESSION \
  --query "Poursuis l'analyse précédente sans rien modifier." \
  --quiet
</syntaxhighlight>

<code>--resume</code> recharge le contexte de la conversation Telegram, mais une réponse produite par la CLI reste affichée dans le terminal. Elle n'est pas publiée automatiquement dans Telegram.

=== Envoyer explicitement un texte dans Telegram ===

Après validation humaine du texte :

<syntaxhighlight lang="bash">
podman exec hermes hermes send \
  --to telegram \
  "Texte validé à publier dans le chat Telegram."
</syntaxhighlight>

<code>hermes send</code> ne lance aucun LLM : la commande livre seulement le texte fourni. Pour poursuivre naturellement le contexte et recevoir la réponse dans Telegram, la méthode la plus simple reste d'écrire directement à <code>@LoicHermesBot</code>.

== Commandes équivalentes avec OpenClaw ==

=== Tour ponctuel sans livraison externe ===

<syntaxhighlight lang="bash">
openclaw agent \
  --agent main \
  --session-key agent:main:consultation-cli \
  --message "Définis Podman Quadlet en trois phrases." \
  --json
</syntaxhighlight>

Sans <code>--deliver</code>, le résultat revient dans le terminal et n'est pas envoyé dans Telegram.

=== Choisir explicitement un modèle OpenClaw ===

Le modèle doit être un identifiant présent dans <code>openclaw models list</code>. Exemple :

<syntaxhighlight lang="bash">
openclaw agent \
  --agent main \
  --session-key agent:main:consultation-gpt54 \
  --model 'openai/gpt-5.4' \
  --message "Compare Docker et Podman en cinq points." \
  --json
</syntaxhighlight>

Cette surcharge vaut pour ce tour ; elle ne change pas la configuration globale. Si l'identifiant n'est pas disponible dans l'installation, le remplacer par une valeur effectivement affichée par :

<syntaxhighlight lang="bash">
openclaw models list
</syntaxhighlight>

=== Lister et reprendre une session ===

<syntaxhighlight lang="bash">
openclaw sessions --agent main --limit 20
</syntaxhighlight>

Reprise par clé :

<syntaxhighlight lang="bash">
openclaw agent \
  --session-key 'CLE_DE_SESSION' \
  --message "Poursuis l'analyse précédente." \
  --json
</syntaxhighlight>

Reprise par identifiant :

<syntaxhighlight lang="bash">
openclaw agent \
  --session-id 'ID_DE_SESSION' \
  --message "Poursuis l'analyse précédente." \
  --json
</syntaxhighlight>

=== Interface terminal ===

<syntaxhighlight lang="bash">
openclaw tui --session 'CLE_DE_SESSION'
</syntaxhighlight>

Ajouter <code>--deliver</code> uniquement si les réponses doivent être livrées au canal externe associé à la session.

=== Répondre dans une conversation Telegram OpenClaw ===

Retrouver d'abord la session :

<syntaxhighlight lang="bash">
openclaw sessions --agent main --json
</syntaxhighlight>

Puis lancer le tour sur sa clé exacte avec livraison explicite :

<syntaxhighlight lang="bash">
openclaw agent \
  --session-key 'CLE_DE_SESSION_TELEGRAM' \
  --message "Poursuis notre échange précédent." \
  --channel telegram \
  --deliver
</syntaxhighlight>

Pour imposer une destination de réponse distincte :

<syntaxhighlight lang="bash">
openclaw agent \
  --session-key 'CLE_DE_SESSION_TELEGRAM' \
  --message "Prépare puis envoie la réponse." \
  --deliver \
  --reply-channel telegram \
  --reply-to 'IDENTIFIANT_DU_CHAT'
</syntaxhighlight>

=== Envoyer un texte sans appeler le LLM ===

<syntaxhighlight lang="bash">
openclaw message send \
  --channel telegram \
  --target 'IDENTIFIANT_DU_CHAT' \
  --message "Texte déjà validé."
</syntaxhighlight>

Cette commande livre un texte existant ; elle ne lance pas de tour d'agent.

== Correspondances rapides ==

{| class="wikitable"
! Besoin
! Hermes
! OpenClaw
|-
| Question ponctuelle
| <code>hermes -z "..."</code>
| <code>openclaw agent --message "..."</code>
|-
| Tour contrôlé
| <code>hermes chat -q "..."</code>
| <code>openclaw agent --message "..."</code>
|-
| Lister les sessions
| <code>hermes sessions list</code>
| <code>openclaw sessions</code>
|-
| Reprendre une session
| <code>hermes chat --resume ID</code>
| <code>openclaw agent --session-key CLE</code>
|-
| Terminal interactif
| <code>hermes chat --resume ID --cli</code>
| <code>openclaw tui --session CLE</code>
|-
| Envoyer sans LLM
| <code>hermes send --to telegram</code>
| <code>openclaw message send --channel telegram</code>
|}

== Précautions ==

# Ne jamais ajouter <code>--yolo</code> pour une simple consultation Hermes.
# Réserver <code>hermes -z</code> aux questions sans effet de bord.
# Utiliser <code>--source tool</code> pour isoler les appels programmatiques Hermes.
# Vérifier l'identifiant de session avant toute reprise.
# Avec OpenClaw, omettre <code>--deliver</code> tant que la réponse ne doit pas quitter le terminal.
# Relire tout contenu avant d'utiliser <code>hermes send</code>, <code>openclaw agent --deliver</code> ou <code>openclaw message send</code>.

== Voir aussi ==

* [[Trace install tas - Hermes Agent]]
* [[Trace install tas]]