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

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

openclaw onboard

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

openclaw configureopenclaw agents add <name>

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

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

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

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

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 เสริม

โหมดระยะไกล จะกำหนดค่าเฉพาะไคลเอนต์ภายในเครื่องให้เชื่อมต่อกับ 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 สำหรับตัวอย่างแบบไม่โต้ตอบ โปรดดู การทำงานอัตโนมัติด้วย CLI สำหรับข้อมูลอ้างอิงทางเทคนิคเชิงลึก รวมถึงรายละเอียด RPC โปรดดู ข้อมูลอ้างอิงการเริ่มต้นใช้งาน

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

• ข้อมูลอ้างอิงคำสั่ง CLI: openclaw onboard
• ภาพรวมการเริ่มต้นใช้งาน: ภาพรวมการเริ่มต้นใช้งาน
• การเริ่มต้นใช้งานแอป macOS: การเริ่มต้นใช้งาน
• พิธีการเรียกใช้ agent ครั้งแรก: การ bootstrap agent