Kod Modu

• Codex Code Mode, Codex kodlama düzeneği içinde çalışır. exec aracı serbest biçimli dil bilgisine sahip bir araçtır: model, Codex’in süreç içi V8 Code Mode çalışma zamanında yürütülen ham JavaScript kaynak kodunu (isteğe bağlı olarak yürütme seçenekleri için bir // @exec: {...} pragma satırıyla başlayan) yazar.
• OpenClaw kod modu, genel OpenClaw ajan çalışma zamanında çalışır ve tools.codeMode.enabled: true yapılandırılmadıkça devre dışıdır. exec aracı, QuickJS-WASI iş parçacığında yürütülen bir JSON { code, language } yükü alır.

​

Ne yapar?

• Modelin görebildiği araç listesi exec, wait ve görüntü sonucu konuk köprüsünden geçemeyen computer ya da yerel görüntü image yükleyicisi gibi yalnızca doğrudan kullanılabilen araçlardan oluşur.
• exec, model tarafından oluşturulan JavaScript veya TypeScript’i yalıtılmış bir QuickJS-WASI işçi iş parçacığında değerlendirir.
• Kataloğa uygun etkinleştirilmiş her araç (OpenClaw çekirdeği, plugin, MCP, istemci), bağımsız bir model aracı olarak gizlenir ve konuk programında ALL_TOOLS ile tools üzerinden kullanıma sunulur.
• exec açıklaması; kesin OpenClaw/plugin katalog kimliklerinin, kompakt girdi ipuçlarının ve güvenilir bir araç çıktı şeması sağladığında kompakt bildirilmiş çıktı ipuçlarının sınırlı bir hızlı dizinini taşır. Açıklamaları, tam şemaları, MCP girdilerini ve kapasiteyi aşan girdileri içermez; konuk tarafındaki katalog araması yedek yöntem olarak kalır.
• Konuk kodu gizli katalogda arama yapar, bir aracın şemasını açıklar ve normal ajan turlarında kullanılan yürütme yoluyla bir aracı çağırır (politika, onaylar, kancalar ve telemetri uygulanmaya devam eder).
• MCP araçları MCP ad alanı altında gruplandırılır; kod modunda bunları çağırmanın desteklenen tek yolu budur.
• wait, iç içe araç çağrıları hâlâ beklemedeyken askıya alınmış bir kod modu çalışmasını sürdürür.

​

Neden kullanılmalı?

• Daha küçük istem yüzeyi: sağlayıcılara düzinelerce veya yüzlerce tam araç şeması yerine iki denetim aracı, sınırlı bir yerel araç dizini ve yalnızca gerekli birkaç doğrudan araç sağlanır.
• Daha iyi orkestrasyon: model, tek bir kod hücresinde döngüler, birleştirmeler, küçük dönüşümler, koşullu mantık ve paralel iç içe araç çağrıları kullanabilir.
• Daha az model gidiş dönüşü: bildirilmiş bir çıktı sözleşmesi, modelin bir araç sonucunu tek bir exec içinde çağırıp dönüştürmesini sağlar; bilinmeyen çıktılarda önce ham veri kullanılır.
• Sağlayıcıdan bağımsız: sağlayıcıya özgü kod yürütmeye bağlı olmadan OpenClaw, plugin, MCP ve istemci araçlarıyla çalışır.
• Güvenli biçimde başarısız olur: kod modu etkinleştirilmiş ancak QuickJS-WASI çalışma zamanı kullanılamıyorsa çalışma, sessizce geniş kapsamlı doğrudan araç erişimine geri dönmek yerine başarısız olur.

​

Hızlı başlangıç

​

Code Mode’u etkinleştirme

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

​

Modelin yaptığı işlemler

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

​

Etkin yüzeyi doğrulama

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

​

Ajanları paralel çalıştırmak için Swarm kullanma

​

Teknik inceleme

​

Çalışma zamanı durumu

​

Kapsam

​

Terimler

• Kod modu: kataloğa uyumlu model araçlarını gizleyen ve exec, wait ile gerekli yalnızca doğrudan araçları kullanıma sunan OpenClaw çalışma zamanı modu.
• Konuk çalışma zamanı: model kodunu değerlendiren QuickJS-WASI JavaScript sanal makinesi.
• Ana makine köprüsü: konuk kodundan OpenClaw’a geri dönen dar, JSON uyumlu geri çağırma yüzeyi.
• Katalog: normal araç politikası, plugin, MCP ve istemci aracı çözümlemesinden sonraki etkin araçların çalışma kapsamındaki listesi.
• İç içe araç çağrısı: konuk kodundan ana makine köprüsü üzerinden yapılan bir araç çağrısı.
• Anlık görüntü: wait aracının askıya alınmış bir kod modu çalışmasını sürdürebilmesi için kaydedilen serileştirilmiş QuickJS-WASI sanal makine durumu.

​

Yapılandırma

​

Etkinleştirme

1. Ajanı, modeli, sağlayıcıyı, korumalı alanı, kanalı, göndereni ve çalıştırma politikasını çözümleyin.
2. Uygun plugin, MCP ve istemci araçlarını ekleyerek etkin OpenClaw araç listesini oluşturun.
3. İzin verme/reddetme politikasını uygulayın.
4. tools.codeMode.enabled false ise normal araç sunumuyla devam edin.
5. Etkinleştirilmişse ve araçlar çalıştırma için etkinse gerekli yalnızca doğrudan araçları koruyun ve katalog için uygun her etkin aracı kod modu kataloğuna kaydedin.
6. Kataloglanan araçları modelin görebildiği listeden kaldırın; korunan yalnızca doğrudan araçların yanına exec ve wait ekleyin.

​

Modelin görebildiği araçlar

​

exec

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

• code veya command öğelerinden biri boş olmamalıdır.
• code, belgelenmiş ve modele yönelik alandır.
• command, hook politikaları ve güvenilir yeniden yazımlar için exec uyumlu bir diğer ad olarak kabul edilir (normal OpenClaw kabuk exec aracı da bir command alanı kullanır); ikisi de mevcutsa değerler eşleşmelidir.
• language varsayılan olarak "javascript" değerini alır; bazı sağlayıcılar bu şekilleri reddettiğinden şema bunu bir oneOf/anyOf birleşimi olarak değil, düz bir dize numaralandırması ("javascript" | "typescript") olarak sunar.
• language, "typescript" ise OpenClaw değerlendirmeden önce kodu dönüştürür.
• exec; import, require, dinamik içe aktarma ve modül yükleyici kalıplarını reddeder.
• exec, normal kabuk exec uygulamasını hiçbir zaman yinelemeli olarak sunmaz.
• Dış kod modu exec hook olayları, politikaların aynı araç adını paylaşan kod modu hücrelerini kabuk tarzı exec çağrılarından ayırt edebilmesi için toolKind: "code_mode_exec" ve toolInputKind: "javascript" | "typescript" (biliniyorsa) taşır.

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, kodu tamamlanma, başarısızlık veya askıya alınma gerçekleşene kadar değerlendirir.
2. Askıya alınma sırasında OpenClaw, QuickJS VM’nin anlık görüntüsünü alır ve bekleyen ana makine işini kaydeder.
3. Bekleyen iş sonuçlandığında wait, VM anlık görüntüsünü geri yükler ve ana makine geri çağrılarını kararlı adlarla yeniden kaydeder.
4. OpenClaw, iç içe araç sonuçlarını geri yüklenen VM’ye iletir ve bekleyen QuickJS işlerini tüketir.
5. wait; completed, failed veya başka bir waiting sonucu döndürür.

• runId bilinmiyorsa veya anlık görüntüsünün süresi zaten dolmuşsa.
• çağıran, askıya alınmış çalıştırmayla aynı çalıştırma/oturum kapsamında değilse.
• bu runId için zaten işlemde olan bir wait varsa.
• QuickJS-WASI geri yüklemesi başarısız olursa.
• sürdürme işlemi maxOutputBytes veya maxSnapshotBytes sınırını aşacaksa.

​

Konuk çalışma zamanı API’si

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

// Gizli katalogda belirsizlik taşımayan bir `web_search` girdisi varsa:
const hits = await tools.web_search({ query: "OpenClaw code mode" });

​

Bildirilmiş çıktı sözleşmeleri

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: "derleme botu" });
const target = listed.conversations.find((item) => item.label === "Derleme botu");
if (!target) throw new Error("konuşma bulunamadı");
return await tools.conversations_send({
  conversationRef: target.conversationRef,
  message: "Derleme tamamlandı.",
});

