---
read_when:
- ค้นหาขั้นตอนหรือแฟล็กเฉพาะในการเริ่มต้นใช้งาน
- ทำให้การเริ่มต้นใช้งานเป็นอัตโนมัติด้วยโหมดไม่โต้ตอบ
- การแก้ไขข้อบกพร่องของลักษณะการทำงานระหว่างการเริ่มต้นใช้งาน
sidebarTitle: Onboarding Reference
summary: 'ข้อมูลอ้างอิงฉบับเต็มสำหรับการเริ่มต้นใช้งาน CLI: ทุกขั้นตอน แฟล็ก และฟิลด์การกำหนดค่า'
title: ข้อมูลอ้างอิงการเริ่มต้นใช้งาน
x-i18n:
generated_at: "2026-07-19T07:36:11Z"
model: gpt-5.6
postprocess_version: locale-links-v1
prompt_version: 32
provider: openai
source_hash: 5fcf2876fcd01f6ce3fe029068e55eaba7281dd997c28d7f3799a97f12e5e751
source_path: reference/wizard.md
workflow: 16
---
นี่คือข้อมูลอ้างอิงฉบับสมบูรณ์สำหรับ `openclaw onboard`
สำหรับภาพรวมระดับสูง โปรดดู [การเริ่มต้นใช้งาน (CLI)](/th/start/wizard) สำหรับพฤติกรรมและผลลัพธ์
แบบทีละขั้นตอน โปรดดู [ข้อมูลอ้างอิงการตั้งค่า CLI](/th/start/wizard-cli-reference)
## รายละเอียดขั้นตอน (โหมดภายในเครื่อง)
- `--reset` รีเซ็ตสถานะก่อนเริ่มการตั้งค่า หากไม่ใช้ตัวเลือกนี้ การเริ่มต้นใช้งานซ้ำ
จะคงการกำหนดค่าที่มีอยู่และนำกลับมาใช้เป็นค่าเริ่มต้น
- `--reset-scope` ควบคุมสิ่งที่ `--reset` นำออก ได้แก่ `config` (เฉพาะไฟล์
การกำหนดค่า), `config+creds+sessions` (ค่าเริ่มต้น) หรือ `full` (นำ
เวิร์กสเปซออกด้วย)
- หากไฟล์การกำหนดค่าไม่ถูกต้อง การเริ่มต้นใช้งานจะหยุดและแจ้งให้เรียกใช้
`openclaw doctor` ก่อน แล้วจึงเรียกใช้การตั้งค่าอีกครั้ง
- การรีเซ็ตจะย้ายสถานะไปยังถังขยะ (ไม่ลบโดยตรงเด็ดขาด)
- ในการเรียกใช้ครั้งแรก (หรือการเรียกใช้ใด ๆ ก่อนตั้งค่า `wizard.securityAcknowledgedAt`)
ระบบจะขอให้ยืนยันว่าเข้าใจว่าเอเจนต์มีความสามารถสูง และการให้สิทธิ์เข้าถึง
ระบบทั้งหมดมีความเสี่ยง
- `--non-interactive` กำหนดให้ระบุ `--accept-risk` อย่างชัดเจน หากไม่มีตัวเลือกนี้
การเริ่มต้นใช้งานจะจบการทำงานพร้อมข้อผิดพลาดแทนการแสดงข้อความถาม
- การเรียกใช้แบบโต้ตอบจะแสดงข้อความขอการยืนยันแทนแฟล็ก หากปฏิเสธ
การตั้งค่าจะถูกยกเลิก
- **คีย์ API ของ Anthropic**: ใช้ `ANTHROPIC_API_KEY` หากมีอยู่ หรือขอให้ป้อนคีย์ แล้วบันทึกไว้ให้ดีมอนใช้งาน
- **Anthropic Claude CLI**: เส้นทางภายในเครื่องที่แนะนำเมื่อมีการลงชื่อเข้าใช้ Claude CLI อยู่แล้ว โดย OpenClaw ยังคงรองรับการยืนยันตัวตนด้วยโทเค็นการตั้งค่าของ Anthropic เป็นทางเลือก
- **การสมัครสมาชิก OpenAI Code (Codex) (OAuth)**: ขั้นตอนผ่านเบราว์เซอร์ ให้วาง `code#state`
- ในการตั้งค่าใหม่ที่ยังไม่มีโมเดลหลัก จะตั้งค่า `agents.defaults.model` เป็น `openai/gpt-5.6-sol` ผ่านรันไทม์ Codex
- **การสมัครสมาชิก OpenAI Code (Codex) (การจับคู่อุปกรณ์)**: ขั้นตอนจับคู่ผ่านเบราว์เซอร์ด้วยรหัสอุปกรณ์ที่มีอายุสั้น
- ในการตั้งค่าใหม่ที่ยังไม่มีโมเดลหลัก จะตั้งค่า `agents.defaults.model` เป็น `openai/gpt-5.6-sol` ผ่านรันไทม์ Codex
- **คีย์ API ของ OpenAI**: ใช้ `OPENAI_API_KEY` หากมีอยู่ หรือขอให้ป้อนคีย์ แล้วจัดเก็บไว้ในโปรไฟล์การยืนยันตัวตน
- ในการตั้งค่าใหม่ที่ยังไม่มีโมเดลหลัก จะตั้งค่า `agents.defaults.model` เป็น `openai/gpt-5.6` โดยรหัสโมเดล API โดยตรงแบบไม่มีส่วนขยายจะได้รับการแปลงเป็นระดับ Sol
- การเพิ่มหรือยืนยันตัวตน OpenAI ใหม่จะคงโมเดลหลักที่ระบุไว้อย่างชัดเจนเดิม รวมถึง `openai/gpt-5.5` หากบัญชีไม่เปิดให้ใช้ GPT-5.6 ให้เลือก `openai/gpt-5.5` อย่างชัดเจน OpenClaw จะไม่ลดระดับโมเดลโดยไม่แจ้ง
- **xAI OAuth**: ลงชื่อเข้าใช้ผ่านเบราว์เซอร์ด้วยรหัสอุปกรณ์โดยไม่ต้องใช้คอลแบ็ก localhost จึงใช้งานผ่าน SSH/Docker/VPS ได้เช่นกัน (`--auth-choice xai-oauth`)
- **คีย์ API ของ xAI**: ขอให้ป้อน `XAI_API_KEY` (`--auth-choice xai-api-key`)
- `--auth-choice xai-device-code` ยังคงทำงานเป็นนามแฝงเพื่อความเข้ากันได้แบบกำหนดเองเท่านั้น สำหรับขั้นตอน OAuth ด้วยรหัสอุปกรณ์ของ xAI เดียวกัน โปรดใช้ `xai-oauth` สำหรับสคริปต์ใหม่
- **OpenCode**: ขอให้ป้อน `OPENCODE_API_KEY` (หรือ `OPENCODE_ZEN_API_KEY` ซึ่งรับได้ที่ https://opencode.ai/auth) และให้เลือกแค็ตตาล็อก Zen หรือ Go
- **Ollama**: ให้เลือก **คลาวด์ + ภายในเครื่อง**, **เฉพาะคลาวด์** หรือ **เฉพาะภายในเครื่อง** ก่อน `Cloud only` จะขอ `OLLAMA_API_KEY` และใช้ `https://ollama.com` ส่วนโหมดที่มีโฮสต์รองรับจะขอ URL ฐานของ Ollama (ค่าเริ่มต้น `http://127.0.0.1:11434`) ค้นหาโมเดลที่พร้อมใช้งาน และดึงโมเดลภายในเครื่องที่เลือกโดยอัตโนมัติเมื่อจำเป็น นอกจากนี้ `Cloud + Local` ยังตรวจสอบว่าโฮสต์ Ollama นั้นลงชื่อเข้าใช้เพื่อเข้าถึงคลาวด์หรือไม่
- รายละเอียดเพิ่มเติม: [Ollama](/th/providers/ollama)
- **คีย์ API**: จัดเก็บคีย์ให้
- **Vercel AI Gateway (พร็อกซีหลายโมเดล)**: ขอให้ป้อน `AI_GATEWAY_API_KEY`
- รายละเอียดเพิ่มเติม: [Vercel AI Gateway](/th/providers/vercel-ai-gateway)
- **Cloudflare AI Gateway**: ขอ Account ID, Gateway ID และ `CLOUDFLARE_AI_GATEWAY_API_KEY`
- รายละเอียดเพิ่มเติม: [Cloudflare AI Gateway](/th/providers/cloudflare-ai-gateway)
- **MiniMax**: ระบบจะเขียนการกำหนดค่าให้อัตโนมัติ ค่าเริ่มต้นแบบโฮสต์คือ `MiniMax-M3`
การตั้งค่าด้วยคีย์ API ใช้ `minimax/...` และการตั้งค่าด้วย OAuth ใช้
`minimax-portal/...`
- รายละเอียดเพิ่มเติม: [MiniMax](/th/providers/minimax)
- **StepFun**: ระบบจะเขียนการกำหนดค่าให้อัตโนมัติสำหรับ StepFun มาตรฐานหรือ Step Plan บนปลายทางจีนหรือทั่วโลก
- ปัจจุบันโหมดมาตรฐานมีค่าเริ่มต้นเป็น `step-3.5-flash` และ Step Plan ยังมี `step-3.5-flash-2603` ด้วย
- รายละเอียดเพิ่มเติม: [StepFun](/th/providers/stepfun)
- **Synthetic (เข้ากันได้กับ Anthropic)**: ขอให้ป้อน `SYNTHETIC_API_KEY`
- รายละเอียดเพิ่มเติม: [Synthetic](/th/providers/synthetic)
- **Moonshot (Kimi K2)**: ระบบจะเขียนการกำหนดค่าให้อัตโนมัติ
- **Kimi Coding**: ระบบจะเขียนการกำหนดค่าให้อัตโนมัติ
- รายละเอียดเพิ่มเติม: [Moonshot AI (Kimi + Kimi Coding)](/th/providers/moonshot)
- **ผู้ให้บริการแบบกำหนดเอง**: ทำงานกับปลายทางที่เข้ากันได้กับ OpenAI, OpenAI Responses หรือ Anthropic แฟล็กสำหรับโหมดไม่โต้ตอบ ได้แก่ `--auth-choice custom-api-key`, `--custom-base-url`, `--custom-model-id`, `--custom-api-key` (ไม่บังคับ หากไม่มีจะใช้ `CUSTOM_API_KEY`), `--custom-provider-id` (ไม่บังคับ ระบบอนุมานจาก URL ฐานโดยอัตโนมัติ), `--custom-compatibility openai|openai-responses|anthropic` (ค่าเริ่มต้น `openai`), `--custom-image-input` / `--custom-text-input` (แทนที่การตรวจหาโมเดลภาพที่อนุมานไว้)
- **ข้าม**: ยังไม่ได้กำหนดค่าการยืนยันตัวตน
- เลือกโมเดลเริ่มต้นจากตัวเลือกที่ตรวจพบ (หรือป้อนผู้ให้บริการ/โมเดลด้วยตนเอง) เพื่อคุณภาพที่ดีที่สุดและลดความเสี่ยงจากการแทรกคำสั่งในพรอมต์ ให้เลือกโมเดลรุ่นล่าสุดที่มีประสิทธิภาพสูงสุดในชุดผู้ให้บริการของคุณ
- การเริ่มต้นใช้งานจะตรวจสอบโมเดลและเตือนหากไม่รู้จักโมเดลที่กำหนดค่าไว้หรือไม่มีการยืนยันตัวตน
- โหมดจัดเก็บคีย์ API มีค่าเริ่มต้นเป็นค่าข้อความธรรมดาในโปรไฟล์การยืนยันตัวตน ใช้ `--secret-input-mode ref` เพื่อจัดเก็บการอ้างอิงที่ใช้ตัวแปรสภาพแวดล้อมแทน (ตัวอย่างเช่น `keyRef: { source: "env", provider: "default", id: "OPENAI_API_KEY" }`) โดยต้องตั้งค่าตัวแปรสภาพแวดล้อมที่อ้างถึงไว้แล้ว มิฉะนั้นการเริ่มต้นใช้งานจะล้มเหลวทันที
- โปรไฟล์การยืนยันตัวตนอยู่ใน `~/.openclaw/agents//agent/auth-profiles.json` (คีย์ API + OAuth) ส่วน `~/.openclaw/credentials/oauth.json` ใช้สำหรับนำเข้าระบบเก่าเท่านั้น
- รายละเอียดเพิ่มเติม: [OAuth](/th/concepts/oauth)
เคล็ดลับสำหรับเซิร์ฟเวอร์/ระบบที่ไม่มีจอ: ดำเนินการ OAuth บนเครื่องที่มีเบราว์เซอร์ให้เสร็จ จากนั้นคัดลอก
`auth-profiles.json` ของเอเจนต์นั้น (ตัวอย่างเช่น
`~/.openclaw/agents//agent/auth-profiles.json` หรือพาธ
`$OPENCLAW_STATE_DIR/...` ที่ตรงกัน) ไปยังโฮสต์ Gateway ส่วน `credentials/oauth.json`
เป็นเพียงแหล่งนำเข้าจากระบบเก่าเท่านั้น
- ค่าเริ่มต้นคือ `~/.openclaw/workspace` (กำหนดค่าได้)
- สร้างไฟล์เวิร์กสเปซเริ่มต้นที่จำเป็นสำหรับขั้นตอนบูตสแตรปของเอเจนต์
- โครงสร้างเวิร์กสเปซฉบับเต็มและคู่มือการสำรองข้อมูล: [เวิร์กสเปซของเอเจนต์](/th/concepts/agent-workspace)
- พอร์ต (ค่าเริ่มต้น **18789**), การผูกที่อยู่, โหมดการยืนยันตัวตน, การเปิดให้เข้าถึงผ่าน Tailscale
- คำแนะนำด้านการยืนยันตัวตน: ใช้ **โทเค็น** ต่อไปแม้กับลูปแบ็ก เพื่อให้ไคลเอนต์ WS ภายในเครื่องต้องยืนยันตัวตน
- ในโหมดโทเค็น การตั้งค่าแบบโต้ตอบมีตัวเลือก:
- **สร้าง/จัดเก็บโทเค็นแบบข้อความธรรมดา** (ค่าเริ่มต้น)
- **ใช้ SecretRef** (เลือกใช้)
- การเริ่มต้นอย่างรวดเร็วจะใช้ SecretRef ของ `gateway.auth.token` ที่มีอยู่ซ้ำในผู้ให้บริการ `env`, `file` และ `exec` สำหรับการตรวจสอบระหว่างเริ่มต้นใช้งาน/การบูตสแตรปแดชบอร์ด
- หากกำหนดค่า SecretRef นั้นไว้แต่ไม่สามารถแปลงค่าได้ การเริ่มต้นใช้งานจะล้มเหลวตั้งแต่เนิ่น ๆ พร้อมข้อความแก้ไขที่ชัดเจน แทนที่จะลดระดับการยืนยันตัวตนของรันไทม์โดยไม่แจ้ง
- ในโหมดรหัสผ่าน การตั้งค่าแบบโต้ตอบยังรองรับการจัดเก็บแบบข้อความธรรมดาหรือ SecretRef
- พาธ SecretRef ของโทเค็นสำหรับโหมดไม่โต้ตอบ: `--gateway-token-ref-env `
- ต้องมีตัวแปรสภาพแวดล้อมที่ไม่ว่างเปล่าในสภาพแวดล้อมของกระบวนการเริ่มต้นใช้งาน
- ใช้ร่วมกับ `--gateway-token` ไม่ได้
- ปิดการยืนยันตัวตนเฉพาะเมื่อเชื่อถือทุกกระบวนการภายในเครื่องอย่างเต็มที่เท่านั้น
- การผูกที่อยู่ที่ไม่ใช่ลูปแบ็กยังคงต้องใช้การยืนยันตัวตน
- [WhatsApp](/th/channels/whatsapp): การเข้าสู่ระบบด้วยคิวอาร์โค้ดแบบไม่บังคับ
- [Telegram](/th/channels/telegram): โทเค็นบอต
- [Discord](/th/channels/discord): โทเค็นบอต
- [Google Chat](/th/channels/googlechat): JSON ของบัญชีบริการ + กลุ่มเป้าหมาย Webhook
- [Mattermost](/th/channels/mattermost) (Plugin): โทเค็นบอต + URL ฐาน
- [Signal](/th/channels/signal) (Plugin): การติดตั้ง `signal-cli` แบบไม่บังคับ + การกำหนดค่าบัญชี
- [iMessage](/th/channels/imessage): พาธ CLI ของ `imsg` + สิทธิ์เข้าถึงฐานข้อมูล Messages ให้ใช้ตัวห่อ SSH เมื่อ Gateway ทำงานนอก Mac
- Discord, Feishu, Microsoft Teams, QQ Bot, Slack และช่องทางอื่น ๆ จัดส่งมาเป็น
Plugin ที่การเริ่มต้นใช้งานสามารถติดตั้งให้ได้ แค็ตตาล็อกฉบับเต็ม: [ช่องทาง](/th/channels)
- ความปลอดภัยของ DM: ค่าเริ่มต้นคือการจับคู่ DM แรกจะส่งรหัสมา ให้อนุมัติผ่าน `openclaw pairing approve ` หรือใช้รายการอนุญาต
- เลือกผู้ให้บริการที่รองรับ เช่น Brave, Codex (Hosted Search), DuckDuckGo, Exa, Firecrawl, Gemini, Grok, Kimi, MiniMax Search, Ollama Web Search, Parallel, Perplexity, SearXNG หรือ Tavily (หรือข้าม)
- ผู้ให้บริการที่ใช้ API สามารถใช้ตัวแปรสภาพแวดล้อมหรือการกำหนดค่าที่มีอยู่เพื่อการตั้งค่าอย่างรวดเร็ว ส่วนผู้ให้บริการที่ไม่ต้องใช้คีย์จะใช้ข้อกำหนดเบื้องต้นเฉพาะของผู้ให้บริการนั้นแทน
- ข้ามด้วย `--skip-search`
- กำหนดค่าภายหลัง: `openclaw configure --section web`
- macOS: LaunchAgent
- ต้องมีเซสชันผู้ใช้ที่เข้าสู่ระบบอยู่ สำหรับระบบที่ไม่มีจอ ให้ใช้ LaunchDaemon แบบกำหนดเอง (ไม่ได้จัดส่งมาด้วย)
- Linux (และ Windows ผ่าน WSL2): ยูนิตผู้ใช้ systemd
- การเริ่มต้นใช้งานจะพยายามเปิดใช้การทำงานค้างหลังออกจากระบบผ่าน `loginctl enable-linger ` เพื่อให้ Gateway ทำงานต่อหลังออกจากระบบ
- อาจขอสิทธิ์ sudo (เขียน `/var/lib/systemd/linger`) โดยจะลองโดยไม่ใช้ sudo ก่อน
- Windows แบบเนทีฟ: ใช้ Scheduled Task ก่อน หากการสร้างงานถูกปฏิเสธ OpenClaw จะถอยไปใช้รายการเข้าสู่ระบบในโฟลเดอร์ Startup ของผู้ใช้แต่ละราย และเริ่ม Gateway ทันที
- **การเลือกรันไทม์:** ต้องใช้ Node เนื่องจากที่เก็บสถานะรันไทม์มาตรฐานใช้ `node:sqlite` บริการ Bun รุ่นเก่าจะถูกย้ายไปยัง Node ระหว่างการซ่อมแซม
- หากการยืนยันตัวตนด้วยโทเค็นต้องใช้โทเค็น และ `gateway.auth.token` จัดการด้วย SecretRef การติดตั้งดีมอนจะตรวจสอบค่า แต่จะไม่บันทึกค่าโทเค็นแบบข้อความธรรมดาที่แปลงแล้วไว้ในข้อมูลเมตาสภาพแวดล้อมบริการของตัวควบคุม
- หากการยืนยันตัวตนด้วยโทเค็นต้องใช้โทเค็น แต่ SecretRef ของโทเค็นที่กำหนดค่าไว้ไม่สามารถแปลงค่าได้ การติดตั้งดีมอนจะถูกบล็อกพร้อมคำแนะนำที่นำไปปฏิบัติได้
- หากกำหนดค่าทั้ง `gateway.auth.token` และ `gateway.auth.password` แต่ไม่ได้ตั้งค่า `gateway.auth.mode` การติดตั้งดีมอนจะถูกบล็อกจนกว่าจะตั้งค่าโหมดอย่างชัดเจน
- เริ่ม Gateway (หากจำเป็น) และเรียกใช้ `openclaw health`
- เคล็ดลับ: `openclaw status --deep` เพิ่มการตรวจสอบสถานะ Gateway แบบสดในผลลัพธ์สถานะ รวมถึงการตรวจสอบช่องทางเมื่อรองรับ (ต้องเข้าถึง Gateway ได้)
- อ่าน Skills ที่พร้อมใช้งานและตรวจสอบข้อกำหนด
- ให้เลือกตัวจัดการ Node: **npm / pnpm / bun**
- ติดตั้งการขึ้นต่อกันเสริมโดยอัตโนมัติสำหรับ Skills แบบรวมชุดที่เชื่อถือได้ (บางรายการใช้ Homebrew บน macOS)
- ข้าม Skills ที่ไม่มีข้อกำหนดเบื้องต้นของตัวติดตั้ง Homebrew, uv หรือ Go จัดกลุ่มรายการเหล่านั้นพร้อมคำแนะนำการตั้งค่าด้วยตนเอง และชี้ไปที่ `openclaw doctor` เมื่อติดตั้งข้อกำหนดเบื้องต้นแล้ว
- สรุป + ขั้นตอนถัดไป รวมถึงข้อความถาม **คุณต้องการฟักเอเจนต์ของคุณอย่างไร?** สำหรับ Terminal, เบราว์เซอร์ หรือไว้ภายหลัง
หากตรวจไม่พบ GUI การเริ่มต้นใช้งานจะแสดงคำแนะนำการส่งต่อพอร์ต SSH สำหรับ Control UI แทนการเปิดเบราว์เซอร์
หากไม่มีแอสเซ็ตของ Control UI การเริ่มต้นใช้งานจะพยายามสร้างแอสเซ็ตเหล่านั้น โดยมีทางเลือกสำรองคือ `pnpm ui:build` (ติดตั้งการขึ้นต่อกันของ UI โดยอัตโนมัติ)
## โหมดไม่โต้ตอบ
ใช้ `--non-interactive --accept-risk` เพื่อทำให้การเริ่มต้นใช้งานเป็นอัตโนมัติหรือใช้ในสคริปต์ (
แฟล็กนี้เป็นการยอมรับความเสี่ยงที่จำเป็น หากไม่มีแฟล็กนี้
การเริ่มต้นใช้งานจะออกพร้อมข้อผิดพลาด):
```bash
openclaw onboard --non-interactive --accept-risk \
--mode local \
--auth-choice apiKey \
--anthropic-api-key "$ANTHROPIC_API_KEY" \
--gateway-port 18789 \
--gateway-bind loopback \
--install-daemon \
--daemon-runtime node \
--skip-skills
```
เพิ่ม `--json` เพื่อรับข้อมูลสรุปที่เครื่องอ่านได้
SecretRef ของโทเค็น Gateway ในโหมดไม่โต้ตอบ:
```bash
export OPENCLAW_GATEWAY_TOKEN="your-token"
openclaw onboard --non-interactive --accept-risk \
--mode local \
--auth-choice skip \
--gateway-auth token \
--gateway-token-ref-env OPENCLAW_GATEWAY_TOKEN
```
`--gateway-token` และ `--gateway-token-ref-env` ไม่สามารถใช้ร่วมกันได้
`--json` **ไม่ได้** หมายถึงโหมดไม่โต้ตอบ ใช้ `--non-interactive --accept-risk` (และ `--workspace`) สำหรับสคริปต์
ตัวอย่างคำสั่งเฉพาะผู้ให้บริการอยู่ใน [การทำงานอัตโนมัติด้วย CLI](/th/start/wizard-cli-automation#provider-specific-examples)
ใช้หน้าอ้างอิงนี้สำหรับความหมายของแฟล็กและลำดับขั้นตอน
### เพิ่มเอเจนต์ (ไม่โต้ตอบ)
```bash
openclaw agents add work \
--workspace ~/.openclaw/workspace-work \
--model openai/gpt-5.6-sol \
--bind whatsapp:biz \
--non-interactive \
--json
```
`main` เป็น ID เอเจนต์ที่สงวนไว้และไม่สามารถใช้กับ `openclaw agents add` ได้
## RPC ของตัวช่วยสร้าง Gateway
Gateway เปิดให้ใช้งานขั้นตอนการเริ่มต้นใช้งานผ่าน RPC (`wizard.start`, `wizard.next`, `wizard.cancel`, `wizard.status`)
ไคลเอนต์ (แอป macOS, Control UI) สามารถแสดงผลขั้นตอนต่างๆ ได้โดยไม่ต้องนำตรรกะการเริ่มต้นใช้งานไปสร้างใหม่
## การตั้งค่า Signal (signal-cli)
การเริ่มต้นใช้งานจะตรวจสอบว่า `signal-cli` อยู่ใน `PATH` หรือไม่ และหากไม่พบ จะเสนอให้ติดตั้ง:
- Linux x86-64: ดาวน์โหลดบิลด์ GraalVM แบบเนทีฟอย่างเป็นทางการจากรีลีส GitHub ของ `signal-cli` และจัดเก็บไว้ภายใต้ `~/.openclaw/tools/signal-cli//`
- macOS และสถาปัตยกรรมอื่นๆ: ติดตั้งผ่าน Homebrew แทน
- Windows แบบเนทีฟ: ยังไม่รองรับ ให้เรียกใช้การเริ่มต้นใช้งานภายใน WSL2 เพื่อใช้เส้นทางการติดตั้งสำหรับ Linux
- ไม่ว่าจะใช้วิธีใด ระบบจะเขียน `channels.signal.cliPath` ลงในการกำหนดค่าของคุณ
## สิ่งที่ตัวช่วยสร้างเขียน
ฟิลด์ทั่วไปใน `~/.openclaw/openclaw.json`:
- `agents.defaults.workspace`
- `agents.defaults.skipBootstrap` เมื่อส่ง `--skip-bootstrap`
- `agents.defaults.model` / `models.providers` (หากเลือก Minimax)
- `tools.profile` (การเริ่มต้นใช้งานภายในเครื่องจะใช้ค่าเริ่มต้นเป็น `"coding"` เมื่อยังไม่ได้ตั้งค่า และจะคงค่าที่ระบุไว้อย่างชัดเจนเดิมไว้)
- `gateway.*` (โหมด, การผูก, การยืนยันตัวตน, tailscale)
- `session.dmScope` (การเริ่มต้นใช้งานจะคงค่าที่ระบุไว้อย่างชัดเจน และหากไม่มีจะปล่อยให้ไม่ได้ตั้งค่า เพื่อให้ค่าเริ่มต้น `"main"` เก็บข้อความโดยตรงทั้งหมดจากทุกช่องทางไว้ในเซสชันหลักแบบต่อเนื่องของเอเจนต์ ซึ่งเป็นค่าเริ่มต้นสำหรับเอเจนต์ส่วนบุคคล สำหรับกล่องข้อความที่ใช้ร่วมกันหรือมีผู้ใช้หลายคน ให้ใช้ `"per-channel-peer"`; `openclaw security audit` จะแนะนำให้แยกเซสชันเมื่อตรวจพบการรับส่ง DM จากผู้ใช้หลายคน รายละเอียด: [ข้อมูลอ้างอิงการตั้งค่า CLI](/th/start/wizard-cli-reference#outputs-and-internals))
- `channels.telegram.botToken`, `channels.discord.token`, `channels.matrix.*`, `channels.signal.*`, `channels.imessage.*`
- รายการอนุญาต DM ของช่องทาง เมื่อคุณเลือกใช้ระหว่างข้อความแจ้งของช่องทาง Discord, Matrix, Microsoft Teams และ Slack จะแปลงชื่อเป็น ID เมื่อทำได้ ส่วนช่องทางอื่นๆ จะรับ ID โดยตรง (เช่น ID ผู้ส่ง Telegram ที่เป็นตัวเลขหรือหมายเลขโทรศัพท์ WhatsApp)
- `skills.install.nodeManager`
- `setup --node-manager` ยอมรับ `npm`, `pnpm` หรือ `bun`
- การกำหนดค่าด้วยตนเองยังคงใช้ `yarn` ได้โดยตั้งค่า `skills.install.nodeManager` โดยตรง
- `wizard.lastRunAt`
- `wizard.lastRunVersion`
- `wizard.lastRunCommit`
- `wizard.lastRunCommand`
- `wizard.lastRunMode`
- `wizard.securityAcknowledgedAt`
`openclaw agents add` เขียน `agents.list[]` และ `bindings` ซึ่งเป็นทางเลือก
ข้อมูลประจำตัวของ WhatsApp อยู่ภายใต้ `~/.openclaw/credentials/whatsapp//`
เซสชันที่ใช้งานอยู่และบทบันทึกการสนทนาจะจัดเก็บไว้ใน
`~/.openclaw/agents//agent/openclaw-agent.sqlite` ไดเรกทอรี
`~/.openclaw/agents//sessions/` ใช้สำหรับอินพุตการย้ายข้อมูลแบบเดิม
และอาร์ติแฟกต์สำหรับการเก็บถาวร/การสนับสนุน
ช่องทางบางรายการส่งมอบในรูปแบบ Plugin เมื่อเลือกช่องทางดังกล่าวระหว่างการตั้งค่า การเริ่มต้นใช้งาน
จะแจ้งให้ติดตั้ง (ผ่าน npm หรือพาธภายในเครื่อง) ก่อนจึงจะสามารถกำหนดค่าได้
## เอกสารที่เกี่ยวข้อง
- ภาพรวมการเริ่มต้นใช้งาน: [การเริ่มต้นใช้งาน (CLI)](/th/start/wizard)
- ข้อมูลอ้างอิงการตั้งค่า CLI: [ข้อมูลอ้างอิงการตั้งค่า CLI](/th/start/wizard-cli-reference)
- การเริ่มต้นใช้งานแอป macOS: [การเริ่มต้นใช้งาน](/th/start/onboarding)
- ข้อมูลอ้างอิงการกำหนดค่า: [การกำหนดค่า Gateway](/th/gateway/configuration)
- ผู้ให้บริการ: [WhatsApp](/th/channels/whatsapp), [Telegram](/th/channels/telegram), [Discord](/th/channels/discord), [Google Chat](/th/channels/googlechat), [Signal](/th/channels/signal), [iMessage](/th/channels/imessage)
- Skills: [Skills](/th/tools/skills), [การกำหนดค่า Skills](/th/tools/skills-config)