وضع الكود

• Codex Code Mode مفعل لخيوط خادم تطبيق Codex ما لم تعطل سياسة الأدوات المقيدة وضع الكود الأصلي. يعمل ضمن حاضنة البرمجة في Codex، حيث يكتب النموذج أوامر الصدفة من خلال عقد exec.command.
• وضع الكود في OpenClaw معطل ما لم يتم ضبط tools.codeMode.enabled: true. يعمل ضمن وقت تشغيل الوكيل العام في OpenClaw، حيث يكتب النموذج برامج JavaScript أو TypeScript من خلال عقد exec.code.

​

ما هذا؟

• قائمة الأدوات المرئية للنموذج هي بالضبط exec وwait.
• يقيم exec JavaScript أو TypeScript مولدا من النموذج في عامل QuickJS-WASI مقيد.
• تكون أدوات OpenClaw العادية مخفية عن مطالبة النموذج ومكشوفة داخل برنامج الضيف عبر ALL_TOOLS وtools.
• يمكن لكود الضيف البحث في الكتالوج المخفي، ووصف أداة، واستدعاء أداة من خلال مسار تنفيذ OpenClaw نفسه المستخدم في دورات الوكيل العادية.
• تجمع أدوات MCP تحت مساحة الاسم MCP. في وضع الكود، مساحة الاسم هذه هي الطريقة الوحيدة المدعومة لاستدعاء أدوات MCP.
• يستأنف wait تشغيلة وضع كود معلقة عندما تظل استدعاءات الأدوات المتداخلة قيد الانتظار.

​

لماذا هذا جيد؟

• سطح مطالبة أصغر: يتلقى المزودون أداتي تحكم بدلا من عشرات أو مئات مخططات الأدوات الكاملة.
• تنسيق أفضل: يمكن للنموذج استخدام الحلقات، والدمج، والتحويلات الصغيرة، والمنطق الشرطي، واستدعاءات الأدوات المتداخلة المتوازية داخل خلية كود واحدة.
• محايد للمزودين: يعمل مع أدوات OpenClaw وPlugin وMCP والعميل دون الاعتماد على تنفيذ كود أصلي لدى المزود.
• تظل السياسة الحالية نافذة: ما زالت استدعاءات الأدوات المتداخلة تمر عبر سياسة OpenClaw، والموافقات، والخطافات، وسياق الجلسة، ومسارات التدقيق.
• نمط فشل واضح: عندما يكون وضع الكود مفعلا صراحة ويكون وقت التشغيل غير متاح، يفشل OpenClaw بإغلاق آمن بدلا من الرجوع إلى كشف واسع ومباشر للأدوات.

​

كيفية تفعيله

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

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

​

جولة تقنية

​

حالة وقت التشغيل

• وقت التشغيل: quickjs-wasi.
• الحالة الافتراضية: معطل.
• الاستقرار: سطح OpenClaw تجريبي؛ وضع Codex Code mode سطح منفصل مستقر في حاضنة Codex.
• السطح الهدف: تشغيلات وكيل OpenClaw العامة.
• الموقف الأمني: كود النموذج عدائي.
• الوعد الموجه للمستخدم: لا يؤدي تفعيل وضع الكود أبدا إلى رجوع صامت إلى كشف واسع ومباشر للأدوات.

​

النطاق

• تعريفات أداتي exec وwait المرئيتين للنموذج
• بناء كتالوج الأدوات المخفي
• تنفيذ ضيف JavaScript وTypeScript
• وقت تشغيل عامل QuickJS-WASI
• استدعاءات المضيف للبحث في الكتالوج، ووصف المخطط، واستدعاء الأداة
• حالة قابلة للاستئناف لبرامج الضيف المعلقة
• حدود الإخراج، والمهلة، والذاكرة، والاستدعاءات المعلقة، واللقطات
• القياس عن بعد وإسقاط المسار لاستدعاءات الأدوات المتداخلة

