openclaw onboard

การตั้งค่าแบบมีคำแนะนำซึ่งเริ่มจากการทำให้การอนุมานใช้งานได้ก่อน โดยตรวจหาการเข้าถึง AI ที่มีอยู่ กำหนดให้ต้องทดสอบการตอบกลับจริง บันทึกเฉพาะเส้นทางที่ใช้งานได้ แล้วจึงเริ่ม OpenClaw เพื่อกำหนดค่าส่วนที่เหลือ openclaw setup จะเข้าสู่ขั้นตอนนี้ในระบบใหม่ หรือเมื่อมีตัวเลือกการเริ่มต้นใช้งาน ส่วนระบบที่กำหนดค่าแล้วจะใช้ openclaw setup โดยไม่มีอาร์กิวเมนต์สำหรับแชตกับเอเจนต์ระบบ openclaw setup --baseline จะ เขียนเฉพาะการกำหนดค่าพื้นฐานและเวิร์กสเปซ

ตัวอย่าง

openclaw onboardopenclaw onboard --tuiopenclaw onboard --classicopenclaw onboard --modernopenclaw onboard --flow quickstartopenclaw onboard --flow manualopenclaw onboard --flow importopenclaw onboard --import-from hermes --import-source ~/.hermesopenclaw onboard --skip-bootstrapopenclaw onboard recommendations --jsonopenclaw onboard recommendations acknowledgeopenclaw onboard recommendations acknowledge --retry "<failed-id>"openclaw onboard recommendations refreshopenclaw onboard --mode remote --remote-url wss://gateway-host:18789

openclaw onboard recommendations จะอ่านรายการแนะนำแอปที่ตรงกันซึ่งยังรอดำเนินการ และถูกจัดเก็บระหว่างการเริ่มต้นใช้งาน เพิ่ม --json เพื่อรับรายการที่เครื่องอ่านได้ซึ่งใช้โดย กระบวนการบูตสแตรปครั้งแรก คำสั่งนี้จะไม่สแกนแอปที่ติดตั้งอีกครั้งหรือเรียก โมเดล ผลลัพธ์มีเฉพาะ ID การติดตั้งที่ผ่านการตรวจสอบ แหล่งที่มา และระดับเท่านั้น โดย จงใจไม่รวมข้อความจากมาร์เก็ตเพลสที่ไม่น่าเชื่อถือ เหตุผลจากโมเดล และป้ายชื่อแอปในเครื่อง หลังจากตอบข้อเสนอคำแนะนำแล้ว คำสั่งจะส่งคืน รายการว่าง และการเริ่มต้นใช้งานครั้งถัดไปจะข้ามขั้นตอนนี้ทั้งหมด openclaw onboard recommendations refresh จะล้างข้อเสนอที่จัดเก็บไว้ เพื่อให้การ เริ่มต้นใช้งานครั้งถัดไปสแกนแอปที่ติดตั้งอีกครั้งและสร้างข้อเสนอใหม่

เวิร์กสเปซใหม่จะเลื่อนการเลือกคำแนะนำไปไว้ในการสนทนาบูตสแตรป หลังจากการสนทนาดังกล่าวจัดการตัวเลือกของผู้ใช้แล้ว openclaw onboard recommendations acknowledge จะทำเครื่องหมายว่าข้อเสนอที่จัดเก็บไว้ได้รับคำตอบแล้ว การยืนยันรับทราบสามารถเรียกซ้ำได้โดยให้ผลลัพธ์เดิม หากการติดตั้งที่เลือกไว้ล้มเหลว ให้ส่ง ID ทึบแสงแต่ละรายการที่ล้มเหลวผ่าน --retry <id...> รายการที่สำเร็จและถูกปฏิเสธจะถูกนำออก ส่วนรายการที่ล้มเหลวจะยังคงรอดำเนินการสำหรับการเริ่มต้นใช้งานครั้งถัดไป ID ที่ไม่รู้จัก จะทำให้คำสั่งล้มเหลวโดยไม่เปลี่ยนข้อเสนอที่จัดเก็บไว้ หลังการติดตั้ง Skills จาก ClawHub ที่ถูกขัดจังหวะ เป้าหมายที่มีอยู่จะถือว่าสำเร็จก็ต่อเมื่อ openclaw skills verify "@owner/slug" ทำงานสำเร็จสำหรับ ID คำแนะนำเดียวกันซึ่งระบุผู้เผยแพร่ และผลลัพธ์ JSON รายงาน openclaw.resolution.source: "installed" การตรวจสอบกับรีจิสทรีเพียงอย่างเดียว ไม่ใช่หลักฐานว่ามีการติดตั้งในเครื่อง มิฉะนั้นให้คง ID นั้นไว้ในสถานะรอดำเนินการด้วย --retry และ อย่าเขียนทับ Skills ที่มีอยู่

