agents.*、multiAgent.*、session.*、
messages.*、talk.* 配下のエージェントスコープ設定キーです。チャンネル、ツール、Gateway ランタイム、その他の
トップレベルキーについては、Configuration reference を参照してください。
エージェントのデフォルト設定
agents.defaults.workspace
デフォルト: ~/.openclaw/workspace。
agents.defaults.repoRoot
システムプロンプトの Runtime 行に表示される任意のリポジトリルートです。未設定の場合、OpenClaw はワークスペースから上方向にたどって自動検出します。
agents.defaults.skills
agents.list[].skills を設定していないエージェント向けの、任意のデフォルト Skill 許可リストです。
- デフォルトで Skills を無制限にするには
agents.defaults.skillsを省略します。 - デフォルトを継承するには
agents.list[].skillsを省略します。 - Skills を使わない場合は
agents.list[].skills: []を設定します。 - 空でない
agents.list[].skillsリストは、そのエージェントに対する最終セットであり、 デフォルトとはマージされません。
agents.defaults.skipBootstrap
ワークスペースのブートストラップファイル(AGENTS.md、SOUL.md、TOOLS.md、IDENTITY.md、USER.md、HEARTBEAT.md、BOOTSTRAP.md)の自動作成を無効にします。
agents.defaults.contextInjection
ワークスペースのブートストラップファイルをシステムプロンプトへ注入するタイミングを制御します。デフォルト: "always"。
"continuation-skip": 安全な継続ターン(アシスタント応答完了後)では、ワークスペースブートストラップの再注入をスキップし、プロンプトサイズを削減します。Heartbeat 実行と post-compaction 再試行では引き続きコンテキストを再構築します。
agents.defaults.bootstrapMaxChars
切り詰め前の、ワークスペースブートストラップファイルごとの最大文字数です。デフォルト: 12000。
agents.defaults.bootstrapTotalMaxChars
すべてのワークスペースブートストラップファイルで注入される総文字数の最大値です。デフォルト: 60000。
agents.defaults.bootstrapPromptTruncationWarning
ブートストラップコンテキストが切り詰められたときの、エージェント可視の警告テキストを制御します。
デフォルト: "once"。
"off": システムプロンプトに警告テキストを注入しません。"once": 一意の切り詰めシグネチャごとに 1 回だけ警告を注入します(推奨)。"always": 切り詰めが存在する場合、毎回の実行で警告を注入します。
コンテキスト予算の所有マップ
OpenClaw には高ボリュームのプロンプト/コンテキスト予算が複数あり、 それらは 1 つの汎用ノブにまとめるのではなく、意図的にサブシステムごとに分割されています。agents.defaults.bootstrapMaxChars/agents.defaults.bootstrapTotalMaxChars: 通常のワークスペースブートストラップ注入。agents.defaults.startupContext.*: ワンショットの/newと/resetの起動プレリュード。最近のmemory/*.mdファイルも含みます。skills.limits.*: システムプロンプトに注入されるコンパクトな Skills 一覧。agents.defaults.contextLimits.*: 境界付きランタイム抜粋と、ランタイム所有の注入ブロック。memory.qmd.limits.*: インデックス化された memory-search スニペットと注入サイズ。
agents.list[].skillsLimits.maxSkillsPromptCharsagents.list[].contextLimits.*
agents.defaults.startupContext
生の /new と /reset
実行時に注入される最初のターンの起動プレリュードを制御します。
agents.defaults.contextLimits
境界付きランタイムコンテキストサーフェス用の共有デフォルトです。
memoryGetMaxChars: 切り詰め メタデータと継続通知が追加される前の、デフォルトのmemory_get抜粋上限。memoryGetDefaultLines:linesが 省略されたときの、デフォルトのmemory_get行ウィンドウ。toolResultMaxChars: 永続化された結果と オーバーフロー回復に使われるライブツール結果の上限。postCompactionMaxChars: post-compaction 更新注入中に使われる AGENTS.md 抜粋上限。
agents.list[].contextLimits
共有 contextLimits ノブのエージェントごとの override です。省略されたフィールドは
agents.defaults.contextLimits から継承されます。
skills.limits.maxSkillsPromptChars
システムプロンプトに注入されるコンパクトな Skills 一覧のグローバル上限です。これは
必要時に SKILL.md ファイルを読むことには影響しません。
agents.list[].skillsLimits.maxSkillsPromptChars
Skills プロンプト予算のエージェントごとの override です。
agents.defaults.imageMaxDimensionPx
プロバイダー呼び出し前に transcript/tool の画像ブロックで許可される、最長辺の最大ピクセルサイズです。
デフォルト: 1200。
低い値では通常、スクリーンショットの多い実行で vision-token 使用量とリクエストペイロードサイズが減少します。
高い値では、より多くの視覚的詳細が保持されます。
agents.defaults.userTimezone
システムプロンプトコンテキスト用のタイムゾーンです(メッセージタイムスタンプ用ではありません)。ホストタイムゾーンにフォールバックします。
agents.defaults.timeFormat
システムプロンプト内の時刻形式です。デフォルト: auto(OS 設定)。
agents.defaults.model
model: 文字列("provider/model")またはオブジェクト({ primary, fallbacks })を受け付けます。- 文字列形式はプライマリモデルのみを設定します。
- オブジェクト形式はプライマリと順序付きフェイルオーバーモデルを設定します。
imageModel: 文字列("provider/model")またはオブジェクト({ primary, fallbacks })を受け付けます。imageツール経路で、その vision-model 設定として使われます。- 選択された/デフォルトのモデルが画像入力を受け付けられない場合のフォールバックルーティングにも使われます。
imageGenerationModel: 文字列("provider/model")またはオブジェクト({ primary, fallbacks })を受け付けます。- 共有画像生成機能と、将来の画像生成を行うツール/Plugin サーフェスで使われます。
- 一般的な値: ネイティブ Gemini 画像生成には
google/gemini-3.1-flash-image-preview、fal にはfal/fal-ai/flux/dev、OpenAI Images にはopenai/gpt-image-2。 - プロバイダー/モデルを直接選択する場合は、一致するプロバイダー認証も設定してください(たとえば
google/*にはGEMINI_API_KEYまたはGOOGLE_API_KEY、openai/gpt-image-2にはOPENAI_API_KEYまたは OpenAI Codex OAuth、fal/*にはFAL_KEY)。 - 省略した場合でも、
image_generateは認証付きプロバイダーのデフォルトを推論できます。まず現在のデフォルトプロバイダーを試し、その後、登録済みの残りの画像生成プロバイダーを provider-id 順で試します。
musicGenerationModel: 文字列("provider/model")またはオブジェクト({ primary, fallbacks })を受け付けます。- 共有音楽生成機能と組み込みの
music_generateツールで使われます。 - 一般的な値:
google/lyria-3-clip-preview、google/lyria-3-pro-preview、minimax/music-2.5+。 - 省略した場合でも、
music_generateは認証付きプロバイダーのデフォルトを推論できます。まず現在のデフォルトプロバイダーを試し、その後、登録済みの残りの音楽生成プロバイダーを provider-id 順で試します。 - プロバイダー/モデルを直接選択する場合は、一致するプロバイダー認証/API キーも設定してください。
- 共有音楽生成機能と組み込みの
videoGenerationModel: 文字列("provider/model")またはオブジェクト({ primary, fallbacks })を受け付けます。- 共有動画生成機能と組み込みの
video_generateツールで使われます。 - 一般的な値:
qwen/wan2.6-t2v、qwen/wan2.6-i2v、qwen/wan2.6-r2v、qwen/wan2.6-r2v-flash、qwen/wan2.7-r2v。 - 省略した場合でも、
video_generateは認証付きプロバイダーのデフォルトを推論できます。まず現在のデフォルトプロバイダーを試し、その後、登録済みの残りの動画生成プロバイダーを provider-id 順で試します。 - プロバイダー/モデルを直接選択する場合は、一致するプロバイダー認証/API キーも設定してください。
- バンドル済みの Qwen 動画生成プロバイダーは、最大 1 本の出力動画、1 枚の入力画像、4 本の入力動画、10 秒の長さ、およびプロバイダーレベルの
size、aspectRatio、resolution、audio、watermarkオプションをサポートします。
- 共有動画生成機能と組み込みの
pdfModel: 文字列("provider/model")またはオブジェクト({ primary, fallbacks })を受け付けます。pdfツールのモデルルーティングに使われます。- 省略した場合、PDF ツールは
imageModel、その次に解決済みのセッション/デフォルトモデルへフォールバックします。
pdfMaxBytesMb:pdfツールで呼び出し時にmaxBytesMbが渡されない場合の、デフォルト PDF サイズ上限。pdfMaxPages:pdfツールの抽出フォールバックモードで考慮するデフォルト最大ページ数。verboseDefault: エージェントのデフォルト verbose レベル。値:"off"、"on"、"full"。デフォルト:"off"。elevatedDefault: エージェントのデフォルト elevated-output レベル。値:"off"、"on"、"ask"、"full"。デフォルト:"on"。model.primary: 形式はprovider/model(例: API キーアクセスにはopenai/gpt-5.4、Codex OAuth にはopenai-codex/gpt-5.5)。プロバイダーを省略した場合、OpenClaw はまずエイリアスを試し、次にその正確なモデル ID に対する一意な configured-provider 一致を試し、それでもだめなら設定済みのデフォルトプロバイダーにフォールバックします(非推奨の互換動作なので、明示的なprovider/modelを推奨します)。そのプロバイダーが設定済みデフォルトモデルをもう提供していない場合、OpenClaw は古い削除済みプロバイダーデフォルトを表面化する代わりに、最初の configured provider/model へフォールバックします。models:/model用の設定済みモデルカタログと許可リスト。各エントリにはalias(ショートカット)とparams(プロバイダー固有。たとえばtemperature、maxTokens、cacheRetention、context1m、responsesServerCompaction、responsesCompactThreshold)を含められます。- 安全な編集: エントリを追加するには
openclaw config set agents.defaults.models '<json>' --strict-json --mergeを使います。config setは、--replaceを渡さない限り、既存の許可リストエントリを削除する置換を拒否します。 - プロバイダースコープの configure/オンボーディングフローは、選択したプロバイダーモデルをこのマップにマージし、すでに設定されている無関係なプロバイダーは保持します。
- 直接の OpenAI Responses モデルでは、サーバー側 Compaction が自動的に有効になります。
context_managementの注入を止めるにはparams.responsesServerCompaction: falseを、しきい値を上書きするにはparams.responsesCompactThresholdを使います。OpenAI server-side compaction を参照してください。
- 安全な編集: エントリを追加するには
params: すべてのモデルに適用されるグローバルなデフォルトプロバイダーパラメータ。agents.defaults.paramsに設定します(例{ cacheRetention: "long" })。paramsのマージ優先順位(config):agents.defaults.params(グローバルベース)がagents.defaults.models["provider/model"].params(モデルごと)で上書きされ、その後agents.list[].params(一致するエージェント ID)がキーごとに上書きします。詳細は Prompt Caching を参照してください。embeddedHarness: デフォルトの低レベル埋め込みエージェントランタイムポリシー。runtime: "auto"を使うと、登録済み Plugin harness がサポート対象モデルを引き受け、runtime: "pi"で組み込み PI harness を強制し、runtime: "codex"のような登録済み harness id も指定できます。自動 PI フォールバックを無効にするにはfallback: "none"を設定します。- これらのフィールドを変更する config writer(たとえば
/models set、/models set-image、フォールバックの追加/削除コマンド)は、正規のオブジェクト形式で保存し、可能な限り既存のフォールバックリストを保持します。 maxConcurrent: セッションをまたぐ並列エージェント実行の最大数(各セッションは引き続き直列化されます)。デフォルト: 4。
agents.defaults.embeddedHarness
embeddedHarness は、埋め込みエージェントターンを実行する低レベル executor を制御します。
ほとんどのデプロイでは、デフォルトの { runtime: "auto", fallback: "pi" } のままにしてください。
これは、バンドル済みの
Codex app-server harness のように、信頼された Plugin がネイティブ harness を提供する場合に使います。
runtime:"auto"、"pi"、または登録済み Plugin harness id。バンドル済み Codex Plugin はcodexを登録します。fallback:"pi"または"none"。"pi"は、Plugin harness が選択されない場合の互換フォールバックとして組み込み PI harness を維持します。`“none”“ は、未登録または未対応の Plugin harness 選択時に、黙って PI を使うのではなく失敗させます。選択された Plugin harness の失敗は常に直接表面化されます。- 環境変数による上書き:
OPENCLAW_AGENT_RUNTIME=<id|auto|pi>はruntimeを上書きします。OPENCLAW_AGENT_HARNESS_FALLBACK=noneはそのプロセスでの PI フォールバックを無効にします。 - Codex 専用デプロイでは、
model: "openai/gpt-5.5"、embeddedHarness.runtime: "codex"、embeddedHarness.fallback: "none"を設定してください。 - Harness の選択は、最初の埋め込み実行後にセッション ID ごとに固定されます。config/env の変更は、新規またはリセットされたセッションには影響しますが、既存の transcript には影響しません。transcript 履歴はあるが記録済みの固定がないレガシーセッションは、PI 固定として扱われます。
/statusでは、Fastの横にcodexのような非 PI harness id が表示されます。 - これは埋め込みチャット harness だけを制御します。メディア生成、vision、PDF、音楽、動画、TTS は引き続きそれぞれのプロバイダー/モデル設定を使います。
agents.defaults.models にある場合のみ適用):
| Alias | Model |
|---|---|
opus | anthropic/claude-opus-4-6 |
sonnet | anthropic/claude-sonnet-4-6 |
gpt | openai/gpt-5.4 または設定済み Codex OAuth GPT-5.5 |
gpt-mini | openai/gpt-5.4-mini |
gpt-nano | openai/gpt-5.4-nano |
gemini | google/gemini-3.1-pro-preview |
gemini-flash | google/gemini-3-flash-preview |
gemini-flash-lite | google/gemini-3.1-flash-lite-preview |
--thinking off を設定するか、agents.defaults.models["zai/<model>"].params.thinking を自分で定義しない限り、自動的に thinking mode を有効にします。
Z.AI モデルは、ツール呼び出しストリーミングのためにデフォルトで tool_stream を有効にします。無効にするには agents.defaults.models["zai/<model>"].params.tool_stream を false に設定してください。
Anthropic Claude 4.6 モデルは、明示的な thinking レベルが設定されていない場合、デフォルトで adaptive thinking を使います。
agents.defaults.cliBackends
テキスト専用フォールバック実行用の任意の CLI バックエンドです(ツール呼び出しなし)。API プロバイダーが失敗したときのバックアップとして便利です。
OC_I18N_900018
- CLI バックエンドはテキスト優先で、ツールは常に無効です。
sessionArgが設定されている場合、セッションをサポートします。imageArgがファイルパスを受け付ける場合、画像のパススルーをサポートします。
agents.defaults.systemPromptOverride
OpenClaw が組み立てたシステムプロンプト全体を固定文字列で置き換えます。デフォルトレベル(agents.defaults.systemPromptOverride)またはエージェントごと(agents.list[].systemPromptOverride)で設定します。エージェントごとの値が優先されます。空文字列または空白のみの値は無視されます。制御されたプロンプト実験に便利です。
OC_I18N_900019
agents.defaults.promptOverlays
モデルファミリーごとに適用される、プロバイダー非依存のプロンプト overlay です。GPT-5 ファミリーの model id には、プロバイダーをまたいだ共有の挙動契約が適用されます。personality は、フレンドリーな interaction-style レイヤーのみを制御します。
OC_I18N_900020
"friendly"(デフォルト)と"on"は、フレンドリーな interaction-style レイヤーを有効にします。"off"はフレンドリーなレイヤーのみを無効にします。タグ付き GPT-5 の挙動契約は引き続き有効です。- レガシーな
plugins.entries.openai.config.personalityは、この共有設定が未設定の場合に引き続き読み取られます。
agents.defaults.heartbeat
定期的な Heartbeat 実行です。
OC_I18N_900021
every: 期間文字列(ms/s/m/h)。デフォルト:30m(API キー認証)または1h(OAuth 認証)。無効にするには0mに設定します。includeSystemPromptSection: false の場合、システムプロンプトから Heartbeat セクションを省略し、ブートストラップコンテキストへのHEARTBEAT.md注入をスキップします。デフォルト:true。suppressToolErrorWarnings: true の場合、Heartbeat 実行中のツールエラー警告ペイロードを抑制します。timeoutSeconds: 中断される前に Heartbeat エージェントターンに許可される最大秒数。未設定の場合はagents.defaults.timeoutSecondsを使います。directPolicy: direct/DM 配信ポリシー。allow(デフォルト)は direct-target 配信を許可します。blockは direct-target 配信を抑制し、reason=dm-blockedを出します。lightContext: true の場合、Heartbeat 実行は軽量ブートストラップコンテキストを使用し、ワークスペースブートストラップファイルのうちHEARTBEAT.mdだけを保持します。isolatedSession: true の場合、各 Heartbeat は会話履歴なしの新しいセッションで実行されます。Cron のsessionTarget: "isolated"と同じ分離パターンです。Heartbeat ごとのトークンコストを約 100K から約 2–5K トークンに削減します。- エージェントごと:
agents.list[].heartbeatを設定します。いずれかのエージェントがheartbeatを定義すると、Heartbeat を実行するのはそのエージェントだけになります。 - Heartbeat は完全なエージェントターンを実行します。短い間隔ほどトークン消費が増えます。
agents.defaults.compaction
OC_I18N_900022
mode:defaultまたはsafeguard(長い履歴向けのチャンク化要約)。Compaction を参照してください。provider: 登録済み Compaction provider Plugin の id。設定すると、組み込み LLM 要約の代わりに、その provider のsummarize()が呼び出されます。失敗時は組み込みにフォールバックします。provider を設定するとmode: "safeguard"が強制されます。Compaction を参照してください。timeoutSeconds: OpenClaw が中断するまでの 1 回の Compaction 操作の最大秒数。デフォルト:900。identifierPolicy:strict(デフォルト)、off、またはcustom。strictは、Compaction 要約中に組み込みの不透明識別子保持ガイダンスを前置します。identifierInstructions:identifierPolicy=customのときに使われる、任意のカスタム識別子保持テキスト。postCompactionSections: Compaction 後に再注入する任意の AGENTS.md H2/H3 セクション名。デフォルトは["Session Startup", "Red Lines"]。再注入を無効にするには[]を設定します。未設定、または明示的にそのデフォルトの組を設定した場合、古いEvery Session/Safety見出しもレガシーフォールバックとして受け入れられます。model: Compaction 要約専用の任意のprovider/model-id上書き。メインセッションは 1 つのモデルのままにしつつ、Compaction 要約を別のモデルで実行したい場合に使います。未設定の場合、Compaction はセッションのプライマリモデルを使います。notifyUser:trueの場合、Compaction の開始時と完了時にユーザーへ短い通知を送信します(たとえば「Compacting context…」「Compaction complete」)。Compaction を無言に保つため、デフォルトでは無効です。memoryFlush: 耐久性のあるメモリを保存するために、自動 Compaction 前に行う無言のエージェントターン。ワークスペースが読み取り専用の場合はスキップされます。
agents.defaults.contextPruning
LLM へ送る前に、メモリ上の古いツール結果を刈り込みます。ディスク上のセッション履歴は変更しません。
OC_I18N_900023
cache-ttl モードの動作
cache-ttl モードの動作
mode: "cache-ttl"で刈り込みパスを有効にします。ttlは、最後のキャッシュタッチ後に、次にいつ再び刈り込みを実行できるかを制御します。- 刈り込みは、必要に応じてまず大きすぎるツール結果をソフトトリムし、その後、より古いツール結果をハードクリアします。
... を挿入します。ハードクリア はツール結果全体をプレースホルダーに置き換えます。注:- 画像ブロックはトリム/クリアされません。
- 比率は厳密なトークン数ではなく、文字数ベース(概算)です。
keepLastAssistants個未満の assistant メッセージしか存在しない場合、刈り込みはスキップされます。
ブロックストリーミング
OC_I18N_900024- Telegram 以外のチャンネルでは、ブロック返信を有効にするには明示的な
*.blockStreaming: trueが必要です。 - チャンネル上書き:
channels.<channel>.blockStreamingCoalesce(およびアカウントごとのバリアント)。Signal/Slack/Discord/Google Chat のデフォルトはminChars: 1500です。 humanDelay: ブロック返信間のランダム化された待機。natural= 800–2500ms。エージェントごとの上書き:agents.list[].humanDelay。
入力中インジケーター
OC_I18N_900025- デフォルト: direct chat/メンションでは
instant、メンションされていないグループチャットではmessage。 - セッションごとの上書き:
session.typingMode,session.typingIntervalSeconds。
agents.defaults.sandbox
埋め込みエージェント向けの任意のサンドボックス化です。完全なガイドは Sandboxing を参照してください。
OC_I18N_900026
サンドボックスの詳細
サンドボックスの詳細
sandbox.docker.binds は Docker 専用です。
イメージをビルドするには:
OC_I18N_900028
agents.list(エージェントごとの上書き)
OC_I18N_900029
id: 安定したエージェント ID(必須)。default: 複数設定されている場合は最初のものが有効になります(警告を記録)。何も設定されていない場合、リストの最初のエントリがデフォルトです。model: 文字列形式はprimaryのみを上書きし、オブジェクト形式{ primary, fallbacks }は両方を上書きします([]でグローバルフォールバックを無効化)。primaryだけを上書きする Cron ジョブは、fallbacks: []を設定しない限り、デフォルトフォールバックを引き続き継承します。params:agents.defaults.modelsの選択されたモデルエントリにマージされる、エージェントごとのストリーム params。モデルカタログ全体を複製せずに、cacheRetention、temperature、maxTokensのようなエージェント固有の上書きに使います。skills: 任意のエージェントごとの Skill 許可リスト。省略した場合、設定されていればagents.defaults.skillsを継承します。明示的なリストはマージではなくデフォルトを置き換え、[]は Skills なしを意味します。thinkingDefault: 任意のエージェントごとのデフォルト thinking レベル(off | minimal | low | medium | high | xhigh | adaptive | max)。メッセージごとまたはセッションの上書きがない場合、このエージェントではagents.defaults.thinkingDefaultを上書きします。reasoningDefault: 任意のエージェントごとのデフォルト reasoning 可視性(on | off | stream)。メッセージごとまたはセッションの reasoning 上書きがない場合に適用されます。fastModeDefault: 任意のエージェントごとの fast mode デフォルト(true | false)。メッセージごとまたはセッションの fast-mode 上書きがない場合に適用されます。embeddedHarness: 任意のエージェントごとの低レベル harness ポリシー上書き。1 つのエージェントだけを Codex 専用にし、他のエージェントはデフォルトの PI フォールバックを維持するには{ runtime: "codex", fallback: "none" }を使います。runtime: 任意のエージェントごとのランタイム記述子。エージェントがデフォルトで ACP harness セッションを使うべき場合は、type: "acp"とruntime.acpデフォルト(agent、backend、mode、cwd)を使います。identity.avatar: ワークスペース相対パス、http(s)URL、またはdata:URI。identityはデフォルトを導出します:ackReactionはemojiから、mentionPatternsはname/emojiから。subagents.allowAgents:sessions_spawn用のエージェント ID 許可リスト(["*"]= 任意。デフォルト: 同じエージェントのみ)。- サンドボックス継承ガード: 依頼元セッションがサンドボックス化されている場合、
sessions_spawnはサンドボックスなしで実行されるターゲットを拒否します。 subagents.requireAgentId: true の場合、agentIdを省略したsessions_spawn呼び出しをブロックします(明示的なプロファイル選択を強制。デフォルト: false)。
マルチエージェントルーティング
1 つの Gateway 内で複数の分離されたエージェントを実行します。Multi-Agent を参照してください。 OC_I18N_900030バインディングの match フィールド
type(任意): 通常のルーティングにはroute(type がない場合も route 扱い)、永続的 ACP 会話バインディングにはacp。match.channel(必須)match.accountId(任意。*= 任意のアカウント、省略 = デフォルトアカウント)match.peer(任意。{ kind: direct|group|channel, id })match.guildId/match.teamId(任意。チャンネル固有)acp(任意。type: "acp"のみ):{ mode, label, cwd, backend }
match.peermatch.guildIdmatch.teamIdmatch.accountId(正確一致、peer/guild/team なし)match.accountId: "*"(チャンネル全体)- デフォルトエージェント
bindings エントリが有効です。
type: "acp" エントリでは、OpenClaw は正確な会話 ID(match.channel + account + match.peer.id)で解決し、上記の route バインディング tier 順序は使いません。
エージェントごとのアクセスプロファイル
フルアクセス(サンドボックスなし)
フルアクセス(サンドボックスなし)
OC_I18N_900031
読み取り専用ツール + ワークスペース
読み取り専用ツール + ワークスペース
OC_I18N_900032
ファイルシステムアクセスなし(メッセージングのみ)
ファイルシステムアクセスなし(メッセージングのみ)
OC_I18N_900033
セッション
OC_I18N_900034セッションフィールドの詳細
セッションフィールドの詳細
scope: グループチャット文脈向けのベースセッショングループ化戦略。per-sender(デフォルト): チャンネル文脈内で、各送信者ごとに独立したセッションを持ちます。global: チャンネル文脈内のすべての参加者が 1 つのセッションを共有します(共有コンテキストが意図されている場合にのみ使用)。
dmScope: DM のグループ化方法。main: すべての DM がメインセッションを共有します。per-peer: チャンネルをまたいで送信者 ID ごとに分離します。per-channel-peer: チャンネル + 送信者ごとに分離します(複数ユーザーの受信箱に推奨)。per-account-channel-peer: アカウント + チャンネル + 送信者ごとに分離します(複数アカウントに推奨)。
identityLinks: チャンネル間セッション共有のため、正規 ID をプロバイダープレフィックス付き peer にマップします。reset: プライマリ reset ポリシー。dailyはローカル時刻のatHourに reset し、idleはidleMinutes後に reset します。両方が設定されている場合、先に期限が来た方が有効です。resetByType: タイプごとの上書き(direct、group、thread)。レガシーのdmはdirectの別名として受け付けられます。parentForkMaxTokens: fork されたスレッドセッション作成時に許可される、親セッションtotalTokensの最大値(デフォルト100000)。- 親の
totalTokensがこの値を超える場合、OpenClaw は親 transcript 履歴を継承せず、新しいスレッドセッションを開始します。 - このガードを無効にして常に親 fork を許可するには
0を設定します。
- 親の
mainKey: レガシーフィールド。ランタイムはメインの direct-chat バケットに常に"main"を使います。agentToAgent.maxPingPongTurns: エージェント間やり取りにおける reply-back ターンの最大数(整数、範囲:0–5)。0は ping-pong 連鎖を無効化します。sendPolicy:channel、chatType(direct|group|channel。レガシーdm別名あり)、keyPrefix、またはrawKeyPrefixで一致させます。最初の deny が優先されます。maintenance: セッションストアのクリーンアップ + 保持制御。mode:warnは警告のみを出し、enforceはクリーンアップを適用します。pruneAfter: 古いエントリの期限(デフォルト30d)。maxEntries:sessions.json内のエントリ最大数(デフォルト500)。rotateBytes:sessions.jsonがこのサイズを超えたらローテーションします(デフォルト10mb)。resetArchiveRetention:*.reset.<timestamp>transcript アーカイブの保持期間。デフォルトではpruneAfterを使います。無効にするにはfalseを設定します。maxDiskBytes: 任意の sessions ディレクトリのディスク予算。warnモードでは警告を記録し、enforceモードでは最も古い artifact/session から削除します。highWaterBytes: 任意の予算クリーンアップ後の目標値。デフォルトはmaxDiskBytesの80%です。
threadBindings: スレッドに結び付いたセッション機能のグローバルデフォルト。enabled: マスターデフォルトスイッチ(プロバイダーが上書き可能。Discord はchannels.discord.threadBindings.enabledを使用)idleHours: 非アクティブ自動 unfocus のデフォルト時間(0で無効。プロバイダーが上書き可能)maxAgeHours: ハード最大経過時間のデフォルト(0で無効。プロバイダーが上書き可能)
メッセージ
OC_I18N_900035応答プレフィックス
チャンネル/アカウントごとの上書き:channels.<channel>.responsePrefix, channels.<channel>.accounts.<id>.responsePrefix。
解決順(より具体的なものが優先): account → channel → global。"" は無効化し、それ以上のカスケードを止めます。"auto" は [{identity.name}] を導出します。
テンプレート変数:
| Variable | 説明 | Example |
|---|---|---|
{model} | 短いモデル名 | claude-opus-4-6 |
{modelFull} | 完全なモデル識別子 | anthropic/claude-opus-4-6 |
{provider} | プロバイダー名 | anthropic |
{thinkingLevel} | 現在の thinking レベル | high, low, off |
{identity.name} | エージェント identity 名 | ("auto" と同じ) |
{think} は {thinkingLevel} の別名です。
確認用リアクション
- デフォルトはアクティブなエージェントの
identity.emoji、なければ"👀"。無効にするには""を設定します。 - チャンネルごとの上書き:
channels.<channel>.ackReaction,channels.<channel>.accounts.<id>.ackReaction。 - 解決順: account → channel →
messages.ackReaction→ identity フォールバック。 - スコープ:
group-mentions(デフォルト)、group-all、direct、all。 removeAckAfterReply: Slack、Discord、Telegram では返信後に ack を削除します。messages.statusReactions.enabled: Slack、Discord、Telegram でライフサイクル状態リアクションを有効にします。 Slack と Discord では、未設定のままだと ack リアクションが有効なときは status reactions も有効のままです。 Telegram では、ライフサイクル状態リアクションを有効にするには明示的にtrueに設定してください。
受信 debounce
同じ送信者からの高速なテキストのみのメッセージを、1 つのエージェントターンにまとめます。メディア/添付ファイルは即座に flush されます。制御コマンドは debouncing をバイパスします。TTS(text-to-speech)
OC_I18N_900036autoはデフォルトの自動 TTS モードを制御します:off、always、inbound、またはtagged。/tts on|offでローカル設定を上書きでき、/tts statusで実効状態を表示します。summaryModelは、自動要約用にagents.defaults.model.primaryを上書きします。modelOverridesはデフォルトで有効です。modelOverrides.allowProviderのデフォルトはfalse(オプトイン)です。- API キーは
ELEVENLABS_API_KEY/XI_API_KEYとOPENAI_API_KEYにフォールバックします。 openai.baseUrlは OpenAI TTS エンドポイントを上書きします。解決順は config、次にOPENAI_TTS_BASE_URL、最後にhttps://api.openai.com/v1です。openai.baseUrlが非 OpenAI エンドポイントを指している場合、OpenClaw はそれを OpenAI 互換 TTS サーバーとして扱い、model/voice 検証を緩和します。
Talk
Talk モード(macOS/iOS/Android)のデフォルトです。 OC_I18N_900037talk.providerは、複数の Talk プロバイダーが設定されている場合、talk.providersのキーと一致している必要があります。- レガシーなフラット Talk キー(
talk.voiceId、talk.voiceAliases、talk.modelId、talk.outputFormat、talk.apiKey)は互換性専用であり、自動的にtalk.providers.<provider>へ移行されます。 - Voice ID は
ELEVENLABS_VOICE_IDまたはSAG_VOICE_IDにフォールバックします。 providers.*.apiKeyは平文文字列または SecretRef オブジェクトを受け付けます。ELEVENLABS_API_KEYフォールバックは、Talk API キーが設定されていない場合にのみ適用されます。providers.*.voiceAliasesにより、Talk ディレクティブでフレンドリーな名前を使えます。silenceTimeoutMsは、ユーザーの無音後に Talk モードが transcript を送信するまで待つ時間を制御します。未設定の場合はプラットフォームデフォルトの待機ウィンドウを維持します(macOS と Android では 700 ms、iOS では 900 ms)。
関連
- Configuration reference — その他すべての設定キー
- Configuration — 一般的なタスクとクイックセットアップ
- Configuration examples