• تنفيذ الكود البعيد الأصلي لدى المزود
• دلالات تنفيذ الصدفة
• تغيير تفويض الأدوات الحالي
• سكربتات مستمرة يؤلفها المستخدم
• الوصول إلى مدير الحزم، أو الملفات، أو الشبكة، أو الوحدات في كود الضيف
• إعادة الاستخدام المباشر لداخليات وضع Codex Code mode

​

المصطلحات

​

الإعداد

• enabled: قيمة منطقية. الافتراضي false. يفعل وضع الكود فقط عندما تكون true.
• runtime: "quickjs-wasi". وقت التشغيل الوحيد المدعوم.
• mode: "only". يكشف exec وwait، ويخفي أدوات النموذج العادية.
• languages: مصفوفة من "javascript" و"typescript". يتضمن الافتراضي كليهما.
• timeoutMs: حد زمني فعلي لعملية exec أو wait واحدة. الافتراضي 10000. حد وقت التشغيل: من 100 إلى 60000.
• memoryLimitBytes: حد كومة QuickJS. الافتراضي 67108864. حد وقت التشغيل: من 1048576 إلى 1073741824.
• maxOutputBytes: حد للنص المعاد، وJSON، والسجلات. الافتراضي 65536. حد وقت التشغيل: من 1024 إلى 10485760.
• maxSnapshotBytes: حد للقطات الآلة الافتراضية المسلسلة. الافتراضي 10485760. حد وقت التشغيل: من 1024 إلى 268435456.
• maxPendingToolCalls: حد لاستدعاءات الأدوات المتداخلة المتزامنة. الافتراضي 16. حد وقت التشغيل: من 1 إلى 128.
• snapshotTtlSeconds: مدة إمكانية استئناف آلة افتراضية معلقة. الافتراضي 900. حد وقت التشغيل: من 1 إلى 86400.
• searchDefaultLimit: عدد نتائج البحث الافتراضي في الكتالوج المخفي. الافتراضي 8. يقيد وقت التشغيل هذا إلى maxSearchLimit.
• maxSearchLimit: الحد الأقصى لعدد نتائج البحث في الكتالوج المخفي. الافتراضي 50. حد وقت التشغيل: من 1 إلى 50.

​

التفعيل

1. حل الوكيل، والنموذج، والمزود، والعزل، والقناة، والمرسل، وسياسة التشغيلة.
2. بناء قائمة أدوات OpenClaw الفعالة.
3. إضافة أدوات Plugin وMCP والعميل المؤهلة.
4. تطبيق سياسة السماح والمنع.
5. إذا كانت tools.codeMode.enabled خطأ، فتابع مع كشف الأدوات العادي.
6. إذا كانت مفعلة وكانت الأدوات نشطة للتشغيلة، فسجل الأدوات الفعالة في كتالوج وضع الكود.
7. أزل كل الأدوات العادية من قائمة الأدوات المرئية للنموذج.
8. أضف exec وwait الخاصتين بوضع الكود.

​

الأدوات المرئية للنموذج

• exec
• wait

​

exec

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

• يجب أن يكون أحد code أو command غير فارغ.
• code هو الحقل الموثق والموجه للنموذج.
• يقبل command كاسم بديل متوافق مع exec لسياسات الخطافات وإعادة الكتابة الموثوقة؛ عند وجودهما معا، يجب أن تتطابق القيمتان.
• تتضمن أحداث خطاف exec الخارجية لوضع الكود toolKind: "code_mode_exec" وتتضمن toolInputKind: "javascript" | "typescript" عندما تكون لغة الإدخال معروفة، بحيث تستطيع السياسات تمييز خلايا وضع الكود عن استدعاءات exec بأسلوب الصدفة التي تشترك في اسم الأداة نفسه.
• القيمة الافتراضية لـ language هي "javascript".
• إذا كانت language هي "typescript"، يقوم OpenClaw بالتحويل قبل التقييم.
• يرفض exec أنماط import، وrequire، والاستيراد الديناميكي، ومحمل الوحدات في v1.
• لا يكشف exec تنفيذ 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 الافتراضية ويسجل عمل المضيف المعلق.
3. عندما يستقر العمل المعلق، تستعيد wait لقطة الآلة الافتراضية.
4. يعيد OpenClaw تسجيل استدعاءات المضيف الراجعة بأسماء مستقرة.
5. يسلّم OpenClaw نتائج الأدوات المتداخلة إلى الآلة الافتراضية المستعادة.
6. يفرّغ OpenClaw مهام QuickJS المعلقة.
7. تُرجع wait النتيجة completed أو failed أو نتيجة waiting أخرى.

