コードモード

• Codex Code Mode は Codex コーディングハーネス内で動作します。その exec ツールは 自由形式文法のツールです。モデルは生の JavaScript ソースを記述し（実行オプション用の // @exec: {...} プラグマ行を先頭に付けることも可能）、Codex のプロセス内 V8 Code Mode ランタイムで 実行されます。
• OpenClaw コードモードは汎用 OpenClaw エージェントランタイムで動作し、 tools.codeMode.enabled: true が設定されていない限り無効です。その exec ツールは JSON の { code, language } ペイロードを受け取り、QuickJS-WASI ワーカーで実行します。

​

機能

• モデルに表示されるツール一覧は、exec、wait、および computer や、画像結果をゲストブリッジ経由で維持できないネイティブビジョンの image ローダーなどの直接実行専用ツールになります。
• exec は、モデルが生成した JavaScript または TypeScript を、 分離された QuickJS-WASI ワーカースレッドで評価します。
• カタログに登録可能な有効ツール（OpenClaw コア、Plugin、MCP、クライアント）はすべて、 モデルの単独ツールとしては非表示になり、ゲストプログラム内で ALL_TOOLS および tools を通じて公開されます。
• exec の説明には、正確な OpenClaw/Plugin カタログ ID の件数制限付きクイックインデックス、 簡潔な入力ヒント、および信頼されたツールが出力スキーマを提供する場合の 簡潔な宣言済み出力ヒントが含まれます。説明、完全なスキーマ、 MCP エントリ、上限を超えたエントリは省略されます。ゲスト側のカタログ検索は引き続きフォールバックとして機能します。
• ゲストコードは非表示のカタログを検索し、ツールのスキーマを記述し、 通常のエージェントターンと同じ実行パスを通じてツールを呼び出します（ポリシー、 承認、フック、テレメトリはすべて引き続き適用されます）。
• MCP ツールは MCP 名前空間にまとめられます。コードモードでは、 これが MCP ツールを呼び出す唯一の対応方法です。
• wait は、ネストされたツール呼び出しがまだ保留中の場合に、 中断されたコードモード実行を再開します。

​

使用する理由

• プロンプトサーフェスの縮小：プロバイダーには、数十または数百の完全なツールスキーマの代わりに、 2 つの制御ツール、件数制限付きのネイティブツールインデックス、および必要最小限の直接ツールだけが 提供されます。
• オーケストレーションの向上：モデルは 1 つのコードセル内で、ループ、結合、小規模な変換、 条件ロジック、並列のネストされたツール呼び出しを使用できます。
• モデルの往復回数を削減：宣言済みの出力契約により、モデルは 1 回の exec で ツール結果を呼び出して変換できます。出力が不明な場合は、最初に未加工の結果が返されます。
• プロバイダー非依存：プロバイダー固有のコード実行に依存せず、 OpenClaw、Plugin、MCP、クライアントツールで動作します。
• フェイルクローズ：コードモードが有効でも QuickJS-WASI ランタイムを 使用できない場合、広範な直接ツール公開へ暗黙的にフォールバックせず、 実行は失敗します。

​

クイックスタート

​

コードモードを有効にする

{
  tools: {
    codeMode: {
      enabled: true,
    },
  },
}

{
  tools: {
    codeMode: true,
  },
}

{
  tools: {
    codeMode: {
      enabled: true,
      timeoutMs: 10000,
      memoryLimitBytes: 67108864,
      maxOutputBytes: 65536,
      maxSnapshotBytes: 10485760,
      maxPendingToolCalls: 16,
      snapshotTtlSeconds: 900,
      searchDefaultLimit: 8,
      maxSearchLimit: 50,
    },
  },
}

​

モデルの動作

const [shipmentTool] = await tools.search("list shipments");
const shipments = await tools.callValue(shipmentTool.id, {});
return shipments.filter((shipment) => !shipment.paid && shipment.tons > 10);

​

有効なサーフェスを確認する