• İşlenmiş content bloklarını veya bir sağlayıcı zarfını değil, tam olarak JSON uyumlu details değerini açıklayın.
• Fırlatma yapmayan her başarı veya hata varyantını ekleyin. Aracın kararlı yapılandırılmış bir sonucu yoksa outputSchema öğesini atlayın.
• Tam bir hızlı dizin ipucu için nesne katmanlarını { additionalProperties: false } ile kapatın. Açık, aşırı büyük veya başka şekilde kısmi şemalara tools.describe(...) üzerinden erişilebilir; ancak bunlar alanların tek turda kullanımını etkinleştirmez.
• OpenClaw, aracı çalıştırmadan önce şemayı derler; ardından normal araç kancalarından sonra ve bir katalog çağrısı dönmeden önce nihai details değerini doğrular. Geçersiz bir şemayla araç çalıştırılamaz; uyumsuzluk, değer yazdırılmadan başarısız olur.
• Kompakt ipuçları deterministik ve sınırlıdır. Kompakt ipucu yetersiz olduğunda tools.describe(...) tam güvenilir şemayı sunar.
• Yüklü plugin kodu zaten güvenilir yerel koddur. Uzak MCP ve istemci meta verileri güvenilmez kalır ve bu hızlı dizin ipuçlarına katılamaz.

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: "Gateway günlüklerini araştır",
});

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 {
  /** Bu TypeScript tarzı API üstbilgisini döndürür. */
  function $api(toolName?: string, options?: { schema?: boolean }): Promise<McpApiHeader>;

  /**
   * Bir GitHub sorunu oluşturur.
   * @param owner Depo sahibi
   * @param repo Depo adı
   * @param title Sorun başlığı
   */
  function createIssue(input: {
    owner: string;
    repo: string;
    title: string;
    body?: string;
  }): Promise<McpToolResult>;
}

