การติดตั้ง OpenClaw และการกำหนดค่า OmniProxy

OpenClaw คือผู้ช่วย AI ที่ติดตั้งอยู่บนคอมพิวเตอร์ของคุณเอง คุณสามารถคุยกับมันได้โดยตรงผ่าน Telegram, Discord, WhatsApp หรือ Feishu โดยไม่ต้องเปิดหน้าต่างแชตอื่นไว้ตลอดเวลา บทสนทนาและบันทึกจะเก็บอยู่ในคอมพิวเตอร์เครื่องนี้ และมันยังสามารถทำขั้นตอนถัดไปต่อภายในเครื่องได้

การเตรียมตัวก่อนติดตั้ง

OpenClaw ต้องใช้ Node 24.16 ขึ้นไป หรือใช้ Node 26.1 ขึ้นไปก็ได้ โดยแนะนำให้ใช้ Node 26 ทั้งนี้ Node เป็นสภาพแวดล้อมพื้นฐานที่ OpenClaw ต้องใช้ในการทำงาน

สามารถติดตั้งได้บน macOS, Linux และ Windows หากคอมพิวเตอร์ไม่มี Node เวอร์ชันที่เหมาะสม สคริปต์ติดตั้งจะจัดเตรียมให้เอง โดยจะเตรียม Node 26 บน macOS และ Node 24 LTS บน Linux ต้องใช้ pnpm เฉพาะเมื่อสร้าง OpenClaw จากซอร์สโค้ดเท่านั้น

หากมี Node เวอร์ชันเก่าติดตั้งอยู่แล้ว ก็ยังไม่จำเป็นต้องรีบถอนการติดตั้ง ในการทดสอบเมื่อ 2026-10-09 คอมพิวเตอร์เครื่องนี้มี Node ของระบบเป็นเวอร์ชัน 24.2.0 ซึ่งต่ำกว่าข้อกำหนด 24.16 แต่สคริปต์ติดตั้งแบบไม่โต้ตอบได้จัดเตรียม Node 24.21.0 ให้เอง

ต้องการหน้าต่าง

ตัวช่วยเดสก์ท็อป

• ใช้แพ็กเกจติดตั้ง Hub บน Windows
• ใช้ DMG จาก GitHub บน macOS
• ติดตั้ง Gateway ภายในเครื่องได้เมื่อใช้ครั้งแรก

แนะนำอย่างเป็นทางการ

สคริปต์ติดตั้ง

• macOS Linux WSL2
• บน Windows ใช้ PowerShell
• เพิ่ม --no-onboard ได้

มี Node แล้ว

ตัวจัดการแพ็กเกจ

• npm, pnpm หรือ bun
• จากนั้นรัน onboard
• ดูเวอร์ชัน Node ในหน้าการติดตั้ง

ติดตั้งและเปิดใช้งานครั้งแรก

คุณสามารถติดตั้งโปรแกรมเดสก์ท็อปคู่หูที่มีหน้าต่าง หรือจะติดตั้งผ่านเทอร์มินัลโดยตรงก็ได้ Gateway คือบริการภายในเครื่องที่ทำหน้าที่รับข้อความ เรียกใช้โมเดล และส่งผลลัพธ์กลับมา โดยสามารถตั้งค่าไปพร้อมกันเมื่อเปิดโปรแกรมเดสก์ท็อปคู่หูเป็นครั้งแรก

หากต้องการหน้าต่าง

• Windows: ดาวน์โหลดและเรียกใช้ OpenClawCompanion-Setup-x64.exe หรือ OpenClawCompanion-Setup-arm64.exe แพ็กเกจติดตั้งมีลายเซ็น และประกอบด้วยการตั้งค่า สถานะในถาดระบบ แชต และโหมด node
• macOS: ดาวน์โหลดไฟล์ .dmg ของ OpenClaw จาก GitHub releases ของ OpenClaw ควรใช้ dmg เป็นตัวเลือกแรก หรือใช้ .zip ก็ได้ หลังติดตั้งแล้วให้เปิด OpenClaw.app หากเวอร์ชันนี้ไม่มีไฟล์สำหรับ macOS ให้ดำเนินการตามหน้าแอป macOS

