Skip to main content
Rocket.Chat is an open-source Slack alternative. profClaw connects via Rocket.Chat’s bot API to respond in channels, DMs, and via slash commands.

Capabilities

FeatureSupported
Direct messagesYes
ChannelsYes
ThreadsYes
Slash commandsYes
File uploadsYes
ReactionsYes
WebhooksYes
REST APIYes

Setup

1

Create a bot user

In Rocket.Chat Admin: Administration > Users > New User
  • Set role to bot
  • Generate a random password
  • Enable the account
2

Get credentials

Log in as the bot user via REST API:
curl -X POST https://your-rocketchat.com/api/v1/login \
  -d "user=profclaw-bot&password=your-password"
# Copy authToken and userId
3

Configure profClaw

ROCKETCHAT_URL=https://your-rocketchat.com
ROCKETCHAT_BOT_TOKEN=your-auth-token
ROCKETCHAT_BOT_USER_ID=your-user-id
4

Configure webhook (optional)

For incoming webhooks, go to Administration > Integrations > New Integration > Incoming WebHook.

Environment Variables

ROCKETCHAT_URL
string
required
Your Rocket.Chat server URL (e.g., https://chat.yourdomain.com).
ROCKETCHAT_BOT_TOKEN
string
required
Bot user auth token from REST API login.
ROCKETCHAT_BOT_USER_ID
string
required
Bot user ID from REST API login.
ROCKETCHAT_WEBHOOK_URL
string
Incoming webhook URL for outbound messages.

Configuration Example

ROCKETCHAT_URL=https://chat.example.com
ROCKETCHAT_BOT_TOKEN=authToken123
ROCKETCHAT_BOT_USER_ID=userId456

Notes

  • Status: Beta
  • Rocket.Chat uses real-time API (WebSocket) for message events.
  • Slash commands require a Rocket.Chat admin to register them under Administration > Integrations.
  • Self-hosted Rocket.Chat requires no external dependencies for profClaw to connect.
  • Compatible with Rocket.Chat Community Edition (open-source) and Enterprise.