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.

เรียกใช้ OpenClaw Gateway แบบถาวรและทำงานตลอดเวลาบน Raspberry Pi เนื่องจาก Pi ทำหน้าที่เป็นเพียง Gateway (โมเดลทำงานในคลาวด์ผ่าน API) แม้แต่ Pi สเปกปานกลางก็รองรับงานได้ดี — ค่าอุปกรณ์ทั่วไปอยู่ที่ $35–80 จ่ายครั้งเดียว ไม่มีค่าบริการรายเดือน

​
ความเข้ากันได้ของฮาร์ดแวร์

รุ่น PiRAMใช้ได้ไหม?หมายเหตุ
Pi 54/8 GBดีที่สุดเร็วที่สุด แนะนำ
Pi 44 GBดีจุดที่เหมาะสำหรับผู้ใช้ส่วนใหญ่
Pi 42 GBพอใช้เพิ่ม swap
Pi 41 GBคับแคบเป็นไปได้เมื่อใช้ swap และ config ขั้นต่ำ
Pi 3B+1 GBช้าใช้ได้แต่หน่วง
Pi Zero 2 W512 MBไม่ได้ไม่แนะนำ
ขั้นต่ำ: RAM 1 GB, 1 core, พื้นที่ว่างดิสก์ 500 MB, OS 64-bit แนะนำ: RAM 2 GB+, SD card 16 GB+ (หรือ USB SSD), Ethernet

​
ข้อกำหนดเบื้องต้น

  • Raspberry Pi 4 หรือ 5 ที่มี RAM 2 GB+ (แนะนำ 4 GB)
  • การ์ด MicroSD (16 GB+) หรือ USB SSD (ประสิทธิภาพดีกว่า)
  • แหล่งจ่ายไฟ Pi อย่างเป็นทางการ
  • การเชื่อมต่อเครือข่าย (Ethernet หรือ WiFi)
  • Raspberry Pi OS 64-bit (จำเป็น — อย่าใช้ 32-bit)
  • ประมาณ 30 นาที

​
การตั้งค่า

1

แฟลช OS

ใช้ Raspberry Pi OS Lite (64-bit) — ไม่ต้องมีเดสก์ท็อปสำหรับเซิร์ฟเวอร์แบบ headless
  1. ดาวน์โหลด Raspberry Pi Imager
  2. เลือก OS: Raspberry Pi OS Lite (64-bit)
  3. ในกล่องโต้ตอบการตั้งค่า ให้กำหนดค่าล่วงหน้า:
    • Hostname: gateway-host
    • เปิดใช้ SSH
    • ตั้งชื่อผู้ใช้และรหัสผ่าน
    • กำหนดค่า WiFi (ถ้าไม่ได้ใช้ Ethernet)
  4. แฟลชลง SD card หรือไดรฟ์ USB ของคุณ ใส่เข้าเครื่อง แล้วบูต Pi
2

เชื่อมต่อผ่าน SSH

ssh user@gateway-host
3

อัปเดตระบบ

sudo apt update && sudo apt upgrade -y
sudo apt install -y git curl build-essential

# Set timezone (important for cron and reminders)
sudo timedatectl set-timezone America/Chicago
4

ติดตั้ง Node.js 24

curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash -
sudo apt install -y nodejs
node --version
5

เพิ่ม swap (สำคัญสำหรับ 2 GB หรือน้อยกว่า)

sudo fallocate -l 2G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile
echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab

# Reduce swappiness for low-RAM devices
echo 'vm.swappiness=10' | sudo tee -a /etc/sysctl.conf
sudo sysctl -p
6

ติดตั้ง OpenClaw

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

เรียกใช้การเริ่มต้นใช้งาน

openclaw onboard --install-daemon
ทำตามวิซาร์ด แนะนำให้ใช้ API keys แทน OAuth สำหรับอุปกรณ์แบบ headless Telegram เป็นช่องทางที่เริ่มใช้ง่ายที่สุด
8

ตรวจสอบ

openclaw status
systemctl --user status openclaw-gateway.service
journalctl --user -u openclaw-gateway.service -f
9

เข้าถึง Control UI

บนคอมพิวเตอร์ของคุณ รับ URL แดชบอร์ดจาก Pi:
ssh user@gateway-host 'openclaw dashboard --no-open'
จากนั้นสร้าง SSH tunnel ในเทอร์มินัลอีกอัน:
ssh -N -L 18789:127.0.0.1:18789 user@gateway-host
เปิด URL ที่พิมพ์ออกมาในเบราว์เซอร์ภายในเครื่องของคุณ สำหรับการเข้าถึงระยะไกลแบบทำงานตลอดเวลา ดู การผสานรวม Tailscale

​
เคล็ดลับด้านประสิทธิภาพ

