Skip to main content

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.

Computer Use เป็น Plugin MCP แบบเนทีฟสำหรับ Codex เพื่อควบคุมเดสก์ท็อปภายในเครื่อง OpenClaw ไม่ได้รวมแอปเดสก์ท็อปไว้ในแพ็กเกจ ไม่ได้ดำเนินการเดสก์ท็อปเอง หรือข้าม สิทธิ์ของ Codex Plugin codex ที่มาพร้อมกันมีหน้าที่เตรียม Codex app-server เท่านั้น: โดยเปิดใช้งานการรองรับ Plugin ของ Codex, ค้นหาหรือติดตั้ง Plugin Codex Computer Use ที่กำหนดค่าไว้, ตรวจสอบว่าเซิร์ฟเวอร์ MCP computer-use พร้อมใช้งาน และ จากนั้นให้ Codex เป็นเจ้าของการเรียกเครื่องมือ MCP แบบเนทีฟระหว่างเทิร์นในโหมด Codex ใช้หน้านี้เมื่อ OpenClaw ใช้ harness แบบเนทีฟของ Codex อยู่แล้ว สำหรับการตั้งค่า runtime เอง โปรดดู Codex harness

​
OpenClaw.app และ Peekaboo

การผสานรวม Peekaboo ของ OpenClaw.app แยกจาก Codex Computer Use แอป macOS สามารถโฮสต์ซ็อกเก็ต PeekabooBridge เพื่อให้ CLI peekaboo ใช้สิทธิ์ Accessibility และ Screen Recording ภายในเครื่องของแอปซ้ำสำหรับเครื่องมือ อัตโนมัติของ Peekaboo เองได้ บริดจ์นั้นไม่ได้ติดตั้งหรือพร็อกซี Codex Computer Use และ Codex Computer Use ไม่ได้เรียกผ่านซ็อกเก็ต PeekabooBridge ใช้ Peekaboo bridge เมื่อคุณต้องการให้ OpenClaw.app เป็น โฮสต์ที่รับรู้สิทธิ์สำหรับระบบอัตโนมัติของ Peekaboo CLI ใช้หน้านี้เมื่อ agent ของ OpenClaw ในโหมด Codex ควรมี Plugin MCP computer-use แบบเนทีฟของ Codex พร้อมใช้งานก่อนเริ่มเทิร์น

​
แอป iOS

แอป iOS แยกจาก Codex Computer Use แอปนี้ไม่ได้ติดตั้งหรือพร็อกซี เซิร์ฟเวอร์ MCP computer-use ของ Codex และไม่ใช่แบ็กเอนด์ควบคุมเดสก์ท็อป แต่แอป iOS จะเชื่อมต่อเป็นโหนด OpenClaw และเปิดเผยความสามารถของมือถือ ผ่านคำสั่งโหนด เช่น canvas.*, camera.*, screen.*, location.* และ talk.* ใช้ iOS เมื่อคุณต้องการให้ agent ควบคุมโหนด iPhone ผ่าน Gateway ใช้หน้านี้เมื่อ agent ในโหมด Codex ควรควบคุมเดสก์ท็อป macOS ภายในเครื่อง ผ่าน Plugin Computer Use แบบเนทีฟของ Codex

​
MCP cua-driver โดยตรง

Codex Computer Use ไม่ใช่วิธีเดียวในการเปิดเผยการควบคุมเดสก์ท็อป หากคุณต้องการให้ runtime ที่ OpenClaw จัดการเรียก driver ของ TryCua โดยตรง ให้ใช้เซิร์ฟเวอร์ cua-driver mcp ต้นทางผ่านรีจิสทรี MCP ของ OpenClaw แทนโฟลว์ marketplace เฉพาะ Codex หลังจากติดตั้ง cua-driver แล้ว ให้ขอคำสั่ง OpenClaw จากเครื่องมือนั้น: 
cua-driver mcp-config --client openclaw
หรือลงทะเบียนเซิร์ฟเวอร์ stdio ด้วยตัวเอง: 
openclaw mcp set cua-driver '{"command":"cua-driver","args":["mcp"]}'
เส้นทางนั้นคงพื้นผิวเครื่องมือ MCP ต้นทางไว้ครบถ้วน รวมถึงสคีมาของ driver และคำตอบ MCP แบบมีโครงสร้าง ใช้เมื่อคุณต้องการให้ driver CUA พร้อมใช้งานเป็นเซิร์ฟเวอร์ MCP ปกติของ OpenClaw ใช้การตั้งค่า Codex Computer Use ใน หน้านี้เมื่อ Codex app-server ควรเป็นเจ้าของการติดตั้ง Plugin, การโหลด MCP ใหม่, และการเรียกเครื่องมือแบบเนทีฟภายในเทิร์นในโหมด Codex driver ของ CUA เฉพาะ macOS และยังต้องใช้สิทธิ์ macOS ภายในเครื่อง ที่แอปแจ้งขอ เช่น Accessibility และ Screen Recording OpenClaw ไม่ได้ติดตั้ง cua-driver, มอบสิทธิ์เหล่านั้น หรือข้ามโมเดลความปลอดภัยของ driver ต้นทาง

