openclaw message

Lệnh gửi đi duy nhất để gửi tin nhắn và thực hiện các thao tác kênh trên Discord, Google Chat, iMessage, Matrix, Mattermost (plugin), Microsoft Teams, Signal, Slack, Telegram và WhatsApp.

openclaw message <subcommand> [flags]

Chọn kênh

• --channel <name> là bắt buộc nếu có nhiều hơn một kênh được cấu hình; nếu chỉ có đúng một kênh được cấu hình, kênh đó sẽ là mặc định.
• Giá trị: discord|googlechat|imessage|matrix|mattermost|msteams|signal|slack|telegram|whatsapp (Mattermost yêu cầu plugin).
• Đích có tiền tố kênh (ví dụ discord:channel:123) sẽ phân giải plugin sở hữu mà không cần chỉ định rõ --channel.

Định dạng đích (-t, --target)

Tra cứu tên kênh: đối với các nhà cung cấp có danh bạ (Discord/Slack/v.v.), các tên như Help hoặc #help được phân giải qua bộ nhớ đệm danh bạ; nếu không tìm thấy trong bộ nhớ đệm và nhà cung cấp hỗ trợ, hệ thống sẽ chuyển sang tra cứu trực tiếp trong danh bạ.

Cờ chung

Mọi thao tác đều chấp nhận: --channel <name>, --account <id>, --json, --dry-run, --verbose. Các thao tác cần đích cũng chấp nhận -t, --target <dest>.

Phân giải SecretRef

openclaw message phân giải các SecretRef của kênh trước khi chạy thao tác, với phạm vi hẹp nhất có thể:

• theo phạm vi kênh khi --channel được đặt (hoặc được suy ra từ đích có tiền tố)
• theo phạm vi tài khoản khi --account cũng được đặt
• tất cả các kênh đã cấu hình khi không đặt cả hai

Các SecretRef chưa phân giải trên những kênh không liên quan không bao giờ chặn một thao tác có đích cụ thể; SecretRef chưa phân giải trên kênh/tài khoản đã chọn sẽ khiến thao tác thất bại theo cơ chế đóng an toàn.

Thao tác

Cốt lõi

Gửi

openclaw message send --channel discord \  --target channel:123 --message "hi" --reply-to 456

• --media <path-or-url>: đính kèm hình ảnh/âm thanh/video/tài liệu (đường dẫn cục bộ hoặc URL).
• --presentation <json>: tải trọng dùng chung với các khối text, context, divider, chart, table, buttons và select, được kết xuất theo khả năng của từng kênh. Xem Trình bày tin nhắn.
• --delivery <json>: tùy chọn phân phối chung, ví dụ {"pin": true}. --pin là dạng viết tắt để phân phối có ghim khi kênh hỗ trợ tính năng này.
• --reply-to <id>, --thread-id <id> (chủ đề diễn đàn Telegram; dấu thời gian luồng Slack, cùng trường với --reply-to).
• --force-document (Telegram, WhatsApp): gửi hình ảnh/GIF/video dưới dạng tài liệu để tránh bị kênh nén.
• --silent (Telegram, Discord): gửi mà không có thông báo.
• --gif-playback (chỉ WhatsApp): xử lý nội dung video như ảnh GIF phát lại.

openclaw message send --channel discord \  --target channel:123 --message "Choose:" \  --presentation '{"blocks":[{"type":"buttons","buttons":[{"label":"Approve","value":"approve","style":"success"},{"label":"Decline","value":"decline","style":"danger"}]}]}'

openclaw message send --channel telegram --target @mychat --message "Choose:" \  --presentation '{"blocks":[{"type":"buttons","buttons":[{"label":"Yes","value":"cmd:yes"},{"label":"No","value":"cmd:no"}]}]}'

Slack kết xuất trực tiếp các khối biểu đồ được hỗ trợ; các kênh khác nhận cùng dữ liệu dưới dạng văn bản dễ đọc:

openclaw message send --channel slack --target channel:C123 \  --presentation '{"blocks":[{"type":"chart","chartType":"bar","title":"Quarterly revenue","categories":["Q1","Q2"],"series":[{"name":"Revenue","values":[120,145]}],"xLabel":"Quarter"}]}'

