すでに Gateway を運用しているチームが壁に当たる典型は「モデルが眠っている」からではなく、AGENTS.md、Skills、bootstrap 注入がコンテキストを肥大化させ、memory_search と日々の memory/*.md が混在して予測不能になることです。どの層がコストを押し上げているか見えにくくなります。本稿では六つのエンジニアリング上の摩擦ポイント、promptMode と bootstrap の対応表、ログと整合させやすい三つのコンテキスト指標、最小限の AGENTS.md サンプル、六ステップの調整手順をまとめます。マルチプラットフォームのインストール記事、インストール後の doctor トリアージ、プロバイダのルーティングとフェイルオーバー、Docker ネットワークのトリアージ、チャネル設定と併読してください。そちらは起動しない・接続しないを扱い、本稿は動くがコンテキストが制御できない場合を扱います。
2026 年の OpenClaw は、起動時にリポジトリ内のファイル束を注入するのが一般的です（例：AGENTS.md、Skills、身元とツール境界）。メモリは bootstrap とオンデマンド検索に分かれます。bootstrap に置くものと memory_search に任せるものの合意がないと、毎ターン巨大な静的プレフィックスが付き、ツールチェーンが長くなり、コストと遅延が上がります。下記の六項目を、週次のトークン見積もり、ツール失敗率、平均ターン数と並べて追跡してください。
minimal や none に移してください。memory/*.md に貼り、memory_search で走査すると IO と埋め込みコストが増えます。リポジトリ内は要約、生テキストは外部にしてください。この六項目を Docker 記事の健全な Gateway とモデル層の失敗の切り分けと揃えると、コンテキスト方針の問題かネットワーク／プロバイダの問題かを早く判断できます。
レビューでは次の表を使います。目的は文章の美しさではなく、タスク形態ごとに予測可能なトークン上限を置くことです。正確なキーは OpenClaw のバージョンに従ってください。
| 次元 | Bootstrap（起動時） | memory_search / memory_get（オンデマンド） |
|---|---|---|
| 典型的な内容 | AGENTS.md、コア Skill の要約、身元とツール境界 | 日付付きメモ、意思決定ログ、長い付録 |
| 失敗時の様子 | 毎ターンが遅く高く、ノイズの多いプレフィックス | ヒット漏れ、広すぎるヒット、繰り返し読み |
| 調整レバー | 文字数上限の合計、段階的注入、promptMode | 索引の粒度、命名、要約ポリシー |
| promptMode | full が最も多く注入する。minimal は節を省略できるサブエージェント向き | bootstrap の代替にはならない。重要な境界だけ memory に隠さない |
| 共同作業 | コードレビューとバージョン管理が必要 | 監査フィールド（作成者、有効期限）が必要 |
| リモート Mac | クラウド上の巨大クローンでは同期遅延と権限に注意 | 書き換えが激しいとノート PC と競合しやすい |
ログと粗いトークン見積もりから集計します。数値はプレースホルダーなので、自チームのベースラインに置き換えてください。
agents.defaults.bootstrapTotalMaxChars。名称はリリースにより異なるので公式ドキュメントに従う）を絞ってください。memory_search の結果のうちモデルが実際に使った割合（スポットチェックや二次確認）。MRH が低いと索引や要約の負債、BEL も高いのに MRH も高いと重複コンテンツの可能性があります。マルチモデルルーティングと動的なコンテキスト推定は 2025〜2026 年も進化しますが、リポジトリ側のノイズが品質の上限を決めます。BEL、TLI、MRH はボードに残してください。
非開発者向けには、BEL は「毎回の会話の前に読み返す社内規程のページ量」、TLI は「進展なくエスカレーションが続く回数」にたとえられます。それを直さずにモデルを大きくしても、高価な紙に同じ厚い冊子を印刷するにすぎません。
# AGENTS.md (example: only eternal boundaries; details live in Skills or memory) ## Repository role - This repo is the xxx service; default branch main; release cadence in docs/release.md. ## Tooling boundaries - Do not change CI secrets or production configs without review; DB migrations need two-person sign-off. ## OpenClaw conventions - Skills directory: .openclaw/skills/ (example—use your layout) - Long decisions: memory/YYYY-MM-decisions.md with a one-line summary at the top.
注意：bootstrap テキストに顧客名、生のシークレット、編集していないログ全文を置かないでください。保存が義務付けられている場合は、スコープを限定したオンデマンド取得を使ってください。
minimal または同等に移し、前後の遅延、成功率、コストをログに残す。間欠的なタイムアウトはモデル差し替えや GPU 追加を誘発しますが、BEL と TLI がなければノイズの多いプロンプトと不安定なインフラを混同します。Docker 記事の順序どおり、Gateway とチャネルを先に、次にプロバイダ、最後にリポジトリのプロンプトです。チャネル記事のトリアージと同じ層構造で、最上段にコンテキスト予算を置いてください。
インシデントチケットには最小再現の四項目を付けてください。(1) 有効な promptMode と BEL の帯、(2) 直近の AGENTS／Skills のマージリクエストへのリンク、(3) memory_search のクエリとヒット数、(4) ツール呼び出し付近の Gateway ログ。サブエージェントや並列ジョブでは分岐ごとの上限も同じ台帳に記録してください。メインセッションだけを見た集計は誤誘導します。
個人マシンでは巨大なプロンプトと場当たりのシークレットがグローバル設定に混ざり、監査が困難です。CI や共有リモート Mac に移すと権限と同期遅延が加わり、AGENTS と memory が見えないうちに分岐します。明示的なコンテキスト方針と専用のリモート環境を組み合わせると、エージェントのワークフローがレビュー可能で引き継ぎ可能な資産になります。
エフェメラルなクラウドデスクトップでも OpenClaw は動きますが、長時間稼働、固定パス、ツールチェーンの低いドリフトでは専用の物理リモート Mac が有利です。Gateway が大きなモノレポと同一ホストやリージョンを共有し、ディスク IO がコンテキストと並ぶボトルネックになる場合も同様です。MACCOME はMac mini M4 および M4 Pro ノードをシンガポール、日本、韓国、香港、米国沿岸部で提供し、常時稼働の Gateway と大規模クローン向けに柔軟なレンタル条件を用意しています。公開の料金ページで BEL の行と整合させ、ディレクトリ方針を固定してから Skills を反復してください。
パイロットでは、より大きなモデルやチャネルを増やす前に、一週間 BEL をチーム目標の帯に収めてください。リポジトリのノイズは大きいモデルではほとんど解消されません。
よくある質問
インストールの問題から読むならどの記事からですか？
まず マルチプラットフォームのインストール記事、続けて doctor のトリアージを読んでください。本稿ではポートと依存関係の確認は繰り返しません。
ネットワークとモデルの話題はどこですか？
CLI からの到達性は Docker ネットワークのトリアージ、モデルチェーンは プロバイダのルーティングを参照してください。