เมื่อเปิดใช้งานครั้งแรก คุณสามารถให้ OpenClaw จัดเตรียม Gateway บนคอมพิวเตอร์เครื่องนี้ หรือเชื่อมต่อกับ Gateway ระยะไกลที่มีอยู่แล้วก็ได้

ติดตั้งด้วยเทอร์มินัล

สำหรับ macOS, Linux และ WSL2 ให้ใช้:

curl -fsSL https://openclaw.ai/install.sh | bash

สำหรับ Windows PowerShell ให้ใช้:

iwr -useb https://openclaw.ai/install.ps1 | iex

สคริปต์จะตรวจหาระบบปัจจุบัน ติดตั้ง Node เมื่อจำเป็น จากนั้นติดตั้ง OpenClaw และเข้าสู่ขั้นตอนตั้งค่าเริ่มต้น ซึ่งจะแนะนำคุณตลอดการตั้งค่าครั้งแรก

หากยังไม่ต้องการเข้าสู่ขั้นตอนตั้งค่า สำหรับ macOS, Linux และ WSL2 ให้เปลี่ยนไปใช้:

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard

สำหรับ Windows ให้ใช้ -NoOnboard อย่างเป็นทางการ:

& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard

หากคุณจัดการ Node ด้วยตนเองอยู่แล้ว ก็สามารถใช้ npm, pnpm หรือ bun ได้ สำหรับ npm 12 รวมถึง npm 11.16 ขึ้นไป ให้เรียกใช้:

npm install -g openclaw@latest --allow-scripts=openclaw
openclaw onboard --install-daemon

สำหรับ npm 11.15 และเวอร์ชันก่อนหน้า ต้องนำ --allow-scripts=openclaw ออก หากใช้ pnpm ต้องเพิ่ม --allow-build=openclaw โปรดดูความแตกต่างโดยละเอียดจากหน้าการติดตั้ง

หลังติดตั้งเสร็จ ให้เรียกใช้คำสั่งสามรายการต่อไปนี้ตามลำดับ:

openclaw --version
openclaw doctor
openclaw gateway status

openclaw --version ใช้ดูเวอร์ชัน openclaw doctor ใช้ตรวจสอบปัญหาทั่วไปของสภาพแวดล้อม และ openclaw gateway status ใช้ดูว่า Gateway กำลังทำงานอยู่หรือไม่ การติดตั้งพื้นฐานจะถือว่าเสร็จสมบูรณ์ต่อเมื่อทั้งสามคำสั่งแสดงผลลัพธ์ตามปกติ

หากเทอร์มินัลแจ้งว่าไม่พบ openclaw โดยทั่วไปหมายความว่ายังไม่ได้เพิ่มไดเรกทอรี bin ส่วนกลางของ npm ลงใน PATH โดย PATH คือรายการตำแหน่งที่เทอร์มินัลใช้ค้นหาโปรแกรม คุณสามารถใช้ node -v, npm prefix -g และ echo "$PATH" เพื่อตรวจสอบเปรียบเทียบ จากนั้นเพิ่มไดเรกทอรี bin ที่เกี่ยวข้องลงใน PATH แล้วเปิดเทอร์มินัลใหม่

หากมีการกำหนดค่าที่ใช้งานอยู่แล้วใน ~/.openclaw สคริปต์ติดตั้งเริ่มต้นจะใช้ไดเรกทอรีนี้ หากต้องการติดตั้งอีกชุดแยกต่างหากเพื่อหลีกเลี่ยงการแก้ไขการกำหนดค่าเดิม ให้เรียกใช้สคริปต์แบบไม่โต้ตอบและระบุไดเรกทอรีใหม่:

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash -s -- --prefix "$HOME/openclaw-omniproxy" --no-onboard

