デプロイモデル
- サーバーに MineClawd を導入すると
/mineclawdと/mclawdが使えるようになります。 - コマンドのコア部分はサーバー側だけで動き、クライアント導入は任意です。
- クライアント側が MineClawd 未導入でも次の機能は使えます:
/mineclawd configの GUI パケット/mineclawd historyのブック UIask-user-questionのポップアップ- オーバーレイ GUI（AssistiveTouch オーブ、ストリーミング、セッション/アセット管理）
クライアントに MineClawd が入っていなくても、チャット上で
choose を使うフォールバック機能があります。つまりオーバーレイがなくてもチャットだけで同じコマンドが動きます。権限と管理
- MineClawd のルートコマンドはバニラの権限レベル
2（source.hasPermissionLevel(2)）でガードされています。 - サブコマンドごとのカスタム権限ノードは存在しません。
- 実務的には信頼できるオペレーターにのみ OP を与えてください。
/mineclawd と /mclawd を AI オペレーター用ロールにだけ公開してください。
忙しいサーバーのための表示制御
MineClawd にはプレイヤーごとの視認性設定があります:self: リクエストエコーとタスク通知は要求者のみが見ます。all: 全員が見ることになります。ops: OP のみが見ます。
mineclawd/player-settings.json にプレイヤー単位で保存されます。GUI 設定画面の「Misc」セクションにも「Broadcast requests to」として存在します。
マルチプレイにおけるセッション所有
- セッションデータはオーナーキーごとに隔離されます。
- プレイヤーコマンドはそのプレイヤーのセッションセットを操作します。
- コンソールコマンドは別のオーナーネームスペースを使います。
専用サーバーでの動的レジストリ
初期設定ではdynamic-registry-mode は AUTO です。このモードは専用サーバーでは動的プレースホルダーを無効にします。
強制的に有効にするには:
有効化すると何が変わるか
- ランタイムでアイテム/ブロック/流体の動的スロットが使えるようになります。
- クライアントに動的状態の同期が送信されます。
- 永続ワールド状態で動的スロットデータが保存されます。
- クライアントにも MineClawd の導入が必要になります。
オペレーター向け推奨ベースライン
| 目的 | 推奨設定 |
|---|---|
| チャットノイズを減らす | broadcast-requests-to ops |
| 長期ツールループを防ぐ | limit-tool-calls true |
| ループの上限を定める | tool-call-limit 8 〜 12 |
| インシデント調査中 | debug-mode true（一時的に） |
サーバーオーナー向け導入チェックリスト
- オペレーターのロールと OP ポリシーを決める。
- プロバイダーとモデルの資格情報を設定する。
- ブロードキャストポリシー（
self、ops、all）を決める。 - 動的レジストリを
autoにするかenabledに切り替えるか判断する。 - オペレーターと非オペレーターの実アカウントでテストする。