openclaw agent chạy một lượt tác nhân duy nhất từ dòng lệnh mà không cần
tin nhắn trò chuyện đến. Dùng lệnh này cho quy trình có script, kiểm thử và
phân phối theo chương trình.
Bắt đầu nhanh
Gửi prompt nhiều dòng từ một tệp
Cờ
| Cờ | Mô tả |
|---|---|
--message \<text\> | Tin nhắn nội tuyến cần gửi |
--message-file \<path\> | Đọc tin nhắn từ một tệp UTF-8 hợp lệ |
--to \<dest\> | Suy ra khóa phiên từ một đích (điện thoại, id trò chuyện) |
--session-key \<key\> | Dùng một khóa phiên rõ ràng |
--agent \<id\> | Nhắm tới một tác nhân đã cấu hình (dùng phiên main của nó) |
--session-id \<id\> | Dùng lại một phiên hiện có theo id |
--local | Buộc dùng runtime nhúng cục bộ (bỏ qua Gateway) |
--deliver | Gửi phản hồi tới một kênh trò chuyện |
--channel \<name\> | Kênh phân phối (whatsapp, telegram, discord, slack, v.v.) |
--reply-to \<target\> | Ghi đè đích phân phối |
--reply-channel \<name\> | Ghi đè kênh phân phối |
--reply-account \<id\> | Ghi đè id tài khoản phân phối |
--thinking \<level\> | Đặt mức suy nghĩ cho hồ sơ mô hình đã chọn |
--verbose \<on|full|off\> | Đặt mức chi tiết |
--timeout \<seconds\> | Ghi đè thời gian chờ của tác nhân |
--json | Xuất JSON có cấu trúc |
Hành vi
- Theo mặc định, CLI đi qua Gateway. Thêm
--localđể buộc dùng runtime nhúng trên máy hiện tại. - Truyền đúng một trong hai tùy chọn
--messagehoặc--message-file. Tin nhắn từ tệp giữ nguyên nội dung nhiều dòng sau khi loại bỏ UTF-8 BOM tùy chọn. - Nếu không thể truy cập Gateway, CLI quay về lượt chạy nhúng cục bộ.
- Chọn phiên:
--tosuy ra khóa phiên (đích nhóm/kênh giữ nguyên tính tách biệt; trò chuyện trực tiếp gộp vềmain). --session-keychọn một khóa rõ ràng. Khóa có tiền tố tác nhân phải dùngagent:<agent-id>:<session-key>, và--agentphải khớp id tác nhân đó khi cả hai cùng được cung cấp. Khóa trần không phải sentinel được đặt trong phạm vi--agentkhi được cung cấp; ví dụ,--agent ops --session-key incident-42định tuyến tớiagent:ops:incident-42. Khi không có--agent, khóa trần không phải sentinel được đặt trong phạm vi tác nhân mặc định đã cấu hình. Giá trị nguyên vănglobalvàunknownvẫn không có phạm vi chỉ khi không cung cấp--agent; trong trường hợp đó, fallback nhúng và quyền sở hữu kho lưu trữ dùng tác nhân mặc định đã cấu hình.- Các cờ suy nghĩ và chi tiết được lưu giữ vào kho phiên.
- Đầu ra: văn bản thuần theo mặc định, hoặc
--jsoncho payload + metadata có cấu trúc. - Với
--json --deliver, JSON bao gồm trạng thái phân phối cho các lượt gửi đã gửi, bị chặn, một phần và thất bại. Xem Trạng thái phân phối JSON.
Ví dụ
Liên quan
Tham chiếu CLI của tác nhân
Tham chiếu đầy đủ về cờ và tùy chọn của
openclaw agent.Tác nhân phụ
Khởi tạo tác nhân phụ chạy nền.
Phiên
Cách khóa phiên hoạt động và cách
--to, --agent, cùng --session-id phân giải chúng.Lệnh gạch chéo
Danh mục lệnh gốc được dùng bên trong phiên tác nhân.