OPENCLAW_DEBUG_CODE_MODE=1 \
OPENCLAW_DEBUG_MODEL_TRANSPORT=1 \
OPENCLAW_DEBUG_MODEL_PAYLOAD=tools \
openclaw gateway

​

エージェントのファンアウトに Swarm を使用する

​

技術解説

​

ランタイムの状態

​

スコープ

​

用語

• コードモード：カタログ対応のモデルツールを非表示にし、 exec、wait、および必要な直接実行専用ツールを公開する OpenClaw ランタイムモード。
• ゲストランタイム：モデルコードを評価する QuickJS-WASI JavaScript VM。
• ホストブリッジ：ゲストコードから OpenClaw に戻る、 JSON 互換の限定的なコールバックサーフェス。
• カタログ：通常のツールポリシー、Plugin、MCP、 クライアントツールの解決後に得られる、実行スコープの有効なツール一覧。
• ネストされたツール呼び出し：ゲストコードからホストブリッジを通じて行われる ツール呼び出し。
• スナップショット：wait が中断されたコードモード実行を継続できるように 保存される、シリアライズ済み QuickJS-WASI VM 状態。

​

設定

​

有効化

1. エージェント、モデル、プロバイダー、サンドボックス、チャネル、送信者、実行 ポリシーを解決します。
2. 有効な OpenClaw ツールリストを構築し、対象となる plugin、MCP、および クライアントツールを追加します。
3. 許可/拒否ポリシーを適用します。
4. tools.codeMode.enabled が false の場合、通常のツール公開を続行します。
5. 有効で、実行時にツールがアクティブな場合、必要な直接専用 ツールを保持し、カタログ対象となるすべての有効なツールをコードモード カタログに登録します。
6. カタログ登録されたツールをモデルに表示されるリストから削除し、保持された直接専用ツールとともに exec および wait を追加します。

​

モデルに表示されるツール

​

exec

type CodeModeExecInput = {
  code?: string;
  command?: string;
  language?: "javascript" | "typescript";
};

• code または command のいずれかが空でない必要があります。
• code は、文書化されているモデル向けフィールドです。
• command は、フックポリシーおよび信頼済みの書き換え用に exec 互換のエイリアスとして受け付けられます （通常の OpenClaw シェル exec ツールも command フィールドを使用します）。両方が指定された場合、値は一致する必要があります。
• language のデフォルトは "javascript" です。一部のプロバイダーはこれらの形式を拒否するため、 スキーマでは oneOf/anyOf ユニオンではなく、フラットな 文字列列挙型（"javascript" | "typescript"）として公開されます。
• language が "typescript" の場合、OpenClaw は評価前にトランスパイルします。
• exec は import、require、動的インポート、およびモジュールローダー パターンを拒否します。
• exec は通常のシェル exec 実装を再帰的に公開することはありません。
• 外側のコードモード exec フックイベントには toolKind: "code_mode_exec" と toolInputKind: "javascript" | "typescript"（既知の場合）が含まれるため、ポリシーは 同じツール名を共有するコードモードセルとシェル形式の exec 呼び出しを 区別できます。

type CodeModeResult = CodeModeCompletedResult | CodeModeWaitingResult | CodeModeFailedResult;

type CodeModeCompletedResult = {
  status: "completed";
  value: unknown;
  output?: CodeModeOutput[];
  telemetry: CodeModeTelemetry;
};

type CodeModeWaitingResult = {
  status: "waiting";
  runId: string;
  reason: "pending_tools" | "yield";
  pendingToolCalls?: CodeModePendingToolCall[];
  output?: CodeModeOutput[];
  telemetry: CodeModeTelemetry;
};

type CodeModeFailedResult = {
  status: "failed";
  error: string;
  code?: CodeModeErrorCode;
  output?: CodeModeOutput[];
  telemetry: CodeModeTelemetry;
};

​

wait

type CodeModeWaitInput = {
  runId: string;
};