• --classic: เปิดวิซาร์ดแบบเต็มทีละขั้นตอน ไม่สามารถใช้ร่วมกับ --non-interactive ได้ ให้ละ --classic สำหรับการตั้งค่าอัตโนมัติ
• --flow quickstart: เปิดวิซาร์ดแบบคลาสสิกที่มีข้อความแจ้งให้น้อยที่สุดและ สร้างโทเค็น Gateway โดยอัตโนมัติ
• --flow manual (นามแฝง advanced): เปิดวิซาร์ดแบบคลาสสิกพร้อมข้อความแจ้งแบบเต็ม สำหรับพอร์ต การผูก และการยืนยันตัวตน
• --flow import: เรียกใช้ผู้ให้บริการย้ายข้อมูลที่ตรวจพบ (ตัวอย่างเช่น Hermes ผ่าน --import-from hermes) แสดงตัวอย่างแผน แล้วนำไปใช้หลังการยืนยัน เมื่อการนำเข้าแบบโต้ตอบระบุโมเดลเริ่มต้น การเริ่มต้นใช้งานจะกำหนดให้เส้นทางนั้นผ่านการตอบกลับจริงก่อนจึงจะข้ามการตั้งค่าผู้ให้บริการ หากเส้นทางที่นำเข้าล้มเหลว ระบบจะกลับไปยังการกำหนดค่าผู้ให้บริการ การนำเข้าจะทำงานกับการตั้งค่า OpenClaw ใหม่เท่านั้น หากมีสถานะใดอยู่แล้ว ให้รีเซ็ตการกำหนดค่า ข้อมูลประจำตัว เซสชัน และสถานะเวิร์กสเปซก่อน ใช้ openclaw migrate สำหรับแผนทดลองรัน โหมดเขียนทับ รายงาน และการจับคู่ที่แน่นอน
• --remote-url และ --remote-token: กรอกขั้นตอน Gateway ระยะไกลของวิซาร์ดแบบคลาสสิกไว้ล่วงหน้า และแทนที่ค่าระยะไกลที่จัดเก็บไว้สำหรับการเรียกใช้ครั้งนี้ การเปลี่ยน URL จะไม่นำข้อมูลประจำตัวที่จัดเก็บไว้กลับมาใช้ เว้นแต่จะส่งโทเค็นด้วย โทเค็นจะถูกปิดบังในข้อความแจ้งและใช้ตัวเลือกการจัดเก็บข้อความธรรมดาหรือ SecretRef ที่วิซาร์ดกำหนดไว้
• --tailscale-reset-on-exit และ --no-tailscale-reset-on-exit: ควบคุมอย่างชัดเจนว่าจะรีเซ็ตการกำหนดค่า Tailscale Serve หรือ Funnel เมื่อ Gateway หยุดทำงานหรือไม่ การละทั้งสองรายการจะคงการตั้งค่าปัจจุบันไว้ระหว่างการเรียกใช้ซ้ำแบบไม่โต้ตอบ
• --modern เป็นนามแฝงเพื่อความเข้ากันได้สำหรับผู้ช่วย ตั้งค่า OpenClaw แบบสนทนา โดยใช้เกตการอนุมานจริงเดียวกับ openclaw setup และ ยอมรับเฉพาะ --workspace, --accept-risk, --non-interactive และ --json แฟล็กการตั้งค่าอื่นจะถูกปฏิเสธแทนที่จะ ถูกละเว้นโดยไม่มีการแจ้งเตือน

ขั้นตอนแบบมีคำแนะนำ

openclaw onboard แบบไม่มีอาร์กิวเมนต์จะเริ่มขั้นตอนแบบมีคำแนะนำ โดยแสดงประกาศด้านความปลอดภัย จากนั้นถามคำถามหนึ่งข้อในตอนเริ่มต้น ได้แก่ สิทธิ์เข้าถึงแบบเต็ม (แนะนำ — การตั้งค่าจะค้นหา แอป AI คีย์ และรันไทม์ในเครื่องโดยอัตโนมัติ) หรือ ถามก่อน (การตั้งค่าจะถาม หนึ่งครั้งก่อนสำรวจระบบ หรือให้กำหนดค่าด้วยตนเอง) ตัวเลือกนี้ จะถูกบันทึกเป็น wizard.accessMode เมื่ออนุญาตให้ค้นหา การเริ่มต้นใช้งาน จะตรวจหาการเข้าถึง AI ที่มีอยู่แล้วผ่านโมเดลที่กำหนดค่าไว้ ตัวแปรสภาพแวดล้อม ของคีย์ API และ CLI ในเครื่องที่รองรับ จากนั้นทดสอบตัวเลือกที่แนะนำ ด้วยการตอบกลับจริง หากตัวเลือกหนึ่งล้มเหลว การเริ่มต้นใช้งานจะลอง ตัวเลือกถัดไปที่ใช้ได้อย่างเงียบ ๆ และสรุปรายการที่ไม่ตอบสนองไว้ใน บรรทัดเดียว โดยประกาศเส้นทางที่ใช้งานได้พร้อมตัวเลือกกดแป้นเดียวเพื่อดู ตัวเลือกอื่นทั้งหมดแทน

