openclaw directory로 채널 ID 쉽고 빠르게 찾기

여러 채널에 메시지를 보낼 때 가장 귀찮은 게 뭘까요? 바로 대상의 ID를 찾는 일이에요. API 문서를 뒤지거나 복잡한 응답값 사이에서 ID를 찾아 복사해서 붙여넣는 과정은 정말 번거롭죠.

openclaw directory는 이런 수고를 덜어주기 위해 만들었어요. 연락처, 그룹, 그리고 본인의 정보를 빠르게 조회해서 다른 명령어에 바로 활용할 수 있게 도와줍니다.

필요한 것

• openclaw CLI
• 설정된 하나 이상의 채널 (Slack, Telegram, WhatsApp 등)

빠른 시작

가장 먼저 Slack에서 특정 사용자의 ID를 찾아 메시지를 보내는 방법을 알아볼게요. 5분도 걸리지 않아요.

1. 사용자 ID 조회하기

   openclaw directory peers list --channel slack --query "U0"

2. 조회한 ID로 메시지 보내기

   openclaw message send --channel slack --target user:U012ABCDEF --message "hello"

스크립트에서 정보를 추출하고 싶다면 --json 플래그를 사용하세요. 기본적으로는 id와 name이 탭으로 구분되어 출력됩니다.

ID Formats (by channel)

각 채널마다 사용하는 ID 형식이 달라요. 아래 형식을 참고해서 --target 인자에 사용하세요.

• WhatsApp: +15551234567 (DM), 1234567890-1234567890@g.us (그룹)
• Telegram: @username 또는 숫자 chat id (그룹은 숫자 id 사용)
• Slack: user:U… 또는 channel:C…
• Discord: user:<id> 또는 channel:<id>
• Matrix (plugin): user:@user:server, room:!roomId:server, #alias:server
• Microsoft Teams (plugin): user:<id>, conversation:<id>
• Zalo (plugin): user id (Bot API)
• Zalo Personal / zalouser (plugin): zca에서 가져온 thread id (me, friend list, group list)

주요 명령어 예시

내 정보 확인

openclaw directory self --channel zalouser

연락처 및 사용자 조회

# 전체 목록 조회
openclaw directory peers list --channel zalouser

# 이름으로 검색 및 개수 제한
openclaw directory peers list --channel zalouser --query "name" --limit 50

그룹 정보 조회

# 특정 키워드가 포함된 그룹 찾기
openclaw directory groups list --channel zalouser --query "work"

# 그룹 멤버 명단 확인
openclaw directory groups members --channel zalouser --group-id \<id\>

문제 해결

원하는 결과가 목록에 나오지 않나요? 많은 채널에서 directory 결과는 실시간 라이브 디렉토리가 아니라 설정 파일에 등록된 정보(allowlists 또는 설정된 그룹)를 기반으로 작동해요. 설정 파일에 해당 채널이나 그룹이 올바르게 등록되어 있는지 확인해 보세요.

여러 채널이 설정되어 있다면? 채널이 여러 개 구성된 경우 --channel <name> 플래그를 반드시 입력해야 해요. 채널이 하나뿐이라면 자동으로 해당 채널을 선택합니다.

---

도움이 필요하신가요? AI Setup Assistant에게 물어보세요!

다음 단계

• openclaw message send 사용법 보러 가기
• 채널 설정 가이드 확인하기