@openclaw/discord 2026.7.2-beta.7 → 2026.8.1-beta.3

package/openclaw.plugin.json

@@ -1,5 +1,9 @@
 {
   "id": "discord",
+  "doctorContract": {
+    "configRepair": true,
+    "stateMigrations": true
+  },
   "name": "Discord",
   "description": "OpenClaw Discord channel plugin for channels, DMs, commands, and app events.",
   "icon": "https://cdn.simpleicons.org/discord",
@@ -13,10 +17,6 @@
     "discord"
   ],
   "contracts": {
-    "tools": [
-      "show_widget",
-      "discord_widget"
-    ],
     "transcriptSourceProviders": [
       "discord-voice"
     ]
@@ -256,13 +256,6 @@
                     "exclusiveMinimum": 0,
                     "maximum": 9007199254740991
                   },
-                  "render": {
-                    "type": "string",
-                    "enum": [
-                      "text",
-                      "rich"
-                    ]
-                  },
                   "toolProgress": {
                     "type": "boolean"
                   },
@@ -424,6 +417,29 @@
                     ],
                     "additionalProperties": false
                   },
+                  {
+                    "type": "object",
+                    "properties": {
+                      "source": {
+                        "type": "string",
+                        "const": "store"
+                      },
+                      "provider": {
+                        "type": "string",
+                        "pattern": "^[a-z][a-z0-9_-]{0,63}$"
+                      },
+                      "id": {
+                        "type": "string",
+                        "pattern": "^[A-Z][A-Z0-9_]{0,127}$"
+                      }
+                    },
+                    "required": [
+                      "source",
+                      "provider",
+                      "id"
+                    ],
+                    "additionalProperties": false
+                  },
                   {
                     "type": "object",
                     "properties": {
@@ -1009,6 +1025,9 @@
           "intents": {
             "type": "object",
             "properties": {
+              "messageContent": {
+                "type": "boolean"
+              },
               "presence": {
                 "type": "boolean"
               },
@@ -1158,6 +1177,9 @@
                     "channelId": {
                       "type": "string",
                       "minLength": 1
+                    },
+                    "whenOccupied": {
+                      "type": "boolean"
                     }
                   },
                   "required": [
@@ -1365,6 +1387,29 @@
                                           "id"
                                         ],
                                         "additionalProperties": false
+                                      },
+                                      {
+                                        "type": "object",
+                                        "properties": {
+                                          "source": {
+                                            "type": "string",
+                                            "const": "store"
+                                          },
+                                          "provider": {
+                                            "type": "string",
+                                            "pattern": "^[a-z][a-z0-9_-]{0,63}$"
+                                          },
+                                          "id": {
+                                            "type": "string",
+                                            "pattern": "^[A-Z][A-Z0-9_]{0,127}$"
+                                          }
+                                        },
+                                        "required": [
+                                          "source",
+                                          "provider",
+                                          "id"
+                                        ],
+                                        "additionalProperties": false
                                       }
                                     ]
                                   }
@@ -1518,6 +1563,29 @@
                                     "id"
                                   ],
                                   "additionalProperties": false
+                                },
+                                {
+                                  "type": "object",
+                                  "properties": {
+                                    "source": {
+                                      "type": "string",
+                                      "const": "store"
+                                    },
+                                    "provider": {
+                                      "type": "string",
+                                      "pattern": "^[a-z][a-z0-9_-]{0,63}$"
+                                    },
+                                    "id": {
+                                      "type": "string",
+                                      "pattern": "^[A-Z][A-Z0-9_]{0,127}$"
+                                    }
+                                  },
+                                  "required": [
+                                    "source",
+                                    "provider",
+                                    "id"
+                                  ],
+                                  "additionalProperties": false
                                 }
                               ]
                             }
@@ -1605,6 +1673,29 @@
                         ],
                         "additionalProperties": false
                       },
