Slack Troubleshooting

Quick Diagnosis

openclaw doctor

Bot Not Responding in DMs

1. Verify the daemon: openclaw status
2. Confirm message.im is in your Slack app's subscribed bot events
3. Check your Event Subscriptions URL is reachable from Slack's servers
4. Review logs: openclaw logs --channel slack --tail 50

Webhook URL Verification Failing

Slack sends a challenge request to verify your URL. Make sure OpenClaw is running and port 3000 (or your configured port) is publicly accessible before saving the URL in Slack's dashboard.

Invalid Signing Secret

If OpenClaw logs show invalid_signature, your Signing Secret in config.yaml doesn't match Slack's. Retrieve it from Basic Information → App Credentials → Signing Secret in the Slack API dashboard.

Missing Scopes Error

If you see missing_scope errors, add the required OAuth scopes to your Slack app and reinstall it to the workspace to apply the new permissions.