--no-onboard เป็นพฤติกรรมเริ่มต้นของสคริปต์นี้ เมื่อ 2026-10-09 คำสั่งนี้ติดตั้ง OpenClaw 2026.9.9 หลังติดตั้งเสร็จ ต้องเรียกใช้ openclaw ที่อยู่ใน bin ของไดเรกทอรีดังกล่าว

รับค่าการเชื่อมต่อจาก OmniProxy

ก่อนอื่นให้ตรวจสอบว่า OmniProxy กำลังทำงานอยู่ จากนั้นเปิดรายการโมเดลและเตรียมข้อมูลสามรายการต่อไปนี้:

baseUrl: https://your-omniproxy-origin.example/v1
apiKey:  <YOUR_OMNIPROXY_API_KEY>
Model ID: คัดลอก ID แบบเต็มจากรายการโมเดลปัจจุบันของ OmniProxy

baseUrl คือที่อยู่ที่ OpenClaw ใช้ส่งคำขอไปยังโมเดล และต้องลงท้ายด้วย /v1 เมื่อเชื่อมต่อ OmniProxy ให้ตั้งค่า api เป็น openai-completions เปลี่ยนเป็น openai-responses เฉพาะเมื่อโมเดลนี้ทำงานผ่าน /v1/responses ได้จริงเท่านั้น

Model ID คือตัวระบุแบบเต็มของโมเดลในรายการ โปรดคัดลอกตามที่แสดงในรายการทุกประการ หากมีเครื่องหมายทับก็ต้องเก็บไว้ด้วย ชื่อสองรายการต่อไปนี้เป็นเพียงข้อมูลสำหรับเปรียบเทียบจากเอกสารของผู้ให้บริการ ณ วันที่ 2026-10-09 หากไม่มีในรายการก็อย่าใช้: claude-sonnet-5-5, gpt-6-luna

แม้ Gateway จะไม่ตรวจสอบคีย์ ก็ยังต้องกรอกค่าใน apiKey โดยสามารถใช้ชุดอักขระตัวแทนที่ใช้เฉพาะบนคอมพิวเตอร์เครื่องนี้ได้ อย่านำคีย์จริงส่งเข้า repository

กรอกการกำหนดค่าของเครื่องมือ

Provider สามารถเข้าใจได้ว่าเป็นชุดการตั้งค่าการเชื่อมต่อที่ OpenClaw ใช้ค้นหาบริการโมเดล ในที่นี้จะตั้งชื่อ Provider ว่า omniproxy

เรียกใช้คำสั่งต่อไปนี้ในเทอร์มินัล แล้วแทนที่ที่อยู่ คีย์ และ Model ID สองรายการด้วยข้อมูลของคุณเอง:

openclaw config set models.providers.omniproxy '{"baseUrl":"https://your-omniproxy-origin.example/v1","apiKey":"<YOUR_OMNIPROXY_API_KEY>","api":"openai-completions","models":[{"id":"claude-sonnet-5-5","name":"Claude Sonnet 5.5"},{"id":"gpt-6-luna","name":"GPT-6 Luna"}]}' --strict-json --merge

คำสั่งนี้จะเขียน Provider และรายการโมเดลลงในการกำหนดค่า หลังคำสั่งทำงานสำเร็จ ไม่จำเป็นต้องรีสตาร์ต Gateway

จากนั้นระบุโมเดลเริ่มต้น การอ้างอิงโมเดลประกอบด้วย omniproxy/ และ Model ID โดยต้องเก็บเครื่องหมายทับทั้งหมดที่มีอยู่เดิมใน ID ไว้ หาก ID ในรายการโมเดลยาวกว่าชื่อแบบสั้นด้านล่าง ให้ใช้ข้อมูลแบบเต็มจากรายการ:

openclaw config set agents.defaults.model.primary '"omniproxy/claude-sonnet-5-5"' --strict-json

