openclaw onboard

การเริ่มต้นใช้งานแบบมีคำแนะนำครบถ้วนสำหรับการตั้งค่า Gateway แบบภายในเครื่องหรือระยะไกล ใช้คำสั่งนี้เมื่อคุณต้องการให้ OpenClaw พาไล่ตั้งแต่การยืนยันตัวตนของโมเดล พื้นที่ทำงาน gateway ช่องทาง Skills และสถานะสุขภาพในโฟลว์เดียว

คู่มือที่เกี่ยวข้อง

ตัวอย่าง

openclaw onboardopenclaw onboard --modernopenclaw onboard --flow quickstartopenclaw onboard --flow manualopenclaw onboard --flow importopenclaw onboard --import-from hermes --import-source ~/.hermesopenclaw onboard --skip-bootstrapopenclaw onboard --mode remote --remote-url wss://gateway-host:18789

--flow import ใช้ผู้ให้บริการการย้ายข้อมูลที่ Plugin เป็นเจ้าของ เช่น Hermes โดยจะทำงานกับการตั้งค่า OpenClaw ใหม่เท่านั้น หากมีคอนฟิก ข้อมูลรับรอง เซสชัน หรือไฟล์หน่วยความจำ/ตัวตนของพื้นที่ทำงานอยู่แล้ว ให้รีเซ็ตหรือเลือกการตั้งค่าใหม่ก่อนนำเข้า

--modern เริ่มตัวอย่างการเริ่มต้นใช้งานแบบสนทนาของ Crestodian หากไม่มี --modern คำสั่ง openclaw onboard จะคงใช้โฟลว์การเริ่มต้นใช้งานแบบคลาสสิก

ในการติดตั้งใหม่ที่ไม่มีไฟล์คอนฟิกที่ใช้งานอยู่ หรือไฟล์นั้นไม่มีการตั้งค่าที่ผู้ใช้เขียนไว้ (ว่างหรือมีเฉพาะเมทาดาทา) คำสั่ง openclaw แบบไม่ระบุอาร์กิวเมนต์จะเริ่ม โฟลว์การเริ่มต้นใช้งานแบบคลาสสิกด้วยเช่นกัน เมื่อไฟล์คอนฟิกมีการตั้งค่าที่ผู้ใช้เขียนไว้แล้ว คำสั่ง openclaw แบบไม่ระบุอาร์กิวเมนต์จะเปิด Crestodian แทน

อนุญาตให้ใช้ ws:// แบบข้อความล้วนสำหรับ loopback, IP ส่วนตัวแบบลิเทอรัล, .local และ URL ของ Gateway บน Tailnet *.ts.net สำหรับชื่อ private-DNS ที่เชื่อถือได้อื่นๆ ให้ตั้งค่า OPENCLAW_ALLOW_INSECURE_PRIVATE_WS=1 ในสภาพแวดล้อมของกระบวนการเริ่มต้นใช้งาน

ภาษา

การเริ่มต้นใช้งานแบบโต้ตอบใช้ภาษาของวิซาร์ด CLI สำหรับข้อความตั้งค่าแบบคงที่ ลำดับการเลือกคือ:

1. OPENCLAW_LOCALE
2. LC_ALL
3. LC_MESSAGES
4. LANG
5. ค่า fallback เป็นภาษาอังกฤษ

ภาษาของวิซาร์ดที่รองรับคือ en, zh-CN และ zh-TW ค่าภาษาอาจใช้ รูปแบบขีดล่างหรือส่วนต่อท้ายแบบ POSIX เช่น zh_CN.UTF-8 ชื่อผลิตภัณฑ์ ชื่อคำสั่ง คีย์คอนฟิก URL, ID ผู้ให้บริการ, ID โมเดล และป้ายชื่อ Plugin/ช่องทาง จะยังคงเป็นลิเทอรัล

ตัวอย่าง:

OPENCLAW_LOCALE=zh-CN openclaw onboard

ผู้ให้บริการแบบกำหนดเองที่ไม่โต้ตอบ:

openclaw onboard --non-interactive \  --auth-choice custom-api-key \  --custom-base-url "https://llm.example.com/v1" \  --custom-model-id "foo-large" \  --custom-api-key "$CUSTOM_API_KEY" \  --secret-input-mode plaintext \  --custom-compatibility openai \  --custom-image-input

