Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

การเริ่มต้นใช้งานผ่าน CLI เป็นวิธีที่แนะนำสำหรับตั้งค่า OpenClaw บน macOS, Linux หรือ Windows (ผ่าน WSL2; แนะนำอย่างยิ่ง) วิธีนี้จะกำหนดค่า Gateway ภายในเครื่องหรือการเชื่อมต่อ Gateway ระยะไกล รวมถึงช่องทาง, skills, และค่าเริ่มต้นของพื้นที่ทำงานในขั้นตอนแนะนำเดียว 
openclaw onboard
แชตแรกที่เร็วที่สุด: เปิด Control UI (ไม่ต้องตั้งค่าช่องทาง) เรียกใช้ openclaw dashboard แล้วแชตในเบราว์เซอร์ เอกสาร: แดชบอร์ด.
หากต้องการกำหนดค่าใหม่ภายหลัง: 
openclaw configure
openclaw agents add <name>
--json ไม่ได้หมายถึงโหมดไม่โต้ตอบ สำหรับสคริปต์ ให้ใช้ --non-interactive
การเริ่มต้นใช้งานผ่าน CLI มีขั้นตอนค้นหาเว็บที่คุณสามารถเลือกผู้ให้บริการได้ เช่น Brave, DuckDuckGo, Exa, Firecrawl, Gemini, Grok, Kimi, MiniMax Search, Ollama Web Search, Perplexity, SearXNG หรือ Tavily ผู้ให้บริการบางรายต้องใช้ API key ขณะที่บางรายไม่ต้องใช้คีย์ คุณยังสามารถกำหนดค่านี้ภายหลังได้ด้วย openclaw configure --section web เอกสาร: เครื่องมือเว็บ.

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

การเริ่มต้นใช้งานเริ่มด้วย เริ่มต้นด่วน (ค่าเริ่มต้น) เทียบกับ ขั้นสูง (ควบคุมได้ทั้งหมด)
  • Gateway ภายในเครื่อง (local loopback)
  • ค่าเริ่มต้นของพื้นที่ทำงาน (หรือพื้นที่ทำงานที่มีอยู่)
  • พอร์ต Gateway 18789
  • การยืนยันตัวตน Gateway แบบ Token (สร้างอัตโนมัติ แม้บน loopback)
  • ค่าเริ่มต้นของนโยบายเครื่องมือสำหรับการตั้งค่าภายในเครื่องใหม่: tools.profile: "coding" (โปรไฟล์ที่ตั้งไว้อย่างชัดเจนอยู่แล้วจะถูกเก็บไว้)
  • ค่าเริ่มต้นของการแยก DM: การเริ่มต้นใช้งานภายในเครื่องจะเขียน session.dmScope: "per-channel-peer" เมื่อยังไม่ได้ตั้งค่า รายละเอียด: ข้อมูลอ้างอิงการตั้งค่า CLI
  • การเปิดเผยผ่าน Tailscale ปิด
  • DM ของ Telegram + WhatsApp ใช้ค่าเริ่มต้นเป็น allowlist (ระบบจะขอให้คุณกรอกหมายเลขโทรศัพท์)

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

โหมดภายในเครื่อง (ค่าเริ่มต้น) จะแนะนำคุณผ่านขั้นตอนเหล่านี้:
  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 เสริม
การเรียกใช้การเริ่มต้นใช้งานซ้ำจะไม่ลบสิ่งใด เว้นแต่คุณจะเลือก รีเซ็ต อย่างชัดเจน (หรือส่ง --reset) CLI --reset จะรีเซ็ต config, credentials และ sessions ตามค่าเริ่มต้น; ใช้ --reset-scope full เพื่อรวมพื้นที่ทำงานด้วย หาก config ไม่ถูกต้องหรือมีคีย์เดิม การเริ่มต้นใช้งานจะขอให้คุณเรียกใช้ openclaw doctor ก่อน
โหมดระยะไกล จะกำหนดค่าเฉพาะไคลเอนต์ภายในเครื่องให้เชื่อมต่อกับ 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 โปรดดู ข้อมูลอ้างอิงการเริ่มต้นใช้งาน

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