หากการตรวจหาอัตโนมัติไม่พบตัวเลือก เครื่องมือเลือกผู้ให้บริการจะแสดง OpenAI, Anthropic, xAI (Grok), Google และ OpenRouter ก่อน เลือก เพิ่มเติม… เพื่อดู ผู้ให้บริการอื่นทั้งหมดที่รองรับโดยจัดกลุ่มตามผู้ให้บริการ จากนั้นภูมิภาค แผน และวิธี ยืนยันตัวตนจะปรากฏในเมนูที่สอง การลงชื่อเข้าใช้ผ่านเบราว์เซอร์หรืออุปกรณ์ที่รองรับ และวิธีใช้คีย์ API หรือโทเค็นแบบปิดบังจะใช้เส้นทางการตอบกลับจริงเดียวกัน OpenClaw จะบันทึก เฉพาะเส้นทางโมเดลที่ผ่านการตรวจสอบและข้อมูลประจำตัวของเส้นทางนั้นหลังการทดสอบสำเร็จ ตัวเลือกที่ล้มเหลวจะไม่แทนที่โมเดลที่กำหนดค่าไว้หรือบันทึกข้อมูลประจำตัว ที่ลองใช้ เลือก ข้ามไปก่อน เพื่อออกโดยไม่เริ่ม OpenClaw และ เรียกใช้ openclaw onboard อีกครั้งเมื่อพร้อม การตั้งค่าเวิร์กสเปซและ Gateway จะยัง ไม่เปลี่ยนแปลงจนกว่า OpenClaw จะเริ่มทำงาน

ในโหมดมีคำแนะนำ --workspace <dir> จะระบุเวิร์กสเปซที่ OpenClaw เสนอ และบริบทการอนุมานแบบแยกส่วน ค่านี้จะไม่ถูกบันทึกจนกว่าจะอนุมัติ ข้อเสนอการตั้งค่า OpenClaw การเริ่มต้นใช้งานแบบคลาสสิกและแบบไม่โต้ตอบจะบันทึก เวิร์กสเปซผ่านขั้นตอนการตั้งค่าตามปกติ เมื่อเรียกใช้อีกครั้งโดยมีรายชื่อเอเจนต์ อยู่แล้ว การเริ่มต้นใช้งานจะคงเวิร์กสเปซของกลุ่มที่กำหนดค่าไว้ วิซาร์ดแบบคลาสสิก จะแสดงทั้งสองพาธและกำหนดให้ยืนยันอย่างชัดเจนก่อนย้าย ส่วนการตั้งค่า แบบไม่โต้ตอบจะแจ้งเตือนและคงค่าปัจจุบันไว้

หลังจากการอนุมานผ่าน การเริ่มต้นใช้งานจะตรวจหาหน่วยความจำจากเครื่องมือ AI ในเครื่อง ที่รองรับ ได้แก่ หน่วยความจำอัตโนมัติของ Claude Code, หน่วยความจำที่รวมไว้ของ Codex และไฟล์ หน่วยความจำของ Hermes เมื่อตรวจพบ หน้าเดียวจะเสนอตัวเลือกให้คัดลอกไฟล์เหล่านั้นไปยังเวิร์กสเปซ ของเอเจนต์ภายใต้ memory/imports/ เพื่อเรียกคืนผ่านดัชนี จะไม่มีการนำเข้า หากไม่ได้รับการยืนยัน ไฟล์ที่เคยนำเข้าแล้วจะถูกข้าม และสามารถนำเข้า ภายหลังได้เสมอจาก หน้านำเข้าหน่วยความจำ ใน Control UI ซึ่งมี ขอบเขตเฉพาะหน่วยความจำแบบเดียวกัน (การเรียกใช้ openclaw migrate แบบเต็มมีขอบเขตกว้างกว่า โดยสามารถนำเข้าการกำหนดค่า Skills และข้อมูลประจำตัวด้วย) วิซาร์ดแบบคลาสสิกจะแสดงหน้าเดียวกันหลังจากเตรียมเวิร์กสเปซแล้ว