ไม่จำเป็นต้องระบุ reasoning, input, cost, contextWindow และ maxTokens หากไม่ได้กรอก โมเดลข้อความจะทำงานตามค่าเริ่มต้น

สามารถเขียนการตั้งค่าชุดเดียวกันลงในไฟล์กำหนดค่าโดยตรงได้เช่นกัน Provider ในการกำหนดค่าหลักอยู่ที่ models.providers แต่ละ agent ยังสามารถมี models.json ของตนเองได้ โดย agent คืออินสแตนซ์ผู้ช่วยที่รับงานและเรียกใช้โมเดลจริง ตำแหน่งไฟล์คือ agent/models.json ภายในไดเรกทอรีของ agent ที่เกี่ยวข้องใต้ ~/.openclaw/agents/

หาก models.json นี้มีการระบุ baseUrl ที่ไม่ว่าง ค่าดังกล่าวจะแทนที่ที่อยู่ในการกำหนดค่าหลัก

ตรวจสอบการติดตั้ง

สามคำสั่ง

• openclaw --version
• openclaw doctor
• gateway status

การตั้งค่า

models.providers

• baseUrl ลงท้ายด้วย /v1
• ใช้ completions สำหรับ api
• โมเดลต้องระบุ id อย่างน้อย

เลือกใช้

provider/โมเดล

• ใช้การอ้างอิงนี้กับ primary
• ควรใช้ตัวแปรสภาพแวดล้อมสำหรับคีย์
• ใช้รายการตามเกตเวย์

ตรวจสอบด้วยงานจริง

เข้าไปยังไดเรกทอรีโปรเจกต์ทั่วไป แล้วส่งข้อความสั้น ๆ หนึ่งข้อความ เปลี่ยนการอ้างอิงโมเดลในคำสั่งเป็น Model ID แบบเต็มของคุณ:

openclaw agent --local --model omniproxy/claude-sonnet-5-5 --timeout 300 --message "ตอบด้วยคำเดียว"

--local หมายถึงเรียกใช้งาน agent ครั้งนี้ภายในเครื่อง --model ระบุโมเดลที่ใช้ในครั้งนี้ และ --timeout 300 หมายถึงรอสูงสุด 300 วินาที

ต้องมีคำตอบจากโมเดลปรากฏขึ้นจริงในเทอร์มินัล เมื่อ 2026-10-09 OpenClaw 2026.9.9 ได้รับคำตอบด้วยคำสั่งนี้ การเรียกใช้ครั้งแรกอาจใช้เวลาหนึ่งถึงสองนาที

หากพบข้อผิดพลาดตามข้อความต้นฉบับ Request timed out before a response was generated ให้เพิ่มค่า --timeout แล้วส่งอีกครั้ง โดยทั่วไปหมายความว่าเวลารอไม่เพียงพอ ไม่ได้แปลว่าที่อยู่ผิดเสมอไป

หลังจากได้รับคำตอบสั้น ๆ สำเร็จแล้ว ให้สั่งให้อ่านไฟล์ภายในเครื่องที่คุณระบุ จากนั้นเปิดบันทึกการเรียกใช้ของ OmniProxy เพื่อตรวจสอบแหล่งที่มาและ Model ID ในบันทึก การมีเพียงผลลัพธ์หมายเลขเวอร์ชันหรือผลจาก doctor ยังไม่เพียงพอที่จะยืนยันว่าการเชื่อมต่อโมเดลได้รับการกำหนดค่าเรียบร้อยแล้ว

การติดตั้ง

คำสั่งตอบสนอง

• แสดงหมายเลขเวอร์ชันได้
• doctor ไม่มีข้อผิดพลาดที่ทำให้ดำเนินการต่อไม่ได้
• อ่านสถานะ Gateway ได้

งาน

มันทำงานเล็ก ๆ หนึ่งอย่างแล้ว

• เช่น อ่านไฟล์ภายในเครื่องหนึ่งไฟล์
• คำตอบไม่ใช่ข้อผิดพลาด
• เขียนการอ้างอิงโมเดลถูกต้อง

