Message
기준일: 2026-07-26
공식 기준: Message
Message 문서는 OpenClaw 공식 문서(cli/message)를 한국어로 정리한 가이드입니다. CLI reference for openclaw message (send + channel actions) 명령·설정 키·코드 예시는 공식 문서를 그대로 보존하며, 해석과 절차 안내는 한국어로 제공합니다. 최종 동작은 설치된 CLI 버전과 공식 원문을 확인하세요.
핵심 요약
CLI reference for openclaw message (send + channel actions)
한국어 가이드 범위: cli/message 경로의 설정·명령·제약·예시를 학습용으로 재구성합니다.
문서 구성
공식 문서의 주요 섹션은 다음과 같습니다.
- Channel selection
- Target formats (-t, --target)
- Common flags
- SecretRef resolution
- Actions
- Core
- Send
- Poll
- Threads
- Emojis
- Stickers
- Roles, channels, voice, events (Discord)
- Moderation (Discord)
- Broadcast
- 관련 문서
상세 내용
openclaw message
Single outbound command for sending messages and channel actions across Discord, Google Chat, iMessage, Matrix, Mattermost (plugin), Microsoft Teams, Signal, Slack, Telegram, and WhatsApp.
위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과
--help를 확인하세요.
openclaw message <subcommand> [flags]
Channel selection
exactly one channel configured, that channel is the default.
위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과
--help를 확인하세요.
주요 항목:
--channel <name>is required if more than one channel is configured; with- Values:
discord|googlechat|imessage|matrix|mattermost|msteams|signal|slack|telegram|whatsapp - Channel-prefixed targets (for example
discord:channel:123) resolve the
Target formats (-t, --target)
Channel name lookup: for providers with a directory (Discord/Slack/etc), names like Help or #help resolve via the directory cache, falling back to a live directory lookup on a cache miss where the provider supports it.
위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과
--help를 확인하세요.
| Channel | Format |
|---|---|
| Discord | channel:<id>, user:<id>, <@id> mention, or a bare numeric id (treated as a channel id) |
| Google Chat | spaces/<spaceId> or users/<userId> |
| iMessage | handle, chat_id:<id>, chat_guid:<guid>, or chat_identifier:<id> |
| Mattermost (plugin) | channel:<id>, user:<id>, @username, or a bare id (treated as a channel) |
| Matrix | @user:server, !room:server, or #alias:server |
| Microsoft Teams | conversation:<id> (19:...@thread.tacv2), a bare conversation id, or user:<aad-object-id> |
| Signal | +E.164, group:<id>, uuid:<id>, username:<name>/u:<name>, or any of these prefixed with signal: |
| Slack | channel:<id> or user:<id> (a bare id is treated as a channel) |
| Telegram | chat id, @username, or a forum topic target: <chatId>:topic:<topicId> (or --thread-id <topicId>) |
E.164, group JID (...@g.us), or Channel/Newsletter JID (...@newsletter) |
Common flags
Every action accepts: --channel , --account , --json, --dry-run, --verbose. Actions that take a destination also accept -t, --target .
위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과
--help를 확인하세요.
SecretRef resolution
openclaw message resolves channel SecretRefs before running the action, scoped as narrowly as possible:
위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과
--help를 확인하세요.
주요 항목:
- channel-scoped when
--channelis set (or inferred from a prefixed target) - account-scoped when
--accountis also set - all configured channels when neither is set
Actions
이 섹션의 세부 항목은 공식 문서 Actions를 참고하세요.
Core
| Action | Channels | Required | Notes |
|---|---|---|---|
send |
Discord, Google Chat, iMessage, Matrix, Mattermost (plugin), Microsoft Teams, Signal, Slack, Telegram, WhatsApp | --target, plus one of --message/--media/--presentation |
See Send below. |
poll |
Discord, Matrix, Microsoft Teams, Telegram, WhatsApp | --target, --poll-question, --poll-option (repeat) |
See Poll below. |
react |
Discord, Matrix, Nextcloud Talk, Signal, Slack, Telegram, WhatsApp | --message-id, --target |
--emoji, --remove (needs --emoji; omit it to clear own reactions where supported, see Reactions). WhatsApp: --participant, --from-me. Signal group reactions require --target-author or --target-author-uuid. Nextcloud Talk only adds reactions; --remove errors. |
reactions |
Discord, Matrix, Microsoft Teams, Slack | --message-id, --target |
--limit. |
read |
Discord, Matrix, Microsoft Teams, Slack | --target |
--limit, --message-id, --before, --after. Discord: --around, --include-thread. Slack: --message-id reads a specific timestamp, combine with --thread-id for an exact thread reply. |
edit |
Discord, Matrix, Microsoft Teams, Slack, Telegram | --message-id, --message, --target |
Telegram forum threads use --thread-id. |
delete |
Discord, Matrix, Microsoft Teams, Slack, Telegram | --message-id, --target |
|
pin / unpin |
Discord, Matrix, Microsoft Teams, Slack | --message-id, --target |
unpin also accepts --pinned-message-id (Microsoft Teams: the pin/list-pins resource id, not the chat message id). |
pins (list) |
Discord, Matrix, Microsoft Teams, Slack | --target |
--limit. |
permissions |
Discord, Matrix | --target |
Matrix: available only when encryption is enabled and verification actions are allowed. |
search |
Discord | --guild-id, --query |
--channel-id, --channel-ids (repeat), --author-id, --author-ids (repeat), --limit. |
member info |
Discord, Matrix, Microsoft Teams, Slack | --user-id |
--guild-id (Discord). |
Send
chart, table, buttons, and select blocks, rendered per channel capability. See Message Presentation.
위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과
--help를 확인하세요.
주요 항목:
--media <path-or-url>: attach image/audio/video/document (local path or--presentation <json>: shared payload withtext,context,divider,--delivery <json>: generic delivery preferences, for example `{"pin":--reply-to <id>,--thread-id <id>(Telegram forum topic; Slack thread--force-document(Telegram, WhatsApp): send images/GIFs/videos as--silent(Telegram, Discord): send without a notification.--gif-playback(WhatsApp only): treat video media as GIF playback.
openclaw message send --channel discord \
--target channel:123 --message "hi" --reply-to 456
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"}]}]}'
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"}]}'
Poll
--poll-anonymous / --poll-public, --thread-id.
위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과
--help를 확인하세요.
주요 항목:
--poll-option <choice>: repeat 2-12 times.--poll-multi: allow multiple selections.- Discord:
--poll-duration-hours,--silent,--message. - Telegram:
--poll-duration-seconds <n>(5-600),--silent,
openclaw message poll --channel discord \
--target channel:123 \
--poll-question "Snack?" \
--poll-option Pizza --poll-option Sushi \
--poll-multi --poll-duration-hours 48
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
Threads
(channel id). 선택: --message-id, --message, --auto-archive-min.
위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과
--help를 확인하세요.
주요 항목:
thread create: channels Discord. 필수:--thread-name,--targetthread list: channels Discord. 필수:--guild-id. 선택:thread reply: channels Discord. 필수:--target(thread id),
Emojis
주요 항목:
emoji list: Discord (--guild-id), Slack (no extra flags).emoji upload: Discord. 필수:--guild-id,--emoji-name,--media.
Stickers
--sticker-desc, --sticker-tags, --media.
위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과
--help를 확인하세요.
주요 항목:
sticker send: Discord. 필수:--target,--sticker-id(repeat).sticker upload: Discord. 필수:--guild-id,--sticker-name,
Roles, channels, voice, events (Discord)
optional --end-time, --desc, --channel-id, --location, --event-type, --image .
위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과
--help를 확인하세요.
주요 항목:
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: required--guild-id,--event-name,--start-time;
Moderation (Discord)
--until (omit both to clear the timeout), --reason.
위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과
--help를 확인하세요.
주요 항목:
timeout:--guild-id,--user-id; optional--duration-minorkick:--guild-id,--user-id,--reason.ban:--guild-id,--user-id,--delete-days,--reason.
Broadcast
Sends one payload to multiple targets. --targets takes a space-separated list. Use --channel all to target every configured provider.
위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과
--help를 확인하세요.
openclaw message broadcast --targets <target...> [--channel all] [--message <text>] [--media <url>] [--dry-run]
관련 문서
주요 항목:
- CLI reference
- Agent send
- Message Presentation
실습 체크리스트
- 공식 문서와 로컬 버전을 대조합니다:
https://docs.openclaw.ai/cli/message - 관련 CLI는
openclaw --help및 하위 명령--help로 옵션을 확인합니다. - 설정 변경 시
openclaw config/openclaw doctor로 유효성을 검사합니다. - Gateway·채널·플러그인 변경 후에는 필요 시 Gateway를 재시작합니다.
자주 쓰는 명령·설정 예시
openclaw message <subcommand> [flags]
openclaw message send --channel discord \
--target channel:123 --message "hi" --reply-to 456
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"}]}]}'
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"}]}'
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}]}'
관련 링크
- 공식 원문: cli/message
- OpenClaw 문서 홈
이 가이드는 공식 문서를 한국어 학습용으로 재구성한 것입니다. 옵션 기본값·플래그 이름은 설치 버전에 따라 달라질 수 있습니다.