เอเจนต์ ACP — การตั้งค่า

สำหรับภาพรวม คู่มือปฏิบัติสำหรับผู้ดูแล และแนวคิด โปรดดู เอเจนต์ ACP.

ส่วนด้านล่างครอบคลุมการตั้งค่าฮาร์เนส acpx, การตั้งค่า Plugin สำหรับบริดจ์ MCP และการกำหนดค่าสิทธิ์

ใช้หน้านี้เฉพาะเมื่อคุณกำลังตั้งค่าเส้นทาง ACP/acpx เท่านั้น สำหรับการตั้งค่ารันไทม์ app-server แบบเนทีฟของ Codex ให้ใช้ ฮาร์เนส Codex สำหรับคีย์ OpenAI API หรือการตั้งค่าผู้ให้บริการโมเดล Codex OAuth ให้ใช้ OpenAI.

Codex มีเส้นทาง OpenClaw สองแบบ:

ควรใช้เส้นทางแบบเนทีฟ เว้นแต่คุณต้องการพฤติกรรม ACP/acpx อย่างชัดเจน

การรองรับฮาร์เนส acpx (ปัจจุบัน)

นามแฝงฮาร์เนสในตัวของ acpx ปัจจุบัน:

• claude
• codex
• copilot
• cursor (Cursor CLI: cursor-agent acp)
• droid
• gemini
• iflow
• kilocode
• kimi
• kiro
• openclaw
• opencode
• qwen

เมื่อ OpenClaw ใช้แบ็กเอนด์ acpx ให้ใช้ค่าเหล่านี้สำหรับ agentId เว้นแต่การตั้งค่า acpx ของคุณจะกำหนดนามแฝงเอเจนต์แบบกำหนดเองไว้ หากการติดตั้ง Cursor ในเครื่องของคุณยังเปิดเผย ACP เป็น agent acp ให้แทนที่คำสั่งเอเจนต์ cursor ในการตั้งค่า acpx ของคุณ แทนที่จะเปลี่ยนค่าเริ่มต้นในตัว

การใช้ acpx CLI โดยตรงสามารถกำหนดเป้าหมายอะแดปเตอร์ใดก็ได้ผ่าน --agent <command> เช่นกัน แต่ช่องทางหลบเลี่ยงดิบนี้เป็นฟีเจอร์ของ acpx CLI (ไม่ใช่เส้นทาง agentId ปกติของ OpenClaw)

การควบคุมโมเดลขึ้นอยู่กับความสามารถของอะแดปเตอร์ การอ้างอิงโมเดล Codex ACP จะถูกทำให้เป็นรูปแบบมาตรฐานโดย OpenClaw ก่อนเริ่มต้น ฮาร์เนสอื่นต้องมี ACP models พร้อมการรองรับ session/set_model; หากฮาร์เนสไม่เปิดเผยทั้งความสามารถ ACP นั้นและแฟล็กโมเดลตอนเริ่มต้นของตัวเอง OpenClaw/acpx จะไม่สามารถบังคับการเลือกโมเดลได้

การตั้งค่าที่จำเป็น

ค่าพื้นฐาน ACP ของคอร์:

