Ứng dụng Linux¶

The Gateway is fully supported on Linux. Node là runtime được khuyến nghị. Bun is not recommended for the Gateway (WhatsApp/Telegram bugs).

Các ứng dụng đồng hành gốc cho Linux đang được lên kế hoạch. Chúng tôi hoan nghênh sự đóng góp nếu bạn muốn giúp xây dựng một ứng dụng.

Lộ trình 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 bạn: ssh -N -L 18789:127.0.0.1:18789 <user>@<host>
5. Mở http://127.0.0.1:18789/ và dán token của bạn

Hướng dẫn VPS từng bước: exe.dev

Cài đặt¶

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

Gateway¶

• Runbook Gateway
• Cấu hình

Cài đặt dịch vụ Gateway (CLI)¶

Dùng một trong các cách sau:

openclaw onboard --install-daemon

Hoặc:

openclaw gateway install

Hoặc:

openclaw configure

Khi được nhắc, chọn Gateway service.

Sửa chữa/di chuyển:

openclaw doctor

Điều khiển hệ thống (systemd user unit)¶

OpenClaw cài đặt một dịch vụ systemd ở chế độ user theo mặc định. Sử dụng system service for shared or always-on servers. The full unit example and guidance live in the Gateway runbook.

Thiết lập tối thiểu:

Tạo ~/.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:

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