​

Dahili ad alanları

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

​

Kayıt defteri yaşam döngüsü

1. Güvenilir bir yükleyici registerCodeModeNamespaceForPlugin(pluginId, registration) çağrısını yapar.
2. Kod modu çalıştırma için gizli ToolSearchRuntime öğesini oluşturur ve çalıştırma kapsamlı kataloğunu okur.
3. createCodeModeNamespaceRuntime(ctx, catalog), yalnızca tüm requiredToolNames öğeleri görünür olan ve aynı pluginId tarafından sahiplenilen kayıtları tutar.
4. Her görünür ad alanı mevcut çalıştırma için createScope(ctx) çağrısını yaparak agentId, sessionKey, sessionId, runId, yapılandırma ve iptal durumu gibi çalıştırma bağlamını alır.
5. Kapsam verileri düz bir tanımlayıcıya serileştirilir ve doğrudan globaller ile namespaces.<globalName> olarak QuickJS’e enjekte edilir.
6. Konuk çağrıları çalışan köprüsü üzerinden askıya alınır, ana makinedeki ad alanı yolu çözümlenir, çağrı bildirilmiş ve plugine ait bir katalog aracına eşlenir ve bu araç ToolSearchRuntime.callExactId üzerinden yürütülür.
7. Hazır ad alanı köprü çağrıları etkin exec/wait çağrısı içinde otomatik olarak boşaltılır; zaman aşımında ad alanı çalışması hâlâ bekliyorsa veya konuk açıkça yürütmeyi devrederse, wait daha sonra aynı ad alanı çalışma zamanını sürdürür.
8. Plugin geri alma veya kaldırma işlemi, başarısız bir plugin yüklemesinden sonra eski globallerin kalmaması için clearCodeModeNamespacesForPlugin(pluginId) çağrısını yapar.

​

Kayıt biçimi

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

const pluginId = "github";

registerCodeModeNamespaceForPlugin(pluginId, {
  id: "github-issues",
  globalName: "Issues",
  description: "Mevcut depo için GitHub sorunu yardımcıları.",
  requiredToolNames: ["github_list_issues", "github_update_issue"],
  prompt: "Issues.list(params) ve Issues.update(number, patch) kullanın.",
  createScope: (ctx) => ({
    repository: ctx.config,
    list: createCodeModeNamespaceTool("github_list_issues", ([params]) => params ?? {}),
    update: createCodeModeNamespaceTool("github_update_issue", ([number, patch]) => ({
      number,
      patch,
    })),
  }),
});

