English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisहिन्दीالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiРусскийفارسیไทย
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this pageOpen in PerplexityAsk questions about this page

Agent coordination

Gửi tác tử

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

  • Chạy một lượt tác nhân đơn giản

    bash
    openclaw agent --agent main --message "What is the weather today?"

    Lệnh này gửi tin nhắn qua Gateway và in phản hồi.

  • Gửi prompt nhiều dòng từ một tệp

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

    Lệnh này đọc một tệp UTF-8 hợp lệ làm nội dung tin nhắn của tác nhân.

  • Nhắm tới một tác nhân hoặc phiên cụ thể

    bash
    # Target a specific agentopenclaw agent --agent ops --message "Summarize logs" # Target a phone number (derives session key)openclaw agent --to +15555550123 --message "Status update" # Reuse an existing sessionopenclaw agent --session-id abc123 --message "Continue the task" # Target an exact session keyopenclaw agent --session-key agent:ops:incident-42 --message "Summarize status"

  • Phân phối phản hồi tới một kênh

    bash
    # Deliver to WhatsApp (default channel)openclaw agent --to +15555550123 --message "Report ready" --deliver # Deliver to Slackopenclaw agent --agent ops --message "Generate report" \  --deliver --reply-channel slack --reply-to "#reports"

    • 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 --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ỏ 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: --to suy 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-key chọn một khóa rõ ràng. Khóa có tiền tố tác nhân phải dùng agent:<agent-id>:<session-key>, và --agent phả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 --agent khi được cung cấp; ví dụ, --agent ops --session-key incident-42 định tuyến tới agent: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ăn global và unknown vẫ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 --json cho 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ụ

    bash
    # Simple turn with JSON outputopenclaw agent --to +15555550123 --message "Trace logs" --verbose on --json # Turn with thinking levelopenclaw agent --session-id 1234 --message "Summarize inbox" --thinking medium # Multiline prompt from a fileopenclaw agent --agent ops --message-file ./task.md # Exact session keyopenclaw agent --session-key agent:ops:incident-42 --message "Summarize status" # Legacy key scoped to an agentopenclaw agent --agent ops --session-key incident-42 --message "Summarize status" # Deliver to a different channel than the sessionopenclaw agent --agent ops --message "Alert" --deliver --reply-channel telegram --reply-to "@admin"

    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.
    Was this useful?
    On this page

    On this page