OpenClaw
One-Command Setup

Connect OpenClaw to
Knobase in 3 Commands

Copy-paste setup for instant @openclaw mentions. Type it anywhere in your document and your agent responds inline.

Step-by-step

Up and running in under a minute

Step 01

Install the Knobase skill

Run this command to install the OpenClaw skill on your machine.

Terminal
$ curl -fsSL https://raw.githubusercontent.com/Knobase-AI/openclaw-knobase/main/install.sh | bash

Expected output

🚀 Installing Knobase Skill for OpenClaw...

✓ Node.js detected
✓ Git detected
✓ Skill installed to ~/.openclaw/skills/knobase

Next: Authenticate with Knobase
Step 02

Choose how to authenticate

Two options — pick whichever suits you:

Terminal
$ openclaw knobase auth --browser

Expected output

Opening browser to app.knobase.com/auth/openclaw...

✓ Browser authentication complete
✓ Token saved locally
✓ Ready to use!
Step 03

Start receiving @mentions

Run this to start listening for @openclaw mentions from Knobase.

Terminal
$ openclaw knobase webhook start

Expected output

🚀 Knobase webhook server running

Agent ID: knobase_agent_a1b2c3d4-e5f6-7890-abcd-ef1234567890
Webhook URL: http://localhost:3456/webhook/knobase
Health Check: http://localhost:3456/health

📱 Notifications will be sent to your configured channel

Press Ctrl+C to stop
Step 04

Test your connection

Send a test notification to make sure everything works.

Terminal
$ openclaw knobase status

Expected output

🔍 Knobase Connection Status

Agent ID: knobase_agent_a1b2c3d4...
Status: ✅ Connected
Workspace: My Workspace
Webhook: ✅ Running on port 3456
API: ✅ Healthy
Last seen: 2 seconds ago
Advanced

One-command setup

For power users who want to run everything at once. Only use if you understand each step.

Terminal
$ curl -fsSL https://raw.githubusercontent.com/Knobase-AI/openclaw-knobase/main/install.sh | bash && openclaw knobase auth --browser && openclaw knobase webhook start

Quick reference

All commands in one place.

Install

curl -fsSL https://raw.githubusercontent.com/Knobase-AI/openclaw-knobase/main/install.sh | bash

Auth

openclaw knobase auth --browser

Start

openclaw knobase webhook start

Status

openclaw knobase status
All Available Commands
# Install
$ curl -fsSL https://raw.githubusercontent.com/Knobase-AI/openclaw-knobase/main/install.sh | bash
 
# Authenticate (browser)
$ openclaw knobase auth --browser
 
# Authenticate (API key)
$ openclaw knobase auth
 
# Start webhook
$ openclaw knobase webhook start
 
# Check status
$ openclaw knobase status
 
# View logs
$ openclaw knobase logs
 
# Stop webhook
$ openclaw knobase webhook stop
 
# Update skill
$ openclaw knobase update
 
# Uninstall
$ openclaw knobase uninstall

Troubleshooting

Ready to connect your agent?

Join thousands of developers using Knobase. Set up in under a minute.

View Documentation