ใช้ USB SSD — SD card ช้าและเสื่อมสภาพได้ USB SSD ช่วยเพิ่มประสิทธิภาพได้อย่างมาก ดู คู่มือการบูต Pi ผ่าน USB เปิดใช้แคชการคอมไพล์โมดูล — เร่งความเร็วการเรียกใช้ CLI ซ้ำ ๆ บนโฮสต์ Pi ที่ใช้พลังงานต่ำกว่า: 
grep -q 'NODE_COMPILE_CACHE=/var/tmp/openclaw-compile-cache' ~/.bashrc || cat >> ~/.bashrc <<'EOF' # pragma: allowlist secret
export NODE_COMPILE_CACHE=/var/tmp/openclaw-compile-cache
mkdir -p /var/tmp/openclaw-compile-cache
export OPENCLAW_NO_RESPAWN=1
EOF
source ~/.bashrc
ลดการใช้หน่วยความจำ — สำหรับการตั้งค่าแบบ headless ให้คืนหน่วยความจำ GPU และปิดบริการที่ไม่ได้ใช้: 
echo 'gpu_mem=16' | sudo tee -a /boot/config.txt
sudo systemctl disable bluetooth
systemd drop-in สำหรับการรีสตาร์ตที่เสถียร — ถ้า Pi เครื่องนี้ใช้รัน OpenClaw เป็นหลัก ให้เพิ่ม service drop-in: 
systemctl --user edit openclaw-gateway.service

[Service]
Environment=OPENCLAW_NO_RESPAWN=1
Environment=NODE_COMPILE_CACHE=/var/tmp/openclaw-compile-cache
Restart=always
RestartSec=2
TimeoutStartSec=90
จากนั้นเรียกใช้ systemctl --user daemon-reload && systemctl --user restart openclaw-gateway.service บน Pi แบบ headless ให้เปิดใช้ lingering หนึ่งครั้งด้วย เพื่อให้บริการของผู้ใช้ยังทำงานต่อหลังออกจากระบบ: sudo loginctl enable-linger "$(whoami)"

​
การตั้งค่าโมเดลที่แนะนำ

เนื่องจาก Pi รันเฉพาะ Gateway ให้ใช้โมเดล API ที่โฮสต์บนคลาวด์: 
{
  "agents": {
    "defaults": {
      "model": {
        "primary": "anthropic/claude-sonnet-4-6",
        "fallbacks": ["openai/gpt-5.4-mini"]
      }
    }
  }
}
อย่ารัน LLM ภายในเครื่องบน Pi — แม้แต่โมเดลขนาดเล็กก็ช้าเกินกว่าจะใช้งานได้จริง ให้ Claude หรือ GPT ทำงานด้านโมเดลแทน

​
หมายเหตุเกี่ยวกับไบนารี ARM

ฟีเจอร์ส่วนใหญ่ของ OpenClaw ทำงานบน ARM64 ได้โดยไม่ต้องเปลี่ยนแปลง (Node.js, Telegram, WhatsApp/Baileys, Chromium) ไบนารีที่บางครั้งไม่มี build สำหรับ ARM มักเป็นเครื่องมือ Go/Rust CLI ที่เป็นตัวเลือกและมาพร้อมกับ Skills ตรวจสอบหน้า release ของไบนารีที่หายไปว่ามี artifact สำหรับ linux-arm64 / aarch64 ก่อนจะย้อนกลับไป build จากซอร์ส

​
ความคงอยู่ของข้อมูลและการสำรองข้อมูล

สถานะของ OpenClaw อยู่ภายใต้:
  • ~/.openclaw/ — openclaw.json, auth-profiles.json แยกตาม agent, สถานะช่องทาง/ผู้ให้บริการ, เซสชัน
  • ~/.openclaw/workspace/ — workspace ของ agent (SOUL.md, หน่วยความจำ, artifacts)
ข้อมูลเหล่านี้ยังอยู่หลังรีบูต สร้าง snapshot แบบพกพาได้ด้วย: 
openclaw backup create
ถ้าคุณเก็บข้อมูลเหล่านี้บน SSD ทั้งประสิทธิภาพและอายุการใช้งานจะดีกว่า SD card

​
การแก้ปัญหา

หน่วยความจำไม่พอ — ตรวจสอบว่า swap ทำงานอยู่ด้วย free -h ปิดบริการที่ไม่ได้ใช้ (sudo systemctl disable cups bluetooth avahi-daemon) ใช้เฉพาะโมเดลที่อิง API ประสิทธิภาพช้า — ใช้ USB SSD แทน SD card ตรวจสอบการถูกจำกัดความเร็ว CPU ด้วย vcgencmd get_throttled (ควรคืนค่า 0x0) บริการไม่เริ่มทำงาน — ตรวจสอบบันทึกด้วย journalctl --user -u openclaw-gateway.service --no-pager -n 100 และเรียกใช้ openclaw doctor --non-interactive ถ้านี่เป็น Pi แบบ headless ให้ตรวจสอบด้วยว่าเปิดใช้ lingering แล้ว: sudo loginctl enable-linger "$(whoami)" ปัญหาไบนารี ARM — ถ้า skill ล้มเหลวพร้อมข้อความ “exec format error” ให้ตรวจสอบว่าไบนารีมี build สำหรับ ARM64 หรือไม่ ตรวจสอบสถาปัตยกรรมด้วย uname -m (ควรแสดง aarch64) WiFi หลุด — ปิดการจัดการพลังงาน WiFi: sudo iwconfig wlan0 power off

​
ขั้นตอนถัดไป

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