---
read_when:
    - คุณต้องการตั้งค่าการอนุมาน จากนั้นดำเนินการตั้งค่า OpenClaw ให้เสร็จสมบูรณ์
summary: เอกสารอ้างอิง CLI สำหรับ `openclaw onboard` (การเริ่มต้นใช้งานแบบโต้ตอบ)
title: เริ่มต้นใช้งาน
x-i18n:
    generated_at: "2026-07-21T15:19:55Z"
    model: gpt-5.6
    postprocess_version: locale-links-v1
    prompt_version: 32
    provider: openai
    source_hash: 778fc7bc688ec5fd1304f2107306a92188cfdbb61f6e83e3935d03dd40224119
    source_path: cli/onboard.md
    workflow: 16
---

# `openclaw onboard`

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

<CardGroup cols={2}>
  <Card title="ศูนย์รวมการเริ่มต้นใช้งานผ่าน CLI" href="/th/start/wizard" icon="rocket">
    คำแนะนำทีละขั้นสำหรับขั้นตอน CLI แบบโต้ตอบ
  </Card>
  <Card title="ภาพรวมการเริ่มต้นใช้งาน" href="/th/start/onboarding-overview" icon="map">
    องค์ประกอบต่าง ๆ ของการเริ่มต้นใช้งาน OpenClaw ทำงานร่วมกันอย่างไร
  </Card>
  <Card title="เอกสารอ้างอิงการตั้งค่าผ่าน CLI" href="/th/start/wizard-cli-reference" icon="book">
    ผลลัพธ์ การทำงานภายใน และลักษณะการทำงานในแต่ละขั้นตอน
  </Card>
  <Card title="การทำงานอัตโนมัติผ่าน CLI" href="/th/start/wizard-cli-automation" icon="terminal">
    แฟล็กแบบไม่โต้ตอบและการตั้งค่าด้วยสคริปต์
  </Card>
  <Card title="การเริ่มต้นใช้งานแอป macOS" href="/th/start/onboarding" icon="apple">
    ขั้นตอนการเริ่มต้นใช้งานสำหรับแอปแถบเมนู macOS
  </Card>
</CardGroup>

## ตัวอย่าง

