OpenClawDocs
ในหน้านี้

ในหน้านี้

View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Setup guides and reference

การทำงานอัตโนมัติด้วย CLI

ใช้ openclaw onboard --non-interactive เพื่อเขียนสคริปต์การตั้งค่า คำสั่งนี้ต้องใช้ --accept-risk: การตั้งค่าแบบไม่โต้ตอบสามารถเขียนข้อมูลรับรองและการกำหนดค่าดีมอนได้โดยไม่มีข้อความแจ้งให้ยืนยัน ดังนั้นแฟล็กนี้จึงเป็นการยอมรับความเสี่ยงอย่างชัดแจ้ง

ตัวอย่างพื้นฐานสำหรับโหมดไม่โต้ตอบ

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

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

  • --gateway-port มีค่าเริ่มต้นเป็น 18789 ให้ระบุเฉพาะเมื่อต้องการแทนที่ค่าเริ่มต้น
  • --skip-bootstrap จะข้ามการสร้างไฟล์พื้นที่ทำงานเริ่มต้น เหมาะสำหรับระบบอัตโนมัติที่เตรียมพื้นที่ทำงานของตนเองไว้ล่วงหน้า
  • --secret-input-mode ref จะจัดเก็บการอ้างอิงที่ใช้ตัวแปรสภาพแวดล้อม ({ source: "env", provider: "default", id: "<ENV_VAR>" }) ไว้ในโปรไฟล์การยืนยันตัวตนแทนคีย์ข้อความธรรมดา ในโหมด ref แบบไม่โต้ตอบ ต้องตั้งค่าตัวแปรสภาพแวดล้อมของผู้ให้บริการไว้ในสภาพแวดล้อมของโพรเซสแล้ว หากส่งแฟล็กคีย์แบบอินไลน์โดยไม่มีตัวแปรสภาพแวดล้อมที่ตรงกัน ระบบจะล้มเหลวทันที
bash
openclaw onboard --non-interactive --accept-risk \  --mode local \  --auth-choice openai-api-key \  --secret-input-mode ref

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

ตัวอย่างคีย์ API ของ Anthropic
bash
openclaw onboard --non-interactive --accept-risk \  --mode local \  --auth-choice apiKey \  --anthropic-api-key "$ANTHROPIC_API_KEY" \  --gateway-bind loopback
ตัวอย่าง Cloudflare AI Gateway
bash
openclaw onboard --non-interactive --accept-risk \  --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-bind loopback
ตัวอย่าง Gemini
bash
openclaw onboard --non-interactive --accept-risk \  --mode local \  --auth-choice gemini-api-key \  --gemini-api-key "$GEMINI_API_KEY" \  --gateway-bind loopback
ตัวอย่าง Mistral
bash
openclaw onboard --non-interactive --accept-risk \  --mode local \  --auth-choice mistral-api-key \  --mistral-api-key "$MISTRAL_API_KEY" \  --gateway-bind loopback
ตัวอย่าง Moonshot
bash
openclaw onboard --non-interactive --accept-risk \  --mode local \  --auth-choice moonshot-api-key \  --moonshot-api-key "$MOONSHOT_API_KEY" \  --gateway-bind loopback
ตัวอย่าง Ollama
bash
openclaw onboard --non-interactive --accept-risk \  --mode local \  --auth-choice ollama \  --custom-model-id "qwen3.5:27b" \  --gateway-bind loopback
ตัวอย่าง OpenCode
bash
openclaw onboard --non-interactive --accept-risk \  --mode local \  --auth-choice opencode-zen \  --opencode-zen-api-key "$OPENCODE_API_KEY" \  --gateway-bind loopback

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

