FAQ

🇬🇧 English | 🇩🇪 Deutsch

🇬🇧 English

Frequently Asked Questions

General

What is DigitalCompass-AgentHub Community?

DigitalCompass-AgentHub Community is a free, open source WordPress plugin that connects any OpenClaw AI Agent to your website as a chat widget. Visitors can chat directly with your AI agent without leaving your site.

What is OpenClaw?

OpenClaw is an AI agent framework that connects AI models (like MiniMax, GPT, Claude) to communication channels. DigitalCompass-AgentHub uses OpenClaw as the AI engine behind the chat widget.

Do I need coding skills to use DigitalCompass-AgentHub?

No. Installation and configuration are done entirely through the WordPress admin panel. The only technical requirement is having OpenClaw installed on a VPS — see OpenClaw Setup →.

Is DigitalCompass-AgentHub really free?

Yes. The Community edition is completely free and open source (MIT License). The source code is available on https://digitalcompass.site/downloads/

Pro, Enterprise and Agency editions with additional features are available at digitalcompass.site/wp-agenthub.

Installation

The chat widget is not showing on my website.

  1. Make sure the plugin is activated under Plugins
  2. Check that Gateway Token and OpenClaw Endpoint are saved in Settings → AgentHub Setup
  3. Go to Settings → Permalinks and click Save Changes — this regenerates the WordPress REST API routes
  4. Clear any caching plugins

I get “An error occurred. Please try again.”

This means the plugin cannot reach OpenClaw. Check:

  1. OpenClaw is running: ss -tlnp | grep 18789
  2. The Gateway Token in plugin settings matches ~/.openclaw/openclaw.json
  3. The OpenClaw Endpoint URL is correct
  4. For external hosting: the Apache proxy or Nginx proxy is configured correctly — see External Hosting →

I get “Too many requests. Please wait a moment.”

The built-in rate limit of 20 requests per IP per hour has been reached. This resets automatically after 1 hour. This limit protects your OpenClaw instance from overuse.

Plugin upload fails with “Forbidden”

This is usually caused by a restrictive .htaccess file in the WordPress wp-admin directory. Check:

cat /var/www/yoursite/wp-admin/.htaccess

If it contains Deny from all for PHP files, remove it:

rm /var/www/yoursite/wp-admin/.htaccess

WordPress will recreate a clean version automatically.

Configuration

How do I switch between agents?

Change the Model field in Settings → AgentHub Setup to the new agent name (e.g. openclaw/stella) and save. The change takes effect immediately — no restart required.

Can I use the same OpenClaw instance for multiple websites?

Yes. Each website gets its own plugin installation with its own settings. You can connect different agents to different websites from one OpenClaw instance.

Power Tip: Create a separate OpenClaw agent with its own Telegram bot for each website. One VPS infrastructure — unlimited agents.

Why does my agent answer in the wrong language?

The agent’s language behavior is defined in AGENTS.md. Add a clear language rule:

## Language Example Instructions
Always respond in the visitor's language.
- Visitor writes English → respond in English
- Visitor writes German → respond in German
- Visitor writes Swedish → respond in Swedish
- For single words like "Hi" or "Hallo" → default to English
- All other languages → respond in English

Can I change the chat button emoji/avatar?

In the Community edition the default avatar is 🤖. To customize the bot name, avatar, and branding upgrade to DigitalCompass-AgentHub Pro.

How do I edit my agent’s AGENTS.md?

Connect to your VPS via SSH and edit the file:

nano ~/.openclaw/workspace/cat/AGENTS.md

Changes take effect immediately — no restart needed.

To edit AGENTS.md directly from the WordPress admin panel without SSH, upgrade to DigitalCompass-AgentHub Pro.

Security & Privacy

Is DigitalCompass-AgentHub GDPR friendly?

Yes. DigitalCompass-AgentHub Community:

  • Does not store any visitor conversations
  • Does not use third-party tracking
  • Does not send data to external services
  • Runs entirely on your own server infrastructure
  • Is open source — the code is fully auditable

Add a note to your privacy policy that an AI chat widget is active on your site and that conversations are processed by your self-hosted AI infrastructure.

Where is the Gateway Token stored?

The Gateway Token is stored in the WordPress database (wp_options table). It is never exposed in the browser or in the page source code. All communication with OpenClaw happens server-side.

Can visitors access my OpenClaw instance directly?

No. The plugin acts as a proxy — visitors send messages to the WordPress REST API, which forwards them to OpenClaw server-side. OpenClaw is never directly accessible from the browser.

Performance

How many simultaneous visitors can the chat handle?

