Gửi tác nhân

openclaw agent chạy một lượt agent 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 các quy trình có tập lệnh, kiểm thử và gửi theo chương trình. Tham khảo đầy đủ về cờ và hành vi: Tài liệu tham khảo CLI agent.

Bắt đầu nhanh

openclaw agent --agent main --message "Thời tiết hôm nay thế nào?"

openclaw agent --agent ops --message-file ./task.md

# Nhắm đến một agent cụ thểopenclaw agent --agent ops --message "Tóm tắt nhật ký" # Nhắm đến một số điện thoại (suy ra khóa phiên)openclaw agent --to +15555550123 --message "Cập nhật trạng thái" # Tái sử dụng một phiên hiện cóopenclaw agent --session-id abc123 --message "Tiếp tục tác vụ" # Nhắm đến một khóa phiên chính xácopenclaw agent --session-key agent:ops:incident-42 --message "Tóm tắt trạng thái"

# Gửi đến WhatsApp (kênh mặc định)openclaw agent --to +15555550123 --message "Báo cáo đã sẵn sàng" --deliver # Gửi đến Slackopenclaw agent --agent ops --message "Tạo báo cáo" \  --deliver --reply-channel slack --reply-to "#reports"

Các 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 chính xác một trong --message hoặc --message-file. Tin nhắn từ tệp giữ nguyên nội dung nhiều dòng sau khi loại bỏ BOM UTF-8 tùy chọn. Các tệp lớn hơn 4 MiB bị từ chối trước khi điều phối.
• Sau các lần thử lại bắt tay do lỗi tạm thời, thời gian chờ Gateway hoặc kết nối bị đóng sẽ khiến lệnh thất bại kèm gợi ý trên stderr; CLI không bao giờ âm thầm chạy lại lượt đó bằng runtime nhúng. Gateway vẫn có thể hoàn tất một lượt đã chấp nhận, vì vậy hãy xác minh trạng thái Gateway và phiên trước khi thử lại hoặc chạy lại với --local.
• Chọn phiên: --to suy ra khóa phiên (đích nhóm/kênh duy trì sự cô lập; cuộc trò chuyện trực tiếp thu gọn thành main). Khi dùng đồng thời --agent, --channel và --to, việc định tuyến tuân theo người nhận chuẩn của kênh và session.dmScope. Các danh tính ổn định chỉ dùng cho gửi đi sử dụng một phiên do nhà cung cấp sở hữu, được cô lập khỏi phiên chính của agent.
• --session-key chọn một khóa tường minh. Các khóa có tiền tố agent phải dùng agent:<agent-id>:<session-key>, và --agent phải khớp với id agent đó khi cả hai đều được cung cấp. Các khóa trần không phải sentinel được giới hạn phạm vi theo --agent khi được cung cấp; ví dụ, --agent ops --session-key incident-42 định tuyến đến agent:ops:incident-42. Khi không có --agent, các khóa trần không phải sentinel được giới hạn phạm vi theo agent mặc định đã cấu hình. Các giá trị nguyên văn global và unknown chỉ không bị giới hạn phạm vi khi không cung cấp --agent.
• --reply-channel và --reply-account chỉ ảnh hưởng đến việc gửi.
• Các cờ suy luận và chi tiết được duy trì trong kho phiên.
• Đầu ra: văn bản thuần theo mặc định hoặc --json để nhận payload có cấu trúc + siêu dữ liệu.
• Với --json --deliver, JSON bao gồm trạng thái gửi cho các lần gửi thành công, bị chặn, một phần và thất bại. Xem Trạng thái gửi JSON.

Ví dụ

# Lượt đơn giản với đầu ra JSONopenclaw agent --to +15555550123 --message "Theo dõi nhật ký" --verbose on --json # Lượt chạy với mô hình được ghi đèopenclaw agent --agent ops --model openai/gpt-5.4 --message "Tóm tắt nhật ký" # Lượt chạy với mức suy luậnopenclaw agent --session-id 1234 --message "Tóm tắt hộp thư đến" --thinking medium # Prompt nhiều dòng từ một tệpopenclaw agent --agent ops --message-file ./task.md # Khóa phiên chính xácopenclaw agent --session-key agent:ops:incident-42 --message "Tóm tắt trạng thái" # Khóa cũ được giới hạn phạm vi theo một agentopenclaw agent --agent ops --session-key incident-42 --message "Tóm tắt trạng thái" # Gửi đến một kênh khác với kênh của phiênopenclaw agent --agent ops --message "Cảnh báo" --deliver --reply-channel telegram --reply-to "@admin"

Liên quan