From c7ffa28980e7ebc8fd4e4b3508970f7597f36649 Mon Sep 17 00:00:00 2001 From: Peter Steinberger Date: Tue, 6 Jan 2026 20:45:44 +0000 Subject: [PATCH] docs: update provider command refs --- README.md | 2 +- docs/discord.md | 1 + docs/slack.md | 5 ++++- 3 files changed, 6 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index ca59caf04..3048cf42c 100644 --- a/README.md +++ b/README.md @@ -321,7 +321,7 @@ Details: [Security guide](https://docs.clawd.bot/security) · [Docker + sandboxi ### [Discord](https://docs.clawd.bot/discord) - Set `DISCORD_BOT_TOKEN` or `discord.token` (env wins). -- Optional: set `discord.slashCommand`, `discord.dm.allowFrom`, `discord.guilds`, or `discord.mediaMaxMb` as needed. +- Optional: set `commands.native`, `commands.text`, or `commands.useAccessGroups`, plus `discord.dm.allowFrom`, `discord.guilds`, or `discord.mediaMaxMb` as needed. ```json5 { diff --git a/docs/discord.md b/docs/discord.md index 541b222f9..6b006c068 100644 --- a/docs/discord.md +++ b/docs/discord.md @@ -30,6 +30,7 @@ Status: ready for DM and guild text channels via the official Discord bot gatewa 8. Group DMs are ignored by default; enable via `discord.dm.groupEnabled` and optionally restrict by `discord.dm.groupChannels`. 9. Optional guild rules: set `discord.guilds` keyed by guild id (preferred) or slug, with per-channel rules. 10. Optional native commands: set `commands.native: true` to register native commands in Discord; set `commands.native: false` to clear previously registered native commands. Text commands are controlled by `commands.text` and must be sent as standalone `/...` messages. Use `commands.useAccessGroups: false` to bypass access-group checks for commands. + - Full command list + config: https://docs.clawd.bot/slash-commands 11. Optional guild context history: set `discord.historyLimit` (default 20) to include the last N guild messages as context when replying to a mention. Set `0` to disable. 12. Reactions: the agent can trigger reactions via the `discord` tool (gated by `discord.actions.*`). - The `discord` tool is only exposed when the current provider is Discord. diff --git a/docs/slack.md b/docs/slack.md index fa5ad42f5..a70822116 100644 --- a/docs/slack.md +++ b/docs/slack.md @@ -17,7 +17,7 @@ read_when: "Setting up Slack or debugging Slack socket mode" - `channel_rename` - `pin_added`, `pin_removed` 5) Invite the bot to channels you want it to read. -6) Slash Commands → create the `/clawd` command (or your preferred name). +6) Slash Commands → create `/clawd` if you use `slack.slashCommand`. If you enable `commands.native`, add slash commands for the built-in chat commands (same names as `/help`). 7) App Home → enable the **Messages Tab** so users can DM the bot. Use the manifest below so scopes and events stay in sync. @@ -98,6 +98,8 @@ Use this Slack app manifest to create the app quickly (adjust the name/command i } ``` +If you enable `commands.native`, add one `slash_commands` entry per command you want to expose (matching the `/help` list). + ## Scopes (current vs optional) Slack's Conversations API is type-scoped: you only need the scopes for the conversation types you actually touch (channels, groups, im, mpim). See @@ -190,6 +192,7 @@ Ack reactions are controlled globally via `messages.ackReaction` + - Channels map to `slack:channel:` sessions. - Slash commands use `slack:slash:` sessions. - Native command registration is controlled by `commands.native`; text commands require standalone `/...` messages and can be disabled with `commands.text: false`. Slack slash commands are managed in the Slack app and are not removed automatically. Use `commands.useAccessGroups: false` to bypass access-group checks for commands. +- Full command list + config: https://docs.clawd.bot/slash-commands ## DM security (pairing) - Default: `slack.dm.policy="pairing"` — unknown DM senders get a pairing code.