AI Assistant¶

Overview¶

StarkOne integrates OpenClaw as an AI assistant for natural-language server management. The AI can read logs, explain errors, help configure services, and execute panel operations on your behalf.

AI assistant endpoints require administrative_operations. The AI runs as a separate process (openclaw) managed by the panel.

Setup & Configuration¶

Install OpenClaw¶

POST /api/ai/setup
{
  "model": "claude-opus-4",
  "telegram_token": "..."   # optional
}

Status¶

GET /api/ai/status

Returns whether OpenClaw is running, its version, and configuration.

Configuration¶

GET /api/ai/config
POST /api/ai/config
{
  "model": "claude-opus-4",
  "thinking": true,
  "max_tokens": 8192
}

Chat Interface¶

REST Chat¶

POST /api/ai/chat
{
  "message": "Why is nginx returning 502?"
}

Streaming Chat¶

POST /api/ai/chat-stream
{
  "message": "Show me disk usage by website"
}

Returns a streaming response (SSE or chunked).

Poll Chat Status¶

GET /api/ai/chat/poll

Returns the latest response when the AI is processing asynchronously.

WebSocket TUI¶

A terminal-style UI is available at:

GET /api/ai/tui?token=<jwt>

Web Console¶

The web console is a full OpenClaw web dashboard proxied through the panel:

# Start the web console
POST /api/ai/webconsole/start

# Stop
POST /api/ai/webconsole/stop

# Status
GET /api/ai/webconsole/status

# Health check
GET /api/ai/webconsole/healthcheck

# Proxy (web UI requests)
ANY /api/ai/webconsole/proxy/*path

# LAN access (useful for local network access)
POST /api/ai/webconsole/enable-lan
POST /api/ai/webconsole/disable-lan

Vault (Secrets Management)¶

The AI vault stores secrets (API keys, passwords) that the AI can reference:

# List secrets (names only, no values)
GET /api/ai/vault

# Create a secret
POST /api/ai/vault
{ "name": "cloudflare_api_key", "value": "..." }

# Delete a secret
DELETE /api/ai/vault/:name

# Export vault (encrypted)
POST /api/ai/vault/export
{ "password": "..." }

# Import vault
POST /api/ai/vault/import
{ "data": "...", "password": "..." }

AI Crontab¶

Schedule AI tasks to run automatically:

GET /api/ai/crontab
PUT /api/ai/crontab
{
  "entries": [
    {
      "schedule": "0 9 * * MON",
      "task": "Summarise last week's server errors"
    }
  ]
}

Telegram Integration¶

GET /api/ai/telegram/config
POST /api/ai/telegram/config
{
  "bot_token": "...",
  "allowed_chat_ids": [123456789]
}

# Pairing
GET /api/ai/telegram/pairings
POST /api/ai/telegram/pairings/approve
{ "pairing_id": "..." }

WhatsApp Integration¶

GET /api/ai/whatsapp/config
POST /api/ai/whatsapp/config
{
  "phone_number": "+15551234567"
}

GET /api/ai/whatsapp/pairings
POST /api/ai/whatsapp/pairings/approve
{ "pairing_id": "..." }

Service Control¶

POST /api/ai/restart
POST /api/ai/stop

# Update OpenClaw to latest version
POST /api/ai/update-openclaw
GET /api/ai/update-openclaw/status

# Advanced
POST /api/ai/advanced/clear-sessions
POST /api/ai/advanced/purge-credentials
POST /api/ai/advanced/restart-gateway
POST /api/ai/advanced/reset-config

StarkBee (Trial Agent)¶

StarkBee is a lightweight chat-only AI agent for trial/evaluation:

GET /api/starkbee/status
POST /api/starkbee/activate
{ "license_key": "..." }

# Messages
GET /api/starkbee/messages
DELETE /api/starkbee/messages

# Telegram config
GET /api/starkbee/telegram
POST /api/starkbee/telegram

# WebSocket chat
GET /api/starkbee/chat?token=<jwt>