English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiفارسیไทย

Fundamentals

実験的な機能

OpenClaw の実験的機能は、オプトインのプレビューサーフェスです。安定したデフォルトや長期的な公開契約に値する前に、まだ実環境での十分な使用実績が必要なため、明示的なフラグの背後に置かれています。

通常の構成とは別物として扱ってください。

  • 関連ドキュメントで試すよう案内されていない限り、デフォルトではオフのままにします。
  • 安定版の構成よりも形状と挙動が速く変わることを想定します。
  • すでに安定した経路が存在する場合は、まずそちらを優先します。
  • OpenClaw を広範囲に展開する場合は、実験的フラグを共有ベースラインに組み込む前に、より小さな環境でテストします。

現在ドキュメント化されているフラグ

サーフェス キー 使う場面 詳細
ローカルモデルランタイム agents.defaults.experimental.localModelLean より小さい、またはより厳格なローカルバックエンドが OpenClaw の完全なデフォルトツールサーフェスを処理しきれない場合 ローカルモデル
メモリ検索 agents.defaults.memorySearch.experimental.sessionMemory memory_search で過去のセッショントランスクリプトをインデックス化し、追加のストレージ/インデックス作成コストを許容したい場合 メモリ構成リファレンス
構造化計画ツール tools.experimental.planTool 互換性のあるランタイムと UI で、複数ステップの作業追跡用に構造化された update_plan ツールを公開したい場合 Gateway 構成リファレンス

ローカルモデルのリーンモード

agents.defaults.experimental.localModelLean: true は、弱めのローカルモデル構成向けの圧力逃がし弁です。有効にすると、OpenClaw はすべてのターンで、エージェントのツールサーフェスから browser、cron、message の 3 つのデフォルトツールを削除します。それ以外は何も変わりません。

この 3 つのツールである理由

この 3 つのツールは、デフォルトの OpenClaw ランタイムの中で説明が最も長く、パラメーター形状も最も多いものです。小さなコンテキスト、またはより厳格な OpenAI 互換バックエンドでは、これは次の差になります。

  • ツールスキーマがプロンプトにきれいに収まるか、会話履歴を圧迫するか。
  • モデルが適切なツールを選ぶか、似たようなスキーマが多すぎて不正な形式のツール呼び出しを出力するか。
  • Chat Completions アダプターがサーバーの構造化出力制限内に収まるか、ツール呼び出しペイロードサイズで 400 を引き起こすか。

これらを削除しても、OpenClaw が暗黙に再配線されることはありません。ツール一覧が短くなるだけです。モデルは引き続き read、write、edit、exec、apply_patch、Web 検索/取得（構成されている場合）、メモリ、セッション/エージェントツールを利用できます。

有効にする場面

モデルが Gateway と通信できることはすでに確認済みだが、完全なエージェントターンが不安定な場合にリーンモードを有効にします。典型的なシグナルの流れは次のとおりです。

  1. openclaw infer model run --gateway --model <ref> --prompt "Reply with exactly: pong" が成功する。
  2. 通常のエージェントターンで、不正な形式のツール呼び出し、過大なプロンプト、またはモデルがツールを無視する問題が発生する。
  3. localModelLean: true に切り替えると失敗が解消する。

オフのままにする場面

バックエンドが完全なデフォルトランタイムを問題なく処理できる場合は、これはオフのままにします。リーンモードは回避策であり、デフォルトではありません。一部のローカルスタックでは、正常に動作するためにより小さなツールサーフェスが必要なため存在しています。ホスト型モデルや十分なリソースを持つローカル環境では不要です。

リーンモードは、tools.profile、tools.allow/tools.deny、またはモデルの compat.supportsTools: false という脱出口を置き換えるものでもありません。特定のエージェント向けに恒久的に狭いツールサーフェスが必要な場合は、実験的フラグよりも、これらの安定したノブを優先してください。

有効化

{
  agents: {
    defaults: {
      experimental: {
        localModelLean: true,
      },
    },
  },
}

フラグを変更したら Gateway を再起動し、次のコマンドで縮小されたツール一覧を確認します。

openclaw status --deep

詳細ステータス出力には有効なエージェントツールが一覧表示されます。リーンモードが有効な場合、browser、cron、message は存在しないはずです。

実験的であることは隠されていることを意味しない

機能が実験的である場合、OpenClaw はそれをドキュメント内と構成パス自体で明確に示すべきです。すべきでないのは、安定して見えるデフォルトのノブにプレビュー挙動を紛れ込ませ、それが通常であるかのように装うことです。それが構成サーフェスを混乱させる原因になります。

関連