Introduction

Clanker Support is an AI-powered support agent for your site. You install it with a single script tag (or the React SDK), point it at your knowledge base — website pages, text snippets, Q&A pairs — and it answers visitor questions in a chat widget on your site. When a visitor needs a person, the agent hands the conversation off to your team, and every conversation lands in a shared inbox at app.clankersupport.com.

Clanker Support is open source (theopenco/llmchat, MIT). You can self-host the whole stack for free with your own LLM Gateway key, or use the hosted service — see Pricing for plans.

What you get

• A support agent on your site — streamed answers grounded in the knowledge sources you add, with a welcome message and brand color you control.
• Escalation to humans — the widget offers a handoff after a configurable number of messages — or immediately when the visitor asks; your team is notified by email (and Slack, if you add a webhook) and the agent stands down.
• A shared inbox — search, filters, tags, and a reply composer; replies reach the visitor in the widget, and by email when they shared an address.
• Quality signals — per-message thumbs up/down on answers, plus a separate 1–5 rating the visitor can leave for the conversation.
• Your choice of install path — a one-line script tag, a React/Next.js SDK, and connectors for Shopify and WordPress.

How it fits together

A workspace is your team and billing account. Inside it you create projects — each project is one embedded widget with its own knowledge base, instructions, and AI model, so separate sites or products get separate agents. Every conversation a project's widget handles lands in the workspace's shared inbox, and when a visitor asks for a person, escalation notifies your team and hands the conversation to a human — the agent sends a brief holding note and goes silent once a teammate replies.

Install in one line

Once you've created a project, the whole install is one script tag with your project's public key:

<script
	src="https://api.clankersupport.com/widget.js"
	data-project="pk_…"
	async
></script>

Using React or Next.js? The @clankersupport/widget-rsc package gives you a <ClankerSupport apiKey="pk_…" /> Server Component instead, restylable with CSS variables — see the React SDK.

Four ways to install

• Script tag — one line, works on any site, no build step.
• React SDK — @clankersupport/widget-rsc on npm; a Server Component for the drop-in path, plus headless primitives when you want full control.
• Shopify — a theme app extension, coming soon to the Shopify App Store. Until then, Shopify merchants can paste the script tag into their theme.
• WordPress — a plugin with a settings page and a [clanker_support] shortcode. The wordpress.org listing is on its way; today it installs as a manual plugin upload.

How these docs are organized

• Getting started — create your account and workspace, build your first agent, and install the widget on your site.
• Pricing — plans, included AI responses, overage, and what self-hosting costs (nothing).
• Features — what the product does: AI responses, knowledge sources, escalation, email threading, the team inbox, ratings, and self-hosting.
• Integrations — the four install paths in detail: script tag, React SDK, Shopify, and WordPress.
• Dashboard — working in the dashboard: the inbox, escalation, tags and search, projects and widget settings, workspaces, and billing.

If you get stuck, use the Help button in the dashboard's top bar.