📘 OpenClaw + Slack Integration Setup Guide

1. Overview

This guide explains how to connect Slack to your OpenClaw Node so you can:

Trigger remote capabilities from Slack
Execute commands on a Node
Receive results directly in Slack
Use Slack as a control interface for OpenClaw

2. Architecture Overview

When integrated, the flow looks like this:

Slack User
   ↓
Slack App / Bot
   ↓
OpenClaw Node (host service)
   ↓
Execution / Capabilities / Workflows

Slack does not replace your Node. Slack sends requests to the Node, and the Node executes them.

3. Prerequisites

Before starting, ensure:

✅ OpenClaw Node is installed
✅ Node service is running
✅ You have admin access to the Node
✅ You have permission to install Slack apps in your workspace

Verify Node status:

openclaw node status

If not running:

openclaw node install
openclaw node restart

4. Step 1 – Ensure Node Is Ready

Your Node must:

Be installed
Be running
Be reachable from Slack (public or via tunnel)
Have pairing/trust configured

If using a local machine, ensure firewall rules allow inbound requests (if required).

5. Step 2 – Install the OpenClaw Slack App

There are two common scenarios:

Option A – Official OpenClaw Slack App

Go to Slack App Directory
Search for “OpenClaw”
Click Add to Slack
Approve requested permissions

Option B – Custom Slack App (Manual Setup)

If no official app exists, create one:

Go to https://api.slack.com/apps
Click Create New App
Choose your workspace
Enable:
- Bot Token Scopes
- Slash Commands
- Event Subscriptions (if needed)

Common required scopes:

commands
chat:write
app_mentions:read

Install the app to your workspace and copy the Bot Token.

6. Step 3 – Connect Slack to Your Node

Now connect Slack to OpenClaw.

This usually requires setting environment variables or configuration.

Example:

export OPENCLAW_SLACK_BOT_TOKEN=xoxb-xxxxxxxx
export OPENCLAW_SLACK_SIGNING_SECRET=xxxxxxxx

Or configure inside OpenClaw config file:

slack:
  enabled: true
  bot_token: xoxb-xxxx
  signing_secret: xxxx

Restart Node after configuration:

openclaw node restart

7. Step 4 – Configure Slack Command Endpoint

If using slash commands:

Go to Slack App → Slash Commands
Add a command like:

/openclaw

Set Request URL to:

https://<your-node-domain>/slack/webhook

If running locally, you may need:

ngrok
reverse proxy
public endpoint

8. Step 5 – Test the Integration

In Slack, try:

/openclaw status

or

@OpenClaw run <task>

Expected behavior:

Slack sends request to Node
Node validates request
Node executes capability
Result is posted back to Slack

9. Security Considerations

Slack integration exposes remote capabilities, so:

Restrict allowed Slack channels
Validate Slack request signatures
Use HTTPS
Limit command permissions
Use role-based access if supported

Pairing still applies — Slack acts as a trusted client of the Node.

10. Troubleshooting

Node not responding

Check:

openclaw node status

Slack command times out

Possible causes:

Node not publicly reachable
Firewall blocking
Incorrect webhook URL
Invalid bot token

Permission errors

Check:

Slack scopes
Workspace installation
Node authorization settings

11. What You Can Do After Setup

Once integrated, you can:

Run remote workflows
Deploy services
Execute system commands
Query infrastructure status
Trigger automation pipelines
Integrate AI-driven tasks (if supported)

Slack becomes your remote control interface for OpenClaw.

12. Summary

To use Slack with OpenClaw:

Install and run OpenClaw Node
Install or create Slack App
Configure Slack credentials in Node
Expose Node endpoint
Test slash commands
Secure access