createScope: () => ({
  // Yanlış: bu, katalog aracı yaşam döngüsünü atlar ve reddedilir.
  list: async () => githubClient.listIssues(),
});

​

Sahiplik ve görünürlük

• gerekli her araç çalıştırma kataloğunda bulunmalıdır
• gerekli her araçta sourceName === pluginId bulunmalıdır
• gerekli herhangi bir araç yoksa veya başka bir plugin tarafından sahiplenilmişse ad alanı gizlenir
• çağrılabilir her yol yalnızca requiredToolNames içinde adı geçen bir aracı hedefleyebilir

​

Kapsam serileştirme kuralları

• ham işlevler
• döngüsel nesne grafikleri
• güvenli olmayan yol segmentleri: __proto__, constructor, prototype, boş anahtarlar veya dahili yol ayırıcısını içeren anahtarlar
• JavaScript tanımlayıcıları olmayan globalName değerleri
• globalName değerinin tools, namespaces, text, json, yield_control, MCP, API, ALL_TOOLS veya __openclaw* gibi yerleşik kod modu globalleriyle çakışması

​

İstemler

{
  description: "Kurgu üretim hizmeti yardımcıları.",
  prompt:
    "Fictions.riskAudit(), Fictions.promoteIfReady(id, status) ve Fictions.unpaidOver(amount) kullanın.",
}

​

Temizleme

clearCodeModeNamespacesForPlugin(pluginId);

​

Test kontrol listesi

• ad alanı istem metni yalnızca destekleyen araçlar görünür olduğunda gösterilir
• başka bir sourceName içindeki aynı adlı araçlar ad alanını açığa çıkarmaz
• ham kapsam işlevleri reddedilir
• sahte ad alanı kimlikleri ve sahte yollar reddedilir
• çağrılabilir yollar bildirilmemiş araçları hedefleyemez
• iç içe nesneler ve paylaşılan başvurular doğru şekilde serileştirilir
• ad alanı çağrıları katalog araçları üzerinden yürütülür ve JSON açısından güvenli ayrıntılar döndürür
• hatalar konuk kodu tarafından yakalanabilir
• askıya alınan ad alanı çağrıları wait üzerinden sürdürülür
• Plugin geri alma işlemi, sahip olunan ad alanı kayıtlarını temizler

​

Çıktı API’si

• text(value), insan tarafından okunabilir çıktıyı output dizisine ekler.
• json(value), JSON uyumlu serileştirmeden sonra yapılandırılmış bir çıktı öğesi ekler.
• Konuk kodunun döndürdüğü son değer, bir completed sonucunda value olur.

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

​

Araç kataloğu

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

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

​

Araç Arama etkileşimi

• OpenClaw; tool_search_code, tool_search, tool_describe veya tool_call öğelerini model tarafından görülebilen araçlar olarak sunmaz.
• Aynı kataloglama yaklaşımı konuk çalışma zamanının içine taşınır.
• Konuk çalışma zamanı, MCP dışı araçlar için kompakt ALL_TOOLS meta verileri ve arama/açıklama/çağrı yardımcıları alır.
• MCP çağrıları, tools.call(...) yerine oluşturulan MCP ad alanını ve onun $api() başlıklarını kullanır.
• İç içe çağrılar, Araç Arama’nın kullandığı aynı OpenClaw yürütücü yolu üzerinden yönlendirilir.

​

Araç adları ve çakışmalar

• tools.call("openclaw:core:exec", input), politika izin veriyorsa kabuk yürütme aracını çağırabilir.
• tools.exec(...), yalnızca kabuk yürütme katalog girdisinin kesin ve güvenli bir adı varsa kurulur.
• kod modu exec aracı, tools üzerinden hiçbir zaman özyinelemeli olarak kullanılamaz.

​

İç içe araç yürütme

​

Çalıştırma ve anlık görüntü yaşam döngüsü

