รันไทม์ของเอเจนต์

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

• Embedded harnesses ทำงานภายในลูปเอเจนต์ที่เตรียมไว้ของ OpenClaw ปัจจุบันคือรันไทม์ pi ในตัว รวมถึง Plugin harnesses ที่ลงทะเบียนไว้ เช่น codex
• CLI backends เรียกใช้โปรเซส CLI ภายในเครื่อง โดยยังคง model ref ให้เป็นแบบ canonical ตัวอย่างเช่น anthropic/claude-opus-4-7 พร้อม agentRuntime.id: "claude-cli" ที่กำหนดขอบเขตระดับโมเดล หมายถึง “เลือกโมเดล Anthropic แล้วดำเนินการผ่าน Claude CLI” claude-cli ไม่ใช่ embedded harness id และต้องไม่ส่งเข้าไปในการเลือก AgentHarness

​

พื้นผิวของ Codex

{
  agents: {
    defaults: {
      model: "openai/gpt-5.5",
    },
  },
}

1. หากผู้ใช้ขอ Codex bind/control/thread/resume/steer/stop ให้ใช้พื้นผิวคำสั่ง /codex แบบเนทีฟเมื่อเปิดใช้ Plugin codex ที่รวมมาให้
2. หากผู้ใช้ขอ Codex เป็นรันไทม์แบบฝังตัว หรือต้องการประสบการณ์เอเจนต์ Codex ปกติที่รองรับด้วย subscription ให้ใช้ openai/<model>
3. หากผู้ใช้เลือก PI สำหรับโมเดล OpenAI อย่างชัดเจน ให้คง model ref เป็น openai/<model> และตั้งนโยบายรันไทม์ระดับผู้ให้บริการ/โมเดลเป็น agentRuntime.id: "pi" โปรไฟล์ตรวจสอบสิทธิ์ openai-codex ที่เลือกจะถูกส่งภายในผ่าน legacy Codex-auth transport ของ PI
4. หากการกำหนดค่าเดิมยังมี openai-codex/* model refs ให้ซ่อมแซมเป็น openai/<model> ด้วย openclaw doctor --fix; doctor จะคงเส้นทางตรวจสอบสิทธิ์ Codex ไว้โดยเพิ่ม agentRuntime.id: "codex" ที่กำหนดขอบเขตระดับผู้ให้บริการ/โมเดลในจุดที่ model ref เดิมสื่อความหมายนั้น
5. หากผู้ใช้ระบุ ACP, acpx หรือ Codex ACP adapter อย่างชัดเจน ให้ใช้ ACP พร้อม runtime: "acp" และ agentId: "codex"
6. หากคำขอเป็นเรื่อง Claude Code, Gemini CLI, OpenCode, Cursor, Droid หรือ external harness อื่น ให้ใช้ ACP/acpx ไม่ใช่รันไทม์ sub-agent แบบเนทีฟ

​

ความเป็นเจ้าของรันไทม์

• หาก OpenClaw เป็นเจ้าของพื้นผิว OpenClaw สามารถให้พฤติกรรม Plugin hook ปกติได้
• หากรันไทม์แบบเนทีฟเป็นเจ้าของพื้นผิว OpenClaw ต้องการ runtime events หรือ native hooks
• หากรันไทม์แบบเนทีฟเป็นเจ้าของสถานะเธรด canonical OpenClaw ควร mirror และ project บริบท ไม่ใช่เขียน internals ที่ไม่รองรับใหม่

​

การเลือกรันไทม์

1. นโยบายรันไทม์ที่กำหนดขอบเขตระดับโมเดลชนะก่อน สิ่งนี้อยู่ได้ในรายการโมเดลของผู้ให้บริการที่กำหนดค่าไว้ หรือใน agents.defaults.models["provider/model"].agentRuntime / agents.list[].models["provider/model"].agentRuntime
2. นโยบายรันไทม์ที่กำหนดขอบเขตระดับผู้ให้บริการตามมาที่ models.providers.<provider>.agentRuntime
3. ในโหมด auto รันไทม์ของ Plugin ที่ลงทะเบียนไว้สามารถ claim คู่ผู้ให้บริการ/โมเดลที่รองรับ
4. หากไม่มีรันไทม์ใด claim เทิร์นในโหมด auto OpenClaw จะใช้ PI เป็นรันไทม์ความเข้ากันได้ ใช้ runtime id แบบชัดเจนเมื่อการรันต้องเข้มงวด

{
  agents: {
    defaults: {
      model: "anthropic/claude-opus-4-7",
      models: {
        "anthropic/claude-opus-4-7": {
          agentRuntime: { id: "claude-cli" },
        },
      },
    },
  },
}

​

สัญญาความเข้ากันได้

​

ป้ายกำกับสถานะ

• model ref เช่น openai/gpt-5.5 บอก provider/model ที่เลือก
• runtime id เช่น codex บอกว่าลูปใดกำลังดำเนินการ turn
• ป้ายกำกับ channel เช่น Telegram หรือ Discord บอกว่าการสนทนาเกิดขึ้นที่ใด

​

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

• Codex harness
• Codex harness runtime
• OpenAI
• Agent harness plugins
• Agent loop
• Models
• Status