การเริ่มต้นใช้งาน (CLI)

openclaw onboard

การเริ่มต้นใช้งานผ่าน CLI เป็นแนวทางที่แนะนำสำหรับการตั้งค่าผ่านเทอร์มินัลบน macOS, Linux และ Windows (แบบเนทีฟหรือ WSL2) โดยค่าเริ่มต้น ระบบจะตรวจหาการเข้าถึง AI ที่มีอยู่แล้วในเครื่อง ตรวจสอบด้วยการสร้างคำตอบจริง และเริ่ม Crestodian เพื่อกำหนดค่าพื้นที่ทำงาน, Gateway และคุณสมบัติเสริม openclaw setup จะเรียกใช้ขั้นตอนเดียวกัน (การตั้งค่า อธิบายตัวแปร --baseline ที่กำหนดค่าเพียงอย่างเดียว) ผู้ใช้เดสก์ท็อป Windows ยังสามารถเริ่มจาก Windows Hub ได้ด้วย

การเริ่มต้นใช้งานแบบมีคำแนะนำจะตั้งค่าการอนุมานก่อน โดยจะตรวจหาการเข้าถึง AI ที่พร้อมใช้งาน กำหนดให้สร้างคำตอบจริงสำเร็จ และหลังจากนั้นจึงเริ่ม Crestodian เพื่อกำหนดค่าส่วนที่เหลือของ OpenClaw ขั้นตอนแบบมีคำแนะนำไม่มี Crestodian ก่อนการอนุมาน และไม่มีเส้นทางข้าม AI

วิซาร์ดแบบคลาสสิกยังคงพร้อมใช้งานสำหรับการลงชื่อเข้าใช้ผู้ให้บริการ การตั้งค่า Gateway ระยะไกล การจับคู่ช่องทาง การควบคุมดีมอน Skills และการนำเข้า เรียกใช้อย่างชัดเจนด้วย openclaw onboard --classic โดยหน้าจอรายการตัวเลือกการอนุมานแบบมีคำแนะนำจะไม่ส่งต่อไปยังวิซาร์ดนี้ หลังจากการอนุมานผ่านแล้ว Crestodian สามารถใช้ open channel wizard for <channel> เพื่อส่งต่อการตั้งค่าช่องทางที่ต้องใช้ข้อมูลลับไปยังวิซาร์ดเทอร์มินัลที่ปกปิดข้อมูล หากต้องการเปลี่ยนผู้ให้บริการโมเดลหรือการยืนยันตัวตนของผู้ให้บริการ ให้ออกจาก Crestodian แล้วเรียกใช้ openclaw onboard โดย Crestodian จะไม่เปิดขั้นตอนผู้ให้บริการแบบมีคำแนะนำหรือแบบคลาสสิก

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

วิซาร์ดจะแปลข้อความคงที่สำหรับการเริ่มต้นใช้งาน ลำดับการตรวจหา: OPENCLAW_LOCALE, LC_ALL, LC_MESSAGES, LANG แล้วจึงภาษาอังกฤษ ภาษาที่รองรับ: en, zh-CN, zh-TW

OPENCLAW_LOCALE=zh-CN openclaw onboard

ชื่อผลิตภัณฑ์ คำสั่ง คีย์การกำหนดค่า URL รหัสผู้ให้บริการ รหัสโมเดล และป้ายกำกับ Plugin/ช่องทางจะยังคงเป็นภาษาอังกฤษไม่ว่าภาษาและภูมิภาคจะเป็นค่าใด

หากต้องการกำหนดค่าที่ไม่เกี่ยวกับการอนุมานใหม่ในภายหลัง:

openclaw configureopenclaw agents add <name>

ค่าเริ่มต้นแบบมีคำแนะนำ

openclaw onboard แบบไม่มีตัวเลือกเพิ่มเติมจะทำตามขั้นตอนนี้:

1. ยอมรับประกาศด้านความปลอดภัย
2. ตรวจหาโมเดลที่กำหนดค่าไว้ ตัวแปรสภาพแวดล้อมของคีย์ API และ CLI ของ AI ภายในเครื่องที่รองรับ
3. ทดสอบตัวเลือกแรกที่ตรวจพบด้วยการสร้างคำตอบจริง หากล้มเหลว ให้แสดงสาเหตุและดำเนินการต่อไปยังตัวเลือกถัดไปที่ใช้งานได้
4. หากตรวจสอบตัวเลือกที่พบทั้งหมดแล้ว ให้ลองตัวเลือกที่ตรวจพบอีกครั้งหรือป้อนคีย์ API ของผู้ให้บริการผ่านพรอมต์ที่ปกปิดข้อมูล การเริ่มต้นใช้งานแบบมีคำแนะนำจะไม่เสนอ Crestodian หรือตัวเลือกออกโดยข้าม AI ก่อนที่การอนุมานจะทำงาน
5. บันทึกเฉพาะเส้นทางโมเดลที่ตรวจสอบแล้ว รวมถึงสถานะข้อมูลประจำตัว/Plugin ที่จำเป็น โดยไม่แก้ไขการตั้งค่าพื้นที่ทำงานและ Gateway
6. เริ่ม Crestodian ด้วยโมเดลที่ตรวจสอบแล้ว เพื่อให้กำหนดค่าพื้นที่ทำงาน, Gateway, ช่องทาง, เอเจนต์, Plugin และการตั้งค่าเสริมที่เหลือได้

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

