let5see/clawdbot
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: align reaction semantics

Browse Source
This commit is contained in:
Peter Steinberger
2026-01-11 03:42:34 +00:00
parent 1fc213468b
commit d7055f8fd2
2 changed files with 14 additions and 13 deletions
Download Patch File Download Diff File Expand all files Collapse all files

17
docs/cli/message.md
View File

@@ -59,44 +59,45 @@ Target formats (`--to`):
- `react` - `react`
- Providers: Discord/Slack/Telegram/WhatsApp - Providers: Discord/Slack/Telegram/WhatsApp
- Required: `--to`, `--message-id` - Required: `--message-id`, `--to` or `--channel-id`
- Optional: `--emoji`, `--remove`, `--participant`, `--from-me`, `--channel-id` - Optional: `--emoji`, `--remove`, `--participant`, `--from-me`, `--channel-id`
- Note: `--remove` requires `--emoji` (omit `--emoji` to clear own reactions where supported; see /tools/reactions)
- WhatsApp only: `--participant`, `--from-me` - WhatsApp only: `--participant`, `--from-me`
- `reactions` - `reactions`
- Providers: Discord/Slack - Providers: Discord/Slack
- Required: `--to`, `--message-id` - Required: `--message-id`, `--to` or `--channel-id`
- Optional: `--limit`, `--channel-id` - Optional: `--limit`, `--channel-id`
- `read` - `read`
- Providers: Discord/Slack - Providers: Discord/Slack
- Required: `--to` - Required: `--to` or `--channel-id`
- Optional: `--limit`, `--before`, `--after`, `--channel-id` - Optional: `--limit`, `--before`, `--after`, `--channel-id`
- Discord only: `--around` - Discord only: `--around`
- `edit` - `edit`
- Providers: Discord/Slack - Providers: Discord/Slack
- Required: `--to`, `--message-id`, `--message` - Required: `--message-id`, `--message`, `--to` or `--channel-id`
- Optional: `--channel-id` - Optional: `--channel-id`
- `delete` - `delete`
- Providers: Discord/Slack - Providers: Discord/Slack
- Required: `--to`, `--message-id` - Required: `--message-id`, `--to` or `--channel-id`
- Optional: `--channel-id` - Optional: `--channel-id`
- `pin` / `unpin` - `pin` / `unpin`
- Providers: Discord/Slack - Providers: Discord/Slack
- Required: `--to`, `--message-id` - Required: `--message-id`, `--to` or `--channel-id`
- Optional: `--channel-id` - Optional: `--channel-id`
- `pins` (list) - `pins` (list)
- Providers: Discord/Slack - Providers: Discord/Slack
- Required: `--to` - Required: `--to` or `--channel-id`
- Optional: `--channel-id` - Optional: `--channel-id`
- `permissions` - `permissions`
- Providers: Discord - Providers: Discord
- Required: `--to` - Required: `--to` or `--channel-id`
- Optional: `--channel-id` - Optional: `--channel-id`
- `search` - `search`

10
docs/tools/reactions.md
View File

@@ -7,13 +7,13 @@ read_when:
Shared reaction semantics across providers: Shared reaction semantics across providers:
- `emoji` is required for reactions. - `emoji` is required when adding a reaction.
- `emoji=""` removes the bot's reaction(s) on the message. - `emoji=""` (or omitting `emoji`) removes the bot's reaction(s) when supported.
- `remove: true` removes the specified emoji when supported. - `remove: true` removes the specified emoji when supported (requires `emoji`).
Provider notes: Provider notes:
- **Discord/Slack**: empty `emoji` removes all of the bot's reactions on the message; `remove: true` removes just that emoji. - **Discord/Slack**: empty `emoji` removes all of the bot's reactions on the message; `remove: true` removes just that emoji.
- **Telegram**: `remove: true` removes your own reaction (Bot API limitation). - **Telegram**: empty `emoji` removes the bot's reactions; `remove: true` also removes reactions but still requires a non-empty `emoji` for tool validation.
- **WhatsApp**: `remove: true` maps to empty emoji (remove bot reaction). - **WhatsApp**: empty `emoji` removes the bot reaction; `remove: true` maps to empty emoji (still requires `emoji`).
- **Signal**: inbound reaction notifications emit system events when `signal.reactionNotifications` is enabled. - **Signal**: inbound reaction notifications emit system events when `signal.reactionNotifications` is enabled.