+                      {
+                        "type": "object",
+                        "properties": {
+                          "source": {
+                            "type": "string",
+                            "const": "store"
+                          },
+                          "provider": {
+                            "type": "string",
+                            "pattern": "^[a-z][a-z0-9_-]{0,63}$"
+                          },
+                          "id": {
+                            "type": "string",
+                            "pattern": "^[A-Z][A-Z0-9_]{0,127}$"
+                          }
+                        },
+                        "required": [
+                          "source",
+                          "provider",
+                          "id"
+                        ],
+                        "additionalProperties": false
+                      },
                       {
                         "type": "object",
                         "properties": {
@@ -1976,13 +2067,6 @@
                           "exclusiveMinimum": 0,
                           "maximum": 9007199254740991
                         },
-                        "render": {
-                          "type": "string",
-                          "enum": [
-                            "text",
-                            "rich"
-                          ]
-                        },
                         "toolProgress": {
                           "type": "boolean"
                         },
@@ -2144,6 +2228,29 @@
                           ],
                           "additionalProperties": false
                         },
+                        {
+                          "type": "object",
+                          "properties": {
+                            "source": {
+                              "type": "string",
+                              "const": "store"
+                            },
+                            "provider": {
+                              "type": "string",
+                              "pattern": "^[a-z][a-z0-9_-]{0,63}$"
+                            },
+                            "id": {
+                              "type": "string",
+                              "pattern": "^[A-Z][A-Z0-9_]{0,127}$"
+                            }
+                          },
+                          "required": [
+                            "source",
+                            "provider",
+                            "id"
+                          ],
+                          "additionalProperties": false
+                        },
                         {
                           "type": "object",
                           "properties": {
@@ -2729,6 +2836,9 @@
                 "intents": {
                   "type": "object",
                   "properties": {
+                    "messageContent": {
+                      "type": "boolean"
+                    },
                     "presence": {
                       "type": "boolean"
                     },
@@ -2878,6 +2988,9 @@
                           "channelId": {
                             "type": "string",
                             "minLength": 1
+                          },
+                          "whenOccupied": {
+                            "type": "boolean"
                           }
                         },
                         "required": [
@@ -3085,6 +3198,29 @@
                                                 "id"
                                               ],
                                               "additionalProperties": false
+                                            },
+                                            {
+                                              "type": "object",
+                                              "properties": {
+                                                "source": {
+                                                  "type": "string",
+                                                  "const": "store"
+                                                },
+                                                "provider": {
+                                                  "type": "string",
+                                                  "pattern": "^[a-z][a-z0-9_-]{0,63}$"
+                                                },
+                                                "id": {
+                                                  "type": "string",
+                                                  "pattern": "^[A-Z][A-Z0-9_]{0,127}$"
+                                                }
+                                              },
+                                              "required": [
+                                                "source",
+                                                "provider",
+                                                "id"
+                                              ],
+                                              "additionalProperties": false
                                             }
                                           ]
                                         }
@@ -3238,6 +3374,29 @@
                                           "id"
                                         ],
                                         "additionalProperties": false
+                                      },
+                                      {
+                                        "type": "object",
+                                        "properties": {
+                                          "source": {
+                                            "type": "string",
+                                            "const": "store"
+                                          },
+                                          "provider": {
+                                            "type": "string",
+                                            "pattern": "^[a-z][a-z0-9_-]{0,63}$"
+                                          },
+                                          "id": {
+                                            "type": "string",
+                                            "pattern": "^[A-Z][A-Z0-9_]{0,127}$"
+                                          }
+                                        },
+                                        "required": [
+                                          "source",
+                                          "provider",
+                                          "id"
+                                        ],
+                                        "additionalProperties": false
                                       }
                                     ]
                                   }
@@ -3325,6 +3484,29 @@
                               ],
                               "additionalProperties": false
                             },
