การกำหนดค่า — เอเจนต์

คีย์การกำหนดค่าที่กำหนดขอบเขตตาม Agent ภายใต้ agents.*, multiAgent.*, session.*, messages.* และ talk.* สำหรับช่องทาง เครื่องมือ รันไทม์ Gateway และคีย์ระดับบนสุดอื่นๆ ดู ข้อมูลอ้างอิงการกำหนดค่า

ค่าเริ่มต้นของ Agent

agents.defaults.workspace

ค่าเริ่มต้น: OPENCLAW_WORKSPACE_DIR เมื่อตั้งค่าไว้ มิฉะนั้นใช้ ~/.openclaw/workspace

{  agents: { defaults: { workspace: "~/.openclaw/workspace" } },}

ค่า agents.defaults.workspace ที่ระบุชัดเจนจะมีลำดับความสำคัญเหนือ OPENCLAW_WORKSPACE_DIR ใช้ตัวแปรสภาพแวดล้อมเพื่อชี้ Agent เริ่มต้น ไปยัง workspace ที่เมานต์ไว้ เมื่อคุณไม่ต้องการเขียนพาธนั้นลงในการกำหนดค่า

agents.defaults.repoRoot

รูทของ repository แบบไม่บังคับที่แสดงในบรรทัด Runtime ของ system prompt หากไม่ได้ตั้งค่า OpenClaw จะตรวจจับอัตโนมัติโดยไล่ขึ้นจาก workspace

{  agents: { defaults: { repoRoot: "~/Projects/openclaw" } },}

agents.defaults.skills

allowlist ของ skill เริ่มต้นแบบไม่บังคับสำหรับ Agent ที่ไม่ได้ตั้งค่า agents.list[].skills