วิซาร์ดแบบคลาสสิก: QuickStart เทียบกับ Advanced

เรียกใช้ openclaw onboard --classic เพื่อเปิดวิซาร์ดแบบเต็ม โดยเริ่มจากการเลือกระหว่าง QuickStart (ค่าเริ่มต้น) และ Advanced (ควบคุมทั้งหมด) ส่ง --flow quickstart หรือ --flow advanced (นามแฝง manual) เพื่อเลือกขั้นตอนแบบคลาสสิกและข้ามพรอมต์ดังกล่าว

โหมดระยะไกล (--mode remote) จะใช้ขั้นตอนขั้นสูงเสมอ โดยกำหนดค่าเฉพาะเครื่องนี้ให้เชื่อมต่อกับ Gateway ที่อยู่ที่อื่น และจะไม่ติดตั้งหรือเปลี่ยนแปลงสิ่งใดบนโฮสต์ระยะไกล

สิ่งที่การเริ่มต้นใช้งานแบบคลาสสิกกำหนดค่า

โหมดภายในเครื่อง (ค่าเริ่มต้น) จะดำเนินการตามขั้นตอนเหล่านี้:

1. โมเดล/การยืนยันตัวตน - เลือกขั้นตอนการยืนยันตัวตนของผู้ให้บริการ (คีย์ API, OAuth หรือการยืนยันตัวตนด้วยตนเองเฉพาะผู้ให้บริการ) รวมถึง Custom Provider (OpenAI-compatible, OpenAI Responses-compatible, Anthropic-compatible หรือ Unknown สำหรับการตรวจหาอัตโนมัติ) แล้วเลือกโมเดลเริ่มต้น การตั้งค่าคีย์ API ของ OpenAI ใหม่จะใช้ค่าเริ่มต้นเป็น openai/gpt-5.6 (รหัส API โดยตรงแบบไม่มีคำนำหน้าจะชี้ไปยัง Sol) ส่วนการตั้งค่า ChatGPT/Codex ใหม่จะใช้ค่าเริ่มต้นเป็น openai/gpt-5.6-sol การเรียกใช้การตั้งค่าซ้ำจะคงโมเดลที่ระบุไว้อย่างชัดเจน รวมถึง openai/gpt-5.5 หากบัญชีไม่เปิดให้ใช้ GPT-5.6 ให้เลือก openai/gpt-5.5 อย่างชัดเจน หมายเหตุด้านความปลอดภัย: หากเอเจนต์นี้จะเรียกใช้เครื่องมือหรือประมวลผลเนื้อหาจาก Webhook/ฮุก ให้เลือกใช้โมเดลรุ่นล่าสุดที่มีความสามารถสูงที่สุด และกำหนดนโยบายเครื่องมืออย่างเข้มงวด โมเดลระดับที่อ่อนกว่าหรือเก่ากว่าจะถูกโจมตีด้วยการแทรกพรอมต์ได้ง่ายกว่า สำหรับการเรียกใช้แบบไม่โต้ตอบ --secret-input-mode ref จะจัดเก็บการอ้างอิงที่ใช้ตัวแปรสภาพแวดล้อมแทนค่าคีย์ API แบบข้อความธรรมดา โดยต้องตั้งค่าตัวแปรสภาพแวดล้อมที่อ้างถึงไว้แล้ว มิฉะนั้นการเริ่มต้นใช้งานจะล้มเหลวทันที โหมดอ้างอิงข้อมูลลับแบบโต้ตอบสามารถชี้ไปยังตัวแปรสภาพแวดล้อมหรือการอ้างอิงผู้ให้บริการที่กำหนดค่าไว้ (file หรือ exec) พร้อมการตรวจสอบล่วงหน้าอย่างรวดเร็วก่อนบันทึก หลังจากตั้งค่าโมเดล/การยืนยันตัวตน วิซาร์ดจะเสนอการทดสอบสร้างคำตอบจริงเป็นตัวเลือก หากล้มเหลว คุณสามารถกลับไปตั้งค่าโมเดล/การยืนยันตัวตนได้หนึ่งครั้ง หรือเพิกเฉยโดยไม่ขัดขวางส่วนที่เหลือของวิซาร์ดแบบคลาสสิก การเพิกเฉยจะไม่ปลดล็อก Crestodian เพราะการตั้งค่าผ่านการสนทนายังคงต้องผ่านการตรวจสอบการอนุมาน
2. พื้นที่ทำงาน - ไดเรกทอรีสำหรับไฟล์เอเจนต์ (ค่าเริ่มต้น ~/.openclaw/workspace) พร้อมสร้างไฟล์เริ่มต้น
3. Gateway - พอร์ต ที่อยู่สำหรับผูก โหมดการยืนยันตัวตน และการเปิดให้เข้าถึงผ่าน Tailscale ในโหมดโทเค็นแบบโต้ตอบ ให้เลือกจัดเก็บโทเค็นเป็นข้อความธรรมดา (ค่าเริ่มต้น) หรือเลือกใช้ SecretRef เส้นทาง SecretRef แบบไม่โต้ตอบ: --gateway-token-ref-env <ENV_VAR>
4. ช่องทาง - ช่องทางแชตในตัวและช่องทางจาก Plugin อย่างเป็นทางการ รวมถึง Discord, Feishu, Google Chat, iMessage, Mattermost, Microsoft Teams, QQ Bot, Signal, Slack, Telegram, WhatsApp และอื่น ๆ
5. ดีมอน - ติดตั้ง LaunchAgent (macOS), ยูนิตผู้ใช้ systemd (Linux/WSL2) หรือ Windows Scheduled Task แบบเนทีฟ โดยมีโฟลเดอร์ Startup ต่อผู้ใช้เป็นทางเลือกสำรอง หากต้องใช้การยืนยันตัวตนด้วยโทเค็นและ gateway.auth.token อยู่ภายใต้การจัดการของ SecretRef การติดตั้งดีมอนจะตรวจสอบค่า แต่จะไม่บันทึกโทเค็นที่แปลงค่าแล้วลงในข้อมูลเมตาสภาพแวดล้อมของบริการตัวควบคุม หากไม่สามารถแปลงค่า SecretRef ได้ ระบบจะขัดขวางการติดตั้งพร้อมแสดงคำแนะนำ หากตั้งค่าทั้ง gateway.auth.token และ gateway.auth.password ขณะที่ยังไม่ได้ตั้งค่า gateway.auth.mode ระบบจะขัดขวางการติดตั้งจนกว่าคุณจะกำหนดโหมดอย่างชัดเจน
6. การตรวจสอบสถานะ - เริ่ม Gateway และตรวจสอบว่าสามารถเข้าถึงได้
7. Skills - ติดตั้ง Skills ที่แนะนำและการขึ้นต่อกันเสริมของ Skills เหล่านั้น

