---
read_when:
    - การเรียกใช้หรือกำหนดค่าการเริ่มต้นใช้งาน CLI
    - การตั้งค่าเครื่องใหม่
sidebarTitle: 'Onboarding: CLI'
summary: 'การเริ่มต้นใช้งาน CLI: การตั้งค่าแบบมีคำแนะนำสำหรับ Gateway, พื้นที่ทำงาน, ช่องทาง และ Skills'
title: การเริ่มต้นใช้งาน (CLI)
x-i18n:
    generated_at: "2026-05-10T19:58:10Z"
    model: gpt-5.5
    provider: openai
    source_hash: 6d8093f2375240f7a784b22c97c824a49b4d39b9217c0d1c0a1490bb15160700
    source_path: start/wizard.md
    workflow: 16
---

การเริ่มต้นใช้งานผ่าน CLI เป็นวิธีที่**แนะนำ**สำหรับตั้งค่า OpenClaw บน macOS,
Linux หรือ Windows (ผ่าน WSL2; แนะนำอย่างยิ่ง)
วิธีนี้จะกำหนดค่า Gateway ภายในเครื่องหรือการเชื่อมต่อ Gateway ระยะไกล รวมถึงช่องทาง, skills,
และค่าเริ่มต้นของพื้นที่ทำงานในขั้นตอนแนะนำเดียว

```bash
openclaw onboard
```

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

หากต้องการกำหนดค่าใหม่ภายหลัง:

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

<Note>
`--json` ไม่ได้หมายถึงโหมดไม่โต้ตอบ สำหรับสคริปต์ ให้ใช้ `--non-interactive`
</Note>

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

## เริ่มต้นด่วนเทียบกับขั้นสูง

การเริ่มต้นใช้งานเริ่มด้วย **เริ่มต้นด่วน** (ค่าเริ่มต้น) เทียบกับ **ขั้นสูง** (ควบคุมได้ทั้งหมด)

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

  </Tab>
  <Tab title="ขั้นสูง (ควบคุมได้ทั้งหมด)">
    - แสดงทุกขั้นตอน (โหมด, พื้นที่ทำงาน, Gateway, ช่องทาง, daemon, skills)

  </Tab>
</Tabs>

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

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

1. **โมเดล/การยืนยันตัวตน** — เลือกผู้ให้บริการ/โฟลว์การยืนยันตัวตนที่รองรับใดก็ได้ (API key, OAuth หรือการยืนยันตัวตนแบบแมนนวลเฉพาะผู้ให้บริการ) รวมถึง Custom Provider
   (เข้ากันได้กับ OpenAI, เข้ากันได้กับ Anthropic หรือ Unknown auto-detect) เลือกโมเดลเริ่มต้น
   หมายเหตุด้านความปลอดภัย: หาก agent นี้จะเรียกใช้เครื่องมือหรือประมวลผลเนื้อหา webhook/hooks ให้ใช้โมเดลรุ่นล่าสุดที่แข็งแกร่งที่สุดเท่าที่มี และตั้งค่านโยบายเครื่องมือให้เข้มงวด ระดับที่อ่อนกว่าหรือเก่ากว่าจะถูก prompt-inject ได้ง่ายกว่า
   สำหรับการเรียกใช้แบบไม่โต้ตอบ `--secret-input-mode ref` จะเก็บ ref ที่อิง env ในโปรไฟล์การยืนยันตัวตนแทนค่าข้อความล้วนของ API key
   ในโหมด `ref` แบบไม่โต้ตอบ ต้องตั้งค่า env var ของผู้ให้บริการไว้ การส่งแฟล็กคีย์แบบ inline โดยไม่มี env var นั้นจะล้มเหลวทันที
   ในการเรียกใช้แบบโต้ตอบ การเลือกโหมด secret reference จะให้คุณชี้ไปยังตัวแปรสภาพแวดล้อมหรือ provider ref ที่กำหนดค่าไว้ (`file` หรือ `exec`) พร้อมการตรวจสอบ preflight อย่างรวดเร็วก่อนบันทึก
   สำหรับ Anthropic การเริ่มต้นใช้งาน/กำหนดค่าแบบโต้ตอบจะเสนอ **Anthropic Claude CLI** เป็นเส้นทางภายในเครื่องที่แนะนำ และ **Anthropic API key** เป็นเส้นทางการใช้งานจริงที่แนะนำ Anthropic setup-token ยังคงพร้อมใช้งานในฐานะเส้นทาง token-auth ที่รองรับด้วย