1. exec は、完了、失敗、または中断までコードを評価します。
2. 中断時に、OpenClaw は QuickJS VM のスナップショットを作成し、保留中のホスト 処理を記録します。
3. 保留中の処理が完了すると、wait は VM スナップショットを復元し、 安定した名前でホストコールバックを再登録します。
4. OpenClaw はネストされたツールの結果を復元済み VM に渡し、 QuickJS の保留中ジョブをドレインします。
5. wait は completed、failed、または別の waiting 結果を返します。

• runId が不明であるか、そのスナップショットがすでに期限切れです。
• 呼び出し元が、中断された実行と同じ実行/セッションスコープ内にありません。
• その runId に対する wait がすでに実行中です。
• QuickJS-WASI の復元に失敗します。
• 再開すると maxOutputBytes または maxSnapshotBytes を超過します。

​

ゲストランタイム API

declare const ALL_TOOLS: ToolCatalogEntry[];
declare const tools: ToolCatalog;
declare const MCP: Record<string, unknown>;
declare const namespaces: Record<string, unknown>;

declare function text(value: unknown): void;
declare function json(value: unknown): void;
declare function yield_control(reason?: string): Promise<void>;

type ToolCatalogEntry = {
  id: string;
  name: string;
  label?: string;
  description: string;
  source: "openclaw" | "mcp" | "client";
  sourceName?: string;
  input: string;
  output?: string;
};

type ToolCatalogEntryWithSchema = ToolCatalogEntry & {
  parameters: unknown;
  outputSchema?: unknown;
};

type ToolCatalog = {
  search(query: string, options?: { limit?: number }): Promise<ToolCatalogEntry[]>;
  describe(id: string): Promise<ToolCatalogEntryWithSchema>;
  callValue(id: string, input?: unknown): Promise<unknown>;
  call(id: string, input?: unknown): Promise<unknown>;
  [safeToolName: string]: unknown;
};

const files = await tools.search("read local file");
const fileRead = await tools.describe(files[0].id);
const content = await tools.callValue(fileRead.id, { path: "README.md" });

// If the hidden catalog has an unambiguous `web_search` entry:
const hits = await tools.web_search({ query: "OpenClaw code mode" });

​

宣言済み出力コントラクト

import { Type } from "typebox";
import { defineToolPlugin } from "openclaw/plugin-sdk/tool-plugin";

const Shipment = Type.Object(
  {
    id: Type.String(),
    paid: Type.Boolean(),
    tons: Type.Number(),
  },
  { additionalProperties: false },
);

export default defineToolPlugin({
  id: "shipping",
  name: "Shipping",
  description: "Shipment tools.",
  tools: (tool) => [
    tool({
      name: "shipping_list",
      description: "List shipments.",
      parameters: Type.Object({}),
      outputSchema: Type.Array(Shipment),
      execute: async () => loadShipments(),
    }),
  ],
});

const listed = await tools.conversations_list({ query: "build bot" });
const target = listed.conversations.find((item) => item.label === "Build bot");
if (!target) throw new Error("conversation not found");
return await tools.conversations_send({
  conversationRef: target.conversationRef,
  message: "Build finished.",
});

• レンダリングされた content ブロックやプロバイダーエンベロープではなく、JSON 互換の正確な details 値を記述します。
• 例外をスローしない成功またはエラーのすべてのバリアントを含めます。ツールに 安定した構造化結果がない場合は、outputSchema を省略します。
• 完全なクイックインデックスヒントにするには、オブジェクト層を { additionalProperties: false } で閉じます。オープンなスキーマ、サイズ超過のスキーマ、またはその他の 部分的なスキーマは tools.describe(...) を通じて引き続き利用できますが、 1 ターンでのフィールド利用は有効になりません。
• OpenClaw はツールを実行する前にスキーマをコンパイルし、その後、通常のツールフックの 完了後かつカタログ呼び出しが返る前に、最終的な details を検証します。 無効なスキーマではツールを実行できません。不一致がある場合は、値を出力せずに失敗します。
• コンパクトなヒントは決定論的で、サイズが制限されています。コンパクトなヒントでは 不十分な場合、tools.describe(...) で信頼済みの完全なスキーマを公開します。
• インストール済みの Plugin コードは、すでに信頼済みのローカルコードです。リモート MCP と クライアントのメタデータは引き続き信頼されず、これらのクイックインデックスヒントを有効にできません。

