First steps
การเริ่มต้นใช้งาน (แอป macOS)
เอกสารนี้อธิบายโฟลว์การตั้งค่าครั้งแรกในสถานะ ปัจจุบัน เป้าหมายคือประสบการณ์ "day 0" ที่ราบรื่น: เลือกตำแหน่งที่ Gateway ทำงาน เชื่อมต่อการยืนยันตัวตน เรียกใช้วิซาร์ด และให้เอเจนต์ bootstrap ตัวเอง สำหรับภาพรวมทั่วไปของเส้นทาง onboarding โปรดดู ภาพรวม Onboarding.
อนุมัติคำเตือน macOS
อนุมัติการค้นหาเครือข่ายภายใน
ข้อความต้อนรับและประกาศด้านความปลอดภัย
โมเดลความไว้วางใจด้านความปลอดภัย:
- โดยค่าเริ่มต้น OpenClaw เป็นเอเจนต์ส่วนบุคคล: ขอบเขตผู้ปฏิบัติการที่เชื่อถือได้หนึ่งคน
- การตั้งค่าแบบแชร์/หลายผู้ใช้ต้องมีการล็อกดาวน์ (แยกขอบเขตความไว้วางใจ จำกัดการเข้าถึงเครื่องมือให้น้อยที่สุด และปฏิบัติตาม ความปลอดภัย)
- ตอนนี้ Local onboarding ตั้งค่า config ใหม่เป็น
tools.profile: "coding"โดยค่าเริ่มต้น เพื่อให้การตั้งค่าในเครื่องใหม่ยังคงมีเครื่องมือ filesystem/runtime โดยไม่บังคับใช้โปรไฟล์fullที่ไม่จำกัด - หากเปิดใช้งาน hooks/webhooks หรือฟีดเนื้อหาอื่นที่ไม่น่าเชื่อถือ ให้ใช้ระดับโมเดลสมัยใหม่ที่แข็งแรง และคงนโยบายเครื่องมือ/การ sandbox ที่เข้มงวดไว้
Local เทียบกับ Remote
Gateway ทำงานที่ไหน?
- Mac เครื่องนี้ (Local เท่านั้น): onboarding สามารถกำหนดค่าการยืนยันตัวตนและเขียน credentials ไว้ในเครื่อง
- Remote (ผ่าน SSH/Tailnet): onboarding จะ ไม่ กำหนดค่าการยืนยันตัวตนในเครื่อง; credentials ต้องมีอยู่บนโฮสต์ gateway
- กำหนดค่าภายหลัง: ข้ามการตั้งค่าและปล่อยให้แอปยังไม่ได้กำหนดค่า
สิทธิ์
Onboarding ขอสิทธิ์ TCC ที่จำเป็นสำหรับ:
- Automation (AppleScript)
- การแจ้งเตือน
- การช่วยการเข้าถึง
- การบันทึกหน้าจอ
- ไมโครโฟน
- การรู้จำเสียงพูด
- กล้อง
- ตำแหน่งที่ตั้ง
CLI
แชต Onboarding (เซสชันเฉพาะ)
หลังตั้งค่าเสร็จ แอปจะเปิดเซสชันแชต onboarding โดยเฉพาะ เพื่อให้เอเจนต์ แนะนำตัวเองและนำทางขั้นตอนถัดไป วิธีนี้จะแยกคำแนะนำในการใช้งานครั้งแรก ออกจากบทสนทนาปกติของคุณ ดู Bootstrapping เพื่อดูว่า เกิดอะไรขึ้นบนโฮสต์ gateway ระหว่างการรันเอเจนต์ครั้งแรก