Codusmodus

• Codex Code Mode wordt uitgevoerd binnen de Codex-codeerharness. De tool exec is een tool met vrije grammatica: het model schrijft onbewerkte JavaScript-broncode (optioneel voorafgegaan door een // @exec: {...}-pragmaregel voor uitvoeringsopties), die wordt uitgevoerd in de in-process V8 Code Mode-runtime van Codex.
• De OpenClaw-codemodus wordt uitgevoerd in de generieke OpenClaw-agentruntime en is uitgeschakeld tenzij tools.codeMode.enabled: true is geconfigureerd. De tool exec accepteert een JSON-{ code, language }-payload, die wordt uitgevoerd in een QuickJS-WASI- worker.

​

Wat het doet

• De voor het model zichtbare toollijst wordt exec, wait, plus elke alleen-directe tool zoals computer of de native-vision-lader image, waarvan het afbeeldingsresultaat de gastbridge niet kan passeren.
• exec evalueert door het model gegenereerde JavaScript of TypeScript in een geïsoleerde QuickJS-WASI-workerthread.
• Elke ingeschakelde tool die geschikt is voor de catalogus (OpenClaw-core, Plugin, MCP, client) wordt verborgen als zelfstandige modeltool en binnen het gastprogramma beschikbaar gemaakt via ALL_TOOLS en tools.
• De beschrijving van exec bevat een begrensde snelle index met exacte OpenClaw-/Plugin- catalogus-id’s, compacte invoerhints en compacte gedeclareerde uitvoerhints wanneer een vertrouwde tool een uitvoerschema biedt. Beschrijvingen, volledige schema’s, MCP-vermeldingen en overloopvermeldingen worden weggelaten; cataloguszoekacties aan gastzijde blijven de terugvaloptie.
• Gastcode doorzoekt de verborgen catalogus, beschrijft het schema van een tool en roept een tool aan via hetzelfde uitvoeringspad dat wordt gebruikt door normale agentbeurten (beleid, goedkeuringen, hooks en telemetrie blijven allemaal van toepassing).
• MCP-tools worden gegroepeerd onder de naamruimte MCP; in codemodus is dit de enige ondersteunde manier om ze aan te roepen.
• wait hervat een onderbroken uitvoering in codemodus wanneer geneste toolaanroepen nog in behandeling zijn.

​

Waarom je het gebruikt

• Kleiner promptoppervlak: providers krijgen twee besturingstools, een begrensde index van native tools en alleen de weinige vereiste directe tools in plaats van tientallen of honderden volledige toolschema’s.
• Betere orkestratie: het model kan lussen, samenvoegingen, kleine transformaties, voorwaardelijke logica en parallelle geneste toolaanroepen binnen één codecel gebruiken.
• Minder modelrondgangen: met een gedeclareerd uitvoercontract kan het model een toolresultaat in één exec aanroepen en transformeren; onbekende uitvoer blijft eerst onbewerkt.
• Providerneutraal: werkt voor OpenClaw-, Plugin-, MCP- en clienttools zonder afhankelijk te zijn van providereigen code-uitvoering.
• Stopt veilig: als codemodus is ingeschakeld maar de QuickJS-WASI-runtime niet beschikbaar is, mislukt de uitvoering in plaats van stilzwijgend terug te vallen op brede directe blootstelling van tools.

​

Snelstart

​

Codemodus inschakelen

{
  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,
    },
  },
}

​

Wat het model doet

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

​

Het actieve oppervlak verifiëren

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

​

Swarm gebruiken voor uitwaaiering van agents

​

Technische rondleiding

​

Runtimestatus

​

Reikwijdte

​

Termen

• Codemodus: de OpenClaw-runtimemodus die cataloguscompatibele modeltools verbergt en exec, wait plus vereiste alleen-directe tools beschikbaar stelt.
• Gastruntime: de QuickJS-WASI JavaScript-VM die modelcode evalueert.
• Hostbridge: het beperkte JSON-compatibele callbackoppervlak van gastcode terug naar OpenClaw.
• Catalogus: de uitvoeringsgebonden lijst van effectieve tools na normale oplossing van toolbeleid, Plugins, MCP en clienttools.
• Geneste toolaanroep: een toolaanroep die vanuit gastcode via de hostbridge wordt uitgevoerd.
• Snapshot: geserialiseerde QuickJS-WASI-VM-status die wordt opgeslagen zodat wait een onderbroken uitvoering in codemodus kan voortzetten.

​

Configuratie

​

Activering