const files = await API.list("mcp");
const githubApi = await API.read("mcp/github.d.ts");

const issue = await MCP.github.createIssue({
  owner: "openclaw",
  repo: "openclaw",
  title: "Investigate gateway logs",
});

const snapshot = await MCP.chromeDevtools.takeSnapshot({ output: "markdown" });
const resource = await MCP.docs.resources.read({ uri: "memo://one" });
const prompt = await MCP.docs.prompts.get({
  name: "brief",
  arguments: { topic: "release" },
});

type McpToolResult = {
  content?: unknown[];
  structuredContent?: unknown;
  isError?: boolean;
  [key: string]: unknown;
};

declare namespace MCP.github {
  /** この TypeScript 形式の API ヘッダーを返します。 */
  function $api(toolName?: string, options?: { schema?: boolean }): Promise<McpApiHeader>;

  /**
   * GitHub issue を作成します。
   * @param owner リポジトリの所有者
   * @param repo リポジトリ名
   * @param title issue のタイトル
   */
  function createIssue(input: {
    owner: string;
    repo: string;
    title: string;
    body?: string;
  }): Promise<McpToolResult>;
}

​

内部名前空間

const open = await Issues.list({ state: "open" });
const alsoOpen = await namespaces.Issues.list({ state: "open" });
return { count: open.length, alsoCount: alsoOpen.length };

​

レジストリのライフサイクル

1. 信頼済みローダーが registerCodeModeNamespaceForPlugin(pluginId, registration) を呼び出します。
2. コードモードは実行用の非表示の ToolSearchRuntime を作成し、その 実行スコープのカタログを読み取ります。
3. createCodeModeNamespaceRuntime(ctx, catalog) は、すべての requiredToolNames が表示可能で、同じ pluginId によって所有されている登録のみを保持します。
4. 表示可能な各名前空間は、現在の実行について createScope(ctx) を呼び出し、 agentId、sessionKey、sessionId、 runId、設定、ならびに中止状態などの実行コンテキストを受け取ります。
5. スコープデータはプレーンな記述子にシリアライズされ、直接グローバルおよび namespaces.<globalName> として QuickJS に注入されます。
6. ゲスト呼び出しはワーカーブリッジを通じて一時停止し、ホスト上で名前空間パスを 解決し、その呼び出しを宣言済みの Plugin 所有カタログツールにマッピングして、 ToolSearchRuntime.callExactId を通じてそのツールを実行します。
7. 準備完了の名前空間ブリッジ呼び出しは、アクティブな exec／wait 呼び出し内で自動的に排出されます。タイムアウト時に 名前空間の処理がまだ保留中である場合、またはゲストが明示的に処理を譲る場合は、 wait が後で同じ名前空間ランタイムを再開します。
8. Plugin のロールバックまたはアンインストールでは、 clearCodeModeNamespacesForPlugin(pluginId) を呼び出し、失敗した Plugin の読み込み後も古いグローバルが 残らないようにします。

​

登録形式

import {
  createCodeModeNamespaceTool,
  registerCodeModeNamespaceForPlugin,
} from "../agents/code-mode-namespaces.js";

const pluginId = "github";

registerCodeModeNamespaceForPlugin(pluginId, {
  id: "github-issues",
  globalName: "Issues",
  description: "GitHub issue helpers for the current repository.",
  requiredToolNames: ["github_list_issues", "github_update_issue"],
  prompt: "Use Issues.list(params) and Issues.update(number, patch).",
  createScope: (ctx) => ({
    repository: ctx.config,
    list: createCodeModeNamespaceTool("github_list_issues", ([params]) => params ?? {}),
    update: createCodeModeNamespaceTool("github_update_issue", ([number, patch]) => ({
      number,
      patch,
    })),
  }),
});