​
การตั้งค่าอย่างรวดเร็ว

ตั้งค่า plugins.entries.codex.config.computerUse เมื่อเทิร์นในโหมด Codex ต้องมี Computer Use พร้อมใช้งานก่อนเริ่มเธรด: 
{
  plugins: {
    entries: {
      codex: {
        enabled: true,
        config: {
          computerUse: {
            autoInstall: true,
          },
        },
      },
    },
  },
  agents: {
    defaults: {
      model: "openai/gpt-5.5",
    },
  },
}
ด้วยการกำหนดค่านี้ OpenClaw จะตรวจสอบ Codex app-server ก่อนแต่ละเทิร์นในโหมด Codex หากไม่มี Computer Use แต่ Codex app-server ได้ค้นพบ marketplace ที่ติดตั้งได้แล้ว OpenClaw จะขอให้ Codex app-server ติดตั้งหรือเปิดใช้งาน Plugin อีกครั้งและโหลด เซิร์ฟเวอร์ MCP ใหม่ บน macOS เมื่อไม่มี marketplace ที่ตรงกันลงทะเบียนไว้ และมีบันเดิลแอป Codex มาตรฐานอยู่ OpenClaw จะพยายามลงทะเบียน marketplace ของ Codex ที่มาพร้อมกันจาก /Applications/Codex.app/Contents/Resources/plugins/openai-bundled ก่อนที่จะ ล้มเหลวด้วย หากการตั้งค่ายังทำให้เซิร์ฟเวอร์ MCP พร้อมใช้งานไม่ได้ เทิร์นจะล้มเหลว ก่อนเริ่มเธรด หลังจากเปลี่ยนการกำหนดค่า Computer Use ให้ใช้ /new หรือ /reset ในแชตที่ได้รับผลกระทบ ก่อนทดสอบ หากเธรด Codex ที่มีอยู่เริ่มไปแล้ว

​
คำสั่ง

ใช้คำสั่ง /codex computer-use จากพื้นผิวแชตใดก็ได้ที่พื้นผิวคำสั่งของ Plugin codex พร้อมใช้งาน คำสั่งเหล่านี้เป็นคำสั่งแชต/runtime ของ OpenClaw ไม่ใช่คำสั่งย่อย CLI openclaw codex ...: 
/codex computer-use status
/codex computer-use install
/codex computer-use install --source <marketplace-source>
/codex computer-use install --marketplace-path <path>
/codex computer-use install --marketplace <name>
status เป็นแบบอ่านอย่างเดียว โดยจะไม่เพิ่มแหล่ง marketplace, ติดตั้ง Plugin หรือ เปิดใช้งานการรองรับ Plugin ของ Codex install เปิดใช้งานการรองรับ Plugin ของ Codex app-server, เพิ่มแหล่ง marketplace ที่กำหนดค่าไว้ถ้ามี, ติดตั้งหรือเปิดใช้งาน Plugin ที่กำหนดค่าไว้ผ่าน Codex app-server อีกครั้ง, โหลดเซิร์ฟเวอร์ MCP ใหม่ และตรวจสอบว่าเซิร์ฟเวอร์ MCP เปิดเผยเครื่องมือ

​
ตัวเลือก marketplace