1. Bepaal het beleid voor de agent, het model, de provider, de sandbox, het kanaal, de afzender en de run.
2. Bouw de effectieve OpenClaw-toollijst en voeg in aanmerking komende plugin-, MCP- en clienttools toe.
3. Pas het toestaan/weigeren-beleid toe.
4. Als tools.codeMode.enabled onwaar is, ga je door met de normale beschikbaarstelling van tools.
5. Als dit is ingeschakeld en er tools actief zijn voor de run, behoud je de vereiste tools die alleen rechtstreeks beschikbaar zijn en registreer je elke effectieve tool die voor de catalogus in aanmerking komt in de code-modecatalogus.
6. Verwijder de gecatalogiseerde tools uit de voor het model zichtbare lijst; voeg exec en wait toe naast de behouden tools die alleen rechtstreeks beschikbaar zijn.

​

Voor het model zichtbare tools

​

exec

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

• Een van code of command mag niet leeg zijn.
• code is het gedocumenteerde veld dat voor het model zichtbaar is.
• command wordt geaccepteerd als een exec-compatibele alias voor hookbeleid en vertrouwde herschrijvingen (de normale OpenClaw-shell-exectool gebruikt ook een command- veld); wanneer beide aanwezig zijn, moeten de waarden overeenkomen.
• language is standaard "javascript"; het schema stelt dit beschikbaar als een platte string-enum ("javascript" | "typescript"), niet als een oneOf/anyOf-union, omdat sommige providers die vormen weigeren.
• Als language "typescript" is, transpileert OpenClaw vóór de evaluatie.
• exec weigert import, require, dynamische import en moduleloaderpatronen.
• exec stelt de normale shellimplementatie van exec nooit recursief beschikbaar.
• Buitenste code-mode-exec-hookgebeurtenissen bevatten toolKind: "code_mode_exec" en toolInputKind: "javascript" | "typescript" (indien bekend), zodat beleid code-modecellen kan onderscheiden van shellachtige exec-aanroepen met dezelfde toolnaam.

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 evalueert code totdat deze is voltooid, mislukt of wordt onderbroken.
2. Bij onderbreking maakt OpenClaw een snapshot van de QuickJS-VM en registreert het hostwerk in behandeling.
3. Wanneer het werk in behandeling is afgehandeld, herstelt wait de VM-snapshot en registreert het hostcallbacks opnieuw met stabiele namen.
4. OpenClaw levert geneste toolresultaten aan de herstelde VM en handelt QuickJS-taken in behandeling af.
5. wait retourneert completed, failed of nog een waiting-resultaat.

• runId onbekend is of de snapshot ervan al is verlopen.
• de aanroeper zich niet binnen hetzelfde run-/sessiebereik bevindt als de onderbroken run.
• er al een wait wordt uitgevoerd voor die runId.
• het herstel van QuickJS-WASI mislukt.
• hervatten maxOutputBytes of maxSnapshotBytes zou overschrijden.

​

Guest-runtime-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" });

// Als de verborgen catalogus een ondubbelzinnige `web_search`-vermelding heeft:
const hits = await tools.web_search({ query: "OpenClaw code mode" });

​

Gedeclareerde uitvoercontracten

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.",
});

• Beschrijf de exacte JSON-compatibele waarde details, niet gerenderde content-blokken of een provider-envelop.
• Neem elke niet-werpende succes- of foutvariant op. Laat outputSchema weg wanneer de tool geen stabiel gestructureerd resultaat heeft.
• Sluit objectlagen af met { additionalProperties: false } voor een volledige snelle-indexhint. Open, te grote of anderszins gedeeltelijke schema’s blijven beschikbaar via tools.describe(...), maar maken veldgebruik in één beurt niet mogelijk.
• OpenClaw compileert het schema voordat de tool wordt uitgevoerd en valideert vervolgens de definitieve details na de normale toolhooks en voordat een catalogusaanroep retourneert. Met een ongeldig schema kan de tool niet worden uitgevoerd; bij een afwijking mislukt de uitvoering zonder de waarde af te drukken.
• Compacte hints zijn deterministisch en begrensd. tools.describe(...) stelt het volledige vertrouwde schema beschikbaar wanneer de compacte hint niet volstaat.
• Geïnstalleerde plugincode is al vertrouwde lokale code. Externe MCP- en clientmetagegevens blijven onvertrouwd en kunnen deze snelle-indexhints niet inschakelen.

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 {
  /** Retourneer deze API-header in TypeScript-stijl. */
  function $api(toolName?: string, options?: { schema?: boolean }): Promise<McpApiHeader>;

  /**
   * Maak een GitHub-issue.
   * @param owner Eigenaar van de repository
   * @param repo Naam van de repository
   * @param title Titel van het issue
   */
  function createIssue(input: {
    owner: string;
    repo: string;
    title: string;
    body?: string;
  }): Promise<McpToolResult>;
}

