Gateway บน macOS

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

การตั้งค่าอัตโนมัติ

บน Mac เครื่องใหม่ ให้เลือก This Mac ระหว่างการเริ่มใช้งาน แอปจะรันตัวติดตั้งที่ลงนามแล้วและ บันเดิลมาด้วยก่อนตัวช่วย Gateway ติดตั้งรันไทม์ Node ในพื้นที่ผู้ใช้ และ CLI openclaw ที่ตรงกันไว้ใต้ ~/.openclaw จากนั้นติดตั้งและเริ่มบริการ launchd ต่อผู้ใช้ เส้นทางนี้ไม่ต้องใช้ Terminal, Homebrew หรือ สิทธิ์ผู้ดูแลระบบ

แอปบันเดิลสคริปต์ติดตั้ง ไม่ใช่เพย์โหลด Node หรือ Gateway ดังนั้นการตั้งค่า จึงต้องใช้อินเทอร์เน็ตเพื่อดาวน์โหลดรันไทม์และแพ็กเกจ OpenClaw ที่ตรงกัน

การกู้คืนด้วยตนเอง

แนะนำให้ใช้ Node 24 สำหรับการติดตั้งด้วยตนเอง Node 22 LTS ซึ่งปัจจุบันคือ 22.19+ ก็ใช้งานได้เช่นกัน จากนั้นติดตั้ง openclaw แบบโกลบอล:

npm install -g openclaw@<version>

ใช้ Retry setup หลังจากการตั้งค่าอัตโนมัติล้มเหลว หากยังล้มเหลว ให้ติดตั้ง CLI ด้วยตนเองด้วยคำสั่งด้านบน จากนั้นเลือก Check again ใน การเริ่มใช้งาน 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 Active" เปิด/ปิดใช้งาน LaunchAgent
• การออกจากแอป ไม่ หยุด gateway (launchd จะคงให้ทำงานอยู่)
• หากมี Gateway กำลังทำงานอยู่บนพอร์ตที่กำหนดค่าไว้แล้ว แอปจะแนบกับ Gateway นั้นแทนการเริ่มตัวใหม่

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

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

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

แอป macOS ตรวจสอบเวอร์ชัน Gateway เทียบกับเวอร์ชันของตัวเอง การเริ่มใช้งาน จะรันการตั้งค่าที่จัดการให้โดยอัตโนมัติเมื่อไม่มี CLI ที่มีอยู่หรือ ไม่เข้ากัน ใช้ Retry setup เพื่อทำการติดตั้งซ้ำ หรือ Check again หลังจากซ่อม CLI ภายนอกแล้ว

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

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

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

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

ใช้ CLI ดีบักของ macOS จากเช็กเอาต์ซอร์สเพื่อทดสอบ handshake ของ 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