Raspberry Pi

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

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

ขั้นต่ำ: 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 นาที

# การตั้งค่า

ssh user@gateway-host

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

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

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

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

openclaw onboard --install-daemon

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

ssh user@gateway-host 'openclaw dashboard --no-open'

ssh -N -L 18789:127.0.0.1:18789 user@gateway-host

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

ใช้ 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

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

• ช่องทาง -- เชื่อมต่อ Telegram, WhatsApp, Discord และอื่น ๆ
• การกำหนดค่า Gateway -- ตัวเลือก config ทั้งหมด
• การอัปเดต -- ทำให้ OpenClaw เป็นเวอร์ชันล่าสุดอยู่เสมอ

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

• ภาพรวมการติดตั้ง
• เซิร์ฟเวอร์ Linux
• แพลตฟอร์ม