> ## Documentation Index
> Fetch the complete documentation index at: https://openclawdoc.org/llms.txt
> Use this file to discover all available pages before exploring further.

# directory

> ディレクトリ検索に対応しているチャネルにおいて、連絡先（ピア）、グループ、および自分自身の情報を検索します。よく使われるフラグ、補足事項、検索結果を message send で利用する例を確認できます。

ディレクトリ検索に対応しているチャネルにおいて、連絡先（ピア）、グループ、および自分自身の情報を検索します。

## よく使われるフラグ

* `--channel <name>`: チャネルの ID または別名（複数のチャネルが構成されている場合は必須、1 つのみの場合は自動的に選択されます）。
* `--account <id>`: アカウント ID（デフォルトはチャネルのデフォルトアカウント）。
* `--json`: JSON 形式で出力。

## 補足事項

* `directory` コマンドは、他のコマンド（特に `openclaw message send --target ...`）で使用するための ID を特定するのに役立ちます。
* 多くのチャネルにおいて、検索結果はプロバイダーのライブデータではなく、構成ファイル（許可リストや設定済みのグループ）に基づいています。
* デフォルトの出力形式は、タブ区切りの `id` (および `name`) です。スクリプトで利用する場合は `--json` を使用してください。

## 検索結果を `message send` で利用する例

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw directory peers list --channel slack --query "U0"
openclaw message send --channel slack --target user:U012ABCDEF --message "こんにちは"
```

## 各チャネルの ID 形式

* WhatsApp: `+15551234567` (DM), `1234567890-1234567890@g.us` (グループ)
* Telegram: `@username` または数値のチャット ID。グループは数値 ID です。
* Slack: `user:U…` および `channel:C…`
* Discord: `user:<id>` および `channel:<id>`
* Matrix (プラグイン): `user:@user:server`, `room:!roomId:server`, または `#alias:server`
* Microsoft Teams (プラグイン): `user:<id>` および `conversation:<id>`
* Zalo (プラグイン): ユーザー ID (Bot API)
* Zalo Personal / `zalouser` (プラグイン): `zca` 由来のスレッド ID (DM/グループ)。`me`, `friend list`, `group list` などで確認できます。

## 自分自身 ("me") の確認

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw directory self --channel zalouser
```

## 連絡先 (Peers/Users) の一覧

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw directory peers list --channel zalouser
openclaw directory peers list --channel zalouser --query "名前"
openclaw directory peers list --channel zalouser --limit 50
```

## グループ (Groups) の一覧

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw directory groups list --channel zalouser
openclaw directory groups list --channel zalouser --query "仕事"
openclaw directory groups members --channel zalouser --group-id <id>
```