Documentation Index
Fetch the complete documentation index at: https://docs.baimoqilin.com/llms.txt
Use this file to discover all available pages before exploring further.
セッション運用を徹底する理由
セッションは MineClawd の長期的な記憶です。整ったセッションフローがあれば、回答の精度が上がり、文脈の誤りが減り、障害からの復旧が素早くなります。セッションのスコーピング
- セッションはオーナーごとに分離されます。
- プレイヤーコマンドはプレイヤーの UUID をオーナーキーに使います。
- コンソールコマンドはコマンドソース名をオーナーキーに使います。
- 各オーナーにアクティブなセッションポインタが一つだけあります。
- すべてのセッションコマンドは OP 権限レベル
2を要求します。
毎日のコマンドワークフロー
| 目的 | コマンド | GUI での操作 |
|---|---|---|
| クリーンな文脈を始める | /mineclawd sessions new | セッションビューで New Session をクリック |
| 保存済みセッションを確認する | /mineclawd sessions list | オーバーレイメニューの Sessions を開く |
| アクティブセッションを切り替える | /mineclawd sessions resume <session> | セッション一覧の行をクリック |
| 古い文脈を削除する | /mineclawd sessions remove <session> | — |
| 現在のチャット履歴を見る | /mineclawd history | オーバーレイの会話をスクロール |
| Vertex 関連の破損を修復する | /mineclawd sessions repair [session] | — |
<session> には 1a2b のような短い ID か 1a2b-my-build-plan のようなトークンを使えます。
長い作業向けのコツ
- 目的ごとにセッションを分け、1 つのセッションにすべてを詰め込まない。
- 文脈をリネームしたいときは古い履歴を伸ばすより、新しいセッションを作って切り替える。
resume、remove、repairを使う前に/mineclawd sessions listを実行する。- リクエストがまだ実行中の状態でセッションを変更しない。
- 破壊的な作業を始める前に
/mineclawd historyで文脈を確認する。
/mineclawd history を有効に使う
- 履歴ブックにはセッショントークン、更新時間、表示可能なチャットターンが出ます。
- このコマンドはプレイヤー専用で、コンソールからは使えません。
- 履歴ブック UI にはクライアント側の MineClawd が必要です。
- 非常に長い履歴は Minecraft 書物のページ制限でトリミングされます。
sessions list と最新のチャットログで代替してください。
復旧手順
リクエストに失敗したが文脈は残したい
最後の失敗メッセージにあるトークンを使って/mineclawd retry <token> を実行します。リトライトークンの有効期限は 30 分です。
Vertex の function-call 不一致エラー
repair は壊れた Vertex 関連のターンを正規化し、修復後のセッションを保存します。
セッションファイルの場所
MineClawd はゲームフォルダーに次のようにセッションを保存します:active.jsonがアクティブなセッション ID を保持します。<id>.jsonにメタデータと OpenAI/Vertex の両方の履歴が入ります。- アクティブセッションを削除すると、MineClawd は直近で更新された残りを自動選択します。残りがなければアクティブポインタをクリアします。
バックアップと掃除の流れ
- 大量削除前に
mineclawd/sessions/をバックアップします。 - 古いセッションは
/mineclawd sessions remove <session>で削除します。 - 各オペレーターは既知の良好なセッションを 1 つ残しておくと即時リカバリできます。
- ストレージの内部を見たいときは
/resources/technical-detailsを参照します。