createScope: () => ({
  // 誤り：これはカタログツールのライフサイクルを迂回するため、拒否されます。
  list: async () => githubClient.listIssues(),
});

​

所有権と可視性

• 必要なすべてのツールが実行カタログに存在する必要があります
• 必要なすべてのツールに sourceName === pluginId が必要です
• 必要なツールのいずれかが存在しないか、別の Plugin によって所有されている場合、 名前空間は非表示になります
• 呼び出し可能な各パスが対象にできるのは、requiredToolNames に指定された ツールのみです

​

スコープのシリアライズ規則

• raw 関数
• 循環するオブジェクトグラフ
• 安全でないパスセグメント：__proto__、constructor、prototype、空のキー、 または内部パス区切り文字を含むキー
• JavaScript 識別子ではない globalName 値
• globalName と、tools、 namespaces、text、json、yield_control、MCP、API、ALL_TOOLS、または __openclaw* などの組み込みコードモードグローバルとの衝突

​

プロンプト

{
  description: "フィクション制作サービスのヘルパー。",
  prompt:
    "Fictions.riskAudit()、Fictions.promoteIfReady(id, status)、Fictions.unpaidOver(amount) を使用します。",
}

​

クリーンアップ

clearCodeModeNamespacesForPlugin(pluginId);

​

テストチェックリスト

• 名前空間のプロンプトテキストは、基盤となるツールが表示されている場合にのみ表示される
• 別の sourceName にある同名のツールは、名前空間を公開しない
• 生のスコープ関数は拒否される
• 偽造された名前空間 ID と偽造されたパスは拒否される
• 呼び出し可能なパスは、宣言されていないツールを対象にできない
• ネストされたオブジェクトと共有参照が正しくシリアライズされる
• 名前空間の呼び出しはカタログツールを介して実行され、JSON セーフな詳細を返す
• 失敗をゲストコードで捕捉できる
• 一時停止された名前空間の呼び出しは、wait を介して再開される
• Plugin のロールバックにより、所有する名前空間登録がクリアされる

​

出力 API

• text(value) は、人間が読める出力を output 配列に追加します。
• json(value) は、JSON 互換のシリアライズ後に構造化された出力項目を追加します。
• ゲストコードが最後に返した値は、completed 結果内の value になります。

type CodeModeOutput = { type: "text"; text: string } | { type: "json"; value: unknown };

​

ツールカタログ

<source>:<owner>:<tool-name>

openclaw:core:message
openclaw:browser:browser_request
mcp:github:create_issue
client:app:select_file

​

Tool Search との連携

• OpenClaw は、tool_search_code、tool_search、tool_describe、または tool_call をモデルから参照可能なツールとして公開しない。
• 同じカタログ化の概念がゲストランタイム内に移動する。
• ゲストランタイムは、コンパクトな ALL_TOOLS メタデータと、MCP 以外のツール向けの検索、説明、呼び出しヘルパーを受け取る。
• MCP 呼び出しでは、tools.call(...) の代わりに、生成された MCP 名前空間とその $api() ヘッダーを使用する。
• ネストされた呼び出しは、Tool Search が使用するものと同じ OpenClaw エグゼキューターパスを介してディスパッチされる。

​

ツール名と衝突

• ポリシーで許可されている場合、tools.call("openclaw:core:exec", input) はシェル exec ツールを呼び出せる。
• tools.exec(...) は、シェル exec のカタログエントリに曖昧さのない安全な名前がある場合にのみインストールされる。
• コードモードの exec ツールを、tools を介して再帰的に利用することはできない。

​

ネストされたツール実行

​

実行とスナップショットのライフサイクル

