Ứng dụng Linux

Gateway được hỗ trợ đầy đủ trên Linux. Node là runtime được khuyên dùng. Không nên dùng Bun cho Gateway (có bug với WhatsApp/Telegram).

Các ứng dụng companion native cho Linux đang được lên kế hoạch. Rất hoan nghênh các bạn đóng góp nếu muốn giúp xây dựng.

Hướng dẫn nhanh cho người mới (VPS)

1. Cài đặt Node 22+
2. npm i -g openclaw@latest
3. openclaw onboard --install-daemon
4. Từ laptop của các bạn: ssh -N -L 18789:127.0.0.1:18789 <user>@<host>
5. Mở http://127.0.0.1:18789/ và paste token vào

Hướng dẫn VPS chi tiết: exe.dev

Cài đặt

• Bắt đầu
• Cài đặt & cập nhật
• Các phương thức tùy chọn: Bun (thử nghiệm), Nix, Docker

Gateway

• Gateway runbook
• Cấu hình

Cài đặt Gateway service (CLI)

Dùng một trong các lệnh sau:

openclaw onboard --install-daemon

Hoặc:

openclaw gateway install

Hoặc:

openclaw configure

Chọn Gateway service khi được hỏi.

Sửa chữa/migrate:

openclaw doctor

Quản lý hệ thống (systemd user unit)

OpenClaw cài đặt systemd user service theo mặc định. Dùng system service cho các server dùng chung hoặc chạy liên tục. Ví dụ unit đầy đủ và hướng dẫn có trong Gateway runbook.

Cấu hình tối thiểu:

Tạo file ~/.config/systemd/user/openclaw-gateway[-<profile>].service:

[Unit]
Description=OpenClaw Gateway (profile: <profile>, v<version>)
After=network-online.target
Wants=network-online.target

[Service]
ExecStart=/usr/local/bin/openclaw gateway --port 18789
Restart=always
RestartSec=5

[Install]
WantedBy=default.target

Kích hoạt service:

systemctl --user enable --now openclaw-gateway[-<profile>].service