• يكون runId غير معروف.
• تكون اللقطة منتهية الصلاحية.
• يكون التشغيل الأصل أو الجلسة قد أُجهض.
• لا يكون المستدعي ضمن نطاق التشغيل/الجلسة نفسه.
• تفشل استعادة QuickJS-WASI.
• تتجاوز الاستعادة الحدود المضبوطة.

​

واجهة 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" | "plugin" | "mcp" | "client";
  sourceName?: string;
};

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

type ToolCatalog = {
  search(query: string, options?: { limit?: number }): Promise<ToolCatalogEntry[]>;
  describe(id: string): Promise<ToolCatalogEntryWithSchema>;
  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.call(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" });

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

  /**
   * Create a GitHub issue.
   * @param owner Repository owner
   * @param repo Repository name
   * @param title Issue title
   */
  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. تُسلسَل بيانات النطاق إلى واصف عادي وتُحقن في QuickJS كعموميات مباشرة و namespaces.<globalName>.
6. تُعلّق استدعاءات الضيف عبر جسر العامل، وتحل مسار مساحة الأسماء على المضيف، وتربط الاستدعاء بأداة فهرس مصرّح بها ومملوكة لـ Plugin، وتنفذ تلك الأداة عبر ToolSearchRuntime.call.
7. يفرّغ OpenClaw تلقائيًا استدعاءات جسر مساحة الأسماء الجاهزة داخل استدعاء أداة 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: () => ({
  // Wrong: this bypasses the catalog tool lifecycle and will be rejected.
  list: async () => githubClient.listIssues(),
});

​

الملكية والرؤية

• يجب أن تكون كل أداة مطلوبة موجودة في فهرس التشغيل
• يجب أن تكون لكل أداة مطلوبة sourceName === pluginId
• تُخفى مساحة الأسماء عند غياب أي أداة مطلوبة أو امتلاكها من Plugin آخر
• لا يجوز لكل مسار قابل للاستدعاء استهداف إلا أداة مسماة في requiredToolNames

​

قواعد تسلسل النطاق

• الدوال الخام
• رسومًا بيانية كائنية دائرية
• مقاطع المسار غير الآمنة: __proto__ أو constructor أو prototype أو المفاتيح الفارغة أو المفاتيح التي تحتوي فاصل المسار الداخلي
• قيم globalName التي ليست معرّفات JavaScript
• تصادمات globalName مع عموميات وضع الشيفرة المدمجة مثل tools أو namespaces أو text أو json أو yield_control أو __openclaw*

​

الموجهات

{
  description: "Fiction production service helpers.",
  prompt:
    "Use Fictions.riskAudit(), Fictions.promoteIfReady(id, status), and Fictions.unpaidOver(amount).",
}

​

التنظيف

clearCodeModeNamespacesForPlugin(pluginId);

​

قائمة تحقق الاختبار

• يظهر نص مطالبة مساحة الأسماء فقط عندما تكون الأدوات الداعمة مرئية
• الأدوات ذات الاسم نفسه من sourceName آخر لا تكشف مساحة الأسماء
• تُرفض دوال النطاق الخام
• تُرفض معرفات مساحة الأسماء المزورة والمسارات المزورة
• لا يمكن للمسارات القابلة للاستدعاء استهداف أدوات غير مصرّح بها
• تُسلسل الكائنات المتداخلة والمراجع المشتركة بشكل صحيح
• تُنفذ استدعاءات مساحة الأسماء عبر أدوات الكتالوج وتعيد تفاصيل آمنة لـ JSON
• يمكن لرمز الضيف التقاط حالات الفشل
• تُستأنف استدعاءات مساحة الأسماء المعلقة عبر wait
• يؤدي التراجع عن Plugin إلى مسح تسجيلات مساحة الأسماء المالكة

​

واجهة API للإخراج

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

• ترتيب الإخراج يطابق استدعاءات الضيف
• الإخراج محدود بواسطة maxOutputBytes
• تُحوّل القيم غير القابلة للتسلسل إلى سلاسل نصية عادية أو أخطاء
• القيم الثنائية غير مدعومة في v1
• تنتقل الصور والملفات عبر أدوات OpenClaw العادية، لا عبر جسر وضع التعليمات البرمجية

​

كتالوج الأدوات

1. أدوات OpenClaw الأساسية.
2. أدوات Plugin المضمنة.
3. أدوات Plugin الخارجية.
4. أدوات MCP.
5. الأدوات المقدمة من العميل للتشغيل الحالي.

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

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

• exec
• wait
• tool_search_code
• tool_search
• tool_describe
• tool_call

​

تفاعل بحث الأدوات

• لا يكشف OpenClaw tool_search_code أو tool_search أو tool_describe أو tool_call كأدوات مرئية للنموذج.
• تنتقل فكرة الفهرسة نفسها إلى داخل وقت تشغيل الضيف.
• يتلقى وقت تشغيل الضيف بيانات تعريف ALL_TOOLS مضغوطة ومساعدات بحث ووصف واستدعاء للأدوات غير التابعة لـ MCP.
• تستخدم استدعاءات MCP مساحة الأسماء MCP المولدة وترويسات $api() الخاصة بها بدلا من tools.call(...).
• تُرسل الاستدعاءات المتداخلة عبر مسار منفذ OpenClaw نفسه الذي يستخدمه بحث الأدوات.

​

أسماء الأدوات والتعارضات

• يمكن لـ tools.call("openclaw:core:exec", input) استدعاء أداة تنفيذ الصدفة إذا سمحت السياسة بذلك.
• لا تُثبت tools.exec(...) إلا إذا كان لإدخال كتالوج تنفيذ الصدفة اسم آمن غير ملتبس.
• لا تكون أداة وضع التعليمات البرمجية exec متاحة أبدا بصورة متكررة عبر tools.

​

تنفيذ الأدوات المتداخلة

• معرف العامل النشط
• معرف الجلسة ومفتاح الجلسة
• سياق المرسل والقناة
• سياسة صندوق العزل
• سياسة الموافقة
• خطافات Plugin before_tool_call
• إشارة الإجهاض
• تحديثات البث حيثما توفرت
• أحداث المسار والتدقيق

​

حالة وقت التشغيل

• running: ينفذ VM أو توجد استدعاءات متداخلة قيد التنفيذ.
• waiting: توجد لقطة VM ويمكن استئنافها باستخدام wait.
• completed: أُعيدت القيمة النهائية؛ حُذفت اللقطة.
• failed: أُعيد خطأ؛ حُذفت اللقطة.
• expired: تجاوزت اللقطة أو الحالة المعلقة مدة الاحتفاظ؛ لا يمكن الاستئناف.
• aborted: أُلغيت الجلسة/التشغيل الأب؛ حُذفت اللقطة.

• الحد الأقصى لبايتات اللقطة لكل تشغيل
• الحد الأقصى للقطات الحية لكل عملية
• مدة بقاء اللقطة
• التنظيف عند نهاية التشغيل
• التنظيف عند إيقاف Gateway حيث لا يكون الاستمرار مدعوما

​

وقت تشغيل QuickJS-WASI

• ترجمة أو تحميل وحدة WebAssembly الخاصة بـ QuickJS-WASI
• إنشاء VM معزول واحد لكل تشغيل أو استئناف في وضع التعليمات البرمجية
• تسجيل استدعاءات المضيف بأسماء مستقرة
• تعيين حدود الذاكرة والمقاطعة
• تقييم JavaScript
• تفريغ المهام المعلقة
• أخذ لقطة لحالة VM المعلقة
• استعادة اللقطات من أجل wait
• التخلص من مقابض VM واللقطات بعد الحالات النهائية

​

TypeScript

• الإدخال المقبول: سلسلة تعليمات TypeScript واحدة
• الإخراج: سلسلة JavaScript يقيّمها QuickJS-WASI
• لا يوجد فحص أنواع
• لا يوجد حل للوحدات
• لا يوجد import أو require في v1
• تُعاد التشخيصات كنتائج failed

​

حد الأمان

• تشغيل QuickJS-WASI خارج حلقة الأحداث الرئيسية
• تحميل quickjs-wasi كتبعية مباشرة، لا عبر Codex أو حزمة انتقالية
• لا نظام ملفات ولا شبكة ولا عملية فرعية ولا استيراد وحدات ولا متغيرات بيئة ولا كائنات مضيف عامة في الضيف
• استخدام حدود ذاكرة ومقاطعة QuickJS
• فرض مهلة زمنية حائطية للعملية الأب
• فرض حدود للإخراج واللقطات والسجلات والاستدعاءات المعلقة
• تسلسل قيم جسر المضيف عبر محول JSON ضيق
• تحويل أخطاء المضيف إلى أخطاء ضيف عادية، وليس إلى كائنات من نطاق المضيف أبدا
• إسقاط اللقطات عند المهلة أو الإجهاض أو نهاية الجلسة أو انتهاء الصلاحية
• رفض الوصول المتكرر إلى exec وwait وأدوات التحكم في بحث الأدوات
• منع تعارضات أسماء الملاءمة من حجب مساعدات الكتالوج

​

رموز الخطأ

type CodeModeErrorCode =
  | "runtime_unavailable"
  | "invalid_config"
  | "invalid_input"
  | "unsupported_language"
  | "typescript_transform_failed"
  | "module_access_denied"
  | "timeout"
  | "memory_limit_exceeded"
  | "output_limit_exceeded"
  | "snapshot_limit_exceeded"
  | "snapshot_expired"
  | "snapshot_restore_failed"
  | "too_many_pending_tool_calls"
  | "nested_tool_failed"
  | "aborted"
  | "internal_error";

​

القياسات

• أسماء الأدوات المرئية المرسلة إلى النموذج
• حجم الكتالوج المخفي وتفصيل المصادر
• أعداد exec وwait
• أعداد البحث والوصف والاستدعاء المتداخلة
• معرفات الأدوات المتداخلة المستدعاة
• حالات فشل حدود المهلة والذاكرة واللقطات والإخراج
• أحداث دورة حياة اللقطات

​

التصحيح

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

​

تخطيط التنفيذ

• عقد التكوين: tools.codeMode
• منشئ الكتالوج: الأدوات الفعلية إلى إدخالات مضغوطة وخريطة معرفات
• محول سطح النموذج: استبدال الأدوات المرئية بـ exec وwait
• محول وقت تشغيل QuickJS-WASI: التحميل، التقييم، اللقطة، الاستعادة، التخلص
• مشرف العامل: المهلة، الإجهاض، عزل الانهيار
• محول الجسر: استدعاءات مضيف آمنة لـ JSON وتسليم النتائج
• محول TypeScript
• مخزن اللقطات: مدة البقاء، حدود الحجم، تحديد نطاق التشغيل/الجلسة
• إسقاط المسار لاستدعاءات الأدوات المتداخلة
• عدادات القياسات والتشخيصات

​

قائمة تحقق التحقق

• يترك الإعداد المعطّل عرض الأدوات الحالي دون تغيير
• إعداد الكائن بدون enabled: true يترك وضع الكود معطّلاً
• يعرض الإعداد المفعّل فقط exec وwait للنموذج عندما تكون الأدوات نشطة للتشغيل
• لا تؤدي التشغيلات الأولية بلا أدوات، وdisableTools، وقوائم السماح الفارغة إلى فرض حمولة وضع الكود
• تظهر جميع الأدوات الفعالة غير MCP في ALL_TOOLS
• لا تظهر الأدوات المرفوضة في ALL_TOOLS
• تعمل tools.search وtools.describe وtools.call مع أدوات OpenClaw
• يتيح API.list("mcp") وAPI.read("mcp/<server>.d.ts") إعلانات MCP بنمط TypeScript دون جسر/استدعاء أداة
• تبقى مساحة أسماء MCP $api() متاحة كبديل احتياطي مضمن للمخططات
• تعمل استدعاءات مساحة أسماء MCP للأدوات المرئية من MCP مع إدخال كائن واحد، بينما لا تكون إدخالات كتالوج MCP المباشرة موجودة في tools.*
• تكون أدوات التحكم في Tool Search مخفية عن كل من سطح النموذج والكتالوج المخفي
• تحافظ الاستدعاءات المتداخلة على سلوك الموافقة والخطاف
• يكون shell exec مخفيًا عن النموذج لكن يمكن استدعاؤه عبر معرّف الكتالوج عند السماح بذلك
• لا يمكن استدعاء exec وwait المتكررين في وضع الكود من كود الضيف
• يتم تحويل إدخال TypeScript وتقييمه دون تحميل TypeScript في المسارات المعطّلة أو الخاصة بـ JavaScript فقط
• يفشل الوصول إلى import وrequire ونظام الملفات والشبكة والبيئة
• تنتهي الحلقات اللانهائية بمهلة ولا يمكنها حظر Gateway
• تنهي حالات فشل حد الذاكرة VM الضيف
• يتم فرض حدود الإخراج واللقطات للاستدعاءات المكتملة والمعلّقة
• يستأنف wait لقطة معلّقة ويعيد القيمة النهائية
• تفشل قيم runId المنتهية الصلاحية، والمُجهضة، وذات الجلسة الخاطئة، والمجهولة
• تحافظ إعادة تشغيل النص والمثابرة على استدعاءات التحكم في وضع الكود
• يعرض النص والقياسات استدعاءات الأدوات المتداخلة بوضوح

​

خطة اختبار E2E

1. ابدأ Gateway مع tools.codeMode.enabled: false.
2. أرسل دورة وكيل مع مجموعة أدوات مباشرة صغيرة.
3. تحقق من أن الأدوات المرئية للنموذج لم تتغير.
4. أعد التشغيل مع tools.codeMode.enabled: true.
5. أرسل دورة وكيل مع أدوات اختبار OpenClaw وPlugin وMCP والعميل.
6. تحقق من أن قائمة الأدوات المرئية للنموذج هي بالضبط exec وwait.
7. في exec، اقرأ ALL_TOOLS وتحقق من وجود أدوات الاختبار الفعالة.
8. في exec، استدع أدوات OpenClaw/Plugin/العميل عبر tools.search، وtools.describe، وtools.call.
9. في exec، استدع API.list("mcp") وAPI.read("mcp/<server>.d.ts") وتحقق من أن ملفات الإعلان تصف أدوات MCP المرئية.
10. في exec، استدع أدوات MCP عبر MCP.<server>.<tool>({ ...input }) وتحقق من أن إدخالات كتالوج MCP المباشرة غير موجودة في ALL_TOOLS وtools.*.
11. تحقق من أن الأدوات المرفوضة غير موجودة ولا يمكن استدعاؤها بمعرّف مُخمّن.
12. ابدأ استدعاء أداة متداخلاً يكتمل بعد أن يعيد exec القيمة waiting.
13. استدع wait وتحقق من أن VM المستعاد يتلقى نتيجة الأداة.
14. تحقق من أن الإجابة النهائية تحتوي على إخراج تم إنتاجه بعد الاستعادة.
15. تحقق من أن المهلة والإجهاض وانتهاء صلاحية اللقطة تنظف حالة وقت التشغيل.
16. صدّر المسار وتحقق من أن الاستدعاءات المتداخلة مرئية تحت استدعاء وضع الكود الأصل.

​

ذات صلة

• Tool Search
• أوقات تشغيل الوكلاء
• أداة Exec
• تنفيذ الكود