openclaw directory で宛先 ID を素早く見つける

チャットツールを使ってメッセージを自動送信しようとするとき、一番の悩みどころは「宛先の ID が分からない」ことではないでしょうか。ドキュメントを読み漁ったり、API のレスポンスを一つずつ確認したりするのは、本来やりたい作業ではありません。

openclaw directory を使えば、こうした ID 探しから解放されます。コマンド一つで必要な ID を特定し、そのままメッセージ送信に利用できます。

必要なもの

• openclaw CLI
• 設定済みの Channel（Slack, WhatsApp, Telegram など）

クイックスタート

5分で ID を見つけてメッセージを送る手順です。

1. 自分の情報を確認する

まずは正しく接続できているか、自分の ID を確認してみましょう。

openclaw directory self --channel zalouser

2. 連絡先（Peers）を検索する

特定のユーザーを探すには peers list を使います。--query で名前を絞り込んだり、--limit で取得件数を指定したりできます。

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

3. グループを探す

グループの ID も同様に検索可能です。

openclaw directory groups list --channel zalouser --query "work"

4. 取得した ID でメッセージを送る

ID が分かれば、あとは message send コマンドに渡すだけです。

# ID を検索
openclaw directory peers list --channel slack --query "U0"

# 取得した ID（例: user:U012ABCDEF）を使って送信
openclaw message send --channel slack --target user:U012ABCDEF --message "hello"

ID formats

Channel ごとに指定する ID の形式が異なります。コピー＆ペーストする際の参考にしてください。

• WhatsApp: +15551234567 (DM), 1234567890-1234567890@g.us (group)
• 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)

トラブルシューティング

期待した結果が表示されない

多くの Channel では、ライブのディレクトリを検索するのではなく、設定ファイル（allowlists や設定済みのグループ）に基づいた結果を返します。目的の ID が表示されない場合は、設定を確認してください。

スクリプトで結果を利用したい

デフォルトの出力は id と name がタブで区切られた形式です。自動化スクリプトなどで利用する場合は、--json フラグを付けて JSON 形式で出力することをおすすめします。

不明な点がある場合は、こちらの AI Setup Assistant で質問してみてください。

次のステップ

• openclaw message send の詳細を確認する
• Channel の設定方法を詳しく見る