• waiting 結果は、wait が再開するか有効期限が切れるまで、QuickJS スナップショット、保留中のブリッジリクエスト、およびスコープメタデータ（エージェント実行 ID、セッション ID／キー）を保存する。
• 期限切れ、誤ったセッション、誤った実行、および不明または再開中の runId 値は、個別の終了ステータスを生成しない。代わりに、code mode run is unavailable or expired. や code mode run belongs to a different session. などのメッセージを持つ failed 結果（code: "invalid_input"）として表面化する。
• 実行のスナップショットは、completed または failed に確定すると直ちにマップから削除される。また、Gateway のシャットダウン時にも破棄される（再起動後には何も残らず、これは一時的なランタイム状態である）。
• 読み取り専用の処理では、exec で restartSafe: true を設定できる。その場合 OpenClaw は、副作用のあるカタログ呼び出しと Plugin 名前空間を実行前に拒否し、一時停止された結果を再実行可能としてマークする。再起動によって wait が中断された場合、再起動からの復旧 はプロセスローカルなスナップショットを復元する代わりに、トランスクリプトからターンを再構築する。復旧ターン自体は、監査済みの読み取り専用コアツールと、明示的に再実行可能な Plugin ツールに引き続き制限される。
• OpenClaw は、プロセスごとに同時に一時停止できる実行数を制限し（64）、その上限を超える新しい一時停止を too many suspended code mode runs. で拒否する。

​

QuickJS-WASI ランタイム

​

TypeScript

​

セキュリティ境界

• QuickJS-WASI をメインイベントループ外のワーカースレッドで実行する
• quickjs-wasi を Codex や推移的パッケージ経由ではなく、直接依存関係として読み込む
• ゲスト内にはファイルシステム、ネットワーク、サブプロセス、モジュールインポート、環境変数、またはホストのグローバルオブジェクトがない
• QuickJS のメモリ制限と割り込み制限に加え、親プロセスの実時間タイムアウトを使用する
• 出力、スナップショット、ログ、および保留中の呼び出しに上限を適用する
• 狭く制限された JSON アダプターを介してホストブリッジの値をシリアライズする
• ホストエラーをプレーンなゲストエラーに変換し、ホストレルムのオブジェクトは決して渡さない
• タイムアウト、中止、セッション終了、または期限切れの際にスナップショットを破棄する
• exec、wait、および Tool Search 制御ツールへの再帰的アクセスを拒否する
• 簡易名の衝突によってカタログヘルパーが隠されることを防ぐ

​

エラーコード

type CodeModeErrorCode =
  | "invalid_input"
  | "runtime_unavailable"
  | "timeout"
  | "output_limit_exceeded"
  | "snapshot_limit_exceeded"
  | "internal_error";

​

テレメトリ

​

デバッグ

OPENCLAW_DEBUG_CODE_MODE=1 \
OPENCLAW_DEBUG_MODEL_TRANSPORT=1 \
OPENCLAW_DEBUG_MODEL_PAYLOAD=tools \
OPENCLAW_DEBUG_SSE=events \
openclaw gateway

​

実装の構成

• 設定コントラクト: tools.codeMode
• カタログビルダー: 有効なツールからコンパクトなエントリおよび ID マップへ変換
• モデルサーフェスアダプター: 表示ツールを制御ツールおよび直接ツールに置換
• QuickJS-WASI ランタイムアダプター: 読み込み、評価、スナップショット、復元、破棄
• ワーカースーパーバイザー: タイムアウト、中止、クラッシュの分離
• ブリッジアダプター: JSON セーフなホストコールバックおよび結果の配信
• TypeScript 変換アダプター
• スナップショットストア: TTL、サイズ上限、実行／セッションのスコープ
• ネストされたツール呼び出しの軌跡プロジェクション
• テレメトリカウンターおよび診断

​

検証チェックリスト

