CLIリファレンス
@metatell/bot-cliは、ルームへの接続確認、在室状況の調査、対話操作に使うコマンドラインツールです。
CLIにはログイン情報を渡すオプションがありません。 未ログイン利用者の入室が許可されているルームで使用してください。 ログインやシングルサインオンが必要なルームには接続できません。
インストール
@metatell/bot-cliにはNode.js 22.12以上が必要です。Node.js 24を推奨します。
npm install --global @metatell/bot-cli
またはnpxで実行できます。
npx @metatell/bot-cli connect https://metatell.app/YOUR_ROOM_ID
接続を確認する
metatell-bot connect <room-url>
接続後にセッションID、接続状態、在室ユーザーを表示し、正常に切断します。
詳細ログが必要な場合は--debugを付けます。
metatell-bot connect https://metatell.app/YOUR_ROOM_ID --debug
ルームを調査する
metatell-bot inspect <room-url>
ルームID、接続先、セッションID、人間とボットの人数、ユーザー一覧を表示します。 その後5秒間、メッセージ、入室、退室の件数を監視して終了します。
対話モード
metatell-bot interactive <room-url>
interactiveはiへ短縮できます。
サブコマンドを省略してルームURLだけを渡した場合も、対話モードで起動します。
metatell-bot i https://metatell.app/YOUR_ROOM_ID
metatell-bot https://metatell.app/YOUR_ROOM_ID
| オプション | 説明 | 既定値 |
|---|---|---|
--name <name>、-n <name> | ボットの表示名です。 | MetatellCLI |
--debug、-d | デバッグログを有効にします。 | 無効 |
通常の入力はチャットとして送信されます。
quitまたはexitで終了します。
対話コマンド
| コマンド | 説明 |
|---|---|
/help、/? | コマンド一覧を表示します。 |
/say <message> | チャットを送信します。 |
/move <x> <y> <z> | ボットを指定座標へ移動します。 |
/look <x> <y> <z> | 指定座標の方向を向きます。 |
/look @<username> | 指定ユーザーの方向を向きます。 |
/nearby [radius] | 指定距離以内のユーザーを表示します。省略時は10mです。 |
/users | 在室ユーザーを表示します。 |
/status | 接続状態とセッションIDを表示します。 |
/info | ボット情報を表示します。 |
/avatar <id> | アバターを変更します。 |
/assets | 選択できるアバターを表示します。 |
/anime <name> | アニメーションを再生します。 |
/animations | 利用できるアニメーションを表示します。 |
/stop | 現在のアニメーションを停止します。 |
警告
CLIの出力にはセッションID、ユーザー名、ルームIDが含まれます。 ログやスクリーンショットを共有するときは、必要に応じてマスクしてください。