CLI commands

Répertoire

openclaw directory

Recherches dans le répertoire pour les canaux qui les prennent en charge (contacts/pairs, groupes et « moi »).

Options communes

  • --channel <name> : identifiant/alias du canal (obligatoire lorsque plusieurs canaux sont configurés ; automatique lorsqu’un seul est configuré)
  • --account <id> : identifiant du compte (par défaut : valeur par défaut du canal)
  • --json : produire du JSON

Notes

  • directory est conçu pour vous aider à trouver des identifiants que vous pouvez coller dans d’autres commandes (notamment openclaw message send --target ...).
  • Pour de nombreux canaux, les résultats proviennent de la configuration (listes d’autorisation / groupes configurés) plutôt que d’un répertoire fournisseur en direct.
  • Les plugins de canal installés peuvent tout de même omettre la prise en charge du répertoire ; dans ce cas, la commande signale l’opération de répertoire non prise en charge au lieu de réinstaller le plugin.
  • La sortie par défaut est id (et parfois name) séparé par une tabulation ; utilisez --json pour les scripts.

Utiliser les résultats avec message send

bash
openclaw directory peers list --channel slack --query "U0"openclaw message send --channel slack --target user:U012ABCDEF --message "hello"

Formats d’identifiants (par canal)

  • WhatsApp : +15551234567 (DM), 1234567890-1234567890@g.us (groupe), 120363123456789@newsletter (cible sortante Channel/Newsletter)
  • Signal : les alias configurés se résolvent en cibles DM E.164/UUID ou en cibles de groupe group:<id>
  • Telegram : @username ou identifiant numérique de discussion ; les groupes sont des identifiants numériques
  • Slack : user:U… et channel:C…
  • Discord : user:<id> et channel:<id>
  • Matrix (plugin) : user:@user:server, room:!roomId:server ou #alias:server
  • Microsoft Teams (plugin) : user:<id> et conversation:<id>
  • Zalo (plugin) : identifiant utilisateur (Bot API)
  • Zalo Personal / zalouser (plugin) : identifiant de fil (DM/groupe) provenant de zca (me, friend list, group list)

Soi-même (« moi »)

bash
openclaw directory self --channel zalouser

Pairs (contacts/utilisateurs)

bash
openclaw directory peers list --channel zalouseropenclaw directory peers list --channel zalouser --query "name"openclaw directory peers list --channel zalouser --limit 50

Groupes

bash
openclaw directory groups list --channel zalouseropenclaw directory groups list --channel zalouser --query "work"openclaw directory groups members --channel zalouser --group-id <id>

Connexe

Was this useful?
On this page

On this page