หลังจากการอนุมานผ่าน (และหลังข้อเสนอการนำเข้าหน่วยความจำ) การเริ่มต้นใช้งานแบบมีคำแนะนำ จะใช้การตั้งค่ามาตรฐานโดยอัตโนมัติ ได้แก่ เวิร์กสเปซ Gateway และเซสชัน ซึ่งเป็นแผนเดียวกับที่แชต openclaw setup แบบสนทนาจะใช้เมื่อได้รับคำตอบว่า "ใช่" จากนั้นจะเสนอคำแนะนำ Plugin และ Skills จากแอปที่ติดตั้ง โดยจับคู่ชื่อแอป ผ่านโมเดลที่กำหนดค่าไว้และการค้นหา ClawHub และสามารถปิดใช้งานขั้นตอนนี้ ด้วย wizard.appRecommendations ในเซสชันเดสก์ท็อป macOS, Linux หรือ Windows จากนั้นระบบจะเปิดแดชบอร์ด Control UI ที่ผ่านการยืนยันตัวตนและรอสูงสุด 60 วินาทีให้ไคลเอนต์เบราว์เซอร์ เชื่อมต่อ บน Linux แบบไม่มีส่วนติดต่อหรือผ่าน SSH ระบบจะแสดง URL แดชบอร์ดที่โดดเด่น และพร้อมคัดลอกวาง รวมถึงคำสั่งส่งต่อพอร์ต SSH สำหรับ Gateway แบบลูปแบ็ก และรอสูงสุดห้านาที เมื่อเชื่อมต่อสำเร็จ ขั้นตอนจะดำเนินต่อในเบราว์เซอร์ หากเข้าถึง Gateway ไม่ได้หรือหมดเวลา ระบบจะย้อนกลับไปยังทางออกผ่านเทอร์มินัล แบบเดิม ส่ง --tui เพื่อข้ามการส่งต่อไปยังเบราว์เซอร์และบังคับใช้ทางออกผ่านเทอร์มินัลนั้น หากการใช้การตั้งค่าล้มเหลว การเริ่มต้นใช้งานจะย้อนกลับไปยังแชต OpenClaw แบบสนทนาเพื่อดำเนินการให้เสร็จแบบโต้ตอบ ช่องทาง เอเจนต์ Plugin และคุณสมบัติเสริมอื่น ๆ ยังคงจัดการผ่านแชต OpenClaw ให้เรียกใช้ openclaw และใช้ open channel wizard for <channel> เพื่อส่งต่อการรวบรวม ข้อมูลประจำตัวของช่องทางไปยังวิซาร์ดเทอร์มินัลแบบปิดบัง หากต้องการเปลี่ยนผู้ให้บริการ โมเดลหรือการยืนยันตัวตน ให้ออกจาก OpenClaw แล้วเรียกใช้ openclaw onboard OpenClaw จะไม่เปิดขั้นตอนผู้ให้บริการแบบมีคำแนะนำหรือแบบคลาสสิก

ในการติดตั้งที่กำหนดค่าแล้ว การเรียกใช้ openclaw onboard อีกครั้งจะตรวจสอบ โมเดลเริ่มต้นปัจจุบันก่อน ทำให้ขั้นตอนเดียวกันทำหน้าที่เป็นการตรวจสอบและซ่อมแซม โดยจะไม่ใช้การตั้งค่าซ้ำ ติดตั้งใหม่ หรือเริ่มบริการ Gateway ใหม่ หากการตรวจสอบล้มเหลว โมเดลที่กำหนดค่าไว้จะไม่ถูกแทนที่โดยอัตโนมัติ การเริ่มต้นใช้งานจะหยุดและถามว่าจะดำเนินการต่ออย่างไร การตรวจสอบจะทำงานนอก เวิร์กสเปซ ดังนั้นโมเดลที่มาจาก Plugin ของเวิร์กสเปซอาจล้มเหลวที่นี่แม้ยัง ใช้งานได้ในเอเจนต์ ใช้ openclaw onboard --classic สำหรับการยืนยันตัวตนเฉพาะผู้ให้บริการ ช่องทาง Skills การตั้งค่า Gateway ระยะไกล การนำเข้า หรือการควบคุม Gateway แบบเต็ม สำหรับการตั้งค่า และซ่อมแซมแบบสนทนาที่ไม่เกี่ยวกับการอนุมาน ให้เรียกใช้ openclaw setup openclaw onboard --modern เป็นนามแฝงเพื่อความเข้ากันได้ที่ผ่านเกตการอนุมานเดียวกัน วิซาร์ด แบบคลาสสิกสามารถเลือกตรวจสอบโมเดลเริ่มต้นด้วยการตอบกลับจริงได้ แต่ OpenClaw จะไม่เริ่มจนกว่าการตรวจสอบการอนุมานจริงของตนเองจะผ่าน