{  acp: {    enabled: true,    // Optional. Default is true; set false to pause ACP dispatch while keeping /acp controls.    dispatch: { enabled: true },    backend: "acpx",    defaultAgent: "codex",    allowedAgents: [      "claude",      "codex",      "copilot",      "cursor",      "droid",      "gemini",      "iflow",      "kilocode",      "kimi",      "kiro",      "openclaw",      "opencode",      "openclaw",      "qwen",    ],    maxConcurrentSessions: 8,    stream: {      coalesceIdleMs: 300,      maxChunkChars: 1200,    },    runtime: {      ttlMinutes: 120,    },  },}

การตั้งค่าการผูกเธรดขึ้นอยู่กับอะแดปเตอร์ช่องทาง ตัวอย่างสำหรับ Discord:

{  session: {    threadBindings: {      enabled: true,      idleHours: 24,      maxAgeHours: 0,    },  },  channels: {    discord: {      threadBindings: {        enabled: true,        spawnSessions: true,      },    },  },}

หากการสปอว์น ACP แบบผูกกับเธรดไม่ทำงาน ให้ตรวจสอบแฟล็กฟีเจอร์ของอะแดปเตอร์ก่อน:

• Discord: channels.discord.threadBindings.spawnSessions=true

การผูกกับการสนทนาปัจจุบันไม่ต้องสร้างเธรดลูก ต้องมีบริบทการสนทนาที่ใช้งานอยู่และอะแดปเตอร์ช่องทางที่เปิดเผยการผูกการสนทนา ACP

ดู ข้อมูลอ้างอิงการกำหนดค่า

การตั้งค่า Plugin สำหรับแบ็กเอนด์ acpx

การติดตั้งแบบแพ็กเกจใช้ Plugin รันไทม์ @openclaw/acpx อย่างเป็นทางการสำหรับ ACP ติดตั้งและเปิดใช้งานก่อนใช้เซสชันฮาร์เนส ACP:

openclaw plugins install @openclaw/acpxopenclaw config set plugins.entries.acpx.enabled true

เช็กเอาต์ซอร์สสามารถใช้ Plugin เวิร์กสเปซในเครื่องได้หลังจาก pnpm install เช่นกัน

เริ่มด้วย:

/acp doctor

หากคุณปิดใช้งาน acpx, ปฏิเสธผ่าน plugins.allow / plugins.deny หรือต้องการเปลี่ยนกลับไปใช้ Plugin แบบแพ็กเกจ ให้ใช้เส้นทางแพ็กเกจแบบระบุชัดเจน:

openclaw plugins install @openclaw/acpxopenclaw config set plugins.entries.acpx.enabled true

การติดตั้งเวิร์กสเปซในเครื่องระหว่างการพัฒนา:

openclaw plugins install ./path/to/local/acpx-plugin

จากนั้นตรวจสอบสุขภาพแบ็กเอนด์:

/acp doctor

คำสั่ง acpx และการกำหนดค่าเวอร์ชัน

โดยค่าเริ่มต้น Plugin acpx จะลงทะเบียนแบ็กเอนด์ ACP แบบฝังระหว่างการเริ่มต้น Gateway และรอการตรวจสอบเริ่มต้นรันไทม์แบบฝังก่อนสัญญาณ ready ของ Gateway ตั้งค่า OPENCLAW_ACPX_RUNTIME_STARTUP_PROBE=0 หรือ OPENCLAW_SKIP_ACPX_RUNTIME_PROBE=1 เฉพาะสำหรับสคริปต์หรือสภาพแวดล้อมที่ตั้งใจปิดใช้งานการตรวจสอบตอนเริ่มต้นไว้เท่านั้น เรียกใช้ /acp doctor สำหรับการตรวจสอบตามคำขออย่างชัดเจน

แทนที่คำสั่งหรือเวอร์ชันในการตั้งค่า Plugin:

{  "plugins": {    "entries": {      "acpx": {        "enabled": true,        "config": {          "command": "../acpx/dist/cli.js",          "expectedVersion": "any"        }      }    }  }}

• command รับพาธสัมบูรณ์ พาธสัมพัทธ์ (แก้จากเวิร์กสเปซ OpenClaw) หรือชื่อคำสั่ง
• expectedVersion: "any" ปิดการจับคู่เวอร์ชันแบบเข้มงวด
• พาธ command แบบกำหนดเองจะปิดการติดตั้งอัตโนมัติภายใน Plugin

แทนที่คำสั่งเอเจนต์ ACP รายตัวด้วยอาร์กิวเมนต์แบบมีโครงสร้างเมื่อพาธหรือค่าแฟล็กควรคงเป็นโทเค็น argv เดียว:

{  "plugins": {    "entries": {      "acpx": {        "enabled": true,        "config": {          "agents": {            "claude": {              "command": "node",              "args": ["/path/to/custom adapter.mjs", "--verbose"]            }          }        }      }    }  }}

• agents.<id>.command คือไฟล์ปฏิบัติการหรือสตริงคำสั่งที่มีอยู่สำหรับเอเจนต์ ACP นั้น
• agents.<id>.args เป็นทางเลือก แต่ละรายการในอาร์เรย์จะถูกใส่เครื่องหมายอ้างอิงสำหรับเชลล์ก่อนที่ OpenClaw จะส่งผ่านรีจิสทรีสตริงคำสั่ง acpx ปัจจุบัน

ดู Plugin

การติดตั้งการพึ่งพาอัตโนมัติ

เมื่อคุณติดตั้ง OpenClaw แบบทั่วระบบด้วย npm install -g openclaw การพึ่งพารันไทม์ acpx (ไบนารีเฉพาะแพลตฟอร์ม) จะถูกติดตั้งโดยอัตโนมัติผ่านฮุก postinstall หากการติดตั้งอัตโนมัติล้มเหลว Gateway จะยังเริ่มทำงานตามปกติและรายงานการพึ่งพาที่ขาดผ่าน openclaw acp doctor

บริดจ์ MCP สำหรับเครื่องมือ Plugin

โดยค่าเริ่มต้น เซสชัน ACPX จะ ไม่ เปิดเผยเครื่องมือที่ลงทะเบียนโดย Plugin ของ OpenClaw ให้กับฮาร์เนส ACP

หากคุณต้องการให้เอเจนต์ ACP เช่น Codex หรือ Claude Code เรียกใช้เครื่องมือ Plugin ของ OpenClaw ที่ติดตั้งไว้ เช่น memory recall/store ให้เปิดใช้งานบริดจ์เฉพาะ:

openclaw config set plugins.entries.acpx.config.pluginToolsMcpBridge true

สิ่งที่ทำ:

• ฉีดเซิร์ฟเวอร์ MCP ในตัวชื่อ openclaw-plugin-tools เข้าในบูตสแตรปเซสชัน ACPX
• เปิดเผยเครื่องมือ Plugin ที่ลงทะเบียนไว้แล้วโดย Plugin ของ OpenClaw ที่ติดตั้งและเปิดใช้งานอยู่
• ทำให้ฟีเจอร์นี้ต้องเปิดใช้งานอย่างชัดเจนและปิดเป็นค่าเริ่มต้น

หมายเหตุด้านความปลอดภัยและความเชื่อถือ:

• สิ่งนี้ขยายพื้นผิวเครื่องมือของฮาร์เนส ACP
• เอเจนต์ ACP เข้าถึงได้เฉพาะเครื่องมือ Plugin ที่ใช้งานอยู่แล้วใน Gateway
• ให้ถือว่านี่เป็นขอบเขตความเชื่อถือเดียวกับการอนุญาตให้ Plugin เหล่านั้นทำงานใน OpenClaw เอง
• ตรวจสอบ Plugin ที่ติดตั้งก่อนเปิดใช้งาน

mcpServers แบบกำหนดเองยังทำงานเหมือนเดิม บริดจ์เครื่องมือ Plugin ในตัวเป็นความสะดวกเพิ่มเติมแบบเลือกเปิดใช้ ไม่ใช่สิ่งทดแทนการตั้งค่าเซิร์ฟเวอร์ MCP ทั่วไป

บริดจ์ MCP สำหรับเครื่องมือ OpenClaw

โดยค่าเริ่มต้น เซสชัน ACPX ก็ ไม่ เปิดเผยเครื่องมือในตัวของ OpenClaw ผ่าน MCP เช่นกัน เปิดใช้งานบริดจ์เครื่องมือคอร์แยกต่างหากเมื่อเอเจนต์ ACP ต้องใช้เครื่องมือในตัวที่เลือก เช่น cron:

openclaw config set plugins.entries.acpx.config.openClawToolsMcpBridge true

สิ่งที่ทำ:

• ฉีดเซิร์ฟเวอร์ MCP ในตัวชื่อ openclaw-tools เข้าในบูตสแตรปเซสชัน ACPX
• เปิดเผยเครื่องมือในตัวของ OpenClaw ที่เลือก เซิร์ฟเวอร์เริ่มต้นเปิดเผย cron
• ทำให้การเปิดเผยเครื่องมือคอร์ต้องเปิดใช้งานอย่างชัดเจนและปิดเป็นค่าเริ่มต้น

การกำหนดค่าเวลาหมดเวลาของการดำเนินงานรันไทม์

Plugin acpx ให้เวลาการเริ่มต้นรันไทม์แบบฝังและการดำเนินงานควบคุม 120 วินาทีโดยค่าเริ่มต้น สิ่งนี้ให้เวลาฮาร์เนสที่ช้ากว่า เช่น Gemini CLI เพียงพอสำหรับการเริ่มต้นและเตรียมใช้งาน ACP แทนที่ค่านี้หากโฮสต์ของคุณต้องใช้ขีดจำกัดการดำเนินงานต่างออกไป:

openclaw config set plugins.entries.acpx.config.timeoutSeconds 180

เทิร์นรันไทม์ใช้เวลาหมดเวลาของเอเจนต์/รันของ OpenClaw รวมถึง /acp timeout sessions_spawn ไม่รับการแทนที่เวลาหมดเวลารายการเรียก รีสตาร์ต Gateway หลังจากเปลี่ยนค่านี้

การกำหนดค่าเอเจนต์ตรวจสอบสุขภาพ

เมื่อ /acp doctor หรือการตรวจสอบตอนเริ่มต้นตรวจแบ็กเอนด์ Plugin acpx ที่รวมมาจะตรวจสอบเอเจนต์ฮาร์เนสหนึ่งตัว หากตั้งค่า acp.allowedAgents ไว้ จะใช้เอเจนต์ที่อนุญาตตัวแรกเป็นค่าเริ่มต้น มิฉะนั้นจะใช้ codex เป็นค่าเริ่มต้น หากการปรับใช้ของคุณต้องใช้เอเจนต์ ACP อื่นสำหรับการตรวจสุขภาพ ให้ตั้งค่าเอเจนต์ตรวจสอบอย่างชัดเจน:

openclaw config set plugins.entries.acpx.config.probeAgent claude

รีสตาร์ต Gateway หลังจากเปลี่ยนค่านี้

การกำหนดค่าสิทธิ์

เซสชัน ACP ทำงานแบบไม่โต้ตอบ ไม่มี TUI สำหรับอนุมัติหรือปฏิเสธพรอมป์สิทธิ์การเขียนไฟล์และการเรียกใช้เชลล์ Plugin acpx มีคีย์การตั้งค่าสองรายการที่ควบคุมวิธีจัดการสิทธิ์:

สิทธิ์ฮาร์เนส ACPX เหล่านี้แยกจากการอนุมัติ exec ของ OpenClaw และแยกจากแฟล็กข้ามของผู้จำหน่ายแบ็กเอนด์ CLI เช่น Claude CLI --permission-mode bypassPermissions ACPX approve-all คือสวิตช์ฉุกเฉินระดับฮาร์เนสสำหรับเซสชัน ACP

สำหรับการเปรียบเทียบที่กว้างขึ้นระหว่าง OpenClaw tools.exec.mode, การอนุมัติ Codex Guardian และสิทธิ์ฮาร์เนส ACPX โปรดดู โหมดสิทธิ์

permissionMode

ควบคุมว่าการดำเนินงานใดที่เอเจนต์ฮาร์เนสสามารถทำได้โดยไม่ต้องถาม

nonInteractivePermissions

ควบคุมว่าจะเกิดอะไรขึ้นเมื่อควรแสดงพรอมป์สิทธิ์แต่ไม่มี TUI แบบโต้ตอบให้ใช้ (ซึ่งเป็นกรณีเสมอสำหรับเซสชัน ACP)

การกำหนดค่า

ตั้งค่าผ่านการตั้งค่า Plugin:

openclaw config set plugins.entries.acpx.config.permissionMode approve-allopenclaw config set plugins.entries.acpx.config.nonInteractivePermissions fail

รีสตาร์ต Gateway หลังจากเปลี่ยนค่าเหล่านี้

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

• เอเจนต์ ACP — ภาพรวม คู่มือปฏิบัติสำหรับผู้ดูแล แนวคิด
• เอเจนต์ย่อย
• การกำหนดเส้นทางหลายเอเจนต์