CloudBot.ai

FAQ & Setup Guide

Everything your users need to install the plugin, connect CloudBot, and configure their dashboard.

1) Create your CloudBot account

  1. Go to cloudbot.ai/signup and create your account.
  2. Confirm your email if prompted.
  3. Log in and open your Dashboard.

2) Copy your CloudBot API key

  1. In Dashboard, open Plugin or API Keys.
  2. Copy your tenant key (starts with cb_live_).
  3. Keep it private, this key connects your OpenClaw backend to your CloudBot tenant.

3) Install the OpenClaw CloudBot plugin

Run this on the machine where your OpenClaw instance is running.

openclaw plugins install @timekeeperbank/openclaw-cloudbot

4) Add CloudBot config to openclaw.json

Use your tenant API key from the dashboard.

{
  "extensions": {
    "cloudbot": {
      "gatewayUrl": "https://rtc.cloudbot.ai",
      "apiKey": "cb_live_YOUR_TENANT_KEY",
      "allowedAgentIds": ["main", "voice-agent"],
      "channelId": "cloudbot",
      "timeout": 130
    }
  }
}
  • gatewayUrl: CloudBot voice gateway.
  • apiKey: your tenant key from dashboard.
  • allowedAgentIds: optional, recommended for tighter routing control.

5) Configure your dashboard

Agent

Set agent name, greeting, system prompt, memory, and personality (Soul).

Voice

Choose TTS voice and optional start/interrupt sounds.

Model

Set your preferred primary and fallback model behavior.

Notifications & Settings

Set timezone, usage alerts, retention, and contact channels.

6) Verify connection

  1. Restart OpenClaw after plugin config changes.
  2. From Dashboard, check status in Overview.
  3. Run a test session and confirm voice + tool routing works.

Frequently Asked Questions

Where do I find my API key?

In your CloudBot Dashboard under API Keys. It is tenant-scoped and usually starts with cb_live_.

What if plugin install fails?

Confirm OpenClaw is up to date and retry. Then verify the plugin name and network access from your server.

Do I need to restart OpenClaw?

Yes, restart after adding or updating plugin config so settings are loaded.

Can I restrict which agent receives CloudBot traffic?

Yes. Use allowedAgentIds in plugin config.