ในเทอร์มินัลแบบโต้ตอบ openclaw โดยไม่มีคำสั่งย่อยจะกำหนดเส้นทางตามสถานะ การกำหนดค่า:

• หากไม่มีไฟล์การกำหนดค่าที่ใช้งานอยู่ หรือไม่มีการตั้งค่าที่ผู้ใช้กำหนดไว้ (ว่างหรือ มีเฉพาะข้อมูลเมตา) ระบบจะเริ่มการเริ่มต้นใช้งานแบบมีคำแนะนำ
• หากมีไฟล์การกำหนดค่าแต่ไม่ผ่านการตรวจสอบ ระบบจะเริ่มขั้นตอน การเริ่มต้นใช้งานแบบคลาสสิกพร้อมคำแนะนำจาก openclaw doctor OpenClaw ต้องใช้ การอนุมานที่ใช้งานได้และจะไม่ถูกใช้เพื่อซ่อมแซมสถานะก่อนการอนุมานนี้
• หากไฟล์การกำหนดค่าถูกต้อง ระบบจะเปิด TUI ปกติของเอเจนต์ Gateway ที่กำหนดค่าไว้และเข้าถึงได้ซึ่งมีเอเจนต์และโมเดลจะเข้าสู่ UI นั้นโดยตรง โดยไม่ผ่าน การเริ่มต้นใช้งานหรือ OpenClaw ในการติดตั้งที่กำหนดค่าแล้ว ให้เข้าถึง OpenClaw ด้วย /openclaw ภายใน TUI หรือ openclaw setup

ระบบยอมรับ ws:// แบบข้อความธรรมดาสำหรับลูปแบ็ก ลิเทอรัล IP ส่วนตัว .local และ URL ของ Gateway แบบ Tailnet *.ts.net สำหรับชื่อ DNS ส่วนตัวอื่นที่เชื่อถือได้ ให้ตั้งค่า OPENCLAW_ALLOW_INSECURE_PRIVATE_WS=1 ในสภาพแวดล้อมของกระบวนการเริ่มต้นใช้งาน

รีเซ็ต

openclaw onboard --resetopenclaw onboard --reset --reset-scope full

--reset จะล้างสถานะก่อนเรียกใช้การตั้งค่า --reset-scope ควบคุมขอบเขตการล้าง ได้แก่ config (เฉพาะการกำหนดค่า), config+creds+sessions (ค่าเริ่มต้นเมื่อส่ง --reset โดยไม่ระบุขอบเขต) หรือ full (รีเซ็ตเวิร์กสเปซด้วย) การรีเซ็ตเวิร์กสเปซจะเกิดขึ้นเมื่อใช้ --reset-scope full เท่านั้น

ภาษาและภูมิภาค

การเริ่มต้นใช้งานแบบโต้ตอบใช้ภาษาและภูมิภาคของวิซาร์ด CLI สำหรับข้อความการตั้งค่าแบบคงที่ โดยใช้ค่าแรกที่ไม่ว่างตามลำดับต่อไปนี้:

1. OPENCLAW_LOCALE
2. LC_ALL
3. LC_MESSAGES
4. LANG
5. ใช้ภาษาอังกฤษเป็นภาษาสำรอง

ภาษาของตัวช่วยตั้งค่าที่รองรับคือ en, zh-CN และ zh-TW ค่าภาษาสามารถใช้รูปแบบขีดล่างหรือส่วนต่อท้าย POSIX เช่น zh_CN.UTF-8 ชื่อผลิตภัณฑ์ ชื่อคำสั่ง คีย์การกำหนดค่า URL, ID ผู้ให้บริการ, ID โมเดล และป้ายกำกับ Plugin/ช่องทางจะคงไว้ตามต้นฉบับ

OPENCLAW_LOCALE=zh-CN openclaw onboardOPENCLAW_LOCALE=en openclaw onboard # บังคับใช้ภาษาอังกฤษอย่างชัดเจน

การตั้งค่าแบบไม่โต้ตอบ

--non-interactive ต้องใช้ --accept-risk (เพื่อยอมรับว่าเอเจนต์มีความสามารถสูงและการเข้าถึงระบบทั้งหมดมีความเสี่ยง) --mode มีค่าเริ่มต้นเป็น local