The chat widget uses cloud-based AI models (via OpenClaw and for example OpenRouter). These scale automatically — hundreds of simultaneous conversations are handled without performance impact on your VPS.

The only potential bottleneck is your VPS handling the WordPress proxy requests, which is minimal.

How much do AI model costs add up to?

Very little. Typical usage of MiniMax M2.5 via OpenRouter:

  • ~2,000–5,000 tokens per conversation
  • ~$0.30–0.50 per 1 million input tokens
  • 1,000 conversations/month ≈ $1–5 in model costs
  • other LLMs cost a little bit more

Upgrade

What does DigitalCompass-AgentHub Pro add?

  • Agent Editor — Edit your AGENTS.md directly from the WordPress admin. No terminal, no SSH.
  • White Label — Custom bot name, avatar, colors, status text and branding
  • Multiple language interface — Full EN/DE admin panel

What does DigitalCompass-AgentHub Enterprise add?

Everything in Pro plus:

  • Analytics Dashboard — Chat sessions, messages sent, link clicks, abandons, browser languages, most asked questions
  • GDPR-compliant data storage — Anonymized, auto-deleted after 30 days
  • Real-time reporting — All data updates live

👉 Learn more and upgrade

🇩🇪 Deutsch

Häufig gestellte Fragen

Allgemein

Was ist DigitalCompass-AgentHub Community?

DigitalCompass-AgentHub Community ist ein kostenloses, quelloffenes WordPress-Plugin das jeden OpenClaw KI-Agenten als Chat-Widget mit deiner Website verbindet. Besucher können direkt mit deinem KI-Agenten chatten ohne die Website zu verlassen.

Was ist OpenClaw?

OpenClaw ist ein KI-Agenten-Framework das KI-Modelle (wie MiniMax, GPT, Claude) mit Kommunikationskanälen verbindet. DigitalCompass-AgentHub nutzt OpenClaw als KI-Engine hinter dem Chat-Widget.

Brauche ich Programmierkenntnisse?

Nein. Installation und Konfiguration erfolgen vollständig über das WordPress Admin-Panel. Die einzige technische Voraussetzung ist OpenClaw auf einem VPS zu installieren — siehe OpenClaw Setup →.

Ist DigitalCompass-AgentHub wirklich kostenlos?

Ja. Die Community Edition ist vollständig kostenlos und Open Source (MIT Lizenz). Der Quellcode ist auf https://digitalcompass.site/downloads/ verfügbar.

Pro, Enterprise und Agency Editionen mit zusätzlichen Features sind unter digitalcompass.site/wp-agenthub erhältlich.

Installation

Das Chat-Widget wird auf meiner Website nicht angezeigt.

  1. Sicherstellen dass das Plugin unter Plugins aktiviert ist
  2. Prüfen dass Gateway Token und OpenClaw Endpoint unter Einstellungen → AgentHub Setup gespeichert sind
  3. Einstellungen → Permalinks aufrufen und Änderungen speichern klicken — das regeneriert die WordPress REST API Routen
  4. Caching-Plugins leeren

Ich erhalte “Ein Fehler ist aufgetreten. Bitte versuche es erneut.”

Das bedeutet das Plugin kann OpenClaw nicht erreichen. Prüfen:

  1. OpenClaw läuft: ss -tlnp | grep 18789
  2. Der Gateway Token in den Plugin-Einstellungen stimmt mit ~/.openclaw/openclaw.json überein
  3. Die OpenClaw Endpoint URL ist korrekt
  4. Bei externem Hosting: der Apache Proxy oder Nginx Proxyist korrekt konfiguriert — siehe Externes Hosting →

Ich erhalte “Too many requests. Please wait a moment.”

Das eingebaute Rate Limit von 20 Anfragen pro IP pro Stunde wurde erreicht. Setzt sich automatisch nach 1 Stunde zurück. Dieses Limit schützt deine OpenClaw-Instanz vor Überlastung. Kann manuell hochgesetzt werden.

Plugin-Upload schlägt mit “Forbidden” fehl

Wird meist durch eine restriktive .htaccess Datei im WordPress wp-admin Verzeichnis verursacht. Prüfen:

cat /var/www/deineseite/wp-admin/.htaccess

Wenn sie Deny from all für PHP-Dateien enthält, löschen:

rm /var/www/deineseite/wp-admin/.htaccess

WordPress erstellt automatisch eine saubere Version neu.

Konfiguration

Wie wechsle ich zwischen Agenten?

Das Model Feld unter Einstellungen → AgentHub Setup auf den neuen Agenten-Namen ändern (z.B. openclaw/stella) und speichern. Die Änderung tritt sofort in Kraft — kein Neustart erforderlich.