• Bir waiting sonucu; QuickJS anlık görüntüsünü, bekleyen köprü isteklerini ve kapsam meta verilerini (aracı çalıştırma kimliği, oturum kimliği/anahtarı), wait onu sürdürene veya süresi dolana kadar saklar.
• Süresi dolmuş, yanlış oturumlu, yanlış çalıştırmalı ve bilinmeyen/zaten sürdürülen runId değerleri ayrı bir son durum oluşturmaz; code mode run is unavailable or expired. veya code mode run belongs to a different session. gibi bir iletiyle failed sonucu (code: "invalid_input") olarak gösterilir.
• Bir çalıştırmanın anlık görüntüsü, completed veya failed durumuna yerleştiği anda eşlemden kaldırılır ya da Gateway kapatıldığında bırakılır (yeniden başlatmada hiçbir şey korunmaz: bu geçici çalışma zamanı durumudur).
• Salt okunur işler için exec, restartSafe: true değerini ayarlayabilir. OpenClaw daha sonra yan etkili katalog çağrılarını ve Plugin ad alanlarını yürütmeden önce reddeder ve askıya alınmış sonuçları yeniden oynatma açısından güvenli olarak işaretler. Yeniden başlatma wait işlemini kesintiye uğratırsa yeniden başlatma kurtarması, işlem yerelindeki anlık görüntüyü geri yüklemek yerine dönüşü transkriptten yeniden oluşturur. Kurtarma dönüşünün kendisi, denetlenmiş salt okunur çekirdek araçları ve açıkça yeniden oynatma açısından güvenli Plugin araçlarıyla sınırlı kalır.
• OpenClaw, işlem başına eşzamanlı olarak askıya alınmış çalıştırma sayısını (64) sınırlar ve bu sınırı aşan yeni askıya alma işlemlerini too many suspended code mode runs. ile reddeder.

​

QuickJS-WASI çalışma zamanı

​

TypeScript

​

Güvenlik sınırı

• QuickJS-WASI’yi ana olay döngüsünün dışında, bir iş parçacığında çalıştırır
• quickjs-wasi öğesini Codex veya geçişli bir paket üzerinden değil, doğrudan bağımlılık olarak yükler
• konukta dosya sistemi, ağ, alt işlem, modül içe aktarma, ortam değişkenleri veya ana makine genel nesneleri bulunmaz
• QuickJS bellek ve kesme sınırlarının yanı sıra üst işlem duvar saati zaman aşımını kullanır
• çıktı, anlık görüntü, günlük ve bekleyen çağrı sınırlarını uygular
• ana makine köprüsü değerlerini dar kapsamlı bir JSON bağdaştırıcısı üzerinden serileştirir
• ana makine hatalarını düz konuk hatalarına dönüştürür; ana makine alanı nesnelerini hiçbir zaman aktarmaz
• zaman aşımı, iptal, oturum sonu veya süre dolumunda anlık görüntüleri bırakır
• exec, wait ve Araç Arama denetim araçlarına özyinelemeli erişimi reddeder
• kolaylık adı çakışmalarının katalog yardımcılarını gölgelemesini önler

​

Hata kodları

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

​

Telemetri

​

Hata ayıklama

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

​

Uygulama düzeni

• yapılandırma sözleşmesi: tools.codeMode
• katalog oluşturucu: etkin araçları kompakt girdilere ve kimlik eşlemesine dönüştürür
• model yüzeyi bağdaştırıcısı: görünür araçları kontrol/doğrudan araçlarla değiştirir
• QuickJS-WASI çalışma zamanı bağdaştırıcısı: yükleme, değerlendirme, anlık görüntü oluşturma, geri yükleme, elden çıkarma
• çalışan gözetmeni: zaman aşımı, iptal, çökme yalıtımı
• köprü bağdaştırıcısı: JSON açısından güvenli ana makine geri çağırmaları ve sonuç teslimi
• TypeScript dönüştürme bağdaştırıcısı
• anlık görüntü deposu: TTL, boyut sınırları, çalıştırma/oturum kapsamı
• iç içe araç çağrıları için yörünge izdüşümü
• telemetri sayaçları ve tanılama

​

Doğrulama kontrol listesi

