English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiفارسیไทย

Platforms overview

Ứng dụng Linux

Gateway được hỗ trợ đầy đủ trên Linux. Node là runtime được khuyến nghị. Bun không được khuyến nghị cho Gateway (lỗi WhatsApp/Telegram).

Ứng dụng đồng hành gốc cho Linux đã được lên kế hoạch. Rất hoan nghênh đóng góp nếu bạn muốn giúp xây dựng một ứng dụng như vậy.

Lộ trình nhanh cho người mới bắt đầu (VPS)

  1. Cài đặt Node 24 (khuyến nghị; Node 22 LTS, hiện là 22.16+, vẫn hoạt động để tương thích)
  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à xác thực bằng bí mật dùng chung đã cấu hình (token theo mặc định; mật khẩu nếu bạn đặt gateway.auth.mode: "password")

Hướng dẫn máy chủ Linux đầy đủ: Máy chủ Linux. Ví dụ VPS từng bước: exe.dev

Cài đặt

Gateway

Cài đặt dịch vụ Gateway (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 Dịch vụ Gateway khi được nhắc.

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

openclaw doctor

Điều khiển hệ thống (đơn vị người dùng systemd)

OpenClaw cài đặt dịch vụ người dùng systemd theo mặc định. Dùng dịch vụ hệ thống cho các máy chủ dùng chung hoặc luôn bật. openclaw gateway install và openclaw onboard --install-daemon đã kết xuất đơn vị chuẩn hiện tại cho bạn; chỉ tự viết khi bạn cần thiết lập hệ thống/trình quản lý dịch vụ tùy chỉnh. Hướng dẫn dịch vụ đầy đủ nằm trong sổ tay vận hành Gateway.

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
TimeoutStopSec=30
TimeoutStartSec=30
SuccessExitStatus=0 143
KillMode=control-group

[Install]
WantedBy=default.target

Bật dịch vụ:

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

Áp lực bộ nhớ và tiến trình bị OOM kết thúc

Trên Linux, kernel chọn một nạn nhân OOM khi cgroup của máy chủ, VM hoặc container hết bộ nhớ. Gateway có thể là nạn nhân không phù hợp vì nó sở hữu các phiên chạy dài hạn và kết nối kênh. Vì vậy OpenClaw ưu tiên để các tiến trình con tạm thời bị kết thúc trước Gateway khi có thể.

Với các tiến trình con Linux đủ điều kiện, OpenClaw khởi động tiến trình con thông qua một trình bao bọc /bin/sh ngắn, tăng oom_score_adj của chính tiến trình con lên 1000, rồi exec lệnh thật. Đây là thao tác không cần đặc quyền vì tiến trình con chỉ tăng khả năng chính nó bị OOM kết thúc.

Các bề mặt tiến trình con được bao phủ gồm:

  • tiến trình con lệnh do supervisor quản lý,
  • tiến trình con shell PTY,
  • tiến trình con máy chủ MCP stdio,
  • tiến trình trình duyệt/Chrome do OpenClaw khởi chạy.

Trình bao bọc chỉ dành cho Linux và được bỏ qua khi không có /bin/sh. Nó cũng được bỏ qua nếu môi trường của tiến trình con đặt OPENCLAW_CHILD_OOM_SCORE_ADJ=0, false, no, hoặc off.

Để xác minh một tiến trình con:

cat /proc/<child-pid>/oom_score_adj

Giá trị mong đợi cho các tiến trình con được bao phủ là 1000. Tiến trình Gateway nên giữ điểm bình thường của nó, thường là 0.

Điều này không thay thế việc tinh chỉnh bộ nhớ thông thường. Nếu VPS hoặc container liên tục kết thúc tiến trình con, hãy tăng giới hạn bộ nhớ, giảm mức đồng thời, hoặc thêm các biện pháp kiểm soát tài nguyên mạnh hơn như MemoryMax= của systemd hoặc giới hạn bộ nhớ cấp container.

Liên quan