--custom-api-key เป็นตัวเลือกในโหมดไม่โต้ตอบ หากละไว้ การเริ่มต้นใช้งานจะตรวจสอบ CUSTOM_API_KEY OpenClaw ทำเครื่องหมาย ID โมเดลวิชันที่พบบ่อยว่าใช้งานรูปภาพได้โดยอัตโนมัติ ส่ง --custom-image-input สำหรับ ID วิชันแบบกำหนดเองที่ไม่รู้จัก หรือ --custom-text-input เพื่อบังคับใช้เมทาดาทาแบบข้อความเท่านั้น ใช้ --custom-compatibility openai-responses สำหรับ endpoint ที่เข้ากันได้กับ OpenAI ซึ่งรองรับ /v1/responses แต่ไม่รองรับ /v1/chat/completions

LM Studio รองรับแฟล็กคีย์เฉพาะผู้ให้บริการในโหมดไม่โต้ตอบด้วย:

openclaw onboard --non-interactive \  --auth-choice lmstudio \  --custom-base-url "http://localhost:1234/v1" \  --custom-model-id "qwen/qwen3.5-9b" \  --lmstudio-api-key "$LM_API_TOKEN" \  --accept-risk

Ollama แบบไม่โต้ตอบ:

openclaw onboard --non-interactive \  --auth-choice ollama \  --custom-base-url "http://ollama-host:11434" \  --custom-model-id "qwen3.5:27b" \  --accept-risk

--custom-base-url มีค่าเริ่มต้นเป็น http://127.0.0.1:11434 --custom-model-id เป็นตัวเลือก หากละไว้ การเริ่มต้นใช้งานจะใช้ค่าเริ่มต้นที่ Ollama แนะนำ ID โมเดลคลาวด์ เช่น kimi-k2.5:cloud ก็ใช้งานได้ที่นี่เช่นกัน

เก็บคีย์ผู้ให้บริการเป็น refs แทนข้อความล้วน:

openclaw onboard --non-interactive \  --auth-choice openai-api-key \  --secret-input-mode ref \  --accept-risk

เมื่อใช้ --secret-input-mode ref การเริ่มต้นใช้งานจะเขียน refs ที่อิงกับ env แทนค่าคีย์แบบข้อความล้วน สำหรับผู้ให้บริการที่อิงกับโปรไฟล์ยืนยันตัวตน จะเขียนรายการ keyRef; สำหรับผู้ให้บริการแบบกำหนดเอง จะเขียน models.providers.<id>.apiKey เป็น env ref (เช่น { source: "env", provider: "default", id: "CUSTOM_API_KEY" })

สัญญาของโหมด ref แบบไม่โต้ตอบ:

• ตั้งค่า env var ของผู้ให้บริการในสภาพแวดล้อมของกระบวนการเริ่มต้นใช้งาน (เช่น OPENAI_API_KEY)
• อย่าส่งแฟล็กคีย์แบบ inline (เช่น --openai-api-key) เว้นแต่ว่า env var นั้นถูกตั้งค่าไว้ด้วย
• หากส่งแฟล็กคีย์แบบ inline โดยไม่มี env var ที่จำเป็น การเริ่มต้นใช้งานจะล้มเหลวทันทีพร้อมคำแนะนำ

ตัวเลือกโทเค็น Gateway ในโหมดไม่โต้ตอบ:

• --gateway-auth token --gateway-token <token> เก็บโทเค็นแบบข้อความล้วน
• --gateway-auth token --gateway-token-ref-env <name> เก็บ gateway.auth.token เป็น env SecretRef
• --gateway-token และ --gateway-token-ref-env ใช้ร่วมกันไม่ได้
• --gateway-token-ref-env ต้องมี env var ที่ไม่ว่างในสภาพแวดล้อมของกระบวนการเริ่มต้นใช้งาน
• เมื่อใช้ --install-daemon หากการยืนยันตัวตนด้วยโทเค็นต้องมีโทเค็น โทเค็น Gateway ที่จัดการด้วย SecretRef จะถูกตรวจสอบความถูกต้องแต่จะไม่ถูกเก็บเป็นข้อความล้วนที่ resolve แล้วในเมทาดาทาสภาพแวดล้อมของบริการ supervisor
• เมื่อใช้ --install-daemon หากโหมดโทเค็นต้องมีโทเค็นและ SecretRef ของโทเค็นที่คอนฟิกไว้ไม่สามารถ resolve ได้ การเริ่มต้นใช้งานจะปิดแบบปลอดภัยพร้อมคำแนะนำการแก้ไข
• เมื่อใช้ --install-daemon หากทั้ง gateway.auth.token และ gateway.auth.password ถูกคอนฟิกไว้ และไม่ได้ตั้งค่า gateway.auth.mode การเริ่มต้นใช้งานจะบล็อกการติดตั้งจนกว่าจะตั้งค่าโหมดอย่างชัดเจน
• การเริ่มต้นใช้งานภายในเครื่องเขียน gateway.mode="local" ลงในคอนฟิก หากไฟล์คอนฟิกในภายหลังไม่มี gateway.mode ให้ถือว่าเป็นคอนฟิกเสียหายหรือการแก้ไขด้วยตนเองที่ไม่สมบูรณ์ ไม่ใช่ทางลัดโหมดภายในเครื่องที่ถูกต้อง
• การเริ่มต้นใช้งานภายในเครื่องจะติดตั้ง Plugin ที่ดาวน์โหลดได้ซึ่งเลือกไว้เมื่อเส้นทางการตั้งค่าที่เลือกต้องใช้
• การเริ่มต้นใช้งานระยะไกลจะเขียนเฉพาะข้อมูลการเชื่อมต่อสำหรับ Gateway ระยะไกล และจะไม่ติดตั้งแพ็กเกจ Plugin ภายในเครื่อง
• --allow-unconfigured เป็นช่องทางหลบออกของ runtime gateway ที่แยกต่างหาก ไม่ได้หมายความว่าการเริ่มต้นใช้งานสามารถละ gateway.mode ได้