• devre dışı yapılandırma, mevcut araç görünürlüğünü değiştirmeden bırakır
• enabled: true içermeyen nesne yapılandırması, Kod modunu devre dışı bırakır
• etkin yapılandırma; araçlar çalıştırma için etkinken modele exec, wait ve yalnızca gerekli, yalnızca doğrudan araçları sunar
• ham araçsız çalıştırmalar, disableTools ve boş izin listeleri Kod modu yükü zorlamasını tetiklemez
• kataloğa uygun tüm etkin MCP dışı araçlar ALL_TOOLS içinde görünür
• yalnızca doğrudan araçlar model tarafından görünür kalır ve ALL_TOOLS içinde görünmez
• reddedilen araçlar ALL_TOOLS içinde görünmez
• tools.search, tools.describe, tools.callValue ve tools.call OpenClaw araçları için çalışır
• API.list("mcp") ve API.read("mcp/<server>.d.ts"), köprü/araç çağrısı olmadan TypeScript tarzı MCP bildirimlerini sunar
• MCP ad alanı $api(), şemalar için satır içi geri dönüş olarak kullanılabilir kalır
• MCP ad alanı çağrıları, tek nesne girdili görünür MCP araçları için çalışırken doğrudan MCP katalog girdileri tools.* içinde bulunmaz
• Araç Arama kontrol araçları hem model yüzeyinden hem de gizli katalogdan gizlenir
• iç içe çağrılar onay ve kanca davranışını korur
• kabuk exec, modelden gizlenir ancak izin verildiğinde katalog kimliğiyle çağrılabilir
• özyinelemeli Kod modu exec ve wait, konuk koddan çağrılamaz
• TypeScript girdisi, devre dışı veya yalnızca JavaScript yollarında TypeScript yüklenmeden dönüştürülür ve değerlendirilir
• import, require, dosya sistemi, ağ ve ortam erişimi başarısız olur
• sonsuz döngüler zaman aşımına uğrar ve Gateway’i engelleyemez
• bellek sınırı hataları konuk VM’yi sonlandırır
• çıktı ve anlık görüntü sınırları tamamlanan ve askıya alınan çağrılar için uygulanır
• wait, askıya alınmış bir anlık görüntüyü sürdürür ve nihai değeri döndürür
• süresi dolmuş, iptal edilmiş, yanlış oturuma ait ve bilinmeyen runId değerleri başarısız olur
• transkript yeniden oynatma ve kalıcılık, Kod modu kontrol çağrılarını korur
• transkript ve telemetri, iç içe araç çağrılarını açıkça gösterir

​

Uçtan uca test planı

1. tools.codeMode.enabled: false ile bir Gateway başlatın.
2. Küçük bir doğrudan araç kümesiyle bir aracı turu gönderin.
3. Model tarafından görülebilen araçların değişmediğini doğrulayın.
4. tools.codeMode.enabled: true ile yeniden başlatın.
5. OpenClaw, Plugin, MCP ve istemci test araçlarıyla bir aracı turu gönderin.
6. Model tarafından görülebilen araç listesinin exec, wait ve yalnızca yapılandırılmış yalnızca doğrudan araçlardan oluştuğunu doğrulayın.
7. exec içinde ALL_TOOLS öğesini okuyun ve kataloğa uygun etkin test araçlarının bulunduğunu, yalnızca doğrudan araçların ise bulunmadığını doğrulayın.
8. exec içinde OpenClaw/Plugin/istemci araçlarını tools.search, tools.describe ve tools.callValue (veya ham tools.call) üzerinden çağırın.
9. exec içinde API.list("mcp") ve API.read("mcp/<server>.d.ts") öğelerini çağırın ve bildirim dosyalarının görünür MCP araçlarını tanımladığını doğrulayın.
10. exec içinde MCP araçlarını MCP.<server>.<tool>({ ...input }) üzerinden çağırın ve doğrudan MCP katalog girdilerinin ALL_TOOLS ve tools.* içinde bulunmadığını doğrulayın.
11. Reddedilen araçların bulunmadığını ve tahmin edilen kimlikle çağrılamadığını doğrulayın.
12. exec, waiting değerini döndürdükten sonra çözümlenen iç içe bir araç çağrısı başlatın.
13. wait öğesini çağırın ve geri yüklenen VM’nin araç sonucunu aldığını doğrulayın.
14. Nihai yanıtın geri yükleme sonrasında üretilen çıktıyı içerdiğini doğrulayın.
15. Zaman aşımı, iptal ve anlık görüntü süresinin dolmasının çalışma zamanı durumunu temizlediğini doğrulayın.
16. Yörüngeyi dışa aktarın ve iç içe çağrıların üst Kod modu çağrısı altında görünür olduğunu doğrulayın.

​

İlgili

• Kod Modu betiklerinden dallanarak aracı düzenleme için Swarm
• Araç Arama
• Aracı çalışma zamanları
• Exec aracı
• Kod yürütme