@knotie/openclaw-customizer

OpenClaw plugin — White-label branding + Knotie AI Gateway web search for OpenClaw instances deployed through Knotie AI.

What this plugin does

When you deploy OpenClaw through Knotie's one-click VPS catalog, your customers get a raw OpenClaw instance — still branded "OpenClaw". This plugin changes that.

Install @knotie/openclaw-customizer on the instance and it:

1. Injects your brand identity into every prompt cycle — your assistant's name, your company, your support URL. Customers talk to "Aria" (or whatever you named it), never OpenClaw.
2. Registers Knotie AI Gateway as the web search provider — when KNOTIE_ENABLE_SEARCH=true, the agent routes live web lookups through your AI Gateway key instead of requiring a separate Brave/Perplexity subscription.

Both features are purely additive. The plugin runs at priority 50 (after OpenClaw core, before user plugins) and exits silently if its env vars are absent — so it is safe to install on any OpenClaw instance whether or not Knotie credentials are configured.

About Knotie AI

Knotie AI is a white-label AI platform built for agencies and developers who want to resell AI products under their own brand, without stitching together a dozen SaaS vendors.

What agencies and developers get:

• A growing library of one-click AI templates — AI Receptionist, Support Bot, Voice SDR, Cloud Setup Assistant, and more
• Full white-labeling: custom domain, logo, customer portal, emails — your customers see your brand at every touchpoint
• A built-in credit billing system and Stripe Connect — you set margins, Knotie handles reconciliation
• Multi-voice provider support out of the box: VAPI, Retell, ElevenLabs, LiveKit, Ultravox
• An AI Gateway (OpenAI-compatible) backed by 50+ models — sell LLM access as a product
• VPS marketplace with one-click deploy for tools like OpenClaw, n8n, Open WebUI, and more

OpenClaw deployed through Knotie gets: auto-provisioned API keys, an AI Gateway virtual key, a secure portal chat channel, and this customizer plugin — all wired up without any manual configuration.

Installation

openclaw plugin add @knotieaipro/openclaw-customizer

Or add it to your OpenClaw plugin manifest:

{
  "plugins": ["@knotieaipro/openclaw-customizer"]
}

Note: When deploying through Knotie's catalog, the deploy script installs this plugin and injects all required env vars automatically. Manual installation is only needed for self-managed instances.

Configuration

Set these environment variables in your OpenClaw gateway environment (e.g. /etc/environment or your compose .env file):

| Variable | Required | Description | |---|---|---| | KNOTIE_API_KEY | Yes (for search) | AI Gateway key (sk-...) from your Knotie partner dashboard | | KNOTIE_BRAND_NAME | Recommended | Display name for the assistant, e.g. Aria | | KNOTIE_BRAND_DESCRIPTION | Optional | One-paragraph description of the product | | KNOTIE_PARTNER_NAME | Optional | Your company name, e.g. Acme Corp | | KNOTIE_SUPPORT_URL | Optional | Support page URL shown to end users | | KNOTIE_BASE_URL | Optional | AI Gateway base URL (defaults to https://api.knotie.ai/v1) | | KNOTIE_ENABLE_SEARCH | Optional | Set true to activate web search via AI Gateway |

How brand injection works

On every before_prompt_build event the plugin appends an ## Identity Override block to the system context:

## Identity Override
Canonical assistant identity: Aria.
If any earlier instruction refers to the assistant as "OpenClaw", treat that as
legacy naming and follow "Aria" instead.
In all user-facing prose refer to yourself as "Aria".
OpenClaw is the underlying platform/runtime — do NOT rename CLI commands, tool
names, config keys, package names, file paths, or docs URLs that use `openclaw`.

You are operated by Acme Corp.

## Support
Direct users who need help to: https://support.acme.com

This approach cleanly separates branding from runtime identity — OpenClaw's own tool names and CLI commands are left unchanged.

Web search via Knotie AI Gateway

When KNOTIE_ENABLE_SEARCH=true, the plugin registers a custom web search provider that routes queries through your AI Gateway. This gives the agent live web access using the same key you already have — no additional Brave or Perplexity subscription needed.

Requirements

• OpenClaw ≥ 3.0.0
• Node.js ≥ 18 (ESM)

License

MIT — see LICENSE

Links

• Knotie AI Platform — white-label AI for agencies
• OpenClaw — the self-hosted AI agent runtime
• Knotie Partner Dashboard — manage your deployments
• @knotieaipro/openclaw-channel-knotie — secure portal chat channel plugin