​

Interne naamruimten

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

​

Levenscyclus van het register

1. Een vertrouwde loader roept registerCodeModeNamespaceForPlugin(pluginId, registration) aan.
2. De codemodus maakt de verborgen ToolSearchRuntime voor de uitvoering en leest de catalogus voor die uitvoering.
3. createCodeModeNamespaceRuntime(ctx, catalog) behoudt alleen registraties waarvan alle requiredToolNames zichtbaar zijn en eigendom zijn van dezelfde pluginId.
4. Elke zichtbare naamruimte roept createScope(ctx) aan voor de huidige uitvoering en ontvangt uitvoeringscontext zoals agentId, sessionKey, sessionId, runId, configuratie en afbreekstatus.
5. Bereikgegevens worden geserialiseerd naar een gewone descriptor en in QuickJS geïnjecteerd als directe globale variabelen en namespaces.<globalName>.
6. Gastaanroepen worden via de workerbridge onderbroken, lossen het naamruimtepad op de host op, koppelen de aanroep aan een gedeclareerde catalogustool die eigendom is van de plugin en voeren die tool uit via ToolSearchRuntime.callExactId.
7. Gereedstaande bridgeaanroepen voor naamruimten worden automatisch afgehandeld binnen de actieve aanroep exec/wait; als er bij de time-out nog naamruimtewerk in behandeling is of de gast expliciet de uitvoering overdraagt, hervat wait later dezelfde naamruimte-runtime.
8. Bij terugdraaien of verwijderen van een plugin wordt clearCodeModeNamespacesForPlugin(pluginId) aangeroepen, zodat verouderde globale variabelen een mislukte pluginlaadbewerking niet overleven.

​

Registratiestructuur

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

const pluginId = "github";

registerCodeModeNamespaceForPlugin(pluginId, {
  id: "github-issues",
  globalName: "Issues",
  description: "GitHub-issuehulpmiddelen voor de huidige repository.",
  requiredToolNames: ["github_list_issues", "github_update_issue"],
  prompt: "Gebruik Issues.list(params) en 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: () => ({
  // Fout: dit omzeilt de levenscyclus van de catalogustool en wordt geweigerd.
  list: async () => githubClient.listIssues(),
});

​

Eigendom en zichtbaarheid

• elke vereiste tool moet in de uitvoeringscatalogus bestaan
• elke vereiste tool moet sourceName === pluginId hebben
• de naamruimte wordt verborgen wanneer een vereiste tool ontbreekt of eigendom is van een andere plugin
• elk aanroepbaar pad mag alleen een tool aanroepen die in requiredToolNames wordt genoemd

​

Serialisatieregels voor bereiken

• onbewerkte functies
• cyclische objectgrafen
• onveilige padsegmenten: __proto__, constructor, prototype, lege sleutels of sleutels die het interne padscheidingsteken bevatten
• globalName-waarden die geen JavaScript-identificatoren zijn
• globalName-conflicten met ingebouwde globale variabelen van de codemodus, zoals tools, namespaces, text, json, yield_control, MCP, API, ALL_TOOLS of __openclaw*

​

Prompts

{
  description: "Helpers voor de fictieproductieservice.",
  prompt:
    "Gebruik Fictions.riskAudit(), Fictions.promoteIfReady(id, status) en Fictions.unpaidOver(amount).",
}

​

Opschoning

clearCodeModeNamespacesForPlugin(pluginId);

​

Testchecklist

• tekst van de namespaceprompt verschijnt alleen wanneer de achterliggende tools zichtbaar zijn
• gelijknamige tools van een andere sourceName stellen de namespace niet beschikbaar
• onbewerkte bereikfuncties worden geweigerd
• vervalste namespace-id’s en vervalste paden worden geweigerd
• aanroepbare paden kunnen niet verwijzen naar niet-gedeclareerde tools
• geneste objecten en gedeelde verwijzingen worden correct geserialiseerd
• namespaceaanroepen worden via catalogustools uitgevoerd en retourneren JSON-veilige details
• gastcode kan fouten afvangen
• opgeschorte namespaceaanroepen worden hervat via wait
• het terugdraaien van een Plugin wist de bijbehorende namespaceregistraties

​

Uitvoer-API

• text(value) voegt voor mensen leesbare uitvoer toe aan de array output.
• json(value) voegt na JSON-compatibele serialisatie een gestructureerd uitvoeritem toe.
• De uiteindelijke geretourneerde waarde van de gastcode wordt value in een completed-resultaat.

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

​

Toolcatalogus

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

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