```bash
openclaw onboard
openclaw onboard --tui
openclaw onboard --classic
openclaw onboard --modern
openclaw onboard --flow quickstart
openclaw onboard --flow manual
openclaw onboard --flow import
openclaw onboard --import-from hermes --import-source ~/.hermes
openclaw onboard --skip-bootstrap
openclaw onboard recommendations --json
openclaw onboard recommendations acknowledge
openclaw onboard recommendations acknowledge --retry "<failed-id>"
openclaw onboard recommendations refresh
openclaw 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`](/th/cli/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/` เพื่อเรียกคืนผ่านดัชนี จะไม่มีการนำเข้า
หากไม่ได้รับการยืนยัน ไฟล์ที่เคยนำเข้าแล้วจะถูกข้าม และสามารถนำเข้า
ภายหลังได้เสมอจาก [หน้านำเข้าหน่วยความจำ](/th/web/control-ui) ใน Control UI ซึ่งมี
ขอบเขตเฉพาะหน่วยความจำแบบเดียวกัน (การเรียกใช้ [`openclaw migrate`](/th/cli/migrate)
แบบเต็มมีขอบเขตกว้างกว่า โดยสามารถนำเข้าการกำหนดค่า Skills และข้อมูลประจำตัวด้วย)
วิซาร์ดแบบคลาสสิกจะแสดงหน้าเดียวกันหลังจากเตรียมเวิร์กสเปซแล้ว

หลังจากการอนุมานผ่าน (และหลังข้อเสนอการนำเข้าหน่วยความจำ) การเริ่มต้นใช้งานแบบมีคำแนะนำ
จะใช้การตั้งค่ามาตรฐานโดยอัตโนมัติ ได้แก่ เวิร์กสเปซ Gateway และเซสชัน
ซึ่งเป็นแผนเดียวกับที่แชต `openclaw setup` แบบสนทนาจะใช้เมื่อได้รับคำตอบว่า "ใช่"
จากนั้นจะเสนอคำแนะนำ Plugin และ Skills จากแอปที่ติดตั้ง โดยจับคู่ชื่อแอป
ผ่านโมเดลที่กำหนดค่าไว้และการค้นหา ClawHub และสามารถปิดใช้งานขั้นตอนนี้
ด้วย [`wizard.appRecommendations`](/th/gateway/configuration-reference#wizard)
ในเซสชันเดสก์ท็อป 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` ในสภาพแวดล้อมของกระบวนการเริ่มต้นใช้งาน

## รีเซ็ต

```bash
openclaw onboard --reset
openclaw 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/ช่องทางจะคงไว้ตามต้นฉบับ

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

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

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

```bash
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 มีแฟล็กคีย์เฉพาะผู้ให้บริการด้วย:

```bash
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 แบบไม่โต้ตอบ:

```bash
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` ก็ใช้ได้ที่นี่เช่นกัน

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

```bash
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`

```bash
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

<Note>
`--auth-choice zai-api-key` จะตรวจหาปลายทางและโมเดล Z.AI ที่เหมาะสมที่สุดสำหรับคีย์โดยอัตโนมัติ: ปลายทาง Coding Plan จะเลือก `zai/glm-5.2` ก่อน (และใช้ `glm-5.1` เป็นทางเลือกหากใช้ไม่ได้) ส่วนปลายทาง API ทั่วไปจะใช้ `zai/glm-5.1` เป็นค่าเริ่มต้น หากต้องการบังคับใช้ปลายทาง Coding Plan ให้เลือก `zai-coding-global` หรือ `zai-coding-cn` โดยตรง
</Note>

```bash
# เลือกปลายทางโดยไม่แสดงพรอมต์
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:

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

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

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

| แฟล็ก                            | คำอธิบาย                                                                                                                 |
| ------------------------------- | --------------------------------------------------------------------------------------------------------------------------- |
| `--token-provider <id>`         | ID ของผู้ให้บริการโทเค็นที่ออกโทเค็น                                                                                         |
| `--token <token>`               | ค่าโทเค็นสำหรับการยืนยันตัวตนของโมเดล                                                                                        |
| `--token-profile-id <id>`       | ID โปรไฟล์การยืนยันตัวตน (ค่าเริ่มต้น `<provider>:manual`; ขั้นตอนบางรายการที่ผู้ให้บริการเป็นเจ้าของจะใช้ค่าเริ่มต้นของตนเอง เช่น `anthropic:default`) |
| `--token-expires-in <duration>` | ระยะเวลาหมดอายุของโทเค็นซึ่งเป็นตัวเลือก (เช่น `365d`, `12h`)                                                                         |

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

<Note>
`--json` ไม่ได้หมายถึงโหมดไม่โต้ตอบในการเริ่มต้นใช้งานแบบแนะนำหรือแบบคลาสสิก
เมื่อใช้ `--modern` JSON จะเป็นภาพรวม OpenClaw แบบครั้งเดียว และจะออกหลังจากได้ผลลัพธ์เดียว
ใช้ `--non-interactive` สำหรับสคริปต์อื่น
</Note>

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

เมื่อตัวเลือกการยืนยันตัวตนระบุผู้ให้บริการที่ต้องการ การเริ่มต้นใช้งานจะกรองตัวเลือกโมเดลเริ่มต้นและรายการอนุญาตล่วงหน้าให้เหลือเฉพาะโมเดลของผู้ให้บริการนั้น ตัวกรองยังจับคู่ผู้ให้บริการอื่นที่ 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](/th/start/wizard-cli-reference#outputs-and-internals)
- เริ่มแชตแรกได้เร็วที่สุด: `openclaw dashboard` (Control UI โดยไม่ตั้งค่าช่องทาง)
- ผู้ให้บริการแบบกำหนดเอง: เชื่อมต่อปลายทางใดๆ ที่เข้ากันได้กับ OpenAI หรือ Anthropic รวมถึงผู้ให้บริการแบบโฮสต์ที่ไม่ได้ระบุไว้ ใช้ความเข้ากันได้แบบ **ไม่ทราบ** เพื่อตรวจหาโดยอัตโนมัติผ่านการทดสอบสด
- หากตรวจพบสถานะ Hermes การเริ่มต้นใช้งานจะเสนอขั้นตอนการย้ายข้อมูล (ดู `--flow import` ด้านบน)

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

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

```bash
openclaw channels add
openclaw configure
openclaw agents add <name>
```
