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)

​
สรุปสั้น ๆ

เลือกเวิร์กโฟลว์การตั้งค่าตามความถี่ที่คุณต้องการอัปเดต และว่าคุณต้องการรัน Gateway ด้วยตัวเองหรือไม่:
  • การปรับแต่งอยู่นอกรีโพ: เก็บการกำหนดค่าและพื้นที่ทำงานของคุณไว้ใน ~/.openclaw/openclaw.json และ ~/.openclaw/workspace/ เพื่อให้การอัปเดตรีโพไม่ไปแตะต้องสิ่งเหล่านั้น
  • เวิร์กโฟลว์เสถียร (แนะนำสำหรับคนส่วนใหญ่): ติดตั้งแอป macOS และปล่อยให้แอปรัน Gateway ที่รวมมาให้
  • เวิร์กโฟลว์ล้ำหน้า (สำหรับนักพัฒนา): รัน Gateway ด้วยตัวเองผ่าน pnpm gateway:watch จากนั้นให้แอป macOS เชื่อมต่อในโหมด Local

​
ข้อกำหนดเบื้องต้น (จากซอร์ส)

  • แนะนำ Node 24 (ยังรองรับ Node 22 LTS ซึ่งปัจจุบันคือ 22.16+)
  • จำเป็นต้องใช้ pnpm สำหรับซอร์สเช็กเอาต์ OpenClaw โหลด plugins ที่รวมมาให้จากแพ็กเกจ pnpm workspace extensions/* ในโหมดพัฒนา ดังนั้นการรัน npm install ที่รูตจึง ไม่ได้เตรียมซอร์สทรีทั้งหมด
  • Docker (ไม่บังคับ; ใช้เฉพาะสำหรับการตั้งค่า/e2e แบบคอนเทนเนอร์ - ดู Docker)

​
กลยุทธ์การปรับแต่ง (เพื่อให้อัปเดตแล้วไม่กระทบ)

หากคุณต้องการให้ “ปรับให้เข้ากับฉัน 100%” และ อัปเดตได้ง่าย ให้เก็บการปรับแต่งไว้ใน:
  • การกำหนดค่า: ~/.openclaw/openclaw.json (คล้าย JSON/JSON5)
  • พื้นที่ทำงาน: ~/.openclaw/workspace (skills, prompts, memories; ทำให้เป็นรีโพ git ส่วนตัว)
บูตสแตรปหนึ่งครั้ง: 
openclaw setup
จากภายในรีโพนี้ ให้ใช้ทางเข้า CLI แบบโลคัล: 
openclaw setup
หากคุณยังไม่มีการติดตั้งแบบโกลบอล ให้รันผ่าน pnpm openclaw setup

​
รัน Gateway จากรีโพนี้

หลังจาก pnpm build คุณสามารถรัน CLI ที่แพ็กเกจแล้วได้โดยตรง: 
node openclaw.mjs gateway --port 18789 --verbose

​
เวิร์กโฟลว์เสถียร (เริ่มจากแอป macOS)

  1. ติดตั้ง + เปิด OpenClaw.app (แถบเมนู)
  2. ทำเช็กลิสต์การเริ่มต้นใช้งาน/สิทธิ์ให้ครบ (พรอมป์ TCC)
  3. ตรวจสอบให้ Gateway เป็น Local และกำลังทำงานอยู่ (แอปจะจัดการให้)
  4. เชื่อมโยงพื้นผิวการใช้งาน (ตัวอย่าง: WhatsApp):
openclaw channels login
  1. ตรวจสอบความสมบูรณ์เบื้องต้น:
openclaw health
หากบิลด์ของคุณไม่มีการเริ่มต้นใช้งาน:
  • รัน openclaw setup จากนั้น openclaw channels login แล้วจึงเริ่ม Gateway ด้วยตนเอง (openclaw gateway)

​
เวิร์กโฟลว์ล้ำหน้า (Gateway ในเทอร์มินัล)

เป้าหมาย: ทำงานกับ TypeScript Gateway, ได้ hot reload, และให้ UI ของแอป macOS เชื่อมต่ออยู่

​
0) (ไม่บังคับ) รันแอป macOS จากซอร์สด้วย

หากคุณต้องการให้แอป macOS อยู่บนรุ่นล้ำหน้าด้วย: 
./scripts/restart-mac.sh

​
1) เริ่ม Gateway สำหรับพัฒนา

pnpm install
# First run only (or after resetting local OpenClaw config/workspace)
pnpm openclaw setup
pnpm gateway:watch
gateway:watch เริ่มหรือรีสตาร์ตกระบวนการเฝ้าดู Gateway ในเซสชัน tmux ที่มีชื่อ และแนบอัตโนมัติจากเทอร์มินัลแบบโต้ตอบ เชลล์ที่ไม่โต้ตอบจะยังคง แยกอยู่และพิมพ์ tmux attach -t openclaw-gateway-watch-main; ใช้ OPENCLAW_GATEWAY_WATCH_ATTACH=0 pnpm gateway:watch เพื่อให้การรันแบบโต้ตอบ ยังคงแยกอยู่ หรือใช้ pnpm gateway:watch:raw สำหรับโหมดเฝ้าดูใน foreground ตัวเฝ้าดู จะโหลดซ้ำเมื่อมีการเปลี่ยนแปลงซอร์ส การกำหนดค่า และเมทาดาทาของ bundled-plugin ที่เกี่ยวข้อง หาก Gateway ที่ถูกเฝ้าดูออกระหว่างเริ่มต้น gateway:watch จะรัน openclaw doctor --fix --non-interactive หนึ่งครั้งแล้วลองใหม่; ตั้งค่า OPENCLAW_GATEWAY_WATCH_AUTO_DOCTOR=0 เพื่อปิดพาสซ่อมแซมสำหรับงานพัฒนาเท่านั้นนี้ pnpm openclaw setup คือขั้นตอนเริ่มต้นการกำหนดค่า/พื้นที่ทำงานแบบโลคัลครั้งเดียวสำหรับเช็กเอาต์ใหม่ pnpm gateway:watch ไม่ได้สร้าง dist/control-ui ใหม่ ดังนั้นให้รัน pnpm ui:build อีกครั้งหลังเปลี่ยนแปลง ui/ หรือใช้ pnpm ui:dev ขณะพัฒนา Control UI

​
2) ชี้แอป macOS ไปยัง Gateway ที่กำลังรันอยู่

ใน OpenClaw.app:
  • โหมดการเชื่อมต่อ: Local แอปจะเชื่อมต่อกับ gateway ที่กำลังรันอยู่บนพอร์ตที่กำหนดค่าไว้

​
3) ตรวจสอบ

  • สถานะ Gateway ในแอปควรแสดงว่า “ใช้ gateway ที่มีอยู่ …”
  • หรือผ่าน CLI:
openclaw health

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

  • พอร์ตผิด: ค่าเริ่มต้นของ Gateway WS คือ ws://127.0.0.1:18789; ให้แอป + CLI ใช้พอร์ตเดียวกัน
  • ตำแหน่งที่เก็บสถานะ:
    • สถานะช่องทาง/ผู้ให้บริการ: ~/.openclaw/credentials/
    • โปรไฟล์ยืนยันตัวตนของโมเดล: ~/.openclaw/agents/<agentId>/agent/auth-profiles.json
    • เซสชัน: ~/.openclaw/agents/<agentId>/sessions/
    • ล็อก: /tmp/openclaw/

​
แผนผังการจัดเก็บข้อมูลรับรอง

ใช้ส่วนนี้เมื่อดีบักการยืนยันตัวตนหรือเมื่อตัดสินใจว่าจะสำรองข้อมูลใด:
  • WhatsApp: ~/.openclaw/credentials/whatsapp/<accountId>/creds.json
  • โทเคนบอต Telegram: config/env หรือ channels.telegram.tokenFile (ไฟล์ปกติเท่านั้น; ไม่รับ symlinks)
  • โทเคนบอต Discord: config/env หรือ SecretRef (ผู้ให้บริการ env/file/exec)
  • โทเคน Slack: config/env (channels.slack.*)
  • allowlists สำหรับการจับคู่:
    • ~/.openclaw/credentials/<channel>-allowFrom.json (บัญชีเริ่มต้น)
    • ~/.openclaw/credentials/<channel>-<accountId>-allowFrom.json (บัญชีที่ไม่ใช่ค่าเริ่มต้น)
  • โปรไฟล์ยืนยันตัวตนของโมเดล: ~/.openclaw/agents/<agentId>/agent/auth-profiles.json
  • payload ความลับที่อิงไฟล์ (ไม่บังคับ): ~/.openclaw/secrets.json
  • การนำเข้า OAuth รุ่นเก่า: ~/.openclaw/credentials/oauth.json รายละเอียดเพิ่มเติม: ความปลอดภัย

​
การอัปเดต (โดยไม่ทำให้การตั้งค่าของคุณพัง)

  • เก็บ ~/.openclaw/workspace และ ~/.openclaw/ เป็น “ของของคุณ”; อย่าใส่พรอมป์/การกำหนดค่าส่วนตัวไว้ในรีโพ openclaw
  • การอัปเดตซอร์ส: git pull + pnpm install + ใช้ pnpm gateway:watch ต่อไป

​
Linux (บริการผู้ใช้ systemd)

การติดตั้งบน Linux ใช้บริการ ผู้ใช้ ของ systemd ตามค่าเริ่มต้น systemd จะหยุด บริการผู้ใช้เมื่อออกจากระบบ/ไม่ได้ใช้งาน ซึ่งจะปิด Gateway การเริ่มต้นใช้งานจะพยายามเปิดใช้ lingering ให้คุณ (อาจขอ sudo) หากยังปิดอยู่ ให้รัน: 
sudo loginctl enable-linger $USER
สำหรับเซิร์ฟเวอร์ที่ต้องเปิดตลอดเวลาหรือมีผู้ใช้หลายคน ให้พิจารณาใช้บริการ ระบบ แทน บริการผู้ใช้ (ไม่ต้องใช้ lingering) ดูหมายเหตุ systemd ได้ที่ คู่มือปฏิบัติการ Gateway

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