OpenClaw Slack Not Connecting — Causes & Fixes

When OpenClaw isn't connecting to Slack, messages go undelivered and your agent goes dark. Here's the systematic way to diagnose and fix it.

Problem

Your OpenClaw agent isn't responding in Slack. Messages are sent but no response comes, or the agent shows as offline. Alternatively, the gateway starts but reports "Slack: disconnected" in its status output.

Common Causes

• Slack OAuth token expired or revoked
• OpenClaw gateway not running
• Slack plugin configuration error
• Network or firewall blocking the Slack API
• Slack app permissions changed or reinstalled

Step 1: Check Gateway Status

openclaw gateway status

Look for the Slack channel status in the output. If the gateway isn't running, start it:

openclaw gateway start

If it starts but Slack still shows disconnected, proceed to Step 2.

Step 2: Check Slack Configuration

openclaw channel list
openclaw channel status slack

If you see "token invalid" or "authentication failed", your Slack OAuth token has expired or been revoked.

Step 3: Re-Authorize Slack

openclaw channel remove slack
openclaw channel add slack
# Follow the OAuth flow in your browser

Make sure you complete the full OAuth flow — don't close the browser window before it redirects back.

Step 4: Verify Slack App Permissions

Go to api.slack.com/apps, find your OpenClaw app, and check: Bot Token Scopes include channels:read, chat:write, im:history, im:read, im:write. Event Subscriptions are enabled. The app is installed in your workspace.

Step 5: Check Gateway Logs

openclaw gateway logs --tail 50

Common error messages and what they mean:

# "invalid_auth" -- Token expired or revoked
# "not_authed" -- Token missing, re-run channel add
# "channel_not_found" -- Bot not added to that channel
# "ratelimited" -- Too many API calls, usually self-resolving

Step 6: Network Check

curl -I https://slack.com/api/api.test
# Should return HTTP 200

If this fails on a corporate network, whitelist Slack API endpoints (slack.com, *.slack.com) at the firewall level.

Step 7: Reinstall the Slack Plugin

openclaw channel remove slack
clawhub update slack
openclaw channel add slack

Preventive Watchdog

openclaw cron add \
  --name "slack-watchdog" \
  --schedule "*/15 * * * *" \
  --agent main \
  --task "Check openclaw channel status slack. If status is not 'connected', log the error to ~/logs/slack-watchdog.md with timestamp."

Ready to go deeper? The OpenClaw Playbook covers this in detail — grab your copy for $9.99.