Gateway บน macOS

OpenClaw.app จะไม่บันเดิล Node/Bun หรือรันไทม์ Gateway อีกต่อไป แอป macOS คาดหวังการติดตั้ง CLI openclaw แบบ ภายนอก ไม่ได้สปอน Gateway เป็น โพรเซสลูก และจัดการบริการ launchd ต่อผู้ใช้เพื่อให้ Gateway ทำงานอยู่เสมอ (หรือเชื่อมต่อกับ Gateway ภายในเครื่องที่มีอยู่แล้ว หากมีตัวหนึ่งทำงานอยู่แล้ว)

ติดตั้ง CLI (จำเป็นสำหรับโหมดภายในเครื่อง)

Node 24 เป็นรันไทม์เริ่มต้นบน Mac ส่วน Node 22 LTS ซึ่งปัจจุบันคือ 22.19+ ยังทำงานได้เพื่อความเข้ากันได้ จากนั้นติดตั้ง openclaw แบบโกลบอล:

npm install -g openclaw@<version>

ปุ่ม ติดตั้ง CLI ของแอป macOS จะรันโฟลว์การติดตั้งแบบโกลบอลเดียวกับที่แอป ใช้ภายใน: จะเลือก npm ก่อน จากนั้น pnpm แล้วจึง bun หากนั่นเป็นตัวจัดการแพ็กเกจเดียว ที่ตรวจพบ Node ยังคงเป็นรันไทม์ Gateway ที่แนะนำ

Launchd (Gateway เป็น LaunchAgent)

ป้ายกำกับ:

• ai.openclaw.gateway (หรือ ai.openclaw.<profile>; com.openclaw.* แบบเดิมอาจยังคงอยู่)

ตำแหน่ง Plist (ต่อผู้ใช้):

• ~/Library/LaunchAgents/ai.openclaw.gateway.plist (หรือ ~/Library/LaunchAgents/ai.openclaw.<profile>.plist)

ตัวจัดการ:

• แอป macOS เป็นเจ้าของการติดตั้ง/อัปเดต LaunchAgent ในโหมด Local
• CLI สามารถติดตั้งได้เช่นกัน: openclaw gateway install

พฤติกรรม:

• "OpenClaw ใช้งานอยู่" เปิด/ปิด LaunchAgent
• การออกจากแอป ไม่ หยุด Gateway (launchd จะคงให้มันทำงานอยู่)
• หากมี Gateway ทำงานอยู่แล้วบนพอร์ตที่กำหนดค่าไว้ แอปจะเชื่อมต่อกับ Gateway นั้นแทนการเริ่มตัวใหม่

การบันทึกล็อก:

• stdout ของ launchd: ~/Library/Logs/openclaw/gateway.log (โปรไฟล์ใช้ gateway-<profile>.log)
• stderr ของ launchd: ถูกระงับ

ความเข้ากันได้ของเวอร์ชัน

แอป macOS จะตรวจสอบเวอร์ชันของ Gateway เทียบกับเวอร์ชันของตัวเอง หากทั้งสอง เข้ากันไม่ได้ ให้อัปเดต CLI แบบโกลบอลให้ตรงกับเวอร์ชันของแอป

ไดเรกทอรีสถานะบน macOS

เก็บสถานะของ OpenClaw ไว้บนดิสก์ภายในเครื่องที่ไม่ซิงค์ หลีกเลี่ยง iCloud Drive และโฟลเดอร์อื่น ที่ซิงค์ผ่านคลาวด์ เพราะความหน่วงในการซิงค์และการล็อกไฟล์อาจส่งผลต่อเซสชัน ข้อมูลประจำตัว และสถานะ Gateway

ตั้งค่า OPENCLAW_STATE_DIR เป็นพาธภายในเครื่องเท่านั้นเมื่อคุณต้องการโอเวอร์ไรด์ openclaw doctor จะเตือนเกี่ยวกับพาธสถานะที่มักซิงค์ผ่านคลาวด์ และแนะนำ ให้ย้ายกลับไปใช้พื้นที่จัดเก็บภายในเครื่อง ดู ตัวแปรสภาพแวดล้อม และ Doctor

ดีบักการเชื่อมต่อของแอป

ใช้ CLI ดีบักของ macOS จากซอร์สเช็กเอาต์เพื่อทดสอบแฮนด์เชก Gateway WebSocket และตรรกะการค้นพบเดียวกับที่แอปใช้:

cd apps/macosswift run openclaw-mac connect --jsonswift run openclaw-mac discover --timeout 3000 --json

connect รับ --url, --token, --timeout และ --json ส่วน discover รับ --timeout, --json และ --include-local เปรียบเทียบเอาต์พุตการค้นพบ กับ openclaw gateway discover --json เมื่อคุณต้องการแยกปัญหาการค้นพบของ CLI ออกจากปัญหาการเชื่อมต่อฝั่งแอป

ตรวจสอบ Smoke

openclaw --version OPENCLAW_SKIP_CHANNELS=1 \OPENCLAW_SKIP_CANVAS_HOST=1 \openclaw gateway --port 18999 --bind loopback

จากนั้น:

openclaw gateway call health --url ws://127.0.0.1:18999 --timeout 3000

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

• แอป macOS
• รันบุ๊ก Gateway