OpenClaw ใช้ API ของ app-server เดียวกับที่ Codex เปิดเผยเอง ฟิลด์ marketplace เลือกตำแหน่งที่ Codex ควรค้นหา computer-use
ฟิลด์ใช้เมื่อการรองรับการติดตั้ง
ไม่มีฟิลด์ marketplaceคุณต้องการให้ Codex app-server ใช้ marketplace ที่รู้อยู่แล้วใช่ เมื่อ app-server ส่งคืน marketplace ภายในเครื่อง
marketplaceSourceคุณมีแหล่ง marketplace ของ Codex ที่ app-server เพิ่มได้ใช่ สำหรับ /codex computer-use install แบบระบุชัดเจน
marketplacePathคุณรู้อยู่แล้วถึงเส้นทางไฟล์ marketplace ภายในเครื่องบนโฮสต์ใช่ สำหรับการติดตั้งแบบระบุชัดเจนและการติดตั้งอัตโนมัติเมื่อเริ่มเทิร์น
marketplaceNameคุณต้องการเลือก marketplace ที่ลงทะเบียนแล้วรายการหนึ่งตามชื่อใช่ เฉพาะเมื่อ marketplace ที่เลือกมีเส้นทางภายในเครื่อง
โฮม Codex ใหม่อาจต้องใช้เวลาสั้น ๆ เพื่อ seed marketplace ทางการ ระหว่างติดตั้ง OpenClaw จะ poll plugin/list สูงสุด marketplaceDiscoveryTimeoutMs มิลลิวินาที ค่าเริ่มต้นคือ 60 วินาที หาก marketplace ที่รู้จักหลายรายการมี Computer Use OpenClaw จะเลือก openai-bundled ก่อน ตามด้วย openai-curated แล้วจึง local การจับคู่ที่คลุมเครือและไม่รู้จัก จะล้มเหลวแบบปิดและขอให้คุณตั้งค่า marketplaceName หรือ marketplacePath

​
marketplace ของ macOS ที่มาพร้อมกัน

บิลด์ Codex desktop รุ่นล่าสุดรวม Computer Use ไว้ที่นี่: 
/Applications/Codex.app/Contents/Resources/plugins/openai-bundled/plugins/computer-use
เมื่อ computerUse.autoInstall เป็น true และไม่มี marketplace ที่มี computer-use ลงทะเบียนไว้ OpenClaw จะพยายามเพิ่มราก marketplace มาตรฐาน ที่มาพร้อมกันโดยอัตโนมัติ: 
/Applications/Codex.app/Contents/Resources/plugins/openai-bundled
คุณยังสามารถลงทะเบียนอย่างชัดเจนจาก shell ด้วย Codex ได้: 
codex plugin marketplace add /Applications/Codex.app/Contents/Resources/plugins/openai-bundled
หากคุณใช้เส้นทางแอป Codex ที่ไม่ใช่มาตรฐาน ให้ตั้งค่า computerUse.marketplacePath เป็น เส้นทางไฟล์ marketplace ภายในเครื่อง หรือเรียกใช้ /codex computer-use install --source <marketplace-source> หนึ่งครั้ง

​
ข้อจำกัดของแค็ตตาล็อกระยะไกล

Codex app-server สามารถแสดงรายการและอ่านรายการแค็ตตาล็อกแบบระยะไกลเท่านั้นได้ แต่ในปัจจุบัน ยังไม่รองรับ plugin/install ระยะไกล ซึ่งหมายความว่า marketplaceName สามารถ เลือก marketplace แบบระยะไกลเท่านั้นสำหรับการตรวจสอบสถานะได้ แต่การติดตั้งและการเปิดใช้งานอีกครั้ง ยังต้องใช้ marketplace ภายในเครื่องผ่าน marketplaceSource หรือ marketplacePath หากสถานะบอกว่า Plugin พร้อมใช้งานใน marketplace ระยะไกลของ Codex แต่ไม่รองรับ การติดตั้งระยะไกล ให้เรียกใช้การติดตั้งด้วยแหล่งหรือเส้นทางภายในเครื่อง: 
/codex computer-use install --source <marketplace-source>
/codex computer-use install --marketplace-path <path>

​
อ้างอิงการกำหนดค่า