openclaw onboard --non-interactive \  --auth-choice custom-api-key \  --custom-base-url "https://llm.example.com/v1" \  --custom-model-id "foo-large" \  --custom-api-key "$CUSTOM_API_KEY" \  --secret-input-mode plaintext \  --custom-compatibility openai \  --custom-image-input

--custom-api-key เป็นตัวเลือก หากละไว้ การเริ่มต้นใช้งานจะตรวจสอบ CUSTOM_API_KEY ใน env โดยอัตโนมัติ OpenClaw จะทำเครื่องหมาย ID ของโมเดลด้านการมองเห็นที่ใช้กันทั่วไป (GPT-4o/4.1/5.x, Claude 3/4, Gemini, Qwen-VL, LLaVA, Pixtral และโมเดลที่คล้ายกัน) ว่ารองรับภาพโดยอัตโนมัติ ส่ง --custom-image-input สำหรับ ID ของโมเดลด้านการมองเห็นแบบกำหนดเองที่ไม่รู้จัก หรือ --custom-text-input เพื่อบังคับใช้เมทาดาทาแบบข้อความเท่านั้น ใช้ --custom-compatibility openai-responses สำหรับปลายทางที่เข้ากันได้กับ OpenAI ซึ่งรองรับ /v1/responses แต่ไม่รองรับ /v1/chat/completions โดยค่าที่ใช้ได้คือ openai (ค่าเริ่มต้น), openai-responses, anthropic

LM Studio มีแฟล็กคีย์เฉพาะผู้ให้บริการด้วย:

openclaw onboard --non-interactive \  --auth-choice lmstudio \  --custom-base-url "http://localhost:1234/v1" \  --custom-model-id "qwen/qwen3.5-9b" \  --lmstudio-api-key "$LM_API_TOKEN" \  --accept-risk

Ollama แบบไม่โต้ตอบ:

openclaw onboard --non-interactive \  --auth-choice ollama \  --custom-base-url "http://ollama-host:11434" \  --custom-model-id "qwen3.5:27b" \  --accept-risk

--custom-base-url มีค่าเริ่มต้นเป็น http://127.0.0.1:11434 ส่วน --custom-model-id เป็นตัวเลือก หากละไว้ การเริ่มต้นใช้งานจะใช้ค่าเริ่มต้นที่ Ollama แนะนำ ID โมเดลคลาวด์ เช่น kimi-k2.5:cloud ก็ใช้ได้ที่นี่เช่นกัน

จัดเก็บคีย์ของผู้ให้บริการเป็นการอ้างอิงแทนข้อความธรรมดา:

openclaw onboard --non-interactive \  --auth-choice openai-api-key \  --secret-input-mode ref \  --accept-risk

เมื่อใช้ --secret-input-mode ref การเริ่มต้นใช้งานจะเขียนการอ้างอิงที่อาศัย env แทนค่าคีย์แบบข้อความธรรมดา: สำหรับผู้ให้บริการที่อาศัยโปรไฟล์การยืนยันตัวตน ระบบจะเขียน keyRef: { source: "env", provider: "default", id: <envVar> }; สำหรับผู้ให้บริการแบบกำหนดเอง ระบบจะเขียน models.providers.<id>.apiKey ในลักษณะเดียวกัน (ตัวอย่างเช่น { source: "env", provider: "default", id: "CUSTOM_API_KEY" }) ข้อกำหนดคือ ตั้งค่าตัวแปร env ของผู้ให้บริการในสภาพแวดล้อมของกระบวนการเริ่มต้นใช้งาน (ตัวอย่างเช่น OPENAI_API_KEY) และอย่าส่งแฟล็กคีย์แบบอินไลน์พร้อมกัน เว้นแต่จะตั้งค่าตัวแปร env นั้นไว้แล้ว มิฉะนั้นค่าแฟล็กที่ไม่มีตัวแปร env ตรงกันจะล้มเหลวทันทีพร้อมคำแนะนำ

การยืนยันตัวตนของ Gateway (แบบไม่โต้ตอบ)

