Chuyển đến nội dung chính

Documentation Index

Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

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ó kịch bản, kiểm thử và gửi nội dung theo chương trình.

​
Bắt đầu nhanh

1

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.
2

Nhắm đến 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"
3

Gử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 mục tiêu (điện thoại, id trò chuyện)
--agent \<id\>Nhắm đến một agent đã cấu hình (dùng phiên main của agent đó)
--session-id \<id\>Tái sử dụng một phiên hiện có theo id
--localBuộc dùng runtime nhúng cục bộ (bỏ qua Gateway)
--deliverGửi phản hồi đến một kênh trò chuyện
--channel \<name\>Kênh gửi (whatsapp, telegram, discord, slack, v.v.)
--reply-to \<target\>Ghi đè mục tiêu gửi
--reply-channel \<name\>Ghi đè kênh gửi
--reply-account \<id\>Ghi đè id tài khoản gửi
--thinking \<level\>Đặt mức suy luận 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
--jsonXuấ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ể truy cập Gateway, CLI chuyển dự phòng sang lượt chạy nhúng cục bộ.
  • Chọn phiên: --to suy ra khóa phiên (mục tiêu nhóm/kênh giữ nguyên cách ly; trò chuyện trực tiếp được gộp về main).
  • Các cờ suy luận và chi tiết đượ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ới --json --deliver, JSON bao gồm trạng thái gử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 gửi JSON.

​
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"

​
Liên quan

Tham chiếu CLI cho agent

Tham chiếu đầy đủ về cờ và tùy chọn của openclaw agent.

Agent phụ

Khởi tạo agent phụ chạy nền.

Phiên

Cách khóa phiên hoạt động và cách --to, --agent, và --session-id phân giải chúng.

Lệnh dấu gạch chéo

Danh mục lệnh gốc được dùng bên trong các phiên agent.