Slack cũng hiển thị nguyên bản các khối bảng được khai báo rõ ràng. Các kênh khác nhận chú thích và mọi hàng dưới dạng văn bản có tính xác định:

openclaw message send --channel slack --target channel:C123 \  --presentation '{"title":"Pipeline report","blocks":[{"type":"table","caption":"Open pipeline","headers":["Account","Stage","ARR"],"rows":[["Acme","Won",125000],["Globex","Review",82000]],"rowHeaderColumnIndex":0}]}'

Các nút Mini App của Telegram sử dụng webApp (web_app vẫn được phân tích cú pháp cho JSON cũ) và chỉ hiển thị trong cuộc trò chuyện riêng tư giữa người dùng và bot:

openclaw message send --channel telegram --target 123456789 --message "Open app:" \  --presentation '{"blocks":[{"type":"buttons","buttons":[{"label":"Launch","webApp":{"url":"https://example.com/app"}}]}]}'

openclaw message send --channel telegram --target @mychat \  --media ./diagram.png --force-document

openclaw message send --channel msteams \  --target conversation:19:abc@thread.tacv2 \  --presentation '{"title":"Status update","blocks":[{"type":"text","text":"Build completed"}]}'

Thăm dò ý kiến

openclaw message poll --channel discord \  --target channel:123 \  --poll-question "Snack?" \  --poll-option Pizza --poll-option Sushi \  --poll-multi --poll-duration-hours 48

• --poll-option <choice>: lặp lại từ 2 đến 12 lần.
• --poll-multi: cho phép chọn nhiều phương án.
• Discord: --poll-duration-hours, --silent, --message.
• Telegram: --poll-duration-seconds <n> (5-600), --silent, --poll-anonymous / --poll-public, --thread-id.

openclaw message poll --channel telegram \  --target @mychat \  --poll-question "Lunch?" \  --poll-option Pizza --poll-option Sushi \  --poll-duration-seconds 120 --silent

openclaw message poll --channel msteams \  --target conversation:19:abc@thread.tacv2 \  --poll-question "Lunch?" \  --poll-option Pizza --poll-option Sushi

Luồng thảo luận

• thread create: dành cho kênh Discord. Bắt buộc: --thread-name, --target (ID kênh). Tùy chọn: --message-id, --message, --auto-archive-min.
• thread list: dành cho kênh Discord. Bắt buộc: --guild-id. Tùy chọn: --channel-id, --include-archived, --before, --limit.
• thread reply: dành cho kênh Discord. Bắt buộc: --target (ID luồng), --message. Tùy chọn: --media, --reply-to.

Biểu tượng cảm xúc

• emoji list: Discord (--guild-id), Slack (không có cờ bổ sung).
• emoji upload: Discord. Bắt buộc: --guild-id, --emoji-name, --media. Tùy chọn: --role-ids (có thể lặp lại).

Nhãn dán

• sticker send: Discord. Bắt buộc: --target, --sticker-id (có thể lặp lại). Tùy chọn: --message.
• sticker upload: Discord. Bắt buộc: --guild-id, --sticker-name, --sticker-desc, --sticker-tags, --media.

Vai trò, kênh, thoại, sự kiện (Discord)

• role info: --guild-id.
• role add / role remove: --guild-id, --user-id, --role-id.
• channel info: --target.
• channel list: --guild-id.
• voice status: --guild-id, --user-id.
• event list: --guild-id.
• event create: bắt buộc --guild-id, --event-name, --start-time; tùy chọn --end-time, --desc, --channel-id, --location, --event-type, --image <url-or-path>.

Kiểm duyệt (Discord)

• timeout: --guild-id, --user-id; tùy chọn --duration-min hoặc --until (bỏ qua cả hai để xóa thời gian chờ), --reason.
• kick: --guild-id, --user-id, --reason.
• ban: --guild-id, --user-id, --delete-days, --reason.

Phát rộng

openclaw message broadcast --targets <target...> [--channel all] [--message <text>] [--media <url>] [--dry-run]

Gửi một tải trọng đến nhiều đích. --targets nhận danh sách được phân tách bằng dấu cách. Dùng --channel all để nhắm đến mọi nhà cung cấp đã cấu hình.

Liên quan

• Tài liệu tham khảo CLI
• Gửi bằng tác tử
• Trình bày tin nhắn