ฟิลด์ค่าเริ่มต้นความหมาย
enabledอนุมานกำหนดให้ต้องใช้ Computer Use ค่าเริ่มต้นเป็น true เมื่อมีการตั้งค่าฟิลด์ Computer Use อื่น
autoInstallfalseติดตั้งหรือเปิดใช้งานอีกครั้งจาก marketplace ที่ค้นพบแล้วเมื่อเริ่มเทิร์น
marketplaceDiscoveryTimeoutMs60000ระยะเวลาที่การติดตั้งรอให้ Codex app-server ค้นพบ marketplace
marketplaceSourceไม่ได้ตั้งค่าสตริงแหล่งที่ส่งไปยัง marketplace/add ของ Codex app-server
marketplacePathไม่ได้ตั้งค่าเส้นทางไฟล์ marketplace ภายในเครื่องของ Codex ที่มี Plugin
marketplaceNameไม่ได้ตั้งค่าชื่อ marketplace ของ Codex ที่ลงทะเบียนไว้เพื่อเลือก
pluginNamecomputer-useชื่อ Plugin ใน marketplace ของ Codex
mcpServerNamecomputer-useชื่อเซิร์ฟเวอร์ MCP ที่ Plugin ที่ติดตั้งเปิดเผย
การติดตั้งอัตโนมัติเมื่อเริ่มเทิร์นตั้งใจปฏิเสธค่า marketplaceSource ที่กำหนดค่าไว้ การเพิ่มแหล่งใหม่เป็นการดำเนินการตั้งค่าแบบชัดเจน ดังนั้นให้ใช้ /codex computer-use install --source <marketplace-source> หนึ่งครั้ง แล้วปล่อยให้ autoInstall จัดการการเปิดใช้งานอีกครั้งในอนาคตจาก marketplace ภายในเครื่องที่ค้นพบ การติดตั้งอัตโนมัติเมื่อเริ่มเทิร์นสามารถใช้ marketplacePath ที่กำหนดค่าไว้ได้ เพราะนั่นเป็น เส้นทางภายในเครื่องบนโฮสต์อยู่แล้ว

​
สิ่งที่ OpenClaw ตรวจสอบ

OpenClaw รายงานเหตุผลการตั้งค่าที่เสถียรภายในและจัดรูปแบบสถานะที่ผู้ใช้เห็น สำหรับแชต:
เหตุผลความหมายขั้นตอนถัดไป
disabledcomputerUse.enabled resolve เป็น falseตั้งค่า enabled หรือฟิลด์ Computer Use อื่น
marketplace_missingไม่มี marketplace ที่ตรงกันพร้อมใช้งานกำหนดค่าแหล่ง, เส้นทาง หรือชื่อ marketplace
plugin_not_installedมี marketplace แต่ยังไม่ได้ติดตั้ง Pluginเรียกใช้การติดตั้งหรือเปิดใช้ autoInstall
plugin_disabledติดตั้ง Plugin แล้วแต่ถูกปิดใช้งานในการกำหนดค่า Codexเรียกใช้การติดตั้งเพื่อเปิดใช้งานอีกครั้ง
remote_install_unsupportedmarketplace ที่เลือกเป็นแบบระยะไกลเท่านั้นใช้ marketplaceSource หรือ marketplacePath
mcp_missingเปิดใช้งาน Plugin แล้ว แต่เซิร์ฟเวอร์ MCP ไม่พร้อมใช้งานตรวจสอบ Codex Computer Use และสิทธิ์ของ OS
readyPlugin และเครื่องมือ MCP พร้อมใช้งานเริ่มเทิร์นในโหมด Codex
check_failedคำขอ Codex app-server ล้มเหลวระหว่างตรวจสอบสถานะตรวจสอบการเชื่อมต่อ app-server และบันทึก
auto_install_blockedการตั้งค่าเมื่อเริ่มเทิร์นจำเป็นต้องเพิ่มแหล่งใหม่เรียกใช้การติดตั้งแบบระบุชัดเจนก่อน
เอาต์พุตแชตรวมสถานะ Plugin, สถานะเซิร์ฟเวอร์ MCP, marketplace, เครื่องมือ เมื่อพร้อมใช้งาน และข้อความเฉพาะสำหรับขั้นตอนการตั้งค่าที่ล้มเหลว

​
สิทธิ์ macOS