{  agents: {    defaults: { skills: ["github", "weather"] },    list: [      { id: "writer" }, // inherits github, weather      { id: "docs", skills: ["docs-search"] }, // replaces defaults      { id: "locked-down", skills: [] }, // no skills    ],  },}

• ละเว้น agents.defaults.skills เพื่อให้ใช้ skills ได้ไม่จำกัดโดยค่าเริ่มต้น
• ละเว้น agents.list[].skills เพื่อสืบทอดค่าเริ่มต้น
• ตั้งค่า agents.list[].skills: [] เพื่อไม่ใช้ skills
• รายการ agents.list[].skills ที่ไม่ว่างคือชุดสุดท้ายสำหรับ Agent นั้น และ จะไม่ผสานกับค่าเริ่มต้น

agents.defaults.skipBootstrap

ปิดใช้งานการสร้างไฟล์ bootstrap ของ workspace โดยอัตโนมัติ (AGENTS.md, SOUL.md, TOOLS.md, IDENTITY.md, USER.md, HEARTBEAT.md, BOOTSTRAP.md)

{  agents: { defaults: { skipBootstrap: true } },}

agents.defaults.skipOptionalBootstrapFiles

ข้ามการสร้างไฟล์ workspace แบบไม่บังคับที่เลือกไว้ ขณะที่ยังเขียนไฟล์ bootstrap ที่จำเป็นอยู่ ค่าที่ใช้ได้: SOUL.md, USER.md, HEARTBEAT.md และ IDENTITY.md

{  agents: {    defaults: {      skipOptionalBootstrapFiles: ["SOUL.md", "USER.md"],    },  },}

agents.defaults.contextInjection

ควบคุมว่าไฟล์ bootstrap ของ workspace จะถูกฉีดเข้าไปใน system prompt เมื่อใด ค่าเริ่มต้น: "always"

• "continuation-skip": เทิร์น continuation ที่ปลอดภัย (หลังจากการตอบกลับของ assistant เสร็จสิ้น) จะข้ามการฉีด bootstrap ของ workspace ซ้ำ เพื่อลดขนาด prompt การรัน Heartbeat และการลองใหม่หลัง Compaction จะยังสร้างบริบทใหม่
• "never": ปิดใช้งาน bootstrap ของ workspace และการฉีดไฟล์บริบทในทุกเทิร์น ใช้ตัวเลือกนี้เฉพาะกับ Agent ที่เป็นเจ้าของวงจรชีวิต prompt ของตัวเองทั้งหมด (เอนจินบริบทแบบกำหนดเอง, รันไทม์ native ที่สร้างบริบทเอง, หรือเวิร์กโฟลว์เฉพาะที่ไม่ใช้ bootstrap) เทิร์น Heartbeat และเทิร์นกู้คืนหลัง Compaction จะข้ามการฉีดด้วย

{  agents: { defaults: { contextInjection: "continuation-skip" } },}

การ override ต่อ Agent: agents.list[].contextInjection ค่าที่ละเว้นจะสืบทอดจาก agents.defaults.contextInjection

agents.defaults.bootstrapMaxChars

จำนวนอักขระสูงสุดต่อไฟล์ bootstrap ของ workspace ก่อนตัดทอน ค่าเริ่มต้น: 20000

{  agents: { defaults: { bootstrapMaxChars: 20000 } },}

การ override ต่อ Agent: agents.list[].bootstrapMaxChars ค่าที่ละเว้นจะสืบทอดจาก agents.defaults.bootstrapMaxChars

agents.defaults.bootstrapTotalMaxChars

จำนวนอักขระรวมสูงสุดที่ฉีดจากไฟล์ bootstrap ของ workspace ทั้งหมด ค่าเริ่มต้น: 60000

{  agents: { defaults: { bootstrapTotalMaxChars: 60000 } },}

การ override ต่อ Agent: agents.list[].bootstrapTotalMaxChars ค่าที่ละเว้นจะ สืบทอดจาก agents.defaults.bootstrapTotalMaxChars

การ override โปรไฟล์ bootstrap ต่อ Agent

ใช้การ override โปรไฟล์ bootstrap ต่อ Agent เมื่อ Agent หนึ่งต้องการพฤติกรรม การฉีด prompt ที่ต่างจากค่าเริ่มต้นร่วมกัน ฟิลด์ที่ละเว้นจะสืบทอดจาก agents.defaults

{  agents: {    defaults: {      contextInjection: "continuation-skip",      bootstrapMaxChars: 20000,      bootstrapTotalMaxChars: 60000,    },    list: [      {        id: "strict-worker",        contextInjection: "always",        bootstrapMaxChars: 50000,        bootstrapTotalMaxChars: 300000,      },    ],  },}

agents.defaults.bootstrapPromptTruncationWarning

ควบคุมประกาศใน system prompt ที่ Agent มองเห็นเมื่อบริบท bootstrap ถูกตัดทอน ค่าเริ่มต้น: "always"

• "off": ไม่ฉีดข้อความประกาศการตัดทอนเข้าไปใน system prompt
• "once": ฉีดประกาศแบบกระชับหนึ่งครั้งต่อ signature การตัดทอนที่ไม่ซ้ำกัน
• "always": ฉีดประกาศแบบกระชับในทุกการรันเมื่อมีการตัดทอน (แนะนำ)

จำนวน raw/injected โดยละเอียดและฟิลด์ปรับแต่งการกำหนดค่าจะอยู่ใน diagnostics เช่น รายงาน context/status และ log; บริบทผู้ใช้/รันไทม์ WebChat ตามปกติจะได้รับเฉพาะ ประกาศการกู้คืนแบบกระชับ

{  agents: { defaults: { bootstrapPromptTruncationWarning: "always" } }, // off | once | always}

แผนผังความเป็นเจ้าของงบประมาณบริบท

OpenClaw มีงบประมาณ prompt/บริบทปริมาณสูงหลายส่วน และตั้งใจแยกตามระบบย่อย แทนที่จะให้ทั้งหมดไหลผ่าน knob ทั่วไปเพียงตัวเดียว

• agents.defaults.bootstrapMaxChars / agents.defaults.bootstrapTotalMaxChars: การฉีด bootstrap ของ workspace ตามปกติ
• agents.defaults.startupContext.*: prelude แบบครั้งเดียวสำหรับการรันโมเดลเมื่อ reset/startup รวมถึงไฟล์ memory/*.md รายวันล่าสุด คำสั่งแชตเปล่า /new และ /reset จะ รับทราบการ reset โดยไม่เรียกใช้โมเดล
• skills.limits.*: รายการ skills แบบกระชับที่ฉีดเข้าไปใน system prompt
• agents.defaults.contextLimits.*: excerpt ของรันไทม์แบบจำกัดขอบเขตและบล็อกที่รันไทม์เป็นเจ้าของซึ่งถูกฉีดเข้าไป
• memory.qmd.limits.*: ขนาด snippet ของการค้นหา memory ที่ทำดัชนีไว้และการฉีด

ใช้การ override ต่อ Agent ที่ตรงกันเฉพาะเมื่อ Agent หนึ่งต้องการงบประมาณที่ต่างออกไป:

• agents.list[].skillsLimits.maxSkillsPromptChars
• agents.list[].contextInjection
• agents.list[].bootstrapMaxChars
• agents.list[].bootstrapTotalMaxChars
• agents.list[].contextLimits.*

agents.defaults.startupContext

ควบคุม prelude สำหรับ startup ในเทิร์นแรกที่ฉีดในการรันโมเดลเมื่อ reset/startup คำสั่งแชตเปล่า /new และ /reset จะรับทราบการ reset โดยไม่เรียกใช้ โมเดล ดังนั้นจึงไม่โหลด prelude นี้

{  agents: {    defaults: {      startupContext: {        enabled: true,        applyOn: ["new", "reset"],        dailyMemoryDays: 2,        maxFileBytes: 16384,        maxFileChars: 1200,        maxTotalChars: 2800,      },    },  },}

agents.defaults.contextLimits

ค่าเริ่มต้นร่วมกันสำหรับพื้นผิวบริบทรันไทม์แบบจำกัดขอบเขต

{  agents: {    defaults: {      contextLimits: {        memoryGetMaxChars: 12000,        memoryGetDefaultLines: 120,        postCompactionMaxChars: 1800,      },    },  },}

• memoryGetMaxChars: เพดาน excerpt เริ่มต้นของ memory_get ก่อนเพิ่ม metadata การตัดทอนและประกาศ continuation
• memoryGetDefaultLines: ช่วงบรรทัดเริ่มต้นของ memory_get เมื่อ ละเว้น lines
• toolResultMaxChars: เพดานผลลัพธ์เครื่องมือสดขั้นสูงที่ใช้สำหรับผลลัพธ์ ที่คงไว้และการกู้คืนเมื่อเกินขนาด เว้นว่างไว้เพื่อใช้เพดานอัตโนมัติของบริบทโมเดล: 16000 อักขระเมื่อต่ำกว่า 100K tokens, 32000 อักขระเมื่อ 100K+ tokens และ 64000 อักขระเมื่อ 200K+ tokens ยอมรับค่าที่ระบุชัดเจนได้ถึง 1000000 สำหรับ โมเดล long-context แต่เพดานที่มีผลยังถูกจำกัดไว้ที่ประมาณ 30% ของ หน้าต่างบริบทของโมเดล openclaw doctor --deep จะแสดงเพดานที่มีผล และ doctor จะเตือนเฉพาะเมื่อการ override ที่ระบุชัดเจนล้าสมัยหรือไม่มีผล
• postCompactionMaxChars: เพดาน excerpt ของ AGENTS.md ที่ใช้ระหว่างการฉีด refresh หลัง Compaction

agents.list[].contextLimits

การ override ต่อ Agent สำหรับ knob contextLimits ร่วมกัน ฟิลด์ที่ละเว้นจะสืบทอด จาก agents.defaults.contextLimits

{  agents: {    defaults: {      contextLimits: {        memoryGetMaxChars: 12000,      },    },    list: [      {        id: "tiny-local",        contextLimits: {          memoryGetMaxChars: 6000,          toolResultMaxChars: 8000, // advanced ceiling for this agent        },      },    ],  },}

skills.limits.maxSkillsPromptChars

เพดานทั่วโลกสำหรับรายการ skills แบบกระชับที่ฉีดเข้าไปใน system prompt ตัวเลือกนี้ ไม่กระทบการอ่านไฟล์ SKILL.md ตามต้องการ

{  skills: {    limits: {      maxSkillsPromptChars: 18000,    },  },}

agents.list[].skillsLimits.maxSkillsPromptChars

การ override ต่อ Agent สำหรับงบประมาณ prompt ของ skills

{  agents: {    list: [      {        id: "tiny-local",        skillsLimits: {          maxSkillsPromptChars: 6000,        },      },    ],  },}

agents.defaults.imageMaxDimensionPx

ขนาดพิกเซลสูงสุดสำหรับด้านที่ยาวที่สุดของรูปภาพในบล็อกรูปภาพของ transcript/เครื่องมือก่อนเรียก provider ค่าเริ่มต้น: 1200

ค่าที่ต่ำกว่ามักลดการใช้ vision-token และขนาด payload ของคำขอสำหรับการรันที่มี screenshot จำนวนมาก ค่าที่สูงกว่าจะรักษารายละเอียดภาพได้มากกว่า

{  agents: { defaults: { imageMaxDimensionPx: 1200 } },}

agents.defaults.imageQuality

ค่ากำหนดการบีบอัด/รายละเอียดของเครื่องมือรูปภาพสำหรับรูปภาพที่โหลดจากพาธไฟล์, URL และการอ้างอิง media ค่าเริ่มต้น: auto

OpenClaw ปรับลำดับขั้นการ resize ให้เข้ากับโมเดลรูปภาพที่เลือก ตัวอย่างเช่น Claude Opus 4.8, OpenAI GPT-5.5, Qwen VL และโมเดล vision ของ Llama 4 ที่โฮสต์อยู่สามารถใช้รูปภาพขนาดใหญ่กว่าเส้นทาง vision high-detail รุ่นเก่า/ค่าเริ่มต้น ขณะที่เทิร์นที่มีหลายรูปภาพจะถูกบีบอัดอย่างเข้มงวดขึ้นในโหมด auto เพื่อควบคุมต้นทุน token และ latency

ค่า:

• auto: ปรับตามขีดจำกัดของโมเดลและจำนวนรูปภาพ
• efficient: เน้นรูปภาพขนาดเล็กลงเพื่อลดการใช้ token และ byte
• balanced: ใช้ลำดับขั้นมาตรฐานแบบกึ่งกลาง
• high: รักษารายละเอียดมากขึ้นสำหรับ screenshot, diagram และรูปภาพเอกสาร

{  agents: { defaults: { imageQuality: "auto" } },}

agents.defaults.userTimezone

เขตเวลาสำหรับบริบท system prompt (ไม่ใช่ timestamp ของข้อความ) หากไม่มีจะ fallback ไปยังเขตเวลาของโฮสต์

{  agents: { defaults: { userTimezone: "America/Chicago" } },}

agents.defaults.timeFormat

รูปแบบเวลาใน system prompt ค่าเริ่มต้น: auto (ค่ากำหนดของ OS)

{  agents: { defaults: { timeFormat: "auto" } }, // auto | 12 | 24}

agents.defaults.model

{  agents: {    defaults: {      models: {        "anthropic/claude-opus-4-6": { alias: "opus" },        "minimax/MiniMax-M2.7": { alias: "minimax" },      },      model: {        primary: "anthropic/claude-opus-4-6",        fallbacks: ["minimax/MiniMax-M2.7"],      },      imageModel: {        primary: "openrouter/qwen/qwen-2.5-vl-72b-instruct:free",        fallbacks: ["openrouter/google/gemini-2.0-flash-vision:free"],      },      imageGenerationModel: {        primary: "openai/gpt-image-2",        fallbacks: ["google/gemini-3.1-flash-image-preview"],      },      videoGenerationModel: {        primary: "qwen/wan2.6-t2v",        fallbacks: ["qwen/wan2.6-i2v"],      },      pdfModel: {        primary: "anthropic/claude-opus-4-6",        fallbacks: ["openai/gpt-5.4-mini"],      },      params: { cacheRetention: "long" }, // global default provider params      pdfMaxBytesMb: 10,      pdfMaxPages: 20,      thinkingDefault: "low",      verboseDefault: "off",      toolProgressDetail: "explain",      reasoningDefault: "off",      elevatedDefault: "on",      timeoutSeconds: 600,      mediaMaxMb: 5,      contextTokens: 200000,      maxConcurrent: 3,    },  },}

• model: รับได้ทั้งสตริง ("provider/model") หรือออบเจ็กต์ ({ primary, fallbacks })
  • รูปแบบสตริงตั้งค่าเฉพาะโมเดลหลักเท่านั้น
  • รูปแบบออบเจ็กต์ตั้งค่าโมเดลหลักพร้อมโมเดลสำรองตามลำดับสำหรับการสลับเมื่อใช้ไม่ได้
• imageModel: รับได้ทั้งสตริง ("provider/model") หรือออบเจ็กต์ ({ primary, fallbacks })
  • ใช้โดยเส้นทางเครื่องมือ image เป็นการกำหนดค่าโมเดลวิชัน
  • ใช้เป็นการกำหนดเส้นทางสำรองด้วย เมื่อโมเดลที่เลือก/โมเดลเริ่มต้นไม่สามารถรับอินพุตรูปภาพได้
  • แนะนำให้ใช้การอ้างอิง provider/model อย่างชัดเจน ระบบยอมรับ ID แบบไม่มีคำนำหน้าเพื่อความเข้ากันได้ หาก ID แบบไม่มีคำนำหน้าตรงกับรายการที่รองรับรูปภาพที่กำหนดค่าไว้ใน models.providers.*.models เพียงรายการเดียว OpenClaw จะเติม provider นั้นให้ ID ดังกล่าว รายการที่กำหนดค่าไว้แล้วแต่กำกวมต้องใช้คำนำหน้า provider อย่างชัดเจน
• imageGenerationModel: รับได้ทั้งสตริง ("provider/model") หรือออบเจ็กต์ ({ primary, fallbacks })
  • ใช้โดยความสามารถการสร้างรูปภาพร่วม และพื้นผิวเครื่องมือ/Plugin ใด ๆ ในอนาคตที่สร้างรูปภาพ
  • ค่าทั่วไป: google/gemini-3.1-flash-image-preview สำหรับการสร้างรูปภาพ Gemini แบบเนทีฟ, fal/fal-ai/flux/dev สำหรับ fal, openai/gpt-image-2 สำหรับ OpenAI Images หรือ openai/gpt-image-1.5 สำหรับเอาต์พุต OpenAI PNG/WebP พื้นหลังโปร่งใส
  • หากคุณเลือก provider/model โดยตรง ให้กำหนดค่าการยืนยันตัวตนของ provider ที่ตรงกันด้วย (เช่น GEMINI_API_KEY หรือ GOOGLE_API_KEY สำหรับ google/*, OPENAI_API_KEY หรือ OpenAI Codex OAuth สำหรับ openai/gpt-image-2 / openai/gpt-image-1.5, FAL_KEY สำหรับ fal/*)
  • หากละไว้ image_generate ยังสามารถอนุมานค่าเริ่มต้นของ provider ที่มีการยืนยันตัวตนรองรับได้ โดยจะลอง provider เริ่มต้นปัจจุบันก่อน แล้วจึงลอง provider การสร้างรูปภาพที่ลงทะเบียนไว้ที่เหลือตามลำดับ ID ของ provider
• musicGenerationModel: รับได้ทั้งสตริง ("provider/model") หรือออบเจ็กต์ ({ primary, fallbacks })
  • ใช้โดยความสามารถการสร้างเพลงร่วมและเครื่องมือในตัว music_generate
  • ค่าทั่วไป: google/lyria-3-clip-preview, google/lyria-3-pro-preview หรือ minimax/music-2.6
  • หากละไว้ music_generate ยังสามารถอนุมานค่าเริ่มต้นของ provider ที่มีการยืนยันตัวตนรองรับได้ โดยจะลอง provider เริ่มต้นปัจจุบันก่อน แล้วจึงลอง provider การสร้างเพลงที่ลงทะเบียนไว้ที่เหลือตามลำดับ ID ของ provider
  • หากคุณเลือก provider/model โดยตรง ให้กำหนดค่าการยืนยันตัวตน/API key ของ provider ที่ตรงกันด้วย
• videoGenerationModel: รับได้ทั้งสตริง ("provider/model") หรือออบเจ็กต์ ({ primary, fallbacks })
  • ใช้โดยความสามารถการสร้างวิดีโอร่วมและเครื่องมือในตัว video_generate
  • ค่าทั่วไป: qwen/wan2.6-t2v, qwen/wan2.6-i2v, qwen/wan2.6-r2v, qwen/wan2.6-r2v-flash หรือ qwen/wan2.7-r2v
  • หากละไว้ video_generate ยังสามารถอนุมานค่าเริ่มต้นของ provider ที่มีการยืนยันตัวตนรองรับได้ โดยจะลอง provider เริ่มต้นปัจจุบันก่อน แล้วจึงลอง provider การสร้างวิดีโอที่ลงทะเบียนไว้ที่เหลือตามลำดับ ID ของ provider
  • หากคุณเลือก provider/model โดยตรง ให้กำหนดค่าการยืนยันตัวตน/API key ของ provider ที่ตรงกันด้วย
  • Plugin การสร้างวิดีโอ Qwen อย่างเป็นทางการรองรับวิดีโอเอาต์พุตสูงสุด 1 รายการ, รูปภาพอินพุต 1 รายการ, วิดีโออินพุต 4 รายการ, ระยะเวลา 10 วินาที และตัวเลือกระดับ provider ได้แก่ size, aspectRatio, resolution, audio และ watermark
• pdfModel: รับได้ทั้งสตริง ("provider/model") หรือออบเจ็กต์ ({ primary, fallbacks })
  • ใช้โดยเครื่องมือ pdf สำหรับการกำหนดเส้นทางโมเดล
  • หากละไว้ เครื่องมือ PDF จะถอยกลับไปใช้ imageModel แล้วจึงใช้โมเดลของเซสชัน/ค่าเริ่มต้นที่ resolve ได้
• pdfMaxBytesMb: ขีดจำกัดขนาด PDF เริ่มต้นสำหรับเครื่องมือ pdf เมื่อไม่ได้ส่ง maxBytesMb ตอนเรียกใช้
• pdfMaxPages: จำนวนหน้าสูงสุดเริ่มต้นที่โหมดสำรองการแยกข้อมูลในเครื่องมือ pdf จะพิจารณา
• verboseDefault: ระดับ verbose เริ่มต้นสำหรับเอเจนต์ ค่า: "off", "on", "full" ค่าเริ่มต้น: "off"
• toolProgressDetail: โหมดรายละเอียดสำหรับสรุปเครื่องมือ /verbose และบรรทัดเครื่องมือแบบร่างความคืบหน้า ค่า: "explain" (ค่าเริ่มต้น, ป้ายกำกับสำหรับมนุษย์แบบกระชับ) หรือ "raw" (ต่อท้ายคำสั่ง/รายละเอียดดิบเมื่อมี) agents.list[].toolProgressDetail รายเอเจนต์จะเขียนทับค่าเริ่มต้นนี้
• reasoningDefault: การมองเห็น reasoning เริ่มต้นสำหรับเอเจนต์ ค่า: "off", "on", "stream" agents.list[].reasoningDefault รายเอเจนต์จะเขียนทับค่าเริ่มต้นนี้ ค่าเริ่มต้น reasoning ที่กำหนดค่าไว้จะถูกใช้เฉพาะกับเจ้าของ ผู้ส่งที่ได้รับอนุญาต หรือบริบท Gateway ของผู้ดูแลระบบปฏิบัติการ เมื่อไม่ได้ตั้งค่าการเขียนทับ reasoning รายข้อความหรือรายเซสชัน
• elevatedDefault: ระดับเอาต์พุตแบบยกระดับเริ่มต้นสำหรับเอเจนต์ ค่า: "off", "on", "ask", "full" ค่าเริ่มต้น: "on"
• model.primary: รูปแบบ provider/model (เช่น openai/gpt-5.5 สำหรับการเข้าถึงด้วย OpenAI API-key หรือ Codex OAuth) หากคุณละ provider ไว้ OpenClaw จะลอง alias ก่อน จากนั้นลองจับคู่ provider ที่กำหนดค่าไว้แบบไม่ซ้ำสำหรับ ID โมเดลนั้นแบบตรงตัว และหลังจากนั้นจึงถอยกลับไปใช้ provider เริ่มต้นที่กำหนดค่าไว้ (พฤติกรรมความเข้ากันได้ที่เลิกแนะนำแล้ว ดังนั้นควรใช้ provider/model อย่างชัดเจน) หาก provider นั้นไม่เปิดเผยโมเดลเริ่มต้นที่กำหนดค่าไว้อีกต่อไป OpenClaw จะถอยกลับไปใช้ provider/model ที่กำหนดค่าไว้รายการแรกแทนการแสดงค่าเริ่มต้นของ provider ที่ถูกลบและล้าสมัย
• models: แคตตาล็อกโมเดลที่กำหนดค่าไว้และ allowlist สำหรับ /model แต่ละรายการสามารถมี alias (ทางลัด) และ params (เฉพาะ provider เช่น temperature, maxTokens, cacheRetention, context1m, responsesServerCompaction, responsesCompactThreshold, การกำหนดเส้นทาง provider ของ OpenRouter, chat_template_kwargs, extra_body/extraBody)
  • ใช้รายการ provider/* เช่น "openai/*": {} หรือ "vllm/*": {} เพื่อแสดงโมเดลที่ค้นพบทั้งหมดสำหรับ provider ที่เลือก โดยไม่ต้องระบุ ID โมเดลทุกรายการด้วยตนเอง
  • เพิ่ม agentRuntime ลงในรายการ provider/* เมื่อโมเดลที่ค้นพบแบบไดนามิกทุกรายการสำหรับ provider นั้นควรใช้รันไทม์เดียวกัน นโยบายรันไทม์แบบตรงตัว provider/model ยังมีสิทธิ์เหนือ wildcard
  • การแก้ไขที่ปลอดภัย: ใช้ openclaw config set agents.defaults.models '<json>' --strict-json --merge เพื่อเพิ่มรายการ config set จะปฏิเสธการแทนที่ที่จะลบรายการ allowlist ที่มีอยู่ เว้นแต่คุณจะส่ง --replace
  • โฟลว์ configure/onboarding แบบจำกัดขอบเขตตาม provider จะรวมโมเดลของ provider ที่เลือกเข้าในแผนที่นี้ และคง provider อื่นที่กำหนดค่าไว้แล้วไว้
  • สำหรับโมเดล OpenAI Responses โดยตรง Compaction ฝั่งเซิร์ฟเวอร์จะเปิดใช้อัตโนมัติ ใช้ params.responsesServerCompaction: false เพื่อหยุดการฉีด context_management หรือใช้ params.responsesCompactThreshold เพื่อเขียนทับค่า threshold ดู Compaction ฝั่งเซิร์ฟเวอร์ของ OpenAI
• params: พารามิเตอร์เริ่มต้นของ provider แบบทั่วโลกที่ใช้กับทุกโมเดล ตั้งค่าที่ agents.defaults.params (เช่น { cacheRetention: "long" })
• ลำดับความสำคัญการ merge ของ params (config): agents.defaults.params (ฐานทั่วโลก) ถูกเขียนทับโดย agents.defaults.models["provider/model"].params (รายโมเดล) จากนั้น agents.list[].params (ID เอเจนต์ที่ตรงกัน) เขียนทับตาม key ดูรายละเอียดใน การแคชพรอมป์
• models.providers.openrouter.params.provider: นโยบายการกำหนดเส้นทาง provider เริ่มต้นทั่วทั้ง OpenRouter OpenClaw ส่งต่อนี้ไปยังออบเจ็กต์ provider ในคำขอของ OpenRouter; agents.defaults.models["openrouter/<model>"].params.provider รายโมเดลและพารามิเตอร์ของเอเจนต์จะเขียนทับตาม key ดู การกำหนดเส้นทาง provider ของ OpenRouter
• params.extra_body/params.extraBody: JSON ส่งผ่านขั้นสูงที่ merge เข้าใน body คำขอ api: "openai-completions" สำหรับพร็อกซีที่เข้ากันได้กับ OpenAI หากชนกับ key คำขอที่สร้างขึ้น extra body จะมีสิทธิ์เหนือกว่า; เส้นทาง completions ที่ไม่ใช่เนทีฟยังคงตัด store ที่ใช้เฉพาะ OpenAI ออกหลังจากนั้น
• params.chat_template_kwargs: อาร์กิวเมนต์ chat-template ที่เข้ากันได้กับ vLLM/OpenAI ซึ่ง merge เข้าใน body คำขอระดับบนสุดของ api: "openai-completions" สำหรับ vllm/nemotron-3-* ที่ปิด thinking อยู่ Plugin vLLM ที่บันเดิลมาจะส่ง enable_thinking: false และ force_nonempty_content: true โดยอัตโนมัติ; chat_template_kwargs ที่ระบุชัดเจนจะเขียนทับค่าเริ่มต้นที่สร้างขึ้น และ extra_body.chat_template_kwargs ยังคงมีสิทธิ์สุดท้าย โมเดล thinking ของ vLLM Qwen และ Nemotron ที่กำหนดค่าไว้จะแสดงตัวเลือก /think แบบไบนารี (off, on) แทนบันได effort หลายระดับ
• compat.thinkingFormat: สไตล์ payload thinking ที่เข้ากันได้กับ OpenAI ใช้ "together" สำหรับ reasoning.enabled สไตล์ Together, "qwen" สำหรับ enable_thinking ระดับบนสุดสไตล์ Qwen หรือ "qwen-chat-template" สำหรับ chat_template_kwargs.enable_thinking บนแบ็กเอนด์ตระกูล Qwen ที่รองรับ kwargs ของ chat-template ระดับคำขอ เช่น vLLM OpenClaw จะแมป thinking ที่ปิดใช้งานเป็น false และ thinking ที่เปิดใช้งานเป็น true และโมเดล vLLM Qwen ที่กำหนดค่าไว้จะแสดงตัวเลือก /think แบบไบนารีสำหรับรูปแบบเหล่านี้
• compat.supportedReasoningEfforts: รายการ reasoning effort ที่เข้ากันได้กับ OpenAI รายโมเดล ใส่ "xhigh" สำหรับ endpoint แบบกำหนดเองที่ยอมรับค่านั้นจริง ๆ; จากนั้น OpenClaw จะแสดง /think xhigh ในเมนูคำสั่ง แถวเซสชัน Gateway การตรวจสอบ session patch การตรวจสอบ agent CLI และการตรวจสอบ llm-task สำหรับ provider/model ที่กำหนดค่าไว้นั้น ใช้ compat.reasoningEffortMap เมื่อแบ็กเอนด์ต้องการค่าที่เฉพาะ provider สำหรับระดับมาตรฐาน
• params.preserveThinking: การเลือกใช้เฉพาะ Z.AI สำหรับ thinking ที่เก็บรักษาไว้ เมื่อเปิดใช้งานและ thinking เปิดอยู่ OpenClaw จะส่ง thinking.clear_thinking: false และเล่นซ้ำ reasoning_content ก่อนหน้า; ดู thinking และ thinking ที่เก็บรักษาไว้ของ Z.AI
• localService: ตัวจัดการกระบวนการระดับ provider แบบไม่บังคับสำหรับเซิร์ฟเวอร์โมเดล local/self-hosted เมื่อโมเดลที่เลือกเป็นของ provider นั้น OpenClaw จะ probe healthUrl (หรือ baseUrl + "/models"), เริ่ม command พร้อม args หาก endpoint ล่ม, รอสูงสุด readyTimeoutMs แล้วจึงส่งคำขอโมเดล command ต้องเป็นพาธแบบ absolute idleStopMs: 0 จะคงกระบวนการไว้จนกว่า OpenClaw จะออก; ค่าบวกจะหยุดกระบวนการที่ OpenClaw สร้างขึ้นหลังจากว่างเป็นจำนวนมิลลิวินาทีดังกล่าว ดู บริการโมเดล local
• นโยบายรันไทม์ควรอยู่บน provider หรือโมเดล ไม่ใช่บน agents.defaults ใช้ models.providers.<provider>.agentRuntime สำหรับกฎทั่วทั้ง provider หรือ agents.defaults.models["provider/model"].agentRuntime / agents.list[].models["provider/model"].agentRuntime สำหรับกฎเฉพาะโมเดล โมเดลเอเจนต์ OpenAI บน provider OpenAI อย่างเป็นทางการจะเลือก Codex เป็นค่าเริ่มต้น
• ตัวเขียน config ที่เปลี่ยนฟิลด์เหล่านี้ (เช่น /models set, /models set-image และคำสั่งเพิ่ม/ลบ fallback) จะบันทึกรูปแบบออบเจ็กต์มาตรฐานและคงรายการ fallback ที่มีอยู่ไว้เมื่อเป็นไปได้
• maxConcurrent: จำนวนการรันเอเจนต์แบบขนานสูงสุดข้ามเซสชัน (แต่ละเซสชันยังคงทำงานแบบลำดับเดียว) ค่าเริ่มต้น: 4

นโยบายรันไทม์

{  models: {    providers: {      openai: {        agentRuntime: { id: "codex" },      },    },  },  agents: {    defaults: {      model: "openai/gpt-5.5",      models: {        "anthropic/claude-opus-4-8": {          agentRuntime: { id: "claude-cli" },        },        "vllm/*": {          agentRuntime: { id: "openclaw" },        },      },    },  },}

• id: "auto", "openclaw", id ของ harness Plugin ที่ลงทะเบียนไว้ หรือ alias ของ backend CLI ที่รองรับ Plugin Codex ที่มาพร้อมแพ็กเกจจะลงทะเบียน codex; Plugin Anthropic ที่มาพร้อมแพ็กเกจให้ backend CLI claude-cli
• id: "auto" อนุญาตให้ harness Plugin ที่ลงทะเบียนไว้รับช่วง turn ที่รองรับ และใช้ OpenClaw เมื่อไม่มี harness ใดตรงกัน รันไทม์ Plugin ที่ระบุชัดเจน เช่น id: "codex" ต้องมี harness นั้นและจะล้มเหลวแบบปิดหากไม่พร้อมใช้งานหรือล้มเหลว
• id: "pi" ยอมรับเฉพาะในฐานะ alias ที่เลิกใช้แล้วของ openclaw เพื่อรักษาการกำหนดค่าที่เผยแพร่ไปแล้วจาก v2026.5.22 และก่อนหน้า การกำหนดค่าใหม่ควรใช้ openclaw
• ลำดับความสำคัญของรันไทม์คือ policy ของโมเดลแบบตรงตัวก่อน (agents.list[].models["provider/model"], agents.defaults.models["provider/model"] หรือ models.providers.<provider>.models[]) จากนั้นจึงเป็น agents.list[] / agents.defaults.models["provider/*"] แล้วจึงเป็น policy ทั้ง provider ที่ models.providers.<provider>.agentRuntime
• คีย์รันไทม์ระดับ agent ทั้งตัวเป็นของเดิม agents.defaults.agentRuntime, agents.list[].agentRuntime, การปักรันไทม์ของ session และ OPENCLAW_AGENT_RUNTIME จะถูกละเว้นโดยการเลือกรันไทม์ ให้รัน openclaw doctor --fix เพื่อลบค่าที่ค้างเก่า
• โมเดล agent ของ OpenAI ใช้ harness Codex เป็นค่าเริ่มต้น; provider/model agentRuntime.id: "codex" ยังคงใช้ได้เมื่อคุณต้องการระบุให้ชัดเจน
• สำหรับการปรับใช้ Claude CLI แนะนำให้ใช้ model: "anthropic/claude-opus-4-8" พร้อม agentRuntime.id: "claude-cli" ที่ผูกกับขอบเขตโมเดล refs โมเดลเดิม claude-cli/claude-opus-4-7 ยังทำงานเพื่อความเข้ากันได้ แต่การกำหนดค่าใหม่ควรรักษาการเลือก provider/model ให้เป็นแบบมาตรฐาน และใส่ backend การประมวลผลไว้ใน policy รันไทม์ของ provider/model
• สิ่งนี้ควบคุมเฉพาะการประมวลผล turn ของ agent แบบข้อความเท่านั้น การสร้างสื่อ, vision, PDF, เพลง, วิดีโอ และ TTS ยังคงใช้การตั้งค่า provider/model ของตนเอง

รูปย่อ alias ในตัว (ใช้เฉพาะเมื่อโมเดลอยู่ใน agents.defaults.models):

alias ที่คุณกำหนดค่าไว้จะมีผลเหนือค่าเริ่มต้นเสมอ

โมเดล Z.AI GLM-4.x จะเปิดใช้โหมดคิดโดยอัตโนมัติ เว้นแต่คุณตั้งค่า --thinking off หรือกำหนด agents.defaults.models["zai/<model>"].params.thinking เอง โมเดล Z.AI เปิดใช้ tool_stream เป็นค่าเริ่มต้นสำหรับการสตรีมการเรียกใช้เครื่องมือ ตั้งค่า agents.defaults.models["zai/<model>"].params.tool_stream เป็น false เพื่อปิดใช้ Anthropic Claude Opus 4.8 ปิดการคิดไว้เป็นค่าเริ่มต้นใน OpenClaw; เมื่อเปิดใช้การคิดแบบปรับตัวอย่างชัดเจน ค่าเริ่มต้นของ effort ที่ provider ของ Anthropic เป็นเจ้าของคือ high โมเดล Claude 4.6 ใช้ค่าเริ่มต้นเป็น adaptive เมื่อไม่ได้ตั้งค่าระดับการคิดอย่างชัดเจน

agents.defaults.cliBackends

backend CLI เสริมสำหรับการรันสำรองแบบข้อความเท่านั้น (ไม่มีการเรียกใช้เครื่องมือ) มีประโยชน์เป็นตัวสำรองเมื่อ provider API ล้มเหลว

{  agents: {    defaults: {      cliBackends: {        "claude-cli": {          command: "/opt/homebrew/bin/claude",        },        "my-cli": {          command: "my-cli",          args: ["--json"],          output: "json",          modelArg: "--model",          sessionArg: "--session",          sessionMode: "existing",          systemPromptArg: "--system",          // Or use systemPromptFileArg when the CLI accepts a prompt file flag.          systemPromptWhen: "first",          imageArg: "--image",          imageMode: "repeat",        },      },    },  },}

• backend CLI เน้นข้อความเป็นหลัก; เครื่องมือจะถูกปิดใช้เสมอ
• รองรับ session เมื่อมีการตั้งค่า sessionArg
• รองรับการส่งต่อรูปภาพเมื่อ imageArg รับพาธไฟล์
• reseedFromRawTranscriptWhenUncompacted: true อนุญาตให้ backend กู้คืน session ที่ถูกทำให้ใช้ไม่ได้อย่างปลอดภัย จากส่วนท้าย transcript ดิบของ OpenClaw ที่มีขอบเขตก่อนที่จะมี สรุป compaction แรก การเปลี่ยนแปลงโปรไฟล์ auth หรือ credential-epoch จะยังไม่มีการ reseed จากข้อมูลดิบเสมอ

agents.defaults.promptOverlays

prompt overlay ที่ไม่ขึ้นกับ provider ซึ่งใช้ตามตระกูลโมเดลบนพื้นผิวพรอมป์ที่ OpenClaw ประกอบขึ้น id โมเดลตระกูล GPT-5 จะได้รับสัญญาพฤติกรรมร่วมกันในเส้นทาง OpenClaw/provider; personality ควบคุมเฉพาะชั้นรูปแบบการโต้ตอบที่เป็นมิตร เส้นทาง app-server ของ Codex แบบ native จะคงคำสั่งฐาน/โมเดลที่ Codex เป็นเจ้าของไว้แทน overlay GPT-5 ของ OpenClaw นี้ และ OpenClaw จะปิดใช้ personality ในตัวของ Codex สำหรับ thread แบบ native

{  agents: {    defaults: {      promptOverlays: {        gpt5: {          personality: "friendly", // friendly | on | off        },      },    },  },}

• "friendly" (ค่าเริ่มต้น) และ "on" เปิดใช้ชั้นรูปแบบการโต้ตอบที่เป็นมิตร
• "off" ปิดใช้เฉพาะชั้นที่เป็นมิตร; สัญญาพฤติกรรม GPT-5 ที่ติดแท็กไว้ยังคงเปิดใช้
• plugins.entries.openai.config.personality แบบเดิมจะยังถูกอ่านเมื่อยังไม่ได้ตั้งค่าร่วมนี้

agents.defaults.heartbeat

การรัน Heartbeat เป็นระยะ

{  agents: {    defaults: {      heartbeat: {        every: "30m", // 0m disables        model: "openai/gpt-5.4-mini",        includeReasoning: false,        includeSystemPromptSection: true, // default: true; false omits the Heartbeat section from the system prompt        lightContext: false, // default: false; true keeps only HEARTBEAT.md from workspace bootstrap files        isolatedSession: false, // default: false; true runs each heartbeat in a fresh session (no conversation history)        skipWhenBusy: false, // default: false; true also waits for this agent's subagent/nested lanes        session: "main",        to: "+15555550123",        directPolicy: "allow", // allow (default) | block        target: "none", // default: none | options: last | whatsapp | telegram | discord | ...        prompt: "Read HEARTBEAT.md if it exists...",        ackMaxChars: 300,        suppressToolErrorWarnings: false,        timeoutSeconds: 45,      },    },  },}

• every: สตริงระยะเวลา (ms/s/m/h) ค่าเริ่มต้น: 30m (auth ด้วยคีย์ API) หรือ 1h (auth ด้วย OAuth) ตั้งค่าเป็น 0m เพื่อปิดใช้
• includeSystemPromptSection: เมื่อเป็น false จะตัดส่วน Heartbeat ออกจาก system prompt และข้ามการฉีด HEARTBEAT.md เข้าในบริบท bootstrap ค่าเริ่มต้น: true
• suppressToolErrorWarnings: เมื่อเป็น true จะระงับ payload คำเตือนข้อผิดพลาดของเครื่องมือระหว่างการรัน heartbeat
• timeoutSeconds: เวลาสูงสุดเป็นวินาทีที่อนุญาตสำหรับ turn ของ agent heartbeat ก่อนที่จะถูกยกเลิก เว้นว่างไว้เพื่อใช้ agents.defaults.timeoutSeconds เมื่อมีการตั้งค่า มิฉะนั้นจะใช้ cadence ของ heartbeat ที่จำกัดไว้ที่ 600 วินาที
• directPolicy: policy การส่งแบบตรง/DM allow (ค่าเริ่มต้น) อนุญาตการส่งไปยังเป้าหมายโดยตรง block ระงับการส่งไปยังเป้าหมายโดยตรงและปล่อย reason=dm-blocked
• lightContext: เมื่อเป็น true การรัน heartbeat จะใช้บริบท bootstrap แบบเบาและเก็บเฉพาะ HEARTBEAT.md จากไฟล์ bootstrap ของ workspace
• isolatedSession: เมื่อเป็น true แต่ละ heartbeat จะรันใน session ใหม่โดยไม่มีประวัติการสนทนาก่อนหน้า รูปแบบการแยกเดียวกับ cron sessionTarget: "isolated" ลดต้นทุน token ต่อ heartbeat จากประมาณ 100K เหลือประมาณ 2-5K token
• skipWhenBusy: เมื่อเป็น true การรัน heartbeat จะเลื่อนไปเมื่อ lane งานยุ่งเพิ่มเติมของ agent นั้นทำงานอยู่ ได้แก่ subagent ที่ผูกกับคีย์ session ของตนเองหรืองานคำสั่งแบบซ้อน lane ของ Cron จะเลื่อน heartbeat เสมอ แม้ไม่มีแฟล็กนี้
• ต่อ agent: ตั้งค่า agents.list[].heartbeat เมื่อ agent ใดก็ตามกำหนด heartbeat เฉพาะ agent เหล่านั้น เท่านั้นที่จะรัน heartbeat
• Heartbeat จะรัน turn ของ agent เต็มรูปแบบ — ช่วงเวลาที่สั้นลงจะใช้ token มากขึ้น

agents.defaults.compaction

{  agents: {    defaults: {      compaction: {        mode: "safeguard", // default | safeguard        provider: "my-provider", // id of a registered compaction provider plugin (optional)        timeoutSeconds: 180,        reserveTokensFloor: 24000,        keepRecentTokens: 50000,        identifierPolicy: "strict", // strict | off | custom        identifierInstructions: "Preserve deployment IDs, ticket IDs, and host:port pairs exactly.", // used when identifierPolicy=custom        qualityGuard: { enabled: true, maxRetries: 1 },        midTurnPrecheck: { enabled: false }, // optional tool-loop pressure check        postCompactionSections: ["Session Startup", "Red Lines"], // opt in to AGENTS.md section reinjection        model: "openrouter/anthropic/claude-sonnet-4-6", // optional compaction-only model override        truncateAfterCompaction: true, // rotate to a smaller successor JSONL after compaction        maxActiveTranscriptBytes: "20mb", // optional preflight local compaction trigger        notifyUser: true, // send brief notices when compaction starts and completes (default: false)        memoryFlush: {          enabled: true,          model: "ollama/qwen3:8b", // optional memory-flush-only model override          softThresholdTokens: 6000,          systemPrompt: "Session nearing compaction. Store durable memories now.",          prompt: "Write any lasting notes to memory/YYYY-MM-DD.md; reply with the exact silent token NO_REPLY if nothing to store.",        },      },    },  },}

• mode: default หรือ safeguard (การสรุปแบบแบ่งชิ้นสำหรับประวัติที่ยาว) ดู Compaction
• provider: id ของ Plugin ผู้ให้บริการ compaction ที่ลงทะเบียนไว้ เมื่อตั้งค่าแล้ว ระบบจะเรียก summarize() ของผู้ให้บริการแทนการสรุปด้วย LLM ในตัว หากล้มเหลวจะย้อนกลับไปใช้แบบในตัว การตั้งค่าผู้ให้บริการจะบังคับใช้ mode: "safeguard" ดู Compaction
• timeoutSeconds: จำนวนวินาทีสูงสุดที่อนุญาตสำหรับการดำเนินการ compaction หนึ่งครั้งก่อนที่ OpenClaw จะยกเลิก ค่าเริ่มต้น: 180
• keepRecentTokens: งบประมาณจุดตัดของเอเจนต์สำหรับเก็บส่วนท้ายของ transcript ล่าสุดแบบคำต่อคำ /compact แบบแมนนวลจะใช้ค่านี้เมื่อมีการตั้งค่าอย่างชัดเจน มิฉะนั้น compaction แบบแมนนวลจะเป็นจุดตรวจสอบแบบแข็ง
• identifierPolicy: strict (ค่าเริ่มต้น), off หรือ custom strict จะเติมคำแนะนำในตัวสำหรับการคงตัวระบุแบบทึบไว้ด้านหน้าระหว่างการสรุป compaction
• identifierInstructions: ข้อความกำหนดเองแบบไม่บังคับสำหรับการคงตัวระบุ ใช้เมื่อ identifierPolicy=custom
• qualityGuard: การตรวจสอบแบบลองใหม่เมื่อเอาต์พุตมีรูปแบบผิดสำหรับสรุปแบบ safeguard เปิดใช้เป็นค่าเริ่มต้นในโหมด safeguard; ตั้ง enabled: false เพื่อข้ามการตรวจสอบ
• midTurnPrecheck: การตรวจแรงกดของลูปเครื่องมือแบบไม่บังคับ เมื่อ enabled: true OpenClaw จะตรวจแรงกดของบริบทหลังจากผนวกผลลัพธ์เครื่องมือและก่อนการเรียกโมเดลครั้งถัดไป หากบริบทไม่พอดีอีกต่อไป ระบบจะยกเลิกความพยายามปัจจุบันก่อนส่งพรอมต์ และใช้เส้นทางกู้คืน precheck ที่มีอยู่ซ้ำเพื่อตัดผลลัพธ์เครื่องมือ หรือทำ compaction แล้วลองใหม่ ทำงานได้กับโหมด compaction ทั้ง default และ safeguard ค่าเริ่มต้น: ปิดใช้งาน
• postCompactionSections: ชื่อส่วน H2/H3 ของ AGENTS.md แบบไม่บังคับเพื่อฉีดกลับเข้ามาหลัง compaction การฉีดกลับจะถูกปิดใช้งานเมื่อไม่ได้ตั้งค่าหรือตั้งเป็น [] การตั้งค่าอย่างชัดเจนเป็น ["Session Startup", "Red Lines"] จะเปิดใช้คู่นั้นและคง fallback แบบเดิม Every Session/Safety เปิดใช้เฉพาะเมื่อบริบทเพิ่มเติมคุ้มกับความเสี่ยงของการทำซ้ำคำแนะนำโปรเจกต์ที่ถูกบันทึกไว้ในสรุป compaction แล้ว
• model: provider/model-id แบบไม่บังคับ หรือ alias เปล่าจาก agents.defaults.models สำหรับการสรุป compaction เท่านั้น alias เปล่าจะถูก resolve ก่อน dispatch; model ID แบบ literal ที่กำหนดค่าไว้ยังคงมีลำดับความสำคัญเมื่อชนกัน ใช้ค่านี้เมื่อเซสชันหลักควรใช้โมเดลหนึ่ง แต่สรุป compaction ควรรันบนอีกโมเดลหนึ่ง; เมื่อไม่ได้ตั้งค่า compaction จะใช้โมเดลหลักของเซสชัน
• maxActiveTranscriptBytes: เกณฑ์จำนวนไบต์แบบไม่บังคับ (number หรือสตริงเช่น "20mb") ที่ทริกเกอร์ compaction ภายในเครื่องตามปกติก่อนการรัน เมื่อ JSONL ที่ใช้งานอยู่โตเกินเกณฑ์ ต้องใช้ truncateAfterCompaction เพื่อให้ compaction ที่สำเร็จสามารถหมุนไปยัง transcript ตัวต่อที่เล็กกว่าได้ ปิดใช้งานเมื่อไม่ได้ตั้งค่าหรือเป็น 0
• notifyUser: เมื่อเป็น true จะส่งการแจ้งเตือนสั้น ๆ ให้ผู้ใช้เมื่อ compaction เริ่มและเมื่อเสร็จสิ้น (เช่น "กำลัง compact บริบท..." และ "Compaction เสร็จสมบูรณ์") ปิดใช้งานเป็นค่าเริ่มต้นเพื่อให้ compaction เงียบ
• memoryFlush: เทิร์น agentic แบบเงียบก่อน auto-compaction เพื่อจัดเก็บความจำที่คงทน ตั้ง model เป็นผู้ให้บริการ/โมเดลที่แน่นอน เช่น ollama/qwen3:8b เมื่อเทิร์นงานดูแลนี้ควรอยู่บนโมเดลภายในเครื่อง; override จะไม่สืบทอด fallback chain ของเซสชันที่ใช้งานอยู่ ข้ามเมื่อ workspace เป็นแบบอ่านอย่างเดียว

agents.defaults.runRetries

ขอบเขตการวนซ้ำของการลองใหม่ในลูปรันชั้นนอกสำหรับรันไทม์เอเจนต์แบบฝัง เพื่อป้องกันลูปการทำงานไม่สิ้นสุดระหว่างการกู้คืนจากความล้มเหลว โปรดทราบว่าการตั้งค่านี้ปัจจุบันใช้กับรันไทม์เอเจนต์แบบฝังเท่านั้น ไม่ใช่รันไทม์ ACP หรือ CLI

{  agents: {    defaults: {      runRetries: {        base: 24,        perProfile: 8,        min: 32,        max: 160,      },    },    list: [      {        id: "main",        runRetries: { max: 50 }, // optional per-agent overrides      },    ],  },}

• base: จำนวนพื้นฐานของรอบการลองรันใหม่สำหรับลูปรันชั้นนอก ค่าเริ่มต้น: 24
• perProfile: จำนวนรอบการลองรันใหม่เพิ่มเติมที่มอบให้ต่อผู้สมัครโปรไฟล์ fallback ค่าเริ่มต้น: 8
• min: ขีดจำกัดสัมบูรณ์ขั้นต่ำสำหรับรอบการลองรันใหม่ ค่าเริ่มต้น: 32
• max: ขีดจำกัดสัมบูรณ์สูงสุดสำหรับรอบการลองรันใหม่เพื่อป้องกันการทำงานหลุดควบคุม ค่าเริ่มต้น: 160

agents.defaults.contextPruning

ตัด ผลลัพธ์เครื่องมือเก่า ออกจากบริบทในหน่วยความจำก่อนส่งไปยัง LLM ไม่ แก้ไขประวัติเซสชันบนดิสก์

{  agents: {    defaults: {      contextPruning: {        mode: "cache-ttl", // off | cache-ttl        ttl: "1h", // duration (ms/s/m/h), default unit: minutes        keepLastAssistants: 3,        softTrimRatio: 0.3,        hardClearRatio: 0.5,        minPrunableToolChars: 50000,        softTrim: { maxChars: 4000, headChars: 1500, tailChars: 1500 },        hardClear: { enabled: true, placeholder: "[Old tool result content cleared]" },        tools: { deny: ["browser", "canvas"] },      },    },  },}

ดูรายละเอียดพฤติกรรมที่ การตัดแต่งเซสชัน

การสตรีมแบบบล็อก

{  agents: {    defaults: {      blockStreamingDefault: "off", // on | off      blockStreamingBreak: "text_end", // text_end | message_end      blockStreamingChunk: { minChars: 800, maxChars: 1200 },      blockStreamingCoalesce: { idleMs: 1000 },      humanDelay: { mode: "natural" }, // off | natural | custom (use minMs/maxMs)    },  },}

• ช่องทางที่ไม่ใช่ Telegram ต้องมี *.blockStreaming: true อย่างชัดเจนเพื่อเปิดใช้การตอบกลับแบบบล็อก
• การ override ระดับช่องทาง: channels.<channel>.blockStreamingCoalesce (และรูปแบบแยกตามบัญชี) Signal/Slack/Discord/Google Chat มีค่าเริ่มต้น minChars: 1500
• humanDelay: การหยุดแบบสุ่มระหว่างการตอบกลับแบบบล็อก natural = 800–2500ms การ override ต่อเอเจนต์: agents.list[].humanDelay

ดูรายละเอียดพฤติกรรม + การแบ่งชิ้นที่ การสตรีม

ตัวบ่งชี้การพิมพ์

{  agents: {    defaults: {      typingMode: "instant", // never | instant | thinking | message      typingIntervalSeconds: 6,    },  },}

• ค่าเริ่มต้น: instant สำหรับแชทโดยตรง/การกล่าวถึง, message สำหรับแชทกลุ่มที่ไม่ได้กล่าวถึง
• การ override ต่อเซสชัน: session.typingMode, session.typingIntervalSeconds

ดู ตัวบ่งชี้การพิมพ์

agents.defaults.sandbox

การทำ sandbox แบบไม่บังคับสำหรับเอเจนต์แบบฝัง ดูคู่มือฉบับเต็มที่ การทำ Sandbox

{  agents: {    defaults: {      sandbox: {        mode: "non-main", // off | non-main | all        backend: "docker", // docker | ssh | openshell        scope: "agent", // session | agent | shared        workspaceAccess: "none", // none | ro | rw        workspaceRoot: "~/.openclaw/sandboxes",        docker: {          image: "openclaw-sandbox:bookworm-slim",          containerPrefix: "openclaw-sbx-",          workdir: "/workspace",          readOnlyRoot: true,          tmpfs: ["/tmp", "/var/tmp", "/run"],          network: "none",          user: "1000:1000",          capDrop: ["ALL"],          env: { LANG: "C.UTF-8" },          setupCommand: "apt-get update && apt-get install -y git curl jq",          pidsLimit: 256,          memory: "1g",          memorySwap: "2g",          cpus: 1,          ulimits: {            nofile: { soft: 1024, hard: 2048 },            nproc: 256,          },          seccompProfile: "/path/to/seccomp.json",          apparmorProfile: "openclaw-sandbox",          dns: ["1.1.1.1", "8.8.8.8"],          extraHosts: ["internal.service:10.0.0.5"],          binds: ["/home/user/source:/source:rw"],        },        ssh: {          target: "user@gateway-host:22",          command: "ssh",          workspaceRoot: "/tmp/openclaw-sandboxes",          strictHostKeyChecking: true,          updateHostKeys: true,          identityFile: "~/.ssh/id_ed25519",          certificateFile: "~/.ssh/id_ed25519-cert.pub",          knownHostsFile: "~/.ssh/known_hosts",          // SecretRefs / inline contents also supported:          // identityData: { source: "env", provider: "default", id: "SSH_IDENTITY" },          // certificateData: { source: "env", provider: "default", id: "SSH_CERTIFICATE" },          // knownHostsData: { source: "env", provider: "default", id: "SSH_KNOWN_HOSTS" },        },        browser: {          enabled: false,          image: "openclaw-sandbox-browser:bookworm-slim",          network: "openclaw-sandbox-browser",          cdpPort: 9222,          cdpSourceRange: "172.21.0.1/32",          vncPort: 5900,          noVncPort: 6080,          headless: false,          enableNoVnc: true,          allowHostControl: false,          autoStart: true,          autoStartTimeoutMs: 12000,        },        prune: {          idleHours: 24,          maxAgeDays: 7,        },      },    },  },  tools: {    sandbox: {      tools: {        allow: [          "exec",          "process",          "read",          "write",          "edit",          "apply_patch",          "sessions_list",          "sessions_history",          "sessions_send",          "sessions_spawn",          "session_status",        ],        deny: ["browser", "canvas", "nodes", "cron", "discord", "gateway"],      },    },  },}

{plugins: {  entries: {    openshell: {      enabled: true,      config: {        mode: "mirror", // mirror | remote        from: "openclaw",        remoteWorkspaceDir: "/sandbox",        remoteAgentWorkspaceDir: "/agent",        gateway: "lab", // optional        gatewayEndpoint: "https://lab.example", // optional        policy: "strict", // optional OpenShell policy id        providers: ["openai"], // optional        autoProviders: true,        timeoutSeconds: 120,      },    },  },},}

การทำ sandbox เบราว์เซอร์และ sandbox.docker.binds ใช้ได้กับ Docker เท่านั้น

สร้างอิมเมจ (จาก source checkout):

scripts/sandbox-setup.sh           # main sandbox imagescripts/sandbox-browser-setup.sh   # optional browser image

สำหรับการติดตั้ง npm โดยไม่มี source checkout ดู Sandboxing § อิมเมจและการตั้งค่า สำหรับคำสั่ง docker build แบบ inline

agents.list (การแทนที่ค่าต่อเอเจนต์)

ใช้ agents.list[].tts เพื่อกำหนดผู้ให้บริการ TTS, เสียง, โมเดล, สไตล์ หรือโหมด auto-TTS ของเอเจนต์เอง บล็อกเอเจนต์จะ deep-merge ทับ messages.tts ระดับ global ดังนั้นข้อมูลรับรองที่แชร์จึงอยู่รวมในที่เดียวได้ ขณะที่เอเจนต์แต่ละตัว แทนที่เฉพาะฟิลด์เสียงหรือผู้ให้บริการที่ต้องการ การแทนที่ของเอเจนต์ที่ทำงานอยู่ มีผลกับการตอบกลับแบบพูดอัตโนมัติ, /tts audio, /tts status และ เครื่องมือเอเจนต์ tts ดู ข้อความเป็นเสียง สำหรับตัวอย่างผู้ให้บริการและลำดับความสำคัญ

{  agents: {    list: [      {        id: "main",        default: true,        name: "Main Agent",        workspace: "~/.openclaw/workspace",        agentDir: "~/.openclaw/agents/main/agent",        model: "anthropic/claude-opus-4-6", // or { primary, fallbacks }        thinkingDefault: "high", // per-agent thinking level override        reasoningDefault: "on", // per-agent reasoning visibility override        fastModeDefault: false, // per-agent fast mode override        params: { cacheRetention: "none" }, // overrides matching defaults.models params by key        tts: {          providers: {            elevenlabs: { speakerVoiceId: "EXAVITQu4vr4xnSDxMaL" },          },        },        skills: ["docs-search"], // replaces agents.defaults.skills when set        identity: {          name: "Samantha",          theme: "helpful sloth",          emoji: "🦥",          avatar: "avatars/samantha.png",        },        groupChat: { mentionPatterns: ["@openclaw"] },        sandbox: { mode: "off" },        runtime: {          type: "acp",          acp: {            agent: "codex",            backend: "acpx",            mode: "persistent",            cwd: "/workspace/openclaw",          },        },        subagents: { allowAgents: ["*"] },        tools: {          profile: "coding",          allow: ["browser"],          deny: ["canvas"],          elevated: { enabled: true },        },      },    ],  },}

• id: id เอเจนต์ที่เสถียร (จำเป็น)
• default: เมื่อตั้งไว้หลายรายการ รายการแรกชนะ (บันทึกคำเตือน) หากไม่ตั้งไว้ รายการแรกในลิสต์คือค่าเริ่มต้น
• model: รูปแบบสตริงตั้งค่า primary ต่อเอเจนต์แบบเข้มงวดโดยไม่มี model fallback; รูปแบบออบเจกต์ { primary } ก็เข้มงวดเช่นกัน เว้นแต่คุณจะเพิ่ม fallbacks ใช้ { primary, fallbacks: [...] } เพื่อให้เอเจนต์นั้นเลือกใช้ fallback หรือ { primary, fallbacks: [] } เพื่อระบุพฤติกรรมเข้มงวดให้ชัดเจน งาน Cron ที่แทนที่เฉพาะ primary ยังคงสืบทอด fallback ค่าเริ่มต้น เว้นแต่คุณจะตั้ง fallbacks: []
• params: stream params ต่อเอเจนต์ที่ผสานทับรายการโมเดลที่เลือกใน agents.defaults.models ใช้สำหรับการแทนค่าเฉพาะเอเจนต์ เช่น cacheRetention, temperature หรือ maxTokens โดยไม่ต้องทำซ้ำแค็ตตาล็อกโมเดลทั้งหมด
• tts: การแทนที่ข้อความเป็นเสียงต่อเอเจนต์แบบเลือกได้ บล็อกนี้ deep-merge ทับ messages.tts ดังนั้นให้เก็บข้อมูลรับรองผู้ให้บริการที่แชร์และนโยบาย fallback ไว้ใน messages.tts และตั้งเฉพาะค่าที่เฉพาะกับบุคลิก เช่น ผู้ให้บริการ, เสียง, โมเดล, สไตล์ หรือโหมดอัตโนมัติที่นี่
• skills: allowlist Skills ต่อเอเจนต์แบบเลือกได้ หากละไว้ เอเจนต์จะสืบทอด agents.defaults.skills เมื่อตั้งค่าไว้; ลิสต์ที่ระบุชัดเจนจะแทนที่ค่าเริ่มต้นแทนการผสาน และ [] หมายถึงไม่มี Skills
• thinkingDefault: ระดับ thinking เริ่มต้นต่อเอเจนต์แบบเลือกได้ (off | minimal | low | medium | high | xhigh | adaptive | max) แทนที่ agents.defaults.thinkingDefault สำหรับเอเจนต์นี้เมื่อไม่มีการแทนที่ต่อข้อความหรือเซสชัน โปรไฟล์ผู้ให้บริการ/โมเดลที่เลือกควบคุมว่าค่าใดใช้ได้; สำหรับ Google Gemini, adaptive จะคง dynamic thinking ที่ผู้ให้บริการเป็นเจ้าของ (thinkingLevel ถูกละไว้บน Gemini 3/3.1, thinkingBudget: -1 บน Gemini 2.5)
• reasoningDefault: การมองเห็น reasoning เริ่มต้นต่อเอเจนต์แบบเลือกได้ (on | off | stream) แทนที่ agents.defaults.reasoningDefault สำหรับเอเจนต์นี้เมื่อไม่มีการแทนที่ reasoning ต่อข้อความหรือเซสชัน
• fastModeDefault: ค่าเริ่มต้นต่อเอเจนต์แบบเลือกได้สำหรับ fast mode ("auto" | true | false) ใช้เมื่อไม่มีการแทนที่ fast-mode ต่อข้อความหรือเซสชัน
• models: การแทนที่แค็ตตาล็อกโมเดล/รันไทม์ต่อเอเจนต์แบบเลือกได้ โดยใช้ id provider/model แบบเต็มเป็นคีย์ ใช้ models["provider/model"].agentRuntime สำหรับข้อยกเว้นรันไทม์ต่อเอเจนต์
• runtime: ตัวอธิบายรันไทม์ต่อเอเจนต์แบบเลือกได้ ใช้ type: "acp" กับค่าเริ่มต้น runtime.acp (agent, backend, mode, cwd) เมื่อเอเจนต์ควรใช้เซสชัน harness ของ ACP เป็นค่าเริ่มต้น
• identity.avatar: พาธสัมพันธ์กับเวิร์กสเปซ, URL http(s) หรือ URI data:
• ไฟล์รูปภาพ identity.avatar แบบสัมพันธ์กับเวิร์กสเปซโลคัลจำกัดที่ 2 MB URL http(s) และ URI data: จะไม่ถูกตรวจด้วยขีดจำกัดขนาดไฟล์โลคัล
• identity สร้างค่าเริ่มต้น: ackReaction จาก emoji, mentionPatterns จาก name/emoji
• subagents.allowAgents: allowlist ของ id เอเจนต์ที่กำหนดค่าไว้สำหรับเป้าหมาย sessions_spawn.agentId ที่ระบุชัดเจน (["*"] = เป้าหมายที่กำหนดค่าไว้ใดก็ได้; ค่าเริ่มต้น: เอเจนต์เดียวกันเท่านั้น) รวม id ของผู้ร้องขอเมื่อควรอนุญาตการเรียก agentId ที่กำหนดเป้าหมายตนเอง รายการค้างที่ config เอเจนต์ถูกลบแล้วจะถูก sessions_spawn ปฏิเสธและละไว้จาก agents_list; รัน openclaw doctor --fix เพื่อล้างรายการเหล่านั้น หรือเพิ่มรายการ agents.list[] ขั้นต่ำหากเป้าหมายนั้นควรยัง spawn ได้ขณะสืบทอดค่าเริ่มต้น
• ตัวป้องกันการสืบทอด sandbox: หากเซสชันผู้ร้องขออยู่ใน sandbox, sessions_spawn จะปฏิเสธเป้าหมายที่จะรันนอก sandbox
• subagents.requireAgentId: เมื่อเป็น true จะบล็อกการเรียก sessions_spawn ที่ละ agentId (บังคับให้เลือกโปรไฟล์อย่างชัดเจน; ค่าเริ่มต้น: false)

การกำหนดเส้นทางหลายเอเจนต์

รันเอเจนต์แยกหลายตัวภายใน Gateway เดียว ดู Multi-Agent

{  agents: {    list: [      { id: "home", default: true, workspace: "~/.openclaw/workspace-home" },      { id: "work", workspace: "~/.openclaw/workspace-work" },    ],  },  bindings: [    { agentId: "home", match: { channel: "whatsapp", accountId: "personal" } },    { agentId: "work", match: { channel: "whatsapp", accountId: "biz" } },  ],}

ฟิลด์การจับคู่ Binding

• type (เลือกได้): route สำหรับการกำหนดเส้นทางปกติ (เมื่อไม่มี type จะใช้ค่าเริ่มต้นเป็น route), acp สำหรับ binding การสนทนา ACP แบบถาวร
• match.channel (จำเป็น)
• match.accountId (เลือกได้; * = บัญชีใดก็ได้; ละไว้ = บัญชีเริ่มต้น)
• match.peer (เลือกได้; { kind: direct|group|channel, id })
• match.guildId / match.teamId (เลือกได้; เฉพาะช่องทาง)
• acp (เลือกได้; เฉพาะสำหรับ type: "acp"): { mode, label, cwd, backend }

ลำดับการจับคู่ที่กำหนดแน่นอน:

1. match.peer
2. match.guildId
3. match.teamId
4. match.accountId (ตรงกัน exact, ไม่มี peer/guild/team)
5. match.accountId: "*" (ทั่วทั้งช่องทาง)
6. เอเจนต์เริ่มต้น

ภายในแต่ละระดับ รายการ bindings แรกที่ตรงกันจะชนะ

สำหรับรายการ type: "acp" OpenClaw จะแก้ไขตามตัวตนการสนทนาแบบ exact (match.channel + บัญชี + match.peer.id) และไม่ใช้ลำดับระดับ route binding ด้านบน

โปรไฟล์การเข้าถึงต่อเอเจนต์

{agents: {  list: [    {      id: "personal",      workspace: "~/.openclaw/workspace-personal",      sandbox: { mode: "off" },    },  ],},}

{agents: {  list: [    {      id: "family",      workspace: "~/.openclaw/workspace-family",      sandbox: { mode: "all", scope: "agent", workspaceAccess: "ro" },      tools: {        allow: [          "read",          "sessions_list",          "sessions_history",          "sessions_send",          "sessions_spawn",          "session_status",        ],        deny: ["write", "edit", "apply_patch", "exec", "process", "browser"],      },    },  ],},}

{agents: {  list: [    {      id: "public",      workspace: "~/.openclaw/workspace-public",      sandbox: { mode: "all", scope: "agent", workspaceAccess: "none" },      tools: {        allow: [          "sessions_list",          "sessions_history",          "sessions_send",          "sessions_spawn",          "session_status",          "whatsapp",          "telegram",          "slack",          "discord",          "gateway",        ],        deny: [          "read",          "write",          "edit",          "apply_patch",          "exec",          "process",          "browser",          "canvas",          "nodes",          "cron",          "gateway",          "image",        ],      },    },  ],},}

ดูรายละเอียดลำดับความสำคัญได้ที่ Sandbox และเครื่องมือแบบหลาย Agent

เซสชัน

{  session: {    scope: "per-sender",    dmScope: "main", // main | per-peer | per-channel-peer | per-account-channel-peer    identityLinks: {      alice: ["telegram:123456789", "discord:987654321012345678"],    },    reset: {      mode: "daily", // daily | idle      atHour: 4,      idleMinutes: 60,    },    resetByType: {      thread: { mode: "daily", atHour: 4 },      direct: { mode: "idle", idleMinutes: 240 },      group: { mode: "idle", idleMinutes: 120 },    },    resetTriggers: ["/new", "/reset"],    store: "~/.openclaw/agents/{agentId}/sessions/sessions.json",    maintenance: {      mode: "enforce", // enforce (default) | warn      pruneAfter: "30d",      maxEntries: 500,      resetArchiveRetention: "30d", // duration or false      maxDiskBytes: "500mb", // optional hard budget      highWaterBytes: "400mb", // optional cleanup target    },    threadBindings: {      enabled: true,      idleHours: 24, // default inactivity auto-unfocus in hours (`0` disables)      maxAgeHours: 0, // default hard max age in hours (`0` disables)    },    mainKey: "main", // legacy (runtime always uses "main")    agentToAgent: { maxPingPongTurns: 5 },    sendPolicy: {      rules: [{ action: "deny", match: { channel: "discord", chatType: "group" } }],      default: "allow",    },  },}

ข้อความ

{  messages: {    responsePrefix: "🦞", // or "auto"    ackReaction: "👀",    ackReactionScope: "group-mentions", // group-mentions | group-all | direct | all    removeAckAfterReply: false,    queue: {      mode: "followup", // steer | followup | collect | interrupt      debounceMs: 500,      cap: 20,      drop: "summarize", // old | new | summarize      byChannel: {        whatsapp: "followup",        telegram: "followup",      },    },    inbound: {      debounceMs: 2000, // 0 disables      byChannel: {        whatsapp: 5000,        slack: 1500,      },    },  },}

คำนำหน้าการตอบกลับ

การเขียนทับต่อช่องทาง/บัญชี: channels.<channel>.responsePrefix, channels.<channel>.accounts.<id>.responsePrefix

การตัดสินค่า (รายการที่เฉพาะเจาะจงที่สุดมีผล): บัญชี → ช่องทาง → ส่วนกลาง "" ปิดใช้งานและหยุด cascade "auto" สร้างจาก [{identity.name}]

ตัวแปรเทมเพลต:

ตัวแปรไม่คำนึงถึงตัวพิมพ์เล็กใหญ่ {think} เป็น alias ของ {thinkingLevel}

ปฏิกิริยา Ack

• ค่าเริ่มต้นคือ identity.emoji ของ agent ที่ใช้งานอยู่ มิฉะนั้นเป็น "👀" ตั้ง "" เพื่อปิดใช้งาน
• การเขียนทับต่อช่องทาง: channels.<channel>.ackReaction, channels.<channel>.accounts.<id>.ackReaction
• ลำดับการตัดสินค่า: บัญชี → ช่องทาง → messages.ackReaction → identity fallback
• ขอบเขต: group-mentions (ค่าเริ่มต้น), group-all, direct, all
• removeAckAfterReply: ลบ ack หลังการตอบกลับบนช่องทางที่รองรับ reaction เช่น Slack, Discord, Signal, Telegram, WhatsApp และ iMessage
• messages.statusReactions.enabled: เปิดใช้งาน lifecycle status reactions บน Slack, Discord, Signal, Telegram และ WhatsApp บน Slack และ Discord หากไม่ได้ตั้งค่าไว้ จะยังเปิดใช้งาน status reactions เมื่อ ack reactions ทำงานอยู่ บน Signal, Telegram และ WhatsApp ให้ตั้งค่าเป็น true อย่างชัดเจนเพื่อเปิดใช้งาน lifecycle status reactions
• messages.statusReactions.emojis: เขียนทับคีย์ emoji ของ lifecycle: queued, thinking, compacting, tool, coding, web, deploy, build, concierge, done, error, stallSoft และ stallHard Telegram อนุญาตเฉพาะชุด reaction คงที่ ดังนั้น emoji ที่กำหนดค่าไว้แต่ไม่รองรับจะ fallback ไปยังตัวแปร status ที่รองรับซึ่งใกล้เคียงที่สุดสำหรับแชตนั้น

Debounce ขาเข้า

รวมข้อความแบบข้อความล้วนที่เข้ามาอย่างรวดเร็วจากผู้ส่งเดียวกันเป็น agent turn เดียว สื่อ/ไฟล์แนบจะ flush ทันที คำสั่งควบคุมข้ามการ debounce

TTS (text-to-speech)

{  messages: {    tts: {      auto: "always", // off | always | inbound | tagged      mode: "final", // final | all      provider: "elevenlabs",      summaryModel: "openai/gpt-5.4-mini",      modelOverrides: { enabled: true },      maxTextLength: 4000,      timeoutMs: 30000,      prefsPath: "~/.openclaw/settings/tts.json",      providers: {        elevenlabs: {          apiKey: "elevenlabs_api_key",          baseUrl: "https://api.elevenlabs.io",          speakerVoiceId: "voice_id",          modelId: "eleven_multilingual_v2",          seed: 42,          applyTextNormalization: "auto",          languageCode: "en",          voiceSettings: {            stability: 0.5,            similarityBoost: 0.75,            style: 0.0,            useSpeakerBoost: true,            speed: 1.0,          },        },        microsoft: {          speakerVoice: "en-US-AvaMultilingualNeural",          lang: "en-US",          outputFormat: "audio-24khz-48kbitrate-mono-mp3",        },        openai: {          apiKey: "openai_api_key",          baseUrl: "https://api.openai.com/v1",          model: "gpt-4o-mini-tts",          speakerVoice: "alloy",        },      },    },  },}

• auto ควบคุมโหมด auto-TTS เริ่มต้น: off, always, inbound หรือ tagged /tts on|off สามารถแทนที่ค่ากำหนดภายในเครื่องได้ และ /tts status แสดงสถานะที่มีผลใช้งานจริง
• summaryModel แทนที่ agents.defaults.model.primary สำหรับการสรุปอัตโนมัติ
• modelOverrides เปิดใช้งานโดยค่าเริ่มต้น; modelOverrides.allowProvider มีค่าเริ่มต้นเป็น false (เลือกเปิดใช้เอง)
• API keys จะ fallback ไปยัง ELEVENLABS_API_KEY/XI_API_KEY และ OPENAI_API_KEY
• ผู้ให้บริการเสียงพูดที่รวมมาเป็นของ Plugin หากตั้งค่า plugins.allow ให้ใส่ Plugin ผู้ให้บริการ TTS แต่ละตัวที่คุณต้องการใช้ เช่น microsoft สำหรับ Edge TTS โดย id ผู้ให้บริการแบบเดิม edge จะยอมรับเป็น alias ของ microsoft
• providers.openai.baseUrl แทนที่ endpoint OpenAI TTS ลำดับการ resolve คือ config จากนั้น OPENAI_TTS_BASE_URL แล้วจึงเป็น https://api.openai.com/v1
• เมื่อ providers.openai.baseUrl ชี้ไปยัง endpoint ที่ไม่ใช่ OpenAI, OpenClaw จะถือว่าเป็นเซิร์ฟเวอร์ TTS ที่เข้ากันได้กับ OpenAI และผ่อนคลายการตรวจสอบความถูกต้องของ model/voice

การพูดคุย

ค่าเริ่มต้นสำหรับโหมดการพูดคุย (macOS/iOS/Android)

{  talk: {    provider: "elevenlabs",    providers: {      elevenlabs: {        speakerVoiceId: "elevenlabs_voice_id",        voiceAliases: {          Clawd: "EXAVITQu4vr4xnSDxMaL",          Roger: "CwhRBWXzGAHq8TQ4Fs17",        },        modelId: "eleven_v3",        outputFormat: "mp3_44100_128",        apiKey: "elevenlabs_api_key",      },      mlx: {        modelId: "mlx-community/Soprano-80M-bf16",      },      system: {},    },    consultThinkingLevel: "low",    consultFastMode: true,    speechLocale: "ru-RU",    silenceTimeoutMs: 1500,    interruptOnSpeech: true,    realtime: {      provider: "openai",      providers: {        openai: {          model: "gpt-realtime-2",          speakerVoice: "cedar",        },      },      instructions: "Speak warmly and keep answers brief.",      mode: "realtime",      transport: "webrtc",      brain: "agent-consult",    },  },}

• talk.provider ต้องตรงกับ key ใน talk.providers เมื่อมีการกำหนดค่าผู้ให้บริการการพูดคุยหลายตัว
• key การพูดคุยแบบแบนเดิม (talk.voiceId, talk.voiceAliases, talk.modelId, talk.outputFormat, talk.apiKey) มีไว้เพื่อความเข้ากันได้เท่านั้น เรียกใช้ openclaw doctor --fix เพื่อเขียน config ที่คงอยู่ใหม่เป็น talk.providers.<provider>
• Voice IDs จะ fallback ไปยัง ELEVENLABS_VOICE_ID หรือ SAG_VOICE_ID
• providers.*.apiKey รับสตริง plaintext หรือออบเจ็กต์ SecretRef
• fallback ของ ELEVENLABS_API_KEY ใช้เฉพาะเมื่อไม่ได้กำหนดค่า API key สำหรับการพูดคุย
• providers.*.voiceAliases ทำให้ directive ของการพูดคุยใช้ชื่อที่เป็นมิตรได้
• providers.mlx.modelId เลือก repo Hugging Face ที่ใช้โดยตัวช่วย MLX ภายในเครื่องของ macOS หากละไว้ macOS จะใช้ mlx-community/Soprano-80M-bf16
• การเล่นเสียง MLX บน macOS ทำงานผ่านตัวช่วย openclaw-mlx-tts ที่รวมมาเมื่อมีอยู่ หรือ executable บน PATH; OPENCLAW_MLX_TTS_BIN แทนที่ path ของตัวช่วยสำหรับการพัฒนา
• consultThinkingLevel ควบคุมระดับการคิดสำหรับการรันเอเจนต์ OpenClaw แบบเต็มที่อยู่เบื้องหลังการเรียก Control UI Talk realtime openclaw_agent_consult ปล่อยว่างไว้เพื่อรักษาพฤติกรรม session/model ปกติ
• consultFastMode ตั้งค่า override fast-mode แบบครั้งเดียวสำหรับ consult ของ Control UI Talk realtime โดยไม่เปลี่ยนการตั้งค่า fast-mode ปกติของ session
• speechLocale ตั้งค่า locale id แบบ BCP 47 ที่ใช้โดยการรู้จำเสียงพูด Talk ของ iOS/macOS ปล่อยว่างไว้เพื่อใช้ค่าเริ่มต้นของอุปกรณ์
• silenceTimeoutMs ควบคุมระยะเวลาที่โหมด Talk รอหลังจากผู้ใช้เงียบก่อนส่ง transcript หากไม่ตั้งค่าจะคงกรอบเวลาหยุดชั่วคราวเริ่มต้นของแพลตฟอร์ม (700 ms on macOS and Android, 900 ms on iOS)
• realtime.instructions ต่อท้ายคำสั่งระบบที่ส่งให้ผู้ให้บริการเข้ากับ prompt realtime ในตัวของ OpenClaw เพื่อให้กำหนดค่าสไตล์เสียงได้โดยไม่สูญเสียคำแนะนำ openclaw_agent_consult เริ่มต้น
• realtime.consultRouting ควบคุม fallback ของ Gateway relay เมื่อผู้ให้บริการ realtime สร้าง transcript ผู้ใช้สุดท้ายโดยไม่มี openclaw_agent_consult: provider-direct คงคำตอบจากผู้ให้บริการโดยตรงไว้ ขณะที่ force-agent-consult ส่งคำขอที่ finalize แล้วผ่าน OpenClaw

ที่เกี่ยวข้อง

• ข้อมูลอ้างอิงการกำหนดค่า — key config อื่นทั้งหมด
• การกำหนดค่า — งานทั่วไปและการตั้งค่าอย่างรวดเร็ว
• ตัวอย่างการกำหนดค่า