--flow import จะเรียกใช้ขั้นตอนการย้ายข้อมูลที่ตรวจพบ (เช่น Hermes) ในวิซาร์ดแบบคลาสสิกแทนการตั้งค่าใหม่ ดู ย้ายข้อมูล และคู่มือการย้ายข้อมูลภายใต้ ติดตั้ง openclaw onboard --modern เป็นนามแฝงเพื่อความเข้ากันได้สำหรับ Crestodian โดยใช้ด่านตรวจสอบการอนุมานเดียวกับ openclaw crestodian: เมื่อการอนุมานผ่านการตรวจสอบ ระบบจะเริ่มผู้ช่วย แต่หากล้มเหลวในโหมดโต้ตอบ ระบบจะกลับไปยังการตั้งค่าการอนุมานแบบมีคำแนะนำ

เพิ่มเอเจนต์อีกตัว

ใช้ openclaw agents add <name> เพื่อสร้างเอเจนต์แยกต่างหากที่มีพื้นที่ทำงาน เซสชัน และโปรไฟล์การยืนยันตัวตนของตนเอง การเรียกใช้โดยไม่มี --workspace จะเริ่มขั้นตอนแบบโต้ตอบสำหรับชื่อ พื้นที่ทำงาน การยืนยันตัวตน ช่องทาง และการผูกเส้นทาง ซึ่งไม่ใช่วิซาร์ด openclaw onboard แบบเต็ม

ค่าที่คำสั่งนี้กำหนด:

• agents.list[].name
• agents.list[].workspace
• agents.list[].agentDir

หมายเหตุ:

• พื้นที่ทำงานเริ่มต้น: ~/.openclaw/workspace-<agentId> (หรืออยู่ภายใต้ agents.defaults.workspace หากมีการตั้งค่าดังกล่าว)
• เพิ่ม bindings เพื่อกำหนดเส้นทางข้อความขาเข้าไปยังเอเจนต์นี้ (การเริ่มต้นใช้งานสามารถดำเนินการให้คุณได้)
• แฟล็กแบบไม่โต้ตอบ: --model, --agent-dir, --bind, --non-interactive

ข้อมูลอ้างอิงฉบับเต็ม

สำหรับรายละเอียดพฤติกรรมทีละขั้นตอนและผลลัพธ์การกำหนดค่า โปรดดู ข้อมูลอ้างอิงการตั้งค่า CLI สำหรับตัวอย่างแบบไม่โต้ตอบ โปรดดู การทำงานอัตโนมัติด้วย CLI สำหรับข้อมูลอ้างอิงแฟล็กทั้งหมด โปรดดู openclaw onboard

เอกสารที่เกี่ยวข้อง

• ข้อมูลอ้างอิงคำสั่ง CLI: openclaw onboard
• ภาพรวมการเริ่มต้นใช้งาน: ภาพรวมการเริ่มต้นใช้งาน
• การเริ่มต้นใช้งานแอป macOS: การเริ่มต้นใช้งาน
• ขั้นตอนเริ่มใช้งานครั้งแรกของเอเจนต์: การเริ่มต้นระบบเอเจนต์