• --gateway-auth token --gateway-token <token> จัดเก็บโทเค็นเป็นข้อความธรรมดา token คือโหมดการยืนยันตัวตนเริ่มต้น
• --gateway-auth token --gateway-token-ref-env <name> จัดเก็บ gateway.auth.token เป็น SecretRef จาก env โดยต้องมีตัวแปร env ชื่อนั้นซึ่งไม่ว่างในสภาพแวดล้อมของกระบวนการเริ่มต้นใช้งาน
• --gateway-token และ --gateway-token-ref-env ไม่สามารถใช้ร่วมกันได้
• เมื่อใช้ --install-daemon: gateway.auth.token ที่จัดการด้วย SecretRef จะได้รับการตรวจสอบ แต่จะไม่ถูกบันทึกเป็นข้อความธรรมดาที่แก้ค่าแล้วในเมทาดาทาสภาพแวดล้อมของบริการผู้ควบคุม หากแก้ค่าการอ้างอิงไม่ได้ การติดตั้งจะปิดกั้นโดยค่าเริ่มต้นพร้อมคำแนะนำในการแก้ไข หากกำหนดค่าทั้ง gateway.auth.token และ gateway.auth.password และไม่ได้ตั้งค่า gateway.auth.mode การติดตั้งจะถูกปิดกั้นจนกว่าจะตั้งค่าโหมดอย่างชัดเจน
• การเริ่มต้นใช้งานภายในเครื่องจะเขียน gateway.mode="local" ลงในการกำหนดค่า หากไฟล์การกำหนดค่าในภายหลังไม่มี gateway.mode แสดงว่าการกำหนดค่าเสียหายหรือมีการแก้ไขด้วยตนเองไม่สมบูรณ์ ไม่ใช่ทางลัดโหมดภายในเครื่องที่ถูกต้อง
• การเริ่มต้นใช้งานภายในเครื่องจะติดตั้ง Plugin ที่ดาวน์โหลดได้ซึ่งจำเป็นสำหรับเส้นทางการตั้งค่าที่เลือก (ตัวอย่างเช่น Plugin รันไทม์ Codex หรือ Copilot สำหรับตัวเลือกการยืนยันตัวตนเหล่านั้น) การเริ่มต้นใช้งานระยะไกลจะเขียนเฉพาะข้อมูลการเชื่อมต่อสำหรับ Gateway ระยะไกลเท่านั้น และจะไม่ติดตั้งแพ็กเกจ Plugin ในเครื่อง
• --allow-unconfigured เป็นช่องทางหลีกเลี่ยง openclaw gateway run ที่แยกต่างหาก โดยไม่ได้อนุญาตให้การเริ่มต้นใช้งานข้าม gateway.mode

export OPENAI_API_KEY="your-provider-key"export OPENCLAW_GATEWAY_TOKEN="your-token"openclaw onboard --non-interactive \  --mode local \  --auth-choice openai-api-key \  --secret-input-mode ref \  --gateway-auth token \  --gateway-token-ref-env OPENCLAW_GATEWAY_TOKEN \  --accept-risk

สถานะการทำงานของ Gateway ภายในเครื่อง

• เว้นแต่จะส่ง --skip-health การเริ่มต้นใช้งานจะรอจนกว่า Gateway ภายในเครื่องจะเข้าถึงได้ก่อนออกด้วยสถานะสำเร็จ
• --install-daemon จะเริ่มเส้นทางการติดตั้ง Gateway ที่มีการจัดการก่อน หากไม่มีตัวเลือกนี้ Gateway ภายในเครื่องต้องกำลังทำงานอยู่แล้ว (ตัวอย่างเช่น openclaw gateway run)
• --skip-health จะข้ามการรอ หากต้องการเพียงเขียนการกำหนดค่า/เวิร์กสเปซ/บูตสแตรปในการทำงานอัตโนมัติ
• --skip-bootstrap จะตั้งค่า agents.defaults.skipBootstrap: true และข้ามการสร้าง AGENTS.md, SOUL.md, TOOLS.md, IDENTITY.md, USER.md, HEARTBEAT.md และ BOOTSTRAP.md
• บน Windows แบบเนทีฟ --install-daemon จะลองใช้ Scheduled Tasks ก่อน และใช้รายการล็อกอินในโฟลเดอร์ Startup ของผู้ใช้เป็นทางเลือก หากไม่ได้รับอนุญาตให้สร้างงาน

โหมดการอ้างอิงแบบโต้ตอบ

• เลือก ใช้การอ้างอิงข้อมูลลับ เมื่อได้รับแจ้ง จากนั้นเลือก ตัวแปรสภาพแวดล้อม หรือผู้ให้บริการข้อมูลลับที่กำหนดค่าไว้ (file หรือ exec)
• การเริ่มต้นใช้งานจะตรวจสอบล่วงหน้าอย่างรวดเร็วก่อนบันทึกการอ้างอิง และให้ลองอีกครั้งเมื่อตรวจสอบไม่ผ่าน

ตัวเลือกปลายทาง Z.AI

# เลือกปลายทางโดยไม่แสดงพรอมต์openclaw onboard --non-interactive \  --auth-choice zai-coding-global \  --zai-api-key "$ZAI_API_KEY" # ตัวเลือกปลายทาง Z.AI อื่นๆ: zai-coding-cn, zai-global, zai-cn