Kann ich dieselbe OpenClaw-Instanz für mehrere Websites nutzen?

Ja. Jede Website bekommt ihre eigene Plugin-Installation mit eigenen Einstellungen. Du kannst verschiedene Agenten mit verschiedenen Websites von einer OpenClaw-Instanz verbinden.

Power-Tipp: Für jede Website einen eigenen OpenClaw Agenten mit eigenem Telegram Bot erstellen. Eine VPS-Infrastruktur — unbegrenzte Agenten.

Warum antwortet mein Agent in der falschen Sprache?

Das Sprachverhalten des Agenten wird in der AGENTS.md definiert. Eine klare Sprachregel hinzufügen:

## Sprache Beispielanweisung
Antworte immer in der Sprache des Besuchers.
- Besucher schreibt Englisch → auf Englisch antworten
- Besucher schreibt Deutsch → auf Deutsch antworten
- Besucher schreibt Schwedisch → auf Schwedisch antworten
- Bei einsilbigen Grüßen wie "Hi" oder "Hallo" → Standard Englisch
- Alle anderen Sprachen → auf Englisch antworten

Kann ich den Chat-Button Emoji/Avatar ändern?

In der Community Edition ist der Standard-Avatar 🤖. Um Bot-Name, Avatar und Branding anzupassen auf WP AgentHub Pro upgraden.

Wie bearbeite ich die AGENTS.md meines Agenten?

Über SSH mit dem VPS verbinden und die Datei bearbeiten:

nano ~/.openclaw/workspace/cat/AGENTS.md

Änderungen treten sofort in Kraft — kein Neustart nötig.

Um die AGENTS.md direkt im WordPress Admin-Panel ohne SSH zu bearbeiten, auf WP AgentHub Pro upgraden.

Sicherheit & Datenschutz

Ist DigitalCompass-AgentHub DSGVO-freundlich?

Ja. DigitalCompass-AgentHub Community:

  • Speichert keine Besucher-Gespräche
  • Nutzt kein Drittanbieter-Tracking
  • Sendet keine Daten an externe Dienste
  • Läuft vollständig auf deiner eigenen Server-Infrastruktur
  • Ist Open Source — der Code ist vollständig prüfbar

Einen Hinweis in deine Datenschutzerklärung aufnehmen dass ein KI-Chat-Widget auf deiner Site aktiv ist und Gespräche von deiner selbstgehosteten KI-Infrastruktur verarbeitet werden.

Wo wird der Gateway Token gespeichert?

Der Gateway Token wird in der WordPress-Datenbank (wp_options Tabelle) gespeichert. Er ist nie im Browser oder im Quellcode der Seite sichtbar. Die gesamte Kommunikation mit OpenClaw erfolgt serverseitig.

Können Besucher direkt auf meine OpenClaw-Instanz zugreifen?

Nein. Das Plugin fungiert als Proxy — Besucher senden Nachrichten an die WordPress REST API, die sie serverseitig an OpenClaw weiterleitet. OpenClaw ist nie direkt vom Browser aus erreichbar.

Performance

Wie viele gleichzeitige Besucher kann der Chat verarbeiten?

Das Chat-Widget nutzt cloud-basierte KI-Modelle (via OpenClaw und OpenRouter). Diese skalieren automatisch — Hunderte gleichzeitiger Gespräche werden ohne Performance-Auswirkung auf deinen VPS verarbeitet.

Wie hoch sind die KI-Modell-Kosten?

Sehr gering. Typische Nutzung von MiniMax M2.5 via OpenRouter:

  • ~2.000–5.000 Tokens pro Gespräch
  • ~$0,30–0,50 pro 1 Million Input-Tokens
  • 1.000 Gespräche/Monat ≈ $1–5 Modell-Kosten
  • andere LLMs kosten etwas mehr

Upgrade

Was fügt DigitalCompass-AgentHub Pro hinzu?

  • Agent Editor — AGENTS.md direkt im WordPress Admin bearbeiten. Kein Terminal, kein SSH.
  • White Label — Eigener Bot-Name, Avatar, Farben, Status-Text und Branding
  • Mehrsprachiges Interface — Vollständiges EN/DE Admin-Panel

Was fügt DigitalCompass-AgentHub Enterprise hinzu?

Alles aus Pro plus:

  • Analytics Dashboard — Chat-Sessions, gesendete Nachrichten, Link-Klicks, Abbrüche, Browser-Sprachen, meistgestellte Fragen
  • DSGVO-konforme Datenspeicherung — Anonymisiert, automatisch nach 30 Tagen gelöscht
  • Echtzeit-Reporting — Alle Daten werden live aktualisiert

👉 Mehr erfahren und upgraden