First steps
การเริ่มต้นใช้งาน (แอป macOS)
ขั้นตอนการใช้งานแอป macOS ครั้งแรก: เลือกตำแหน่งที่ Gateway ทำงาน เชื่อมต่อ แบ็กเอนด์ AI ที่ยืนยันแล้ว อนุญาตสิทธิ์ และส่งต่อไปยังกระบวนการ บูตสแตรปของเอเจนต์ สำหรับการเริ่มต้นใช้งานผ่าน CLI และการเปรียบเทียบทั้งสองเส้นทาง โปรดดูภาพรวมการเริ่มต้นใช้งาน
อนุมัติคำเตือนของ macOS
อนุญาตการค้นหาเครือข่ายภายใน
ข้อความต้อนรับและประกาศด้านความปลอดภัย
โมเดลความเชื่อถือด้านความปลอดภัย:
- โดยค่าเริ่มต้น OpenClaw เป็นเอเจนต์ส่วนบุคคล โดยมีขอบเขตผู้ควบคุมที่เชื่อถือได้หนึ่งราย
- การตั้งค่าแบบใช้ร่วมกัน/หลายผู้ใช้จำเป็นต้องควบคุมอย่างเข้มงวด: แยกขอบเขตความเชื่อถือ จำกัดการเข้าถึงเครื่องมือให้น้อยที่สุด และปฏิบัติตามความปลอดภัย
- การเริ่มต้นใช้งานภายในเครื่องจะตั้งค่าเริ่มต้นของการกำหนดค่าใหม่เป็น
tools.profile: "coding"เพื่อให้การตั้งค่าใหม่ยังคงใช้เครื่องมือระบบไฟล์/รันไทม์ได้โดยไม่ต้องใช้โปรไฟล์fullที่ไม่จำกัด - หากเปิดใช้ฮุก/Webhook หรือฟีดเนื้อหาอื่นที่ไม่น่าเชื่อถือ ให้ใช้โมเดลระดับสูงที่ทันสมัยและแข็งแกร่ง พร้อมคงนโยบายเครื่องมือ/การแซนด์บ็อกซ์ที่เข้มงวด
ภายในเครื่องเทียบกับระยะไกล
Gateway ทำงานที่ใด
- Mac เครื่องนี้ (ภายในเครื่องเท่านั้น): การเริ่มต้นใช้งานจะกำหนดค่าการยืนยันตัวตนและเขียนข้อมูลประจำตัวไว้ภายในเครื่อง
- ระยะไกล (ผ่าน SSH/Tailnet): การเริ่มต้นใช้งานจะไม่กำหนดค่าการยืนยันตัวตนภายในเครื่อง
ข้อมูลประจำตัวต้องมีอยู่บนโฮสต์ Gateway แล้ว ช่องโทเค็น Gateway ระยะไกล
จะจัดเก็บโทเค็นที่แอป macOS ใช้เชื่อมต่อกับ Gateway นั้น
ค่า SecretRef
gateway.remote.tokenที่มีอยู่จะถูกเก็บรักษาไว้จนกว่าจะ แทนที่ค่าเหล่านั้น - กำหนดค่าภายหลัง: ข้ามการตั้งค่าและปล่อยให้แอปยังไม่ได้กำหนดค่า
CLI
การตั้งค่าภายในเครื่องจะติดตั้ง CLI openclaw แบบส่วนกลางผ่าน npm, pnpm หรือ bun
โดยเลือก npm ก่อน Node ยังคงเป็นรันไทม์ที่แนะนำสำหรับตัว Gateway
ระบบจะนำการติดตั้งเดิมที่เข้ากันได้กลับมาใช้
เชื่อมต่อ AI
Gateway ที่เชื่อมต่อแล้วและมีการกำหนดค่าโมเดลเอเจนต์ไว้แล้วจะข้าม หน้านี้ทั้งหมดและเปิด UI ปกติของเอเจนต์ การตั้งค่า OpenClaw และผู้ให้บริการ จะทำงานเฉพาะกับ Gateway ใหม่หรือที่ตั้งค่าไม่สมบูรณ์เท่านั้น
เมื่อ Gateway พร้อมแล้ว การเริ่มต้นใช้งานจะค้นหาการเข้าถึง AI ที่มีอยู่แล้ว:
การเข้าสู่ระบบ Claude Code หรือ Codex, OPENAI_API_KEY / ANTHROPIC_API_KEY หรือ
โมเดลที่ใช้เครื่องมือได้และมีบริบทที่มีประสิทธิผลซึ่งวัดได้อย่างน้อย 16K โดยติดตั้ง
อยู่แล้วในเซิร์ฟเวอร์ Ollama หรือ LM Studio ที่เข้าถึงได้ การตรวจจับทำงานบน
โฮสต์ Gateway รวมถึงกรณีที่แอป macOS เชื่อมต่อกับ Gateway บน Linux ระบบจะทดสอบ
ตัวเลือกที่ดีที่สุดด้วยการสร้างผลลัพธ์จริงและบันทึกเฉพาะ
หลังจากได้รับคำตอบแล้ว เมื่อการทดสอบล้มเหลว แอปจะลองตัวเลือกถัดไปโดยอัตโนมัติ
และแสดงสาเหตุที่ตัวเลือกก่อนหน้าล้มเหลว หากพบหลายตัวเลือก จะสามารถ
สลับระหว่างตัวเลือกเหล่านั้นก่อนดำเนินการต่อ การค้นหาภายในเครื่องโดยอัตโนมัติจะไม่ดึง
หรือดาวน์โหลดโมเดล
หากต้องการใช้การสมัครสมาชิก Claude เมื่อโฮสต์ Gateway ไม่มีการเข้าสู่ระบบ Claude CLI ให้เรียกใช้
claude setup-token บนเครื่องใดก็ได้ที่ติดตั้ง Claude Code แล้ววาง
โทเค็นที่แสดงเป็น Anthropic setup-token ภายใต้ Connect with an API key or
token
CLI ของ Gemini, Antigravity, Pi และ OpenCode ที่ติดตั้งไว้จะแสดงเพื่อให้บริบท เมื่อไม่สามารถเลือกเป็นเส้นทางการอนุมานสำหรับการตั้งค่าแบบมีคำแนะนำที่นำกลับมาใช้ได้ Gemini และ Antigravity ไม่สามารถบังคับใช้โพรบการอนุมานที่ไม่ใช้เครื่องมือได้ Pi และ OpenCode เป็นชุดควบคุมเอเจนต์แบบครบวงจร ไม่ใช่เส้นทางการอนุมานสำหรับการตั้งค่า การผสานรวมเซสชันของทั้งสองต้องตั้งค่ารันไทม์และ Plugin แยกต่างหาก
ยังสามารถเข้าสู่ระบบผ่านขั้นตอน OAuth หรือการจับคู่อุปกรณ์ของผู้ให้บริการได้ ตัวเลือกในตัวประกอบด้วย OpenAI/ChatGPT, OpenRouter, GitHub Copilot, Google Gemini CLI, xAI, MiniMax Global และ CN รวมถึง Chutes รายการนี้มาจาก Plugin ผู้ให้บริการการอนุมานข้อความที่ใช้งานอยู่ของ Gateway แทนที่จะเป็นรายการคงที่ของแอป ดังนั้นผู้ให้บริการรายอื่นจึงสามารถเข้าร่วมได้โดยไม่ต้องเพิ่มโค้ด macOS เฉพาะสำหรับผู้ให้บริการ
ตัวเลือกคีย์/โทเค็นแบบกำหนดเองใช้รีจิสทรีผู้ให้บริการเดียวกัน ในทุกเส้นทาง ผู้ให้บริการจะจัดเตรียมโมเดลเริ่มต้นและการกำหนดค่าของตน OpenClaw จะตรวจสอบ ข้อมูลประจำตัวด้วยการทดสอบแบบสดเดียวกันก่อนจัดเก็บโปรไฟล์การยืนยันตัวตน ปุ่ม Next จะยังคงถูกล็อกจนกว่าแบ็กเอนด์หนึ่งจะผ่านการทดสอบ เพื่อไม่ให้การแชตกับเอเจนต์ครั้งแรก เริ่มต้นโดยไม่มีการอนุมานที่ใช้งานได้ หลังจากการตรวจสอบแบบสดผ่านแล้ว OpenClaw จะ พร้อมช่วยกำหนดค่าพื้นที่ทำงาน Gateway ช่องทาง และ คุณสมบัติเสริมอื่น ๆ ที่เหลือ เมื่อ OpenClaw เสนอรายการตัวเลือกสั้น ๆ แอป จะแสดงการ์ดตัวเลือกแบบเนทีฟ การเลือกการ์ดจะส่งค่าที่เลือก และ Skip for now จะทำให้ตัวเลือกนั้นยังคงเป็นตัวเลือกเสมอ นอกจากนี้ยังเข้าถึง OpenClaw ได้ภายหลังที่ Settings → OpenClaw
นำเข้าหน่วยความจำ (แสดงเมื่อตรวจพบ)
สำหรับ Gateway ภายในเครื่อง การเริ่มต้นใช้งานจะตรวจสอบหน่วยความจำบน Mac จากเครื่องมือ AI
ที่รองรับ ได้แก่ หน่วยความจำอัตโนมัติของ Claude Code, หน่วยความจำรวมของ Codex และไฟล์หน่วยความจำ
ของ Hermes เมื่อพบรายการใด หน้านี้จะแสดงแหล่งที่มาแต่ละแห่งพร้อมจำนวนหน่วยความจำ
และให้เลือกนำเข้าแหล่งที่มาที่เลือกไปยังพื้นที่ทำงานของเอเจนต์ภายใต้
memory/imports/ เพื่อเรียกคืนผ่านดัชนี ระบบจะข้ามไฟล์ที่นำเข้าแล้ว และ
หน้านี้จะไม่ปรากฏเมื่อไม่มีสิ่งใดให้นำเข้า การข้ามไม่มีผลเสีย
หน้านำเข้าหน่วยความจำของแดชบอร์ดสามารถนำเข้าแบบเดียวกันได้ในภายหลังพร้อมการควบคุม
แยกตามไฟล์
สิทธิ์
การเริ่มต้นใช้งานจะขอสิทธิ์ TCC สำหรับ: ระบบอัตโนมัติ (AppleScript), การแจ้งเตือน, การช่วยการเข้าถึง, การบันทึกหน้าจอ, ไมโครโฟน, การรู้จำเสียง, กล้อง และตำแหน่งที่ตั้ง
เสร็จสิ้น
หลังจากการอนุมานผ่านแล้ว OpenClaw จะดูแลการตั้งค่าเสริมที่เหลือและสามารถ ส่งต่อไปยังการแชตปกติกับเอเจนต์ได้ เมื่อดำเนินขั้นตอนสิทธิ์จนเสร็จ ระบบจะเปิดการแชตเดียวกัน แอปจะไม่สร้างพื้นที่ทำงานหรือเปิดการสนทนาสำหรับ ตั้งค่าเอเจนต์แยกต่างหากก่อน OpenClaw โปรดดู การบูตสแตรป สำหรับสิ่งที่เกิดขึ้นบนโฮสต์ Gateway ระหว่างการโต้ตอบจริงครั้งแรกของเอเจนต์