加入我们的 Telegram 社群 (clawdbotCN) 学习分享和了解更多 →
en
Getting Started
Dashboard

Dashboard

Clawdbot provides a browser-based dashboard for visual management and monitoring of your AI assistant.

Access the Dashboard

By default, the dashboard runs locally:

http://127.0.0.1:18789/

Open this address in your browser after ensuring the gateway is running.

Main Features

Session Management

  • View all active sessions
  • Monitor conversations in real-time
  • Manually reset or end sessions
  • View session history and token usage

Channel Status

  • View connection status for each channel
  • WhatsApp QR code pairing
  • Channel reconnection and diagnostics
  • Message statistics and analytics

Agent Configuration

  • Manage multiple AI agents
  • Configure agent binding rules
  • Adjust sandbox settings
  • Tool permission management

Log Viewer

  • Real-time log streaming
  • Filter by level
  • Error diagnostics
  • Export logs

Secure Access

Local Access

By default, the dashboard binds to 127.0.0.1 only, accessible only from localhost.

Remote Access

For remote access, use these secure methods:

1. Tailscale VPN (Recommended)

{
  gateway: {
    bind: "0.0.0.0:18789",
    token: "your-secure-token"
  }
}

Then access via Tailscale IP.

2. SSH Tunnel

ssh -L 18789:127.0.0.1:18789 user@your-server

Then access http://127.0.0.1:18789/

Token Authentication

Enable token authentication for enhanced security:

{
  gateway: {
    token: "your-secure-token"
  }
}

Or set via environment variable:

export CLAWDBOT_GATEWAY_TOKEN="your-secure-token"

Keyboard Shortcuts

ShortcutFunction
Ctrl + KQuick search
Ctrl + LClear logs
Ctrl + RRefresh status
EscapeClose modal

WebSocket Connection

The dashboard communicates with the gateway via WebSocket:

ws://127.0.0.1:18789/ws

Connection protocol:

  • Request: {type:"req", id, method, params}
  • Response: {type:"res", id, ok, payload|error}

Troubleshooting

Cannot Access Dashboard

  1. Confirm gateway is running: clawdbot status
  2. Check if port is in use: lsof -i :18789
  3. View gateway logs: clawdbot logs --follow

Connection Drops

  • Check network connection
  • Confirm token is correct
  • Check browser console for errors

Next Steps

WizardOverview