FAQ — Hỏi Đáp Thường Gặp
Tổng hợp 50+ câu hỏi thường gặp khi dùng OpenClaw: cài đặt, cấu hình, kết nối kênh, xử lý lỗi, chi phí API, bảo mật. Giải đáp nhanh, có code mẫu.
🔧 Cài Đặt & Khởi Động
Cài đặt thất bại / npm báo lỗi
Kiểm tra Node.js >= 24 (khuyên dùng) hoặc >= 22.16. Xóa cache npm rồi cài lại.
node --version # Cần >= 24 (hoặc 22.16+)\nnpm cache clean --force\nnpm install -g openclaw@latestCần Node.js phiên bản mấy?
Node.js 24+ (khuyên dùng) hoặc Node 22.16+. Tải từ nodejs.org hoặc dùng brew install node@24.
WSL2 là gì? Có cần thiết không?
WSL2 (Windows Subsystem for Linux) giúp chạy Linux trên Windows. Khuyên dùng cho Windows vì OpenClaw hoạt động tốt nhất trên Linux/macOS. Cài: wsl --install
wsl --install\n# Sau đó trong WSL:\nnpm install -g openclaw@latestSao không có winget / brew tap / scoop?
OpenClaw giờ cài qua npm (Node.js package manager) — đơn giản và hoạt động trên mọi OS. Không cần brew tap, winget, hay scoop nữa.
Gateway không khởi động được
Kiểm tra port 18789 có bị chiếm không. Từ v2026.3.7+ cần set gateway.auth.mode.
lsof -i :18789 # Xem ai chiếm port\nopenclaw config set gateway.auth.mode token\nopenclaw gateway restart"Permission denied" trên macOS
Cấp quyền cho thư mục .openclaw:
chmod 700 ~/.openclaw\nchmod +x $(which openclaw)Windows báo "running scripts is disabled"
Mở PowerShell với quyền Admin và chạy:
Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSignedDocker container không chạy
Kiểm tra volume mount và port mapping:
docker logs openclaw\ndocker run -d --name openclaw \\\n -p 18789:18789 \\\n -v ~/.openclaw:/root/.openclaw \\\n openclaw/openclaw:latest📱 Kết Nối Kênh
Telegram bot không phản hồi
Kiểm tra bot_token đúng chưa, dùng --probe để test kết nối:
openclaw channels status --probe\nopenclaw channels logs --channel telegramWhatsApp mất kết nối liên tục
WhatsApp Web hay bị ngắt. Scan lại QR code, hoặc nên chuyển sang Telegram cho ổn định hơn.
openclaw channels login # Scan lại QRDiscord bot offline
Kiểm tra đã bật đủ Intents trong Discord Developer Portal (MESSAGE CONTENT, SERVER MEMBERS).
openclaw channels status --probe\n# Vào Discord Developer Portal → Bot → Privileged Intents → Bật tất cả🤖 Model & API
API key không hoạt động
Kiểm tra format key và provider có khớp không:
openclaw config validate\n# Anthropic key bắt đầu bằng sk-ant-\n# OpenAI key bắt đầu bằng sk-\n# Google key bắt đầu bằng AI..."Rate limit exceeded"
Hết quota API. Đổi sang model khác hoặc chờ reset:
openclaw config set model gemini-2.5-pro # Đổi model tạm\n# Hoặc dùng OpenRouter: 1 key = nhiều modelModel trả lời chậm
Dùng /fast để toggle chế độ nhanh, hoặc đổi sang model nhẹ hơn:
/fast\n# Hoặc đổi model:\nopenclaw config set model deepseek-v3AI "câm" — chỉ chat, không làm gì được
tools.profile phải là "full" (mặc định từ v2026.3.2). Kiểm tra:
openclaw config set tools.profile full\nopenclaw gateway restart⚡ Tính Năng
Memory/bộ nhớ không hoạt động
Chạy lệnh index lại toàn bộ bộ nhớ:
openclaw memory index --all\nopenclaw memory search --query 'test'Heartbeat không gửi thông báo
Kiểm tra file HEARTBEAT.md không rỗng, và activeHours đúng timezone:
cat ~/.openclaw/workspace/HEARTBEAT.md\nopenclaw config get agent.heartbeatCron job không chạy
Kiểm tra danh sách cron và schedule syntax:
openclaw cron list\nopenclaw cron run <tên> # Test thủ côngContext đầy — AI quên hết
Dùng /compact để nén context, hoặc /new để bắt đầu cuộc hội thoại mới:
/compact\n# Hoặc:\n/new🔄 Cập Nhật & Bảo Trì
Cập nhật bị lỗi
Xóa cache rồi cài lại phiên bản mới nhất:
npm cache clean --force\nnpm i -g openclaw@latest\nopenclaw --versionConfig lỗi sau khi upgrade
Validate config và chạy doctor:
openclaw config validate\nopenclaw doctor --deep --yesDung lượng đầy
Dọn dẹp các phiên cũ:
openclaw sessions cleanup\ndu -sh ~/.openclaw # Kiểm tra dung lượng💡 Gặp vấn đề không có trong danh sách? Chạy openclaw doctor --deep --yes — lệnh này tự chẩn đoán và sửa hầu hết lỗi phổ biến.
openclaw doctor --deep --yes