ตัวอย่าง:

export OPENCLAW_GATEWAY_TOKEN="your-token"openclaw onboard --non-interactive \  --mode local \  --auth-choice skip \  --gateway-auth token \  --gateway-token-ref-env OPENCLAW_GATEWAY_TOKEN \  --accept-risk

สถานะสุขภาพของ Gateway ภายในเครื่องแบบไม่โต้ตอบ:

• เว้นแต่คุณส่ง --skip-health การเริ่มต้นใช้งานจะรอให้ Gateway ภายในเครื่องเข้าถึงได้ก่อนจึงจะออกด้วยความสำเร็จ
• --install-daemon เริ่มเส้นทางการติดตั้ง Gateway ที่มีการจัดการก่อน หากไม่มีแฟล็กนี้ คุณต้องมี Gateway ภายในเครื่องที่ทำงานอยู่แล้ว เช่น openclaw gateway run
• หากคุณต้องการให้ automation เขียนเฉพาะคอนฟิก/พื้นที่ทำงาน/bootstrap ให้ใช้ --skip-health
• หากคุณจัดการไฟล์พื้นที่ทำงานเอง ให้ส่ง --skip-bootstrap เพื่อตั้งค่า agents.defaults.skipBootstrap: true และข้ามการสร้าง AGENTS.md, SOUL.md, TOOLS.md, IDENTITY.md, USER.md, HEARTBEAT.md และ BOOTSTRAP.md
• บน Windows แบบเนทีฟ --install-daemon จะลองใช้ Scheduled Tasks ก่อน และ fallback ไปยังรายการเข้าสู่ระบบในโฟลเดอร์ Startup รายผู้ใช้หากการสร้างงานถูกปฏิเสธ

พฤติกรรมการเริ่มต้นใช้งานแบบโต้ตอบเมื่อใช้โหมดอ้างอิง:

• เลือก ใช้การอ้างอิง secret เมื่อมี prompt
• จากนั้นเลือกอย่างใดอย่างหนึ่ง:
  • ตัวแปรสภาพแวดล้อม
  • ผู้ให้บริการ secret ที่คอนฟิกไว้ (file หรือ exec)
• การเริ่มต้นใช้งานทำการตรวจสอบ preflight อย่างรวดเร็วก่อนบันทึก ref
  • หากการตรวจสอบล้มเหลว การเริ่มต้นใช้งานจะแสดงข้อผิดพลาดและให้คุณลองใหม่

ตัวเลือก endpoint ของ Z.AI แบบไม่โต้ตอบ

# Promptless endpoint selectionopenclaw onboard --non-interactive \  --auth-choice zai-coding-global \  --zai-api-key "$ZAI_API_KEY" # Other Z.AI endpoint choices:# --auth-choice zai-coding-cn# --auth-choice zai-global# --auth-choice zai-cn

ตัวอย่าง Mistral แบบไม่โต้ตอบ:

openclaw onboard --non-interactive \  --auth-choice mistral-api-key \  --mistral-api-key "$MISTRAL_API_KEY"

หมายเหตุเกี่ยวกับโฟลว์

คำสั่งติดตามผลที่พบบ่อย

openclaw channels addopenclaw configureopenclaw agents add <name>

ใช้ openclaw setup แทนเมื่อคุณต้องการเพียงคอนฟิก/พื้นที่ทำงานพื้นฐาน ใช้ openclaw configure ภายหลังสำหรับการเปลี่ยนแปลงเฉพาะจุด และ openclaw channels add สำหรับการตั้งค่าเฉพาะช่องทาง