Guides

การทำงานอัตโนมัติของ CLI

ใช้ --non-interactive เพื่อทำให้ openclaw onboard ทำงานอัตโนมัติ

ตัวอย่างพื้นฐานแบบไม่โต้ตอบ

openclaw onboard --non-interactive \
  --mode local \
  --auth-choice apiKey \
  --anthropic-api-key "$ANTHROPIC_API_KEY" \
  --secret-input-mode plaintext \
  --gateway-port 18789 \
  --gateway-bind loopback \
  --install-daemon \
  --daemon-runtime node \
  --skip-bootstrap \
  --skip-skills

เพิ่ม --json เพื่อรับสรุปที่เครื่องอ่านได้

ใช้ --skip-bootstrap เมื่อระบบอัตโนมัติของคุณเตรียมไฟล์พื้นที่ทำงานไว้ล่วงหน้า และไม่ต้องการให้ onboarding สร้างไฟล์ bootstrap เริ่มต้น

ใช้ --secret-input-mode ref เพื่อจัดเก็บการอ้างอิงที่รองรับด้วย env ในโปรไฟล์การรับรองความถูกต้องแทนค่าข้อความธรรมดา การเลือกแบบโต้ตอบระหว่างการอ้างอิง env และการอ้างอิงผู้ให้บริการที่กำหนดค่าไว้ (file หรือ exec) มีให้ใช้ในโฟลว์ onboarding

ในโหมด ref แบบไม่โต้ตอบ ต้องตั้งค่าตัวแปร env ของผู้ให้บริการในสภาพแวดล้อมของกระบวนการ การส่งแฟล็กคีย์แบบอินไลน์โดยไม่มีตัวแปร env ที่ตรงกันจะล้มเหลวทันที

ตัวอย่าง:

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

ตัวอย่างเฉพาะผู้ให้บริการ

ตัวอย่างคีย์ Anthropic API
openclaw onboard --non-interactive \
  --mode local \
  --auth-choice apiKey \
  --anthropic-api-key "$ANTHROPIC_API_KEY" \
  --gateway-port 18789 \
  --gateway-bind loopback
ตัวอย่าง Gemini
openclaw onboard --non-interactive \
  --mode local \
  --auth-choice gemini-api-key \
  --gemini-api-key "$GEMINI_API_KEY" \
  --gateway-port 18789 \
  --gateway-bind loopback
ตัวอย่าง Z.AI
openclaw onboard --non-interactive \
  --mode local \
  --auth-choice zai-api-key \
  --zai-api-key "$ZAI_API_KEY" \
  --gateway-port 18789 \
  --gateway-bind loopback
ตัวอย่าง Vercel AI Gateway
openclaw onboard --non-interactive \
  --mode local \
  --auth-choice ai-gateway-api-key \
  --ai-gateway-api-key "$AI_GATEWAY_API_KEY" \
  --gateway-port 18789 \
  --gateway-bind loopback
ตัวอย่าง Cloudflare AI Gateway
openclaw onboard --non-interactive \
  --mode local \
  --auth-choice cloudflare-ai-gateway-api-key \
  --cloudflare-ai-gateway-account-id "your-account-id" \
  --cloudflare-ai-gateway-gateway-id "your-gateway-id" \
  --cloudflare-ai-gateway-api-key "$CLOUDFLARE_AI_GATEWAY_API_KEY" \
  --gateway-port 18789 \
  --gateway-bind loopback
ตัวอย่าง Moonshot
openclaw onboard --non-interactive \
  --mode local \
  --auth-choice moonshot-api-key \
  --moonshot-api-key "$MOONSHOT_API_KEY" \
  --gateway-port 18789 \
  --gateway-bind loopback
ตัวอย่าง Mistral
openclaw onboard --non-interactive \
  --mode local \
  --auth-choice mistral-api-key \
  --mistral-api-key "$MISTRAL_API_KEY" \
  --gateway-port 18789 \
  --gateway-bind loopback
ตัวอย่าง Synthetic
openclaw onboard --non-interactive \
  --mode local \
  --auth-choice synthetic-api-key \
  --synthetic-api-key "$SYNTHETIC_API_KEY" \
  --gateway-port 18789 \
  --gateway-bind loopback
ตัวอย่าง OpenCode
openclaw onboard --non-interactive \
  --mode local \
  --auth-choice opencode-zen \
  --opencode-zen-api-key "$OPENCODE_API_KEY" \
  --gateway-port 18789 \
  --gateway-bind loopback

เปลี่ยนเป็น --auth-choice opencode-go --opencode-go-api-key "$OPENCODE_API_KEY" สำหรับแค็ตตาล็อก Go

ตัวอย่าง Ollama
openclaw onboard --non-interactive \
  --mode local \
  --auth-choice ollama \
  --custom-model-id "qwen3.5:27b" \
  --accept-risk \
  --gateway-port 18789 \
  --gateway-bind loopback
ตัวอย่างผู้ให้บริการแบบกำหนดเอง
openclaw onboard --non-interactive \
  --mode local \
  --auth-choice custom-api-key \
  --custom-base-url "https://llm.example.com/v1" \
  --custom-model-id "foo-large" \
  --custom-api-key "$CUSTOM_API_KEY" \
  --custom-provider-id "my-custom" \
  --custom-compatibility anthropic \
  --custom-image-input \
  --gateway-port 18789 \
  --gateway-bind loopback

--custom-api-key เป็นตัวเลือก หากละไว้ onboarding จะตรวจสอบ CUSTOM_API_KEY OpenClaw ทำเครื่องหมาย ID โมเดล vision ทั่วไปว่าใช้งานรูปภาพได้โดยอัตโนมัติ เพิ่ม --custom-image-input สำหรับ ID vision แบบกำหนดเองที่ไม่รู้จัก หรือ --custom-text-input เพื่อบังคับ metadata แบบข้อความเท่านั้น

ตัวแปรโหมด ref:

export CUSTOM_API_KEY="your-key"
openclaw onboard --non-interactive \
  --mode local \
  --auth-choice custom-api-key \
  --custom-base-url "https://llm.example.com/v1" \
  --custom-model-id "foo-large" \
  --secret-input-mode ref \
  --custom-provider-id "my-custom" \
  --custom-compatibility anthropic \
  --custom-image-input \
  --gateway-port 18789 \
  --gateway-bind loopback

ในโหมดนี้ onboarding จะจัดเก็บ apiKey เป็น { source: "env", provider: "default", id: "CUSTOM_API_KEY" }

setup-token ของ Anthropic ยังคงมีให้ใช้เป็นเส้นทางโทเค็น onboarding ที่รองรับ แต่ตอนนี้ OpenClaw ต้องการนำ Claude CLI กลับมาใช้เมื่อพร้อมใช้งาน สำหรับการใช้งานจริง ให้ใช้คีย์ Anthropic API เป็นหลัก

เพิ่มเอเจนต์อีกตัว

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

openclaw agents add work \
  --workspace ~/.openclaw/workspace-work \
  --model openai/gpt-5.5 \
  --bind whatsapp:biz \
  --non-interactive \
  --json

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

  • agents.list[].name
  • agents.list[].workspace
  • agents.list[].agentDir

หมายเหตุ:

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

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