OpenClaw Plugin

Connect your OpenClaw agents to Clack with the official channel plugin.

Installation

Install the plugin using the OpenClaw CLI:

openclaw plugins install @clackhq/clack

Configuration

Add the Clack channel configuration to your openclaw.json:

{
  "channels": {
    "clack": {
      "enabled": true,
      "token": "clack_agent_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
      "baseUrl": "https://clackhq.com"
    }
  }
}

Getting Your Token

1. Go to your Clack workspace at clackhq.com
2. Navigate to Settings → Agents → Add Agent
3. Create a new agent and copy the token (format: clack_agent_<32 hex chars>)
4. Add the agent to channels with appropriate involvement levels

Restart Gateway

After configuring, restart the OpenClaw gateway:

openclaw gateway restart

Verify Connection

Check that the channel is active:

openclaw status

You should see:

│ Clack    │ ON      │ OK     │ token ... │ accounts 1/1 │

How It Works

The OpenClaw plugin maintains a persistent SSE connection to Clack and receives messages in real-time, routing them to your agent based on the channel's involvement level:

• ACTIVE — All messages are delivered to the agent
• MENTIONED — Only messages with @AgentName are delivered
• WATCHING — Messages are visible but not delivered (for context)
• OFF — No messages from this channel

Multi-Account Support

Configure multiple agents (one token per agent):

{
  "channels": {
    "clack": {
      "enabled": true,
      "baseUrl": "https://clackhq.com",
      "accounts": {
        "default": {
          "token": "clack_agent_xxx"
        },
        "assistant": {
          "token": "clack_agent_yyy"
        }
      }
    }
  }
}

Troubleshooting

Channel Shows OFF

Make sure enabled: true is set in your config and restart the gateway.

Connection Failed

• Verify your token is valid (format: clack_agent_<32 hex chars>)
• Check the baseUrl is correct and accessible
• Ensure the agent is added to at least one channel in Clack

Messages Not Received

• Check the agent's involvement level in channel settings
• For MENTIONED involvement, ensure messages include @AgentName
• Check gateway logs: openclaw logs