Các lệnh OpenClaw Gateway là nhóm lệnh CLI giúp bạn quản lý đường vào các cổng trong hệ sinh thái Open Claw. Dưới đây là những OpenClaw Gateway Command bạn cần biết.
Gateway là gì?
Nếu đang tìm kiếm "openclaw gateway" hay "openclaw gateway start", có thể bạn đã cài đặt OpenClaw nhưng vẫn chưa chắc chắn về vai trò của Gateway. Hiểu đơn giản, Gateway là trung tâm điều khiển của OpenClaw — nó nhận tin nhắn từ các nền tảng giao tiếp (Telegram, LINE, Discord, v.v.), chuyển tiếp chúng đến các tác nhân AI để xử lý và quản lý tất cả các kết nối và xác thực.
Hãy coi Gateway như một "tổng đài dành cho các tác nhân AI" — tất cả các tin nhắn đến đều phải đi qua nó trước, và nó sẽ quyết định tác nhân nào xử lý yêu cầu, mô hình AI nào sẽ được sử dụng và quy tắc bảo mật nào sẽ được áp dụng.
Bảng lệnh Gateway trong OpenClaw
Truy vấn trạng thái
| Lệnh | Chức năng | Mô tả |
|---|---|---|
openclaw gateway status |
Kiểm tra trạng thái Gateway runtime | Hiện trạng thái runtime (running/stopped), port, PID |
openclaw gateway status --json |
Xuất định dạng JSON | Phù hợp phân tích script tự động |
openclaw gateway status --deep |
Kiểm tra trạng thái chuyên sâu | Kiểm tra kết nối và trạng thái kênh WebSocket |
openclaw status |
Tổng quan trạng thái tổng thể | Hiện Gateway, Node, và trạng thái Channel cùng nhau |
openclaw status --deep |
Chuẩn đoán chuyên sâu toàn diện | Báo cáo chi tiết về tình trạng của tất cả thành phần |
openclaw health |
Kiểm tra endpoint trạng thái | Xác thực nhanh gateway đang phản hồi |
Khởi động và dừng lại
| Lệnh | Chức năng | Mô tả |
|---|---|---|
openclaw gateway --port 18789 |
Khởi động Gateway ở chế độ nền trước | Cổng mặc định 18789, tốt cho gỡ lỗi (Ctrl+C để dừng lại) |
openclaw gateway install --force |
Cài đặt lại/Gỡ cài đặt dịch vụ hệ thống | Thiết lập systemd (Linux) hoặc dịch vụ nền launchd (macOS) |
openclaw gateway restart |
Khởi động lại dịch vụ Gateway | Thường được dùng sau khi thay đổi config |
Lưu ý: OpenClaw Gateway không có các lệnh con riêng biệt để khởi động cổng hoặc dừng cổng. Để khởi động, hãy chạy openclaw gateway (ở nền trước) hoặc cài đặt như một dịch vụ hệ thống thông qua openclaw gateway install --force. Để dừng dịch vụ, hãy sử dụng systemctl stop openclaw-gateway trên Linux hoặc launchctl unload trên macOS.
Chẩn đoán và gỡ lỗi
| Lệnh | Chức năng | Mô tả |
|---|---|---|
openclaw doctor |
Tự động chẩn đoán lỗi hệ thống | Kiểm tra cấu hình, quyền và kết nối |
openclaw doctor --generate-gateway-token |
Tạo token bảo mật Gateway | Tự động viết vào openclaw.json |
openclaw logs --follow |
Lưu nhật ký luồng tại thời gian thực | Giống như tail -f, trực tiếp quan sát hoạt động của Gateway |
openclaw security audit |
Kiểm tra an toàn | Quét rủi ro bảo mật đã biết |
openclaw security audit --deep |
Quét bảo mật chuyên sâu | Kiểm tra cấu hình xác thực, độ mạnh của mã thông báo và các cổng được mở. |
openclaw security audit --fix |
Tự động sửa các lỗi bảo mật | Thực hiện các biện pháp tự động khắc phục các sự cố đã phát hiện. |
Quản lý cấu hình
| Lệnh | Chức năng | Ví dụ |
|---|---|---|
openclaw config get <key> |
Đọc giá trị cấu hình | openclaw config get gateway.port |
openclaw config set <key> <value> |
Chỉnh sửa một giá trị config | openclaw config set gateway.port 28789 |
openclaw config unset <key> |
Xóa một giá trị config | openclaw config unset gateway.auth.token |
openclaw configure |
Hướng dẫn tương tác config | Tốt nhất cho các thiết lập lần đầu tiên và những thay đổi chính |
openclaw onboard --install-daemon |
Khởi tạo hoàn chỉnh | Thiết lập xác thực, Gateway, Channel và cài đặt dịch vụ nền. |