---
read_when:
    - การเรียกใช้หรือกำหนดค่าการเริ่มต้นใช้งานผ่าน CLI
    - การตั้งค่าเครื่องใหม่
sidebarTitle: 'Onboarding: CLI'
summary: 'การเริ่มต้นใช้งานผ่าน CLI: ตรวจสอบการอนุมาน แล้วส่งต่อการตั้งค่าที่เหลือให้ Crestodian'
title: การเริ่มต้นใช้งาน (CLI)
x-i18n:
    generated_at: "2026-07-12T16:48:38Z"
    model: gpt-5.6
    postprocess_version: locale-links-v1
    provider: openai
    source_hash: 62dd8fc2780940f738fc99f04ef0c765f5582161c55d11100fae3b4bbbb0ea15
    source_path: start/wizard.md
    workflow: 16
---

```bash
openclaw onboard
```

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

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

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

<Info>
วิธีเริ่มแชตครั้งแรกที่เร็วที่สุด: ตั้งค่าแบบมีคำแนะนำให้เสร็จ เรียกใช้ `openclaw dashboard` แล้วแชตในเบราว์เซอร์ผ่าน Control UI เอกสาร: [แดชบอร์ด](/th/web/dashboard)
</Info>

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

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

```bash
OPENCLAW_LOCALE=zh-CN openclaw onboard
```

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

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

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

<Note>
`--json` ไม่ได้หมายถึงโหมดไม่โต้ตอบ สำหรับสคริปต์ ให้ใช้ `--non-interactive` (ดู [การทำงานอัตโนมัติด้วย CLI](/th/start/wizard-cli-automation))
</Note>

<Tip>
วิซาร์ดแบบคลาสสิกมีขั้นตอนค้นหาเว็บที่ให้คุณเลือกผู้ให้บริการ ได้แก่ Brave, DuckDuckGo, Exa, Firecrawl, Gemini, Grok, Kimi, MiniMax Search, Ollama Web Search, Perplexity, SearXNG หรือ Tavily บางรายต้องใช้คีย์ API ส่วนบางรายไม่ต้องใช้คีย์ กำหนดค่านี้ภายหลังได้ด้วย `openclaw configure --section web` เอกสาร: [เครื่องมือเว็บ](/th/tools/web)
</Tip>

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

`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`) เพื่อเลือกขั้นตอนแบบคลาสสิกและข้ามพรอมต์ดังกล่าว

<Tabs>
  <Tab title="QuickStart (defaults)">
    - Gateway ภายในเครื่อง ผูกกับลูปแบ็ก
    - พื้นที่ทำงานเริ่มต้น (หรือพื้นที่ทำงานที่มีอยู่)
    - พอร์ต Gateway **18789**
    - การยืนยันตัวตนของ Gateway แบบ **Token** (สร้างโดยอัตโนมัติ แม้ใช้ลูปแบ็ก)
    - นโยบายเครื่องมือ: `tools.profile: "coding"` สำหรับการตั้งค่าใหม่ (หากมีโปรไฟล์ที่ระบุไว้อย่างชัดเจนอยู่แล้ว ระบบจะคงค่าไว้)
    - การแยก DM: `session.dmScope: "per-channel-peer"` สำหรับการตั้งค่าใหม่ รายละเอียด: [ข้อมูลอ้างอิงการตั้งค่า CLI](/th/start/wizard-cli-reference#outputs-and-internals)
    - การเปิดให้เข้าถึงผ่าน Tailscale **Off**
    - DM ของ Telegram และ WhatsApp ใช้ค่าเริ่มต้นเป็น **allowlist**: Telegram จะขอรหัสผู้ใช้ Telegram แบบตัวเลข ส่วน WhatsApp จะขอหมายเลขโทรศัพท์

  </Tab>
  <Tab title="Advanced (full control)">
    - แสดงทุกขั้นตอน ได้แก่ โหมด พื้นที่ทำงาน Gateway ช่องทาง ดีมอน และ Skills

  </Tab>
</Tabs>

โหมดระยะไกล (`--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 เหล่านั้น

<Note>
การเรียกใช้การเริ่มต้นใช้งานซ้ำจะ **ไม่** ลบสิ่งใด เว้นแต่คุณจะเลือก **Reset** อย่างชัดเจน (หรือส่ง `--reset`) โดยค่าเริ่มต้น `--reset` ของ CLI จะรีเซ็ตการกำหนดค่า ข้อมูลประจำตัว และเซสชัน ใช้ `--reset-scope full` เพื่อลบพื้นที่ทำงานด้วย หากการกำหนดค่าไม่ถูกต้องหรือมีคีย์แบบเก่า การเริ่มต้นใช้งานจะขอให้คุณเรียกใช้ `openclaw doctor` ก่อน
</Note>

`--flow import` จะเรียกใช้ขั้นตอนการย้ายข้อมูลที่ตรวจพบ (เช่น Hermes) ในวิซาร์ดแบบคลาสสิกแทนการตั้งค่าใหม่ ดู [ย้ายข้อมูล](/th/cli/migrate) และคู่มือการย้ายข้อมูลภายใต้ [ติดตั้ง](/th/install/migrating-hermes) `openclaw onboard --modern` เป็นนามแฝงเพื่อความเข้ากันได้สำหรับ [Crestodian](/th/cli/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](/th/start/wizard-cli-reference)
สำหรับตัวอย่างแบบไม่โต้ตอบ โปรดดู [การทำงานอัตโนมัติด้วย CLI](/th/start/wizard-cli-automation)
สำหรับข้อมูลอ้างอิงแฟล็กทั้งหมด โปรดดู [`openclaw onboard`](/th/cli/onboard)

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

- ข้อมูลอ้างอิงคำสั่ง CLI: [`openclaw onboard`](/th/cli/onboard)
- ภาพรวมการเริ่มต้นใช้งาน: [ภาพรวมการเริ่มต้นใช้งาน](/th/start/onboarding-overview)
- การเริ่มต้นใช้งานแอป macOS: [การเริ่มต้นใช้งาน](/th/start/onboarding)
- ขั้นตอนเริ่มใช้งานครั้งแรกของเอเจนต์: [การเริ่มต้นระบบเอเจนต์](/th/start/bootstrapping)