Cómo encontrar IDs de canales con openclaw directory

¿Alguna vez has intentado enviar un mensaje automatizado y te has quedado bloqueado buscando el ID exacto del chat? Es frustrante tener que revisar interfaces web o bases de datos solo para encontrar un identificador de grupo o de usuario.

Este proceso suele interrumpir tu flujo de trabajo y hace que la automatización sea más lenta de lo necesario. Para resolver esto, openclaw directory te permite consultar estos datos directamente desde tu terminal.

Requisitos previos

• Tener instalado openclaw.
• Al menos un channel configurado en tu entorno.

Inicio rápido

El comando directory sirve para encontrar IDs que luego puedes copiar y usar en otros comandos, como openclaw message send. Te recomiendo usar la flag --json si planeas procesar la salida con scripts.

Aquí tienes el flujo básico para buscar un usuario en Slack y enviarle un mensaje:

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

Flags comunes que puedes usar:

• --channel <name>: Define el id o alias del channel (obligatorio si tienes varios configurados).
• --account <id>: Define el id de la cuenta (por defecto usa la del channel).
• --json: Cambia la salida a formato JSON.

Formatos de ID por channel

Cada channel maneja los IDs de forma distinta. Aquí tienes los formatos que utiliza openclaw:

• WhatsApp: +15551234567 (mensajes directos) o 1234567890-1234567890@g.us (grupos).
• Telegram: @username o id numérico para chats; los grupos siempre usan IDs numéricos.
• Slack: user:U… para usuarios y channel:C… para canales.
• Discord: user:<id> y channel:<id>.
• Matrix (plugin): user:@user:server, room:!roomId:server o #alias:server.
• Microsoft Teams (plugin): user:<id> y conversation:<id>.
• Zalo (plugin): id de usuario (Bot API).
• Zalo Personal / zalouser (plugin): thread id para mensajes directos o grupos.

Ejemplos de uso

Consultar tu propio perfil

Si necesitas ver tu propia información en un channel específico:

openclaw directory self --channel zalouser

Buscar contactos (Peers)

Puedes listar todos tus contactos o filtrar por nombre y limitar los resultados:

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

Gestionar grupos

Para encontrar grupos o ver quiénes forman parte de ellos:

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

Solución de problemas

No aparecen resultados recientes o faltan contactos En muchos canales, los resultados no provienen de una búsqueda en vivo en el servidor del proveedor. Los datos suelen estar basados en tu configuración local, como allowlists o grupos que ya has configurado previamente.

La salida es difícil de leer en scripts Por defecto, la salida muestra el id y el name separados por un tabulador. Para automatizaciones, usa siempre la flag --json.

¿Necesitas ayuda para configurar tus canales? Prueba el AI Setup Assistant.

Próximos pasos

• Guía de openclaw message send
• Configuración de canales