บันทึก

มองเห็นได้ในเกตเวย์

• แหล่งที่มาคือ OpenClaw
• ID โมเดลตรงกัน
• คีย์ไม่อยู่ในรีโพซิทอรี

ข้อผิดพลาดที่พบบ่อย

• ไม่พบ openclaw: เพิ่ม bin ส่วนกลางของ npm ลงใน PATH แล้วเปิดเทอร์มินัลใหม่ หากติดตั้งลงในไดเรกทอรีที่ระบุ ให้เรียกใช้โปรแกรมใน bin ของไดเรกทอรีนั้น
• node -v ต่ำกว่า 24.16: ไม่จำเป็นต้องถอนการติดตั้งเวอร์ชันเก่าก่อน ตรวจสอบ Node ที่สคริปต์ติดตั้งจัดเตรียมไว้ หรือใช้ 24.16+ หรือ 26.1+ ตามหน้าการติดตั้ง แนะนำให้ใช้ Node 26
• โมเดลไม่ปรากฏ: ต้องเขียนโมเดลไว้ในอาร์เรย์ models ของ models.providers และอย่างน้อยต้องมี id ที่ตรงกัน การเขียนเฉพาะ agents.defaults.models จะไม่ลงทะเบียนโมเดลใหม่แยกต่างหาก
• ได้รับ 400 และมีการกล่าวถึงบทบาท developer: เมื่อโฮสต์ของที่อยู่ไม่ใช่ api.openai.com ให้คงค่าเริ่มต้นไว้ และอย่าตั้ง supportsDeveloperRole เป็น true แม้ตั้งเป็น true ก็ยังถูกแทนที่
• หมดเวลาอย่างรวดเร็ว: เพิ่ม --timeout เป็น 300 วินาทีขึ้นไป และยังไม่ต้องเปลี่ยนที่อยู่
• เลือก gpt-6-luna แต่การเรียกใช้เครื่องมือล้มเหลว: โมเดลนี้รองรับ Chat Completions ส่วนการเรียกใช้ฟังก์ชันใน Chat Completions จะรองรับเฉพาะเมื่อ reasoning_effort เป็น none หาก ID ในรายการแตกต่างจากนี้ ให้ยึด ID ในรายการเป็นหลัก
• เชื่อมต่อที่อยู่ไม่ได้: ตรวจสอบว่า OmniProxy กำลังทำงานอยู่ baseUrl ลงท้ายด้วย /v1 และที่อยู่ที่เขียนลงในการกำหนดค่าสามารถเข้าถึงได้ ที่อยู่เครือข่ายส่วนตัวอื่น ๆ ต้องได้รับอนุญาตแยกต่างหาก
• กำหนดค่าแล้วแต่ยังเชื่อมต่อไปยังที่อยู่อื่น: ตรวจสอบว่า models.json ของ agent ดังกล่าวระบุ baseUrl อื่นไว้หรือไม่

เอกสารอ้างอิงอย่างเป็นทางการ

ดูขั้นตอนการติดตั้งได้ที่ OpenClaw install ดูวิธีกำหนดค่า Provider แบบกำหนดเองได้ที่ Custom providers และ ฟิลด์การกำหนดค่า ส่วน Model ID ที่ใช้ในตัวอย่างสามารถตรวจสอบเทียบกับ ภาพรวมโมเดล Claude และ GPT-6 Luna

แทนที่ตัววางตำแหน่งทั้งหมดด้วยค่าจากการกำหนดค่า OmniProxy ของคุณ ห้ามเผยแพร่คีย์จริง

ผลลัพธ์ที่บันทึกหรือ HTTP 200 เพียงอย่างเดียวไม่พิสูจน์ความเข้ากันได้เต็มรูปแบบของเอเจนต์ ตรวจสอบแหล่งที่มาและโมเดลในบันทึกการเรียกใช้ของ OmniProxy

แหล่งทางการ · OpenClaw ↗