Mistral:

openclaw onboard --non-interactive \  --auth-choice mistral-api-key \  --mistral-api-key "$MISTRAL_API_KEY"

แฟล็กเพิ่มเติมสำหรับโหมดไม่โต้ตอบ

การยืนยันตัวตนของโมเดลด้วยโทเค็น (ใช้ร่วมกับ --auth-choice token):

Cloudflare AI Gateway: --cloudflare-ai-gateway-account-id <id>, --cloudflare-ai-gateway-gateway-id <id>

การควบคุมการติดตั้งเดมอน: --no-install-daemon / --skip-daemon (นามแฝง; ข้ามการติดตั้งบริการ Gateway), --daemon-runtime <node>

Skills: --node-manager <npm|pnpm|bun> (ค่าเริ่มต้น npm), --skip-skills

การตั้งค่า UI และฮุก: --skip-ui (ข้ามพรอมต์ Control UI/TUI), --skip-hooks (ข้ามการตั้งค่า Webhook/ฮุก), --skip-channels, --skip-search

เอาต์พุต: --suppress-gateway-token-output จะระงับเอาต์พุต Gateway/UI ที่มีโทเค็น (คำใบ้โทเค็น, URL เข้าสู่ระบบอัตโนมัติที่ฝังโทเค็น และการเปิด Control UI อัตโนมัติ) ซึ่งมีประโยชน์ในเทอร์มินัลที่ใช้ร่วมกันและ CI

การกรองผู้ให้บริการล่วงหน้า

เมื่อตัวเลือกการยืนยันตัวตนระบุผู้ให้บริการที่ต้องการ การเริ่มต้นใช้งานจะกรองตัวเลือกโมเดลเริ่มต้นและรายการอนุญาตล่วงหน้าให้เหลือเฉพาะโมเดลของผู้ให้บริการนั้น ตัวกรองยังจับคู่ผู้ให้บริการอื่นที่ Plugin เดียวกันเป็นเจ้าของด้วย ซึ่งครอบคลุมรูปแบบ Coding Plan เช่น volcengine/volcengine-plan และ byteplus/byteplus-plan หากตัวกรองผู้ให้บริการที่ต้องการไม่พบโมเดลที่โหลดไว้ การเริ่มต้นใช้งานจะกลับไปใช้แค็ตตาล็อกที่ไม่กรอง แทนที่จะปล่อยให้ตัวเลือกว่างเปล่า

คำถามติดตามสำหรับการค้นหาเว็บ

ผู้ให้บริการค้นหาเว็บบางรายจะเรียกพรอมต์ติดตามเฉพาะผู้ให้บริการระหว่างการเริ่มต้นใช้งาน:

• Grok สามารถเสนอตัวเลือกการตั้งค่า x_search โดยใช้การยืนยันตัวตน xAI เดียวกันและตัวเลือกโมเดล x_search
• Kimi สามารถถามถึงภูมิภาค Moonshot API (api.moonshot.ai เทียบกับ api.moonshot.cn) และโมเดลค้นหาเว็บ Kimi เริ่มต้น

พฤติกรรมอื่นๆ

• พฤติกรรมขอบเขต DM ของการเริ่มต้นใช้งานภายในเครื่อง: ข้อมูลอ้างอิงการตั้งค่า CLI
• เริ่มแชตแรกได้เร็วที่สุด: openclaw dashboard (Control UI โดยไม่ตั้งค่าช่องทาง)
• ผู้ให้บริการแบบกำหนดเอง: เชื่อมต่อปลายทางใดๆ ที่เข้ากันได้กับ OpenAI หรือ Anthropic รวมถึงผู้ให้บริการแบบโฮสต์ที่ไม่ได้ระบุไว้ ใช้ความเข้ากันได้แบบ ไม่ทราบ เพื่อตรวจหาโดยอัตโนมัติผ่านการทดสอบสด
• หากตรวจพบสถานะ Hermes การเริ่มต้นใช้งานจะเสนอขั้นตอนการย้ายข้อมูล (ดู --flow import ด้านบน)

คำสั่งติดตามผลที่ใช้บ่อย

ใช้ openclaw configure ในภายหลังสำหรับการเปลี่ยนแปลงแบบเจาะจงที่ไม่ใช้การอนุมาน และใช้ openclaw channels add สำหรับการตั้งค่าเฉพาะช่องทาง สำหรับการเปลี่ยนผู้ให้บริการโมเดลหรือเส้นทางการยืนยันตัวตน ให้เรียกใช้ openclaw onboard แทน

openclaw channels addopenclaw configureopenclaw agents add <name>