การส่งของเอเจนต์

openclaw agent เรียกใช้การทำงานของเอเจนต์หนึ่งรอบจากบรรทัดคำสั่งโดยไม่มี ข้อความแชตขาเข้า ใช้สำหรับเวิร์กโฟลว์แบบสคริปต์ การทดสอบ และ การส่งผลลัพธ์ด้วยโปรแกรม เอกสารอ้างอิงแฟล็กและพฤติกรรมทั้งหมด: เอกสารอ้างอิง CLI ของเอเจนต์

เริ่มต้นอย่างรวดเร็ว

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

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

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

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

แฟล็ก

พฤติกรรม

• โดยค่าเริ่มต้น CLI จะทำงาน ผ่าน Gateway เพิ่ม --local เพื่อบังคับใช้ รันไทม์แบบฝังบนเครื่องปัจจุบัน
• ส่ง --message หรือ --message-file อย่างใดอย่างหนึ่งเท่านั้น ข้อความจากไฟล์จะคง เนื้อหาหลายบรรทัดไว้หลังจากนำ UTF-8 BOM ที่อาจมีออก
• หากคำขอไปยัง Gateway ล้มเหลว CLI จะ สลับไปใช้ การทำงานแบบฝังภายในเครื่อง หาก Gateway หมดเวลา ระบบจะสลับไปใช้เซสชันใหม่แทนการทำงานแข่งกับ ทรานสคริปต์เดิม
• การเลือกเซสชัน: --to สร้างคีย์เซสชัน (เป้าหมายกลุ่ม/ช่องทาง จะรักษาการแยกจากกัน ส่วนแชตโดยตรงจะรวมเป็น main) เมื่อใช้ --agent, --channel และ --to ร่วมกัน การกำหนดเส้นทางจะเป็นไปตามผู้รับมาตรฐานของช่องทาง และ session.dmScope ข้อมูลประจำตัวที่เสถียรสำหรับการส่งออกเท่านั้นจะใช้ เซสชันที่ผู้ให้บริการเป็นเจ้าของ ซึ่งแยกจากเซสชันหลักของเอเจนต์
• --session-key เลือกคีย์ที่ระบุอย่างชัดเจน คีย์ที่ขึ้นต้นด้วยเอเจนต์ต้องใช้ agent:<agent-id>:<session-key> และเมื่อระบุทั้งสองค่า --agent ต้องตรงกับรหัสเอเจนต์นั้น คีย์เปล่าที่ไม่ใช่ค่าเซนทิเนลจะถูกกำหนดขอบเขตตาม --agent เมื่อระบุไว้ ตัวอย่างเช่น --agent ops --session-key incident-42 จะกำหนดเส้นทางไปยัง agent:ops:incident-42 หากไม่มี --agent คีย์เปล่าที่ไม่ใช่ค่าเซนทิเนลจะถูกกำหนดขอบเขต ตามเอเจนต์เริ่มต้นที่กำหนดค่าไว้ ค่า global และ unknown แบบตรงตัวจะยังคง ไม่มีขอบเขตเฉพาะเมื่อไม่ได้ระบุ --agent เท่านั้น ส่วนเส้นทางสำรองแบบฝัง จะแปลงเซสชันเซนทิเนลเหล่านั้นเป็นเอเจนต์เริ่มต้นที่กำหนดค่าไว้
• --reply-channel และ --reply-account มีผลต่อการส่งเท่านั้น
• แฟล็กระดับการคิดและระดับรายละเอียดจะถูกบันทึกไว้ในที่เก็บเซสชัน
• ผลลัพธ์: เป็นข้อความธรรมดาโดยค่าเริ่มต้น หรือใช้ --json สำหรับเพย์โหลดแบบมีโครงสร้างพร้อมข้อมูลเมตา
• เมื่อใช้ --json --deliver JSON จะรวมสถานะการส่งสำหรับการส่งที่ สำเร็จ ถูกระงับ สำเร็จบางส่วน และล้มเหลว ดู สถานะการส่ง JSON

ตัวอย่าง

# Simple turn with JSON outputopenclaw agent --to +15555550123 --message "Trace logs" --verbose on --json # Turn with a model overrideopenclaw agent --agent ops --model openai/gpt-5.4 --message "Summarize logs" # 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"

เนื้อหาที่เกี่ยวข้อง