openclaw message

Discord, Google Chat, iMessage, Matrix, Mattermost (plugin), Microsoft Teams, Signal, Slack, Telegram ve WhatsApp genelinde mesaj ve kanal eylemleri göndermek için tek bir giden komut.

openclaw message <subcommand> [flags]

Kanal seçimi

• Birden fazla kanal yapılandırılmışsa --channel <name> zorunludur; tam olarak bir kanal yapılandırılmışsa bu kanal varsayılandır.
• Değerler: discord|googlechat|imessage|matrix|mattermost|msteams|signal|slack|telegram|whatsapp (Mattermost, plugin gerektirir).
• Kanal önekli hedefler (örneğin discord:channel:123), açıkça --channel belirtilmeden sahibi olan plugin'i çözümler.

Hedef biçimleri (-t, --target)

Kanal adı araması: dizini olan sağlayıcılarda (Discord/Slack/vb.) Help veya #help gibi adlar dizin önbelleği aracılığıyla çözümlenir; önbellekte bulunamadığında ve sağlayıcı desteklediğinde canlı dizin aramasına başvurulur.

Ortak bayraklar

Her eylem şunları kabul eder: --channel <name>, --account <id>, --json, --dry-run, --verbose. Hedef alan eylemler ayrıca -t, --target <dest> kabul eder.

SecretRef çözümlemesi

openclaw message, eylemi çalıştırmadan önce kanal SecretRef'lerini mümkün olduğunca dar bir kapsamda çözümler:

• --channel ayarlandığında (veya önekli hedeften çıkarıldığında) kanal kapsamında
• --account da ayarlandığında hesap kapsamında
• ikisi de ayarlanmadığında yapılandırılmış tüm kanallarda

İlgisiz kanallardaki çözümlenmemiş SecretRef'ler hedeflenmiş bir eylemi asla engellemez; seçilen kanal/hesaptaki çözümlenmemiş bir SecretRef, eylemin güvenli biçimde başarısız olmasına neden olur.

Eylemler

Temel

Gönderme

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

• --media <path-or-url>: resim/ses/video/belge ekleyin (yerel yol veya URL).
• --presentation <json>: kanal yeteneğine göre işlenen text, context, divider, chart, table, buttons ve select bloklarını içeren paylaşılan yük. Bkz. Mesaj Sunumu.
• --delivery <json>: genel teslim tercihleri, örneğin {"pin": true}. Kanal desteklediğinde --pin, sabitlenmiş teslimin kısa biçimidir.
• --reply-to <id>, --thread-id <id> (Telegram forum konusu; Slack ileti dizisi zaman damgası, --reply-to ile aynı alan).
• --force-document (Telegram, WhatsApp): kanal sıkıştırmasını önlemek için resimleri/GIF'leri/videoları belge olarak gönderir.
• --silent (Telegram, Discord): bildirim olmadan gönderir.
• --gif-playback (yalnızca WhatsApp): video medyasını GIF oynatımı olarak değerlendirir.

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, desteklenen grafik bloklarını yerel olarak işler; diğer kanallar aynı verileri okunabilir metin olarak alır:

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 ayrıca açık tablo bloklarını yerel olarak işler. Diğer kanallar, başlığı ve her satırı deterministik metin olarak alır:

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}]}'

Telegram Mini App düğmeleri webApp kullanır (web_app, eski JSON için hâlâ ayrıştırılır) ve yalnızca bir kullanıcı ile bot arasındaki özel sohbetlerde işlenir:

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"}]}'

Anket

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>: 2-12 kez tekrarlayın.
• --poll-multi: birden fazla seçime izin verir.
• 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

İleti dizileri

• thread create: Discord kanalları. Gerekli: --thread-name, --target (kanal kimliği). İsteğe bağlı: --message-id, --message, --auto-archive-min.
• thread list: Discord kanalları. Gerekli: --guild-id. İsteğe bağlı: --channel-id, --include-archived, --before, --limit.
• thread reply: Discord kanalları. Gerekli: --target (ileti dizisi kimliği), --message. İsteğe bağlı: --media, --reply-to.

Emojiler

• emoji list: Discord (--guild-id), Slack (ek bayrak yok).
• emoji upload: Discord. Gerekli: --guild-id, --emoji-name, --media. İsteğe bağlı: --role-ids (tekrarlanabilir).

Çıkartmalar

• sticker send: Discord. Gerekli: --target, --sticker-id (tekrarlanabilir). İsteğe bağlı: --message.
• sticker upload: Discord. Gerekli: --guild-id, --sticker-name, --sticker-desc, --sticker-tags, --media.

Roller, kanallar, ses ve etkinlikler (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: gerekli: --guild-id, --event-name, --start-time; isteğe bağlı: --end-time, --desc, --channel-id, --location, --event-type, --image <url-or-path>.

Moderasyon (Discord)

• timeout: --guild-id, --user-id; isteğe bağlı: --duration-min veya --until (zaman aşımını kaldırmak için ikisini de belirtmeyin), --reason.
• kick: --guild-id, --user-id, --reason.
• ban: --guild-id, --user-id, --delete-days, --reason.

Toplu yayın

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

Tek bir yükü birden fazla hedefe gönderir. --targets, boşlukla ayrılmış bir liste alır. Yapılandırılmış tüm sağlayıcıları hedeflemek için --channel all kullanın.

İlgili

• CLI başvurusu
• Agent gönderimi
• İleti Sunumu