ワークスペース（必須）
各エージェントは、単一のワークスペースディレクトリ（agents.defaults.workspace、またはエージェントごとの agents.list[].workspace）を、ツールとコンテキストの 唯一の 作業ディレクトリ（cwd）として使用します。
推奨: ~/.openclaw/openclaw.json がない場合は openclaw setup を使って作成し、ワークスペースファイルを初期化します。
完全なワークスペースレイアウト + バックアップガイド: エージェントワークスペース
agents.defaults.sandbox が有効な場合、main 以外のセッションは、agents.defaults.sandbox.workspaceRoot の下にあるセッションごとのワークスペースでこれを上書きできます（Gateway 設定 を参照）。
ブートストラップファイル（注入）
ワークスペース内で、OpenClaw はこれらのユーザー編集可能なファイルを想定します。| ファイル | 目的 |
|---|---|
AGENTS.md | 操作指示 + 「メモリ」 |
SOUL.md | ペルソナ、境界、トーン |
TOOLS.md | ユーザーが管理するツールメモと規約 |
IDENTITY.md | エージェント名/雰囲気/絵文字 |
USER.md | ユーザープロファイル + 希望する呼び方 |
HEARTBEAT.md | Heartbeat 固有の指示 |
BOOTSTRAP.md | 初回実行時だけの儀式（完了後に削除） |
MEMORY.md | 存在する場合のルート長期メモリファイル |
MEMORY.md は、ワークスペースルートに存在する場合にのみ注入されます。
空のファイルはスキップされます。大きなファイルは、プロンプトを軽量に保つため、マーカー付きで切り詰められます（完全な内容はファイルを読んでください）。MEMORY.md 以外のファイルがない場合は、代わりに 1 行の「missing file」マーカーが注入されます。openclaw setup は、そのための安全なデフォルトテンプレートを作成します。
BOOTSTRAP.md は まったく新しいワークスペース（他のブートストラップファイルが存在しない場合）にのみ作成されます。保留中の間、OpenClaw はそれを Project Context に保持し、ユーザーメッセージへコピーする代わりに、初期儀式向けのシステムプロンプトのブートストラップガイダンスを追加します。儀式を完了した後に削除すると、後の再起動で再作成されることはありません。
ワークスペースが一度観測されると、OpenClaw はそのワークスペースパスに対する state-dir 証明マーカーも保持します。最近証明されたワークスペースが消えたり消去されたりした場合、起動時に BOOTSTRAP.md を黙って再シードすることは拒否されます。ワークスペースを復元するか、完全なオンボーディングリセットを使ってワークスペースとマーカーを一緒にクリアしてください。
ブートストラップファイル作成を完全に無効化するには（事前にシード済みのワークスペース向け）、次を設定します。
組み込みツール
コアツール（read/exec/edit/write および関連するシステムツール）は、ツールポリシーの範囲内で常に利用できます。apply_patch は OpenAI モデルではデフォルトで有効で、tools.exec.applyPatch（enabled、workspaceOnly、allowModels）によって制御されます。TOOLS.md は、どのツールが存在するかを制御するものではありません。これは、あなたが それらをどう使ってほしいかのガイダンスです。
Skills
OpenClaw は、次の場所から Skills を読み込みます（上ほど優先度が高い）。- ワークスペース:
<workspace>/skills - プロジェクトエージェント Skills:
<workspace>/.agents/skills - 個人エージェント Skills:
~/.agents/skills - 管理/local:
~/.openclaw/skills - バンドル（インストールに同梱）
- 追加の Skill フォルダー:
skills.load.extraDirs
<workspace>/skills/personal/foo/SKILL.md のようなグループ化フォルダーを含められます。この Skill は、それでも frontmatter のフラットな名前、たとえば foo として公開されます。
Skills は config/env で制御できます（Gateway 設定 の skills を参照）。
ランタイム境界
組み込みエージェントランタイムは OpenClaw が所有します。モデル検出、ツール配線、プロンプト組み立て、セッション管理、チャネル配信は、1 つの統合されたランタイムサーフェスを共有します。セッション
セッショントランスクリプトは JSONL として次に保存されます。~/.openclaw/agents/<agentId>/sessions/<SessionId>.jsonl
ストリーミング中のステアリング
実行中に到着した受信プロンプトは、デフォルトで現在の実行へステアリングされます。ステアリングは、現在のアシスタントターンがツール呼び出しの実行を完了した後、次の LLM 呼び出しの前に届けられ、現在のアシスタントメッセージに残っているツール呼び出しをスキップしなくなりました。/queue steer は、アクティブ実行のデフォルト動作です。/queue followup と /queue collect は、ステアリングする代わりに、後のターンまでメッセージを待機させます。/queue interrupt は、代わりにアクティブな実行を中止します。キューと境界の動作については、Queue と ステアリングキュー を参照してください。
ブロックストリーミングは、完了したアシスタントブロックを完了し次第送信します。これは デフォルトでオフ です（agents.defaults.blockStreamingDefault: "off"）。
境界は agents.defaults.blockStreamingBreak（text_end と message_end。デフォルトは text_end）で調整します。
ソフトブロックのチャンク化は agents.defaults.blockStreamingChunk で制御します（デフォルトは 800-1200 文字。段落区切りを優先し、次に改行、最後に文）。
ストリーミングされたチャンクは agents.defaults.blockStreamingCoalesce で結合し、単一行のスパムを減らします（送信前のアイドルベースのマージ）。Telegram 以外のチャネルでは、ブロック返信を有効にするために明示的な *.blockStreaming: true が必要です。
詳細なツールサマリーはツール開始時に出力されます（デバウンスなし）。Control UI は、利用可能な場合にエージェントイベントを介してツール出力をストリーミングします。
詳細: ストリーミング + チャンク化。
モデル参照
設定内のモデル参照（例:agents.defaults.model と agents.defaults.models）は、最初の / で分割して解析されます。
- モデルを設定するときは
provider/modelを使います。 - モデル ID 自体に
/が含まれる場合（OpenRouter 形式）、プロバイダープレフィックスを含めます（例:openrouter/moonshotai/kimi-k2）。 - プロバイダーを省略した場合、OpenClaw はまずエイリアスを試し、次にその正確なモデル ID に一致する一意の設定済みプロバイダーを試し、その後にのみ設定済みのデフォルトプロバイダーへフォールバックします。そのプロバイダーが設定済みのデフォルトモデルを公開しなくなった場合、OpenClaw は古い削除済みプロバイダーのデフォルトを表面化するのではなく、最初の設定済みプロバイダー/モデルへフォールバックします。
設定（最小）
最低限、次を設定します。agents.defaults.workspacechannels.whatsapp.allowFrom（強く推奨）