Computer Use เฉพาะ macOS เซิร์ฟเวอร์ MCP ที่ Codex เป็นเจ้าของอาจต้องใช้สิทธิ์ OS ภายในเครื่องก่อนที่จะตรวจสอบหรือควบคุมแอปได้ หาก OpenClaw บอกว่า Computer Use ติดตั้งแล้วแต่เซิร์ฟเวอร์ MCP ไม่พร้อมใช้งาน ให้ตรวจสอบการตั้งค่า Computer Use ฝั่ง Codex ก่อน:
  • Codex app-server กำลังทำงานบนโฮสต์เดียวกับที่ควรเกิดการควบคุมเดสก์ท็อป
  • Plugin Computer Use เปิดใช้งานอยู่ในการกำหนดค่า Codex
  • เซิร์ฟเวอร์ MCP computer-use ปรากฏในสถานะ MCP ของ Codex app-server
  • macOS ได้ให้สิทธิ์ที่จำเป็นสำหรับแอปควบคุมเดสก์ท็อปแล้ว
  • เซสชันโฮสต์ปัจจุบันสามารถเข้าถึงเดสก์ท็อปที่กำลังถูกควบคุมได้
OpenClaw ตั้งใจให้ปิดกั้นโดยค่าเริ่มต้นเมื่อ computerUse.enabled เป็น true รอบการทำงานในโหมด Codex ไม่ควรดำเนินต่อไปแบบเงียบ ๆ โดยไม่มีเครื่องมือเดสก์ท็อปแบบเนทีฟที่การกำหนดค่ากำหนดไว้

​
การแก้ไขปัญหา

สถานะบอกว่ายังไม่ได้ติดตั้ง เรียกใช้ /codex computer-use install หากไม่พบ marketplace ให้ส่ง --source หรือ --marketplace-path สถานะบอกว่าติดตั้งแล้วแต่ปิดใช้งานอยู่ เรียกใช้ /codex computer-use install อีกครั้ง การติดตั้ง Codex app-server จะเขียนการกำหนดค่า Plugin กลับเป็นเปิดใช้งาน สถานะบอกว่าไม่รองรับการติดตั้งระยะไกล ใช้แหล่งที่มาหรือพาธ marketplace แบบภายในเครื่อง รายการแค็ตตาล็อกที่มีเฉพาะระยะไกลสามารถตรวจสอบได้ แต่ติดตั้งผ่าน API ของ app-server ปัจจุบันไม่ได้ สถานะบอกว่าเซิร์ฟเวอร์ MCP ไม่พร้อมใช้งาน เรียกใช้การติดตั้งซ้ำหนึ่งครั้งเพื่อให้เซิร์ฟเวอร์ MCP โหลดใหม่ หากยังไม่พร้อมใช้งาน ให้แก้ไขแอป Codex Computer Use, สถานะ MCP ของ Codex app-server หรือสิทธิ์ของ macOS สถานะหรือ probe หมดเวลาที่ computer-use.list_apps Plugin และเซิร์ฟเวอร์ MCP มีอยู่แล้ว แต่บริดจ์ Computer Use ภายในเครื่องไม่ตอบสนอง ออกจากหรือรีสตาร์ท Codex Computer Use, เปิด Codex Desktop ใหม่หากจำเป็น แล้วลองอีกครั้งในเซสชัน OpenClaw ใหม่ เครื่องมือ Computer Use แจ้งว่า Native hook relay unavailable hook เครื่องมือแบบเนทีฟของ Codex ไม่สามารถเข้าถึงรีเลย์ OpenClaw ที่ใช้งานอยู่ผ่านบริดจ์ภายในเครื่องหรือ Gateway fallback ได้ เริ่มเซสชัน OpenClaw ใหม่ด้วย /new หรือ /reset หากยังเกิดขึ้นอีก ให้รีสตาร์ท Gateway เพื่อให้เธรด app-server เก่าและการลงทะเบียน hook ถูกล้างออก แล้วลองใหม่อีกครั้ง การติดตั้งอัตโนมัติเมื่อเริ่มรอบการทำงานปฏิเสธแหล่งที่มา นี่เป็นพฤติกรรมโดยตั้งใจ ให้เพิ่มแหล่งที่มาด้วยคำสั่งที่ชัดเจน /codex computer-use install --source <marketplace-source> ก่อน จากนั้นการติดตั้งอัตโนมัติเมื่อเริ่มรอบการทำงานในอนาคตจะใช้ marketplace ภายในเครื่องที่ค้นพบได้

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