@@ -25,12 +25,147 @@ Production-ready for DMs and channels via Slack app integrations. Default mode i
2525<Tab title="Socket Mode (default)">
2626<Steps>
2727 <Step title="Create a new Slack app">
28- In Slack app settings press the **[Create New App](https://api.slack.com/apps/new)** button:
28+ Open [api.slack.com/apps](https://api.slack.com/apps/new) → **Create New App** → **From a manifest** → select your workspace → paste one of the manifests below → **Next** → **Create**.
292930- - choose **from a manifest** and select a workspace for your app
31- - paste the [example manifest](#manifest-and-scope-checklist) from below and continue to create
32- - generate an **App-Level Token** (`xapp-...`) with `connections:write`
33- - install app and copy the **Bot Token** (`xoxb-...`) shown
30+ <CodeGroup>
31+32+```json Recommended
33+{
34+"display_information": {
35+"name": "OpenClaw",
36+"description": "Slack connector for OpenClaw"
37+ },
38+"features": {
39+"bot_user": { "display_name": "OpenClaw", "always_online": true },
40+"app_home": {
41+"home_tab_enabled": true,
42+"messages_tab_enabled": true,
43+"messages_tab_read_only_enabled": false
44+ },
45+"slash_commands": [
46+ {
47+"command": "/openclaw",
48+"description": "Send a message to OpenClaw",
49+"should_escape": false
50+ }
51+ ]
52+ },
53+"oauth_config": {
54+"scopes": {
55+"bot": [
56+"app_mentions:read",
57+"assistant:write",
58+"channels:history",
59+"channels:read",
60+"chat:write",
61+"commands",
62+"emoji:read",
63+"files:read",
64+"files:write",
65+"groups:history",
66+"groups:read",
67+"im:history",
68+"im:read",
69+"im:write",
70+"mpim:history",
71+"mpim:read",
72+"mpim:write",
73+"pins:read",
74+"pins:write",
75+"reactions:read",
76+"reactions:write",
77+"usergroups:read",
78+"users:read"
79+ ]
80+ }
81+ },
82+"settings": {
83+"socket_mode_enabled": true,
84+"event_subscriptions": {
85+"bot_events": [
86+"app_home_opened",
87+"app_mention",
88+"channel_rename",
89+"member_joined_channel",
90+"member_left_channel",
91+"message.channels",
92+"message.groups",
93+"message.im",
94+"message.mpim",
95+"pin_added",
96+"pin_removed",
97+"reaction_added",
98+"reaction_removed"
99+ ]
100+ }
101+ }
102+}
103+```
104+105+```json Minimal
106+{
107+"display_information": {
108+"name": "OpenClaw",
109+"description": "Slack connector for OpenClaw"
110+ },
111+"features": {
112+"bot_user": { "display_name": "OpenClaw", "always_online": true },
113+"app_home": {
114+"home_tab_enabled": true,
115+"messages_tab_enabled": true,
116+"messages_tab_read_only_enabled": false
117+ },
118+"slash_commands": [
119+ {
120+"command": "/openclaw",
121+"description": "Send a message to OpenClaw",
122+"should_escape": false
123+ }
124+ ]
125+ },
126+"oauth_config": {
127+"scopes": {
128+"bot": [
129+"app_mentions:read",
130+"assistant:write",
131+"channels:history",
132+"channels:read",
133+"chat:write",
134+"commands",
135+"groups:history",
136+"groups:read",
137+"im:history",
138+"im:read",
139+"im:write",
140+"users:read"
141+ ]
142+ }
143+ },
144+"settings": {
145+"socket_mode_enabled": true,
146+"event_subscriptions": {
147+"bot_events": [
148+"app_home_opened",
149+"app_mention",
150+"message.channels",
151+"message.groups",
152+"message.im"
153+ ]
154+ }
155+ }
156+}
157+```
158+159+ </CodeGroup>
160+161+ <Note>
162+ **Recommended** matches the bundled Slack plugin's full feature set: App Home, slash commands, files, reactions, pins, group DMs, and emoji/usergroup reads. Pick **Minimal** when workspace policy restricts scopes — it covers DMs, channel/group history, mentions, and slash commands but drops files, reactions, pins, group-DM (`mpim:*`), `emoji:read`, and `usergroups:read`. See [Manifest and scope checklist](#manifest-and-scope-checklist) for per-scope rationale and additive options like extra slash commands.
163+ </Note>
164+165+ After Slack creates the app:
166+167+ - **Basic Information → App-Level Tokens → Generate Token and Scopes**: add `connections:write`, save, copy the `xapp-...` value.
168+ - **Install App → Install to Workspace**: copy the `xoxb-...` Bot User OAuth Token.
3416935170 </Step>
36171@@ -80,12 +215,159 @@ openclaw gateway
80215<Tab title="HTTP Request URLs">
81216<Steps>
82217 <Step title="Create a new Slack app">
83- In Slack app settings press the **[Create New App](https://api.slack.com/apps/new)** button:
218+ Open [api.slack.com/apps](https://api.slack.com/apps/new) → **Create New App** → **From a manifest** → select your workspace → paste one of the manifests below → replace `https://gateway-host.example.com/slack/events` with your public Gateway URL → **Next** → **Create**.
219+220+ <CodeGroup>
221+222+```json Recommended
223+{
224+"display_information": {
225+"name": "OpenClaw",
226+"description": "Slack connector for OpenClaw"
227+ },
228+"features": {
229+"bot_user": { "display_name": "OpenClaw", "always_online": true },
230+"app_home": {
231+"home_tab_enabled": true,
232+"messages_tab_enabled": true,
233+"messages_tab_read_only_enabled": false
234+ },
235+"slash_commands": [
236+ {
237+"command": "/openclaw",
238+"description": "Send a message to OpenClaw",
239+"should_escape": false,
240+"url": "https://gateway-host.example.com/slack/events"
241+ }
242+ ]
243+ },
244+"oauth_config": {
245+"scopes": {
246+"bot": [
247+"app_mentions:read",
248+"assistant:write",
249+"channels:history",
250+"channels:read",
251+"chat:write",
252+"commands",
253+"emoji:read",
254+"files:read",
255+"files:write",
256+"groups:history",
257+"groups:read",
258+"im:history",
259+"im:read",
260+"im:write",
261+"mpim:history",
262+"mpim:read",
263+"mpim:write",
264+"pins:read",
265+"pins:write",
266+"reactions:read",
267+"reactions:write",
268+"usergroups:read",
269+"users:read"
270+ ]
271+ }
272+ },
273+"settings": {
274+"event_subscriptions": {
275+"request_url": "https://gateway-host.example.com/slack/events",
276+"bot_events": [
277+"app_home_opened",
278+"app_mention",
279+"channel_rename",
280+"member_joined_channel",
281+"member_left_channel",
282+"message.channels",
283+"message.groups",
284+"message.im",
285+"message.mpim",
286+"pin_added",
287+"pin_removed",
288+"reaction_added",
289+"reaction_removed"
290+ ]
291+ },
292+"interactivity": {
293+"is_enabled": true,
294+"request_url": "https://gateway-host.example.com/slack/events",
295+"message_menu_options_url": "https://gateway-host.example.com/slack/events"
296+ }
297+ }
298+}
299+```
300+301+```json Minimal
302+{
303+"display_information": {
304+"name": "OpenClaw",
305+"description": "Slack connector for OpenClaw"
306+ },
307+"features": {
308+"bot_user": { "display_name": "OpenClaw", "always_online": true },
309+"app_home": {
310+"home_tab_enabled": true,
311+"messages_tab_enabled": true,
312+"messages_tab_read_only_enabled": false
313+ },
314+"slash_commands": [
315+ {
316+"command": "/openclaw",
317+"description": "Send a message to OpenClaw",
318+"should_escape": false,
319+"url": "https://gateway-host.example.com/slack/events"
320+ }
321+ ]
322+ },
323+"oauth_config": {
324+"scopes": {
325+"bot": [
326+"app_mentions:read",
327+"assistant:write",
328+"channels:history",
329+"channels:read",
330+"chat:write",
331+"commands",
332+"groups:history",
333+"groups:read",
334+"im:history",
335+"im:read",
336+"im:write",
337+"users:read"
338+ ]
339+ }
340+ },
341+"settings": {
342+"event_subscriptions": {
343+"request_url": "https://gateway-host.example.com/slack/events",
344+"bot_events": [
345+"app_home_opened",
346+"app_mention",
347+"message.channels",
348+"message.groups",
349+"message.im"
350+ ]
351+ },
352+"interactivity": {
353+"is_enabled": true,
354+"request_url": "https://gateway-host.example.com/slack/events",
355+"message_menu_options_url": "https://gateway-host.example.com/slack/events"
356+ }
357+ }
358+}
359+```
360+361+ </CodeGroup>
362+363+ <Note>
364+ **Recommended** matches the bundled Slack plugin's full feature set; **Minimal** drops files, reactions, pins, group-DM (`mpim:*`), `emoji:read`, and `usergroups:read` for restrictive workspaces. See [Manifest and scope checklist](#manifest-and-scope-checklist) for per-scope rationale.
365+ </Note>
366+367+ After Slack creates the app:
8436885- - choose **from a manifest** and select a workspace for your app
86- - paste the [example manifest](#manifest-and-scope-checklist) and update the URLs before create
87- - save the **Signing Secret** for request verification
88- - install app and copy the **Bot Token** (`xoxb-...`) shown
369+ - **Basic Information → App Credentials**: copy the **Signing Secret** for request verification.
370+ - **Install App → Install to Workspace**: copy the `xoxb-...` Bot User OAuth Token.
8937190372 </Step>
91373此内容由惯性聚合(RSS阅读器)自动聚合整理，仅供阅读参考。 原文来自 — 版权归原作者所有。