+                            {
+                              "type": "object",
+                              "properties": {
+                                "source": {
+                                  "type": "string",
+                                  "const": "store"
+                                },
+                                "provider": {
+                                  "type": "string",
+                                  "pattern": "^[a-z][a-z0-9_-]{0,63}$"
+                                },
+                                "id": {
+                                  "type": "string",
+                                  "pattern": "^[A-Z][A-Z0-9_]{0,127}$"
+                                }
+                              },
+                              "required": [
+                                "source",
+                                "provider",
+                                "id"
+                              ],
+                              "additionalProperties": false
+                            },
                             {
                               "type": "object",
                               "properties": {
@@ -3521,11 +3703,11 @@
         },
         "streaming": {
           "label": "Discord Streaming Mode",
-          "help": "Unified Discord stream preview mode: \"off\" | \"partial\" | \"block\" | \"progress\". \"progress\" keeps a single editable progress draft until final delivery. Legacy boolean/streamMode keys are auto-mapped."
+          "help": "Discord preview streaming is off by default. Set mode to \"partial\", \"block\", or \"progress\" to opt in. Run openclaw doctor --fix to migrate legacy keys."
         },
         "streaming.mode": {
           "label": "Discord Streaming Mode",
-          "help": "Canonical Discord preview mode: \"off\" | \"partial\" | \"block\" | \"progress\"."
+          "help": "Discord preview mode: \"off\" | \"partial\" | \"block\" | \"progress\". Default: \"off\"."
         },
         "streaming.chunkMode": {
           "label": "Discord Chunk Mode",
@@ -3533,7 +3715,7 @@
         },
         "streaming.block.enabled": {
           "label": "Discord Block Streaming Enabled",
-          "help": "Enable chunked block-style Discord preview delivery when channels.discord.streaming.mode=\"block\"."
+          "help": "Enable normal Discord block replies. This takes precedence over editable preview delivery."
         },
         "streaming.block.coalesce": {
           "label": "Discord Block Streaming Coalesce",
@@ -3557,7 +3739,7 @@
         },
         "streaming.preview.commandText": {
           "label": "Discord Draft Command Text",
-          "help": "Command/exec detail in preview tool-progress lines: \"raw\" preserves released behavior; \"status\" shows only the tool label."
+          "help": "Command/exec detail in preview tool-progress lines: \"status\" is the safe default; \"raw\" opts into command text."
         },
         "streaming.progress.label": {
           "label": "Discord Progress Label",
@@ -3585,7 +3767,7 @@
         },
         "streaming.progress.commandText": {
           "label": "Discord Progress Command Text",
-          "help": "Command/exec detail in progress draft lines: \"raw\" preserves released behavior; \"status\" shows only the tool label."
+          "help": "Command/exec detail in progress draft lines: \"status\" is the safe default; \"raw\" opts into command text."
         },
         "proxy": {
           "label": "Discord Proxy URL",
@@ -3627,6 +3809,10 @@
           "label": "Discord Component TTL (ms)",
           "help": "How long sent Discord component callbacks remain registered. Default is 1800000 (30 minutes); maximum is 86400000 (24 hours)."
         },
+        "intents.messageContent": {
+          "label": "Discord Message Content Intent",
+          "help": "Request the privileged Message Content intent (default: true). Set false only for mention-only guild operation when Discord cannot grant the intent; DMs and explicit mentions still include message content."
+        },
         "intents.presence": {
           "label": "Discord Presence Intent",
           "help": "Enable the Guild Presences privileged intent. Must also be enabled in the Discord Developer Portal. Allows tracking user activities (e.g. Spotify). Default: false."
@@ -3718,7 +3904,11 @@
         },
         "voice.autoJoin": {
           "label": "Discord Voice Auto-Join",
-          "help": "Voice channels to auto-join on startup (list of guildId/channelId entries)."
+          "help": "Voice channels to auto-join (list of guildId/channelId entries). Set whenOccupied on an entry to connect only while humans are present."
+        },
+        "voice.autoJoin.*.whenOccupied": {
+          "label": "Discord Voice Auto-Join When Occupied",
+          "help": "Join and remain in this auto-managed voice channel only while at least one human is present. The OpenClaw bot and other bots do not count. Default: false."
         },
         "voice.allowedChannels": {
           "label": "Discord Voice Allowed Channels",
@@ -3851,7 +4041,7 @@
         },
         "activities": {
           "label": "Discord Activities",
-          "help": "Enable Discord Activity widgets for this account. Routes, the agent tool, and the launch handler remain disabled when this block is absent."
+          "help": "Enable the Discord Activity presenter for the core show_widget tool on this account. Activity routes and the launch handler remain disabled when this block is absent."
         },
         "activities.clientSecret": {
           "label": "Discord Activities Client Secret",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openclaw/discord",
-  "version": "2026.7.2-beta.7",
+  "version": "2026.8.1-beta.3",
   "description": "OpenClaw Discord channel plugin for channels, DMs, commands, and app events.",
   "repository": {
     "type": "git",
@@ -13,14 +13,13 @@
     "discord-api-types": "0.38.52",
     "libopus-wasm": "0.2.0",
     "mdast-util-from-markdown": "2.0.3",
-    "p-map": "7.0.6",
     "typebox": "1.3.6",
     "undici": "8.9.0",
     "ws": "8.21.1",
     "zod": "4.4.3"
   },
   "peerDependencies": {
-    "openclaw": ">=2026.7.2-beta.7"
+    "openclaw": ">=2026.8.1-beta.3"
   },
   "peerDependenciesMeta": {
     "openclaw": {
@@ -32,9 +31,6 @@
       "./index.ts"
     ],
     "setupEntry": "./dist/setup-entry.js",
-    "setupFeatures": {
-      "legacyStateMigrations": true
-    },
     "channel": {
       "id": "discord",
       "configuredState": {
@@ -73,13 +69,22 @@
             "cli": {
               "flags": "--use-env",
               "description": "Use DISCORD_BOT_TOKEN"
-            }
+            },
+            "envVars": [
+              "DISCORD_BOT_TOKEN"
+            ]
           }
         ]
       },
       "commands": {
         "nativeCommandsAutoEnabled": true,
         "nativeSkillsAutoEnabled": true
+      },
+      "doctorCapabilities": {
+        "dmAllowFromMode": "topOnly",
+        "groupModel": "route",
+        "groupAllowFromFallbackToAllowFrom": false,
+        "warnOnEmptyGroupSenderAllowlist": false
       }
     },
     "install": {
@@ -89,10 +94,10 @@
       "allowInvalidConfigRecovery": true
     },
     "compat": {
-      "pluginApi": ">=2026.7.2-beta.7"
+      "pluginApi": ">=2026.8.1-beta.3"
     },
     "build": {
-      "openclawVersion": "2026.7.2-beta.7",
+      "openclawVersion": "2026.8.1-beta.3",
       "staticAssets": [
         {
           "source": "./assets/embedded-app-sdk.mjs",
@@ -101,7 +106,7 @@
       ]
     },
     "assetScripts": {
-      "build": "node ../../scripts/build-discord-activity-sdk.mjs"
+      "build": "node --import tsx ../../scripts/build-discord-activity-sdk.mts"
     },
     "release": {
       "publishToClawHub": true,
@@ -124,7 +129,6 @@
     "discord-api-types",
     "libopus-wasm",
     "mdast-util-from-markdown",
-    "p-map",
     "typebox",
     "undici",
     "ws",

package/skills/discord/SKILL.md

@@ -1,136 +1,43 @@
 ---
 name: discord
-description: "Discord message-tool ops: send/read/edit/delete, react, poll, pin, thread, search, presence, media/components."
+description: "Discord messaging workflows through OpenClaw's message tool."
 metadata: { "openclaw": { "emoji": "🎮", "requires": { "config": ["channels.discord.token"] } } }
 allowed-tools: ["message"]
 ---
 
 # Discord
 
-Use the `message` tool with `channel: "discord"`. No separate Discord tool.
+Use the `message` tool with `channel: "discord"`. The tool schema lists the actions enabled by the current account's `channels.discord.actions.*` gates; do not assume unavailable actions.
 
-## Rules
+## Workflow
 
-- Respect `channels.discord.actions.*` gates.
-- Prefer explicit `guildId`, `channelId`, `messageId`, `userId`.
-- Multi-account: pass `accountId` when needed.
-- Send targets: `to: "channel:<id>"` or `to: "user:<id>"`.
-- Mention users as `<@USER_ID>`.
-- Avoid Markdown tables in outbound Discord messages.
-- Prefer components v2 for rich UI; do not mix v2 `components` with legacy `embeds`.
+- Prefer stable `guildId`, `channelId`, `messageId`, and `userId` values from context. Pass `accountId` when more than one Discord account could apply.
+- Resolve the exact message before editing, deleting, pinning, moderating, or reacting when the user's reference is ambiguous.
+- Keep thread replies in their existing thread. A forum parent cannot receive components; send components to the created forum thread instead.
+- Confirm destructive or moderation actions unless the user already specified the exact target and action.
 
-## Common actions
+## Interactive components
 
-Send:
-
-```json
-{ "action": "send", "channel": "discord", "to": "channel:123", "message": "hello", "silent": true }
-```
-
-Send media:
-
-```json
-{
-  "action": "send",
-  "channel": "discord",
-  "to": "channel:123",
-  "message": "see attachment",
-  "media": "file:///tmp/example.png"
-}
-```
-
-Components v2:
+`components` must be a structured object or native component array, never a placeholder string. Do not combine components v2 with legacy `embeds`.
 
 ```json
 {
   "action": "send",
   "channel": "discord",
   "to": "channel:123",
-  "message": "Status",
-  "components": "[Carbon v2 components]"
-}
-```
-
-React:
-
-```json
-{ "action": "react", "channel": "discord", "channelId": "123", "messageId": "456", "emoji": "👍" }
-```
-
-Read:
-
-```json
-{ "action": "read", "channel": "discord", "to": "channel:123", "limit": 20 }
-```
-
-Edit/delete:
-
-```json
-{
-  "action": "edit",
-  "channel": "discord",
-  "channelId": "123",
-  "messageId": "456",
-  "message": "fixed typo"
+  "message": "Choose an option",
+  "components": {
+    "blocks": [
+      {
+        "type": "actions",
+        "buttons": [
+          { "label": "Approve", "style": "success", "callbackData": "approve" },
+          { "label": "Decline", "style": "danger", "callbackData": "decline" }
+        ]
+      }
+    ]
+  }
 }
 ```
 
-```json
-{ "action": "delete", "channel": "discord", "channelId": "123", "messageId": "456" }
-```
-
-Poll:
-
-```json
-{
-  "action": "poll",
-  "channel": "discord",
-  "to": "channel:123",
-  "pollQuestion": "Lunch?",
-  "pollOption": ["Pizza", "Sushi"],
-  "pollDurationHours": 24
-}
-```
-
-Pin:
-
-```json
-{ "action": "pin", "channel": "discord", "channelId": "123", "messageId": "456" }
-```
-
-Thread:
-
-```json
-{
-  "action": "thread-create",
-  "channel": "discord",
-  "channelId": "123",
-  "messageId": "456",
-  "threadName": "bug triage"
-}
-```
-
-Search:
-
-```json
-{
-  "action": "search",
-  "channel": "discord",
-  "guildId": "999",
-  "query": "release notes",
-  "channelIds": ["123"],
-  "limit": 10
-}
-```
-
-Presence, often gated:
-
-```json
-{
-  "action": "set-presence",
-  "channel": "discord",
-  "activityType": "playing",
-  "activityName": "OpenClaw",
-  "status": "online"
-}
-```
+Discord mention syntax, component availability, and form hints are injected automatically. Follow the current hints and tool schema rather than a duplicated action catalog.