​

Interactie met Tool Search

• OpenClaw stelt tool_search_code, tool_search, tool_describe en tool_call niet beschikbaar als voor het model zichtbare tools.
• Hetzelfde catalogusidee verhuist naar de gast-runtime.
• De gast-runtime ontvangt compacte ALL_TOOLS-metadata en helpers voor zoeken/beschrijven/ aanroepen voor niet-MCP-tools.
• MCP-aanroepen gebruiken de gegenereerde namespace MCP en de bijbehorende $api()-headers in plaats van tools.call(...).
• Geneste aanroepen worden verzonden via hetzelfde uitvoerderpad van OpenClaw dat Tool Search gebruikt.

​

Toolnamen en conflicten

• tools.call("openclaw:core:exec", input) kan de shell-uitvoeringstool aanroepen als het beleid dit toestaat.
• tools.exec(...) wordt alleen geïnstalleerd als de catalogusvermelding voor shell-uitvoering een ondubbelzinnige, veilige naam heeft.
• de codemodustool exec is nooit recursief beschikbaar via tools.

​

Geneste tooluitvoering

​

Levenscyclus van uitvoeringen en momentopnamen

• Een waiting-resultaat bewaart de QuickJS-momentopname, wachtende brugverzoeken en bereikmetadata (agentuitvoerings-id, sessie-id/-sleutel) totdat wait deze hervat of deze verloopt.
• Verlopen, een verkeerde sessie, een verkeerde uitvoering en onbekende/reeds hervattende runId- waarden leveren geen afzonderlijke eindstatus op; ze worden weergegeven als een failed-resultaat (code: "invalid_input") met een bericht zoals code mode run is unavailable or expired. of code mode run belongs to a different session..
• De momentopname van een uitvoering wordt uit de kaart verwijderd zodra deze eindigt als completed of failed, of wordt verwijderd wanneer de Gateway wordt afgesloten (niets overleeft een herstart: dit is tijdelijke runtimestatus).
• Voor alleen-lezenwerk kan exec restartSafe: true instellen. OpenClaw weigert dan catalogusaanroepen en Pluginnamespaces met neveneffecten vóór uitvoering en markeert opgeschorte resultaten als veilig voor herhaling. Als een herstart wait onderbreekt, reconstrueert herstel na herstart de beurt vanuit het transcript in plaats van de proceslokale momentopname te herstellen. De herstel- beurt zelf blijft beperkt tot gecontroleerde alleen-lezenkerntools en expliciet herhalingsveilige Plugintools.
• OpenClaw begrenst het aantal gelijktijdig opgeschorte uitvoeringen per proces (64) en weigert nieuwe opschortingen boven die limiet met too many suspended code mode runs..

​

QuickJS-WASI-runtime

​

TypeScript

​

Beveiligingsgrens

• voert QuickJS-WASI buiten de hoofdgebeurtenislus uit, in een workerthread
• laadt quickjs-wasi als directe afhankelijkheid, niet via Codex of een transitief pakket
• geen bestandssysteem, netwerk, subproces, module-import, omgevingsvariabelen of globale hostobjecten in de gast
• gebruikt geheugen- en onderbrekingslimieten van QuickJS plus een wandklok- time-out van het bovenliggende proces
• handhaaft limieten voor uitvoer, momentopnamen, logboeken en wachtende aanroepen
• serialiseert hostbrugwaarden via een beperkte JSON-adapter
• converteert hostfouten naar gewone gastfouten, nooit naar objecten uit het hostbereik
• verwijdert momentopnamen bij time-out, afbreken, sessie-einde of verlopen
• weigert recursieve toegang tot exec, wait en besturingstools van Tool Search
• voorkomt dat conflicten tussen gemaksnamen catalogushelpers overschaduwen

​

Foutcodes

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

​

Telemetrie

​

Foutopsporing

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

​

Implementatie-indeling

• configuratiecontract: tools.codeMode
• catalogusbouwer: effectieve tools omzetten in compacte vermeldingen en een id-toewijzing
• adapter voor het modeloppervlak: zichtbare tools vervangen door besturings-/directe tools
• QuickJS-WASI-runtimeadapter: laden, evalueren, momentopname maken, herstellen, vrijgeven
• workersupervisor: time-out, afbreken, crashisolatie
• bridge-adapter: JSON-veilige hostcallbacks en levering van resultaten
• TypeScript-transformatieadapter
• opslag voor momentopnamen: TTL, groottelimieten, afbakening per uitvoering/sessie
• trajectieprojectie voor geneste toolaanroepen
• telemetrietellers en diagnostiek

​

Validatiechecklist

