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

Documentation Index

Fetch the complete documentation index at: https://docs.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 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

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

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
--localBuộc dùng runtime nhúng cục bộ (bỏ qua Gateway)
--deliverGử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
--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ể 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: --to suy 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ành main).
  • 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"

​
Liên quan

Tham chiếu CLI của agent

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

Sub-agent

Sinh sub-agent trong 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 slash

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