2. **พื้นที่ทำงาน** — ตำแหน่งสำหรับไฟล์ agent (ค่าเริ่มต้น `~/.openclaw/workspace`) พร้อมสร้างไฟล์ bootstrap เริ่มต้น
3. **Gateway** — พอร์ต, ที่อยู่ bind, โหมดการยืนยันตัวตน, การเปิดเผยผ่าน Tailscale
   ในโหมด token แบบโต้ตอบ ให้เลือกการจัดเก็บ token แบบข้อความล้วนตามค่าเริ่มต้น หรือเลือกใช้ SecretRef
   เส้นทาง SecretRef ของ token แบบไม่โต้ตอบ: `--gateway-token-ref-env <ENV_VAR>`
4. **ช่องทาง** — ช่องทางแชตในตัวและที่รวมมาให้ เช่น iMessage, Discord, Feishu, Google Chat, Mattermost, Microsoft Teams, QQ Bot, Signal, Slack, Telegram, WhatsApp และอื่นๆ
5. **Daemon** — ติดตั้ง LaunchAgent (macOS), systemd user unit (Linux/WSL2) หรือ Windows Scheduled Task แบบ native พร้อมทางเลือก fallback ผ่านโฟลเดอร์ Startup ต่อผู้ใช้
   หากการยืนยันตัวตนด้วย token ต้องใช้ token และ `gateway.auth.token` ถูกจัดการด้วย SecretRef การติดตั้ง daemon จะตรวจสอบความถูกต้อง แต่จะไม่คงค่า token ที่ resolve แล้วไว้ใน metadata สภาพแวดล้อมของ supervisor service
   หากการยืนยันตัวตนด้วย token ต้องใช้ token และ token SecretRef ที่กำหนดค่าไว้ยัง resolve ไม่ได้ การติดตั้ง daemon จะถูกบล็อกพร้อมคำแนะนำที่นำไปปฏิบัติได้
   หากตั้งค่าทั้ง `gateway.auth.token` และ `gateway.auth.password` แล้ว แต่ยังไม่ได้ตั้งค่า `gateway.auth.mode` การติดตั้ง daemon จะถูกบล็อกจนกว่าจะตั้งค่าโหมดอย่างชัดเจน
6. **การตรวจสอบสุขภาพ** — เริ่ม Gateway และตรวจสอบว่ากำลังทำงานอยู่
7. **Skills** — ติดตั้ง skills ที่แนะนำและ dependency เสริม

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

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

## เพิ่ม agent อีกตัว

ใช้ `openclaw agents add <name>` เพื่อสร้าง agent แยกต่างหากที่มีพื้นที่ทำงาน,
sessions และโปรไฟล์การยืนยันตัวตนของตัวเอง การเรียกใช้โดยไม่มี `--workspace` จะเปิดการเริ่มต้นใช้งาน

สิ่งที่ตั้งค่า:

- `agents.list[].name`
- `agents.list[].workspace`
- `agents.list[].agentDir`

หมายเหตุ:

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

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

สำหรับรายละเอียดแบบทีละขั้นตอนและผลลัพธ์ config โปรดดู
[ข้อมูลอ้างอิงการตั้งค่า CLI](/th/start/wizard-cli-reference)
สำหรับตัวอย่างแบบไม่โต้ตอบ โปรดดู [การทำงานอัตโนมัติด้วย CLI](/th/start/wizard-cli-automation)
สำหรับข้อมูลอ้างอิงทางเทคนิคเชิงลึก รวมถึงรายละเอียด RPC โปรดดู
[ข้อมูลอ้างอิงการเริ่มต้นใช้งาน](/th/reference/wizard)

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

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