ตัวอย่าง Synthetic
bash
openclaw onboard --non-interactive --accept-risk \  --mode local \  --auth-choice synthetic-api-key \  --synthetic-api-key "$SYNTHETIC_API_KEY" \  --gateway-bind loopback
ตัวอย่าง Vercel AI Gateway
bash
openclaw onboard --non-interactive --accept-risk \  --mode local \  --auth-choice ai-gateway-api-key \  --ai-gateway-api-key "$AI_GATEWAY_API_KEY" \  --gateway-bind loopback
ตัวอย่าง Z.AI
bash
openclaw onboard --non-interactive --accept-risk \  --mode local \  --auth-choice zai-api-key \  --zai-api-key "$ZAI_API_KEY" \  --gateway-bind loopback
ตัวอย่างผู้ให้บริการแบบกำหนดเอง
bash
openclaw onboard --non-interactive --accept-risk \  --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-bind loopback

--custom-api-key เป็นตัวเลือก ปลายทางบางแห่งไม่ต้องใช้การยืนยันตัวตน หากละไว้ ขั้นตอนเริ่มต้นใช้งานจะตรวจสอบ CUSTOM_API_KEY ในตัวแปรสภาพแวดล้อม --custom-provider-id เป็นตัวเลือก และจะถูกสร้างโดยอัตโนมัติจาก URL ฐานเมื่อละไว้ --custom-compatibility มีค่าเริ่มต้นเป็น openai (ค่าอื่น ๆ ได้แก่ openai-responses, anthropic)

OpenClaw อนุมานการรองรับอินพุตรูปภาพจากรูปแบบรหัสโมเดลวิชันที่รู้จัก (gpt-4o, claude-3/4, gemini, ส่วนต่อท้าย -vl/vision และรูปแบบที่คล้ายกัน) เพิ่ม --custom-image-input เพื่อบังคับเปิดใช้สำหรับโมเดลวิชันที่ระบบไม่รู้จัก หรือใช้ --custom-text-input เพื่อบังคับให้รองรับเฉพาะข้อความ

รูปแบบโหมดอ้างอิง ซึ่งจัดเก็บ apiKey เป็น { source: "env", provider: "default", id: "CUSTOM_API_KEY" }:

bash
export CUSTOM_API_KEY="your-key"openclaw onboard --non-interactive --accept-risk \  --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-bind loopback

ยังคงรองรับการยืนยันตัวตนด้วยโทเค็นการตั้งค่าของ Anthropic แต่ OpenClaw จะเลือกใช้ข้อมูลเข้าสู่ระบบของ Claude CLI ซ้ำเมื่อมีการเข้าสู่ระบบ Claude CLI ภายในเครื่อง สำหรับระบบใช้งานจริง แนะนำให้ใช้คีย์ API ของ Anthropic

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

openclaw agents add <name> จะสร้างเอเจนต์แยกต่างหากที่มีพื้นที่ทำงาน เซสชัน และโปรไฟล์การยืนยันตัวตนของตนเอง การเรียกใช้โดยไม่มี --workspace (และไม่มีแฟล็กอื่น) จะเปิดตัวช่วยแบบโต้ตอบ ส่วนการระบุ --workspace, --model, --agent-dir, --bind หรือ --non-interactive อย่างใดอย่างหนึ่ง จะเรียกใช้แบบไม่โต้ตอบและกำหนดให้ต้องระบุ --workspace

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

คีย์การกำหนดค่าที่คำสั่งนี้เขียน (รายการ agents.list[] สำหรับรหัสเอเจนต์ใหม่):

  • name
  • workspace
  • agentDir
  • model (เฉพาะเมื่อระบุ --model)

หมายเหตุ:

  • พื้นที่ทำงานเริ่มต้น (เมื่อละ --workspace ในตัวช่วยแบบโต้ตอบ): ~/.openclaw/workspace-<agentId>
  • สามารถระบุ --bind <channel[:accountId]> ซ้ำได้ เพิ่มการเชื่อมโยงเพื่อกำหนดเส้นทางข้อความขาเข้าไปยังเอเจนต์ใหม่ (ตัวช่วยสามารถดำเนินการนี้แบบโต้ตอบได้เช่นกัน)
  • ชื่อเอเจนต์จะถูกปรับให้อยู่ในรูปแบบรหัสเอเจนต์ที่ถูกต้อง โดยสงวน main ไว้

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

Was this useful?