• 無効な設定では、既存のツール公開状態が変更されない
• enabled: true を含まないオブジェクト設定では、コードモードが無効なままになる
• 有効な設定では、実行時にツールが有効な場合、exec、wait、および必須の直接専用ツールのみが モデルに公開される
• ツールを使用しない未加工の実行、disableTools、および空の許可リストでは、 コードモードのペイロード検証がトリガーされない
• カタログの対象となる有効な非 MCP ツールがすべて ALL_TOOLS に表示される
• 直接専用ツールはモデルに表示されたままとなり、ALL_TOOLS には表示されない
• 拒否されたツールは ALL_TOOLS に表示されない
• tools.search、tools.describe、tools.callValue、および tools.call が OpenClaw ツールで動作する
• API.list("mcp") および API.read("mcp/<server>.d.ts") は、ブリッジ／ツール呼び出しなしで TypeScript 形式の MCP 宣言を公開する
• MCP 名前空間 $api() は、スキーマのインラインフォールバックとして引き続き利用できる
• MCP 名前空間の呼び出しは、1 つのオブジェクト入力を持つ表示可能な MCP ツールで動作し、 直接 MCP カタログエントリは tools.* に存在しない
• Tool Search の制御ツールは、モデルサーフェスと非表示カタログの両方から非表示になる
• ネストされた呼び出しで、承認およびフックの動作が維持される
• シェル exec はモデルには表示されないが、許可されている場合はカタログ ID で呼び出せる
• 再帰的なコードモードの exec および wait は、ゲストコードから呼び出せない
• 無効なパスまたは JavaScript のみのパスで TypeScript を読み込まずに、TypeScript 入力が変換および評価される
• import、require、ファイルシステム、ネットワーク、および環境へのアクセスが失敗する
• 無限ループがタイムアウトし、Gateway をブロックできない
• メモリ上限の超過によりゲスト VM が終了する
• 完了した呼び出しと中断された呼び出しの両方で、出力およびスナップショットの上限が適用される
• wait が中断されたスナップショットを再開し、最終値を返す
• 期限切れ、中止済み、誤ったセッション、および不明な runId の値が失敗する
• トランスクリプトの再生および永続化で、コードモードの制御呼び出しが維持される
• トランスクリプトおよびテレメトリに、ネストされたツール呼び出しが明確に表示される

​

E2E テスト計画

1. tools.codeMode.enabled: false を使用して Gateway を起動する。
2. 少数の直接ツールセットを使用してエージェントターンを送信する。
3. モデルに表示されるツールが変更されていないことを確認する。
4. tools.codeMode.enabled: true を使用して再起動する。
5. OpenClaw、Plugin、MCP、およびクライアントのテストツールを使用してエージェントターンを送信する。
6. モデルに表示されるツールのリストが exec、wait、および設定された 直接専用ツールのみであることを確認する。
7. exec で ALL_TOOLS を読み取り、カタログの対象となる有効なテスト ツールが存在し、直接専用ツールが存在しないことを確認する。
8. exec で、tools.search、tools.describe、および tools.callValue （または未加工の tools.call）を介して OpenClaw／Plugin／クライアントツールを呼び出す。
9. exec で API.list("mcp") および API.read("mcp/<server>.d.ts") を呼び出し、 宣言ファイルが表示可能な MCP ツールを記述していることを確認する。
10. exec で MCP.<server>.<tool>({ ...input }) を介して MCP ツールを呼び出し、 直接 MCP カタログエントリが ALL_TOOLS および tools.* に存在しないことを確認する。
11. 拒否されたツールが存在せず、推測した ID では呼び出せないことを確認する。
12. exec が waiting を返した後に解決される、ネストされたツール呼び出しを開始する。
13. wait を呼び出し、復元された VM がツール結果を受け取ることを確認する。
14. 最終回答に、復元後に生成された出力が含まれることを確認する。
15. タイムアウト、中止、およびスナップショットの期限切れによってランタイム状態がクリーンアップされることを確認する。
16. 軌跡をエクスポートし、ネストされた呼び出しが親の コードモード呼び出しの下に表示されることを確認する。

​

関連項目

• コードモードスクリプトからエージェントをファンアウトオーケストレーションするための Swarm
• Tool Search
• エージェントランタイム
• Exec ツール
• コード実行