Agent coordination
Gửi tới tác tử
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 chat gửi đến. Dùng lệnh này cho các workflow có script, kiểm thử và
phân phối theo chương trình.
Bắt đầu nhanh
Chạy một lượt agent đơn giản
openclaw agent --message "What is the weather today?"
Lệnh này gửi tin nhắn qua Gateway và in phản hồi.
Nhắm tới một agent hoặc phiên cụ thể
# Target a specific agent
openclaw agent --agent ops --message "Summarize logs"
# Target a phone number (derives session key)
openclaw agent --to +15555550123 --message "Status update"
# Reuse an existing session
openclaw agent --session-id abc123 --message "Continue the task"
Phân phối phản hồi đến một kênh
# Deliver to WhatsApp (default channel)
openclaw agent --to +15555550123 --message "Report ready" --deliver
# Deliver to Slack
openclaw agent --agent ops --message "Generate report" \
--deliver --reply-channel slack --reply-to "#reports"
Cờ
| Cờ | Mô tả |
|---|---|
--message \<text\> |
Tin nhắn cần gửi (bắt buộc) |
--to \<dest\> |
Suy ra khóa phiên từ một đích (điện thoại, chat id) |
--agent \<id\> |
Nhắm tới một agent đã cấu hình (dùng phiên main của nó) |
--session-id \<id\> |
Tái sử dụng 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 đến một kênh chat |
--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 agent |
--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. - Nếu không thể kết nối Gateway, CLI chuyển dự phòng sang 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 cách ly; chat trực tiếp thu gọn thànhmain). - Các cờ thinking và verbose được lưu vào kho phiên.
- Đầu ra: mặc định là văn bản thuần, hoặc
--jsonđể có payload + siêu dữ liệu có cấu trúc.
Ví dụ
# Simple turn with JSON output
openclaw agent --to +15555550123 --message "Trace logs" --verbose on --json
# Turn with thinking level
openclaw agent --session-id 1234 --message "Summarize inbox" --thinking medium
# Deliver to a different channel than the session
openclaw agent --agent ops --message "Alert" --deliver --reply-channel telegram --reply-to "@admin"