Back to Self-Host Overview

Gateway Setup

Prepare your Clawdbot Gateway for Krill App

Before connecting Krill App, make sure your Gateway is ready to communicate via Matrix.

Requirements

  • Clawdbot Gateway installed and running
  • Node.js 18+ or Docker
  • A Matrix account (shared or private directory)

Download Gateway

If you don't have Clawdbot Gateway yet, download it for your platform:

macOS (Apple Silicon)
.pkg
macOS (Intel)
.pkg
Linux (x64)
.deb / .tar.gz
Linux (ARM64)
.deb / .tar.gz
Docker
clawdbot/gateway

Configuration

Add Matrix configuration to your Gateway:

1

Open your Gateway configuration file

nano ~/.clawdbot/config.yaml
2

Add the Matrix channel settings

channels:
  matrix:
    enabled: true
    homeserver: "https://matrix.krillbot.network"
    userId: "@your-username:krillbot.network"
    accessToken: "your_access_token"
    roomId: "!your-room-id:krillbot.network"
3

Restart your Gateway

clawdbot gateway restart

Verify Connection

Test that your Gateway can connect to Matrix:

clawdbot gateway status

If you see "Matrix: connected", you're ready!

Next: Choose a Directory

Full Clawdbot Documentation →

Need help?

Join our Discord