• uitgeschakelde configuratie de bestaande beschikbaarstelling van tools ongewijzigd laat
• objectconfiguratie zonder enabled: true de codemodus uitgeschakeld laat
• ingeschakelde configuratie exec, wait en uitsluitend vereiste direct-only tools aan het model beschikbaar stelt wanneer tools actief zijn voor de uitvoering
• onbewerkte uitvoeringen zonder tools, disableTools en lege toelatingslijsten geen payloadhandhaving voor de codemodus activeren
• alle effectieve niet-MCP-tools die voor de catalogus in aanmerking komen in ALL_TOOLS verschijnen
• direct-only tools zichtbaar blijven voor het model en niet in ALL_TOOLS verschijnen
• geweigerde tools niet in ALL_TOOLS verschijnen
• tools.search, tools.describe, tools.callValue en tools.call werken voor OpenClaw-tools
• API.list("mcp") en API.read("mcp/<server>.d.ts") MCP-declaraties in TypeScript-stijl beschikbaar stellen zonder een bridge-/toolaanroep
• MCP-namespace $api() beschikbaar blijft als inline terugvaloptie voor schema’s
• MCP-namespaceaanroepen werken voor zichtbare MCP-tools met één objectinvoer, terwijl directe MCP-catalogusvermeldingen ontbreken in tools.*
• besturingstools van Tool Search verborgen zijn voor zowel het modeloppervlak als de verborgen catalogus
• geneste aanroepen het goedkeurings- en hookgedrag behouden
• shell exec verborgen is voor het model, maar via de catalogus-id kan worden aangeroepen wanneer dit is toegestaan
• recursieve codemodus-exec en wait niet vanuit gastcode kunnen worden aangeroepen
• TypeScript-invoer wordt getransformeerd en geëvalueerd zonder TypeScript te laden op uitgeschakelde of uitsluitend JavaScript gebruikende paden
• import, require en toegang tot het bestandssysteem, netwerk en de omgeving mislukken
• oneindige lussen een time-out krijgen en de Gateway niet kunnen blokkeren
• fouten door geheugenlimieten de gast-VM beëindigen
• uitvoer- en momentopnamelimieten worden afgedwongen voor voltooide en onderbroken aanroepen
• wait een onderbroken momentopname hervat en de uiteindelijke waarde retourneert
• verlopen, afgebroken, bij een verkeerde sessie behorende en onbekende runId-waarden mislukken
• het opnieuw afspelen en opslaan van transcripties besturingsaanroepen van de codemodus behouden
• transcriptie en telemetrie geneste toolaanroepen duidelijk weergeven

​

E2E-testplan

1. Start een Gateway met tools.codeMode.enabled: false.
2. Verstuur een agentbeurt met een kleine set directe tools.
3. Controleer dat de voor het model zichtbare tools ongewijzigd zijn.
4. Start opnieuw met tools.codeMode.enabled: true.
5. Verstuur een agentbeurt met testtools voor OpenClaw, plugins, MCP en clients.
6. Controleer dat de voor het model zichtbare lijst met tools exec, wait en uitsluitend geconfigureerde direct-only tools bevat.
7. Lees in exec ALL_TOOLS en controleer dat de effectieve testtools die voor de catalogus in aanmerking komen aanwezig zijn, terwijl direct-only tools ontbreken.
8. Roep in exec OpenClaw-/plugin-/clienttools aan via tools.search, tools.describe en tools.callValue (of onbewerkte tools.call).
9. Roep in exec API.list("mcp") en API.read("mcp/<server>.d.ts") aan en controleer dat de declaratiebestanden zichtbare MCP-tools beschrijven.
10. Roep in exec MCP-tools aan via MCP.<server>.<tool>({ ...input }) en controleer dat directe MCP-catalogusvermeldingen ontbreken in ALL_TOOLS en tools.*.
11. Controleer dat geweigerde tools ontbreken en niet via een geraden id kunnen worden aangeroepen.
12. Start een geneste toolaanroep die wordt voltooid nadat exec waiting retourneert.
13. Roep wait aan en controleer dat de herstelde VM het toolresultaat ontvangt.
14. Controleer dat het uiteindelijke antwoord uitvoer bevat die na het herstel is geproduceerd.
15. Controleer dat time-out, afbreken en het verlopen van de momentopname de runtimestatus opschonen.
16. Exporteer het traject en controleer dat geneste aanroepen zichtbaar zijn onder de bovenliggende codemodusaanroep.

​

Gerelateerd

• Swarm voor fan-out-agentorkestratie vanuit codemodusscripts
• Tool Search
• Agentruntimes
• Exec-tool
• Code-uitvoering