OpenClaw Setup Guide

One plugin, 100+ tools, 14KB skill file built in. No separate setup.

What Makes OpenClaw Different

Every other MCP client gives you access to Adspirer’s 100+ tools. That’s the baseline. OpenClaw gives you a complete AI advertising agent — pre-configured, pre-trained, ready to run campaigns. The plugin includes a 14.4KB SKILL.md file that documents every tool, every workflow, every platform-specific nuance. The plugin doesn’t just connect to Adspirer — it includes a 14.4KB instruction manual that turns OpenClaw into a specialized advertising AI. You’re deploying an expert, not configuring tools.

Prerequisites

Node.js 18+
An Adspirer account (free to start)

Setup

Local Install
Hostinger VPS

Install OpenClaw on your own machine (Mac, Linux, or Windows with WSL).

Install OpenClaw

npm install -g openclaw

Initialize OpenClaw

openclaw init

This creates ~/.openclaw/openclaw.json with default settings.

Set Tools Profile

openclaw config set tools.profile full

This gives the agent access to bash, file operations, and web tools.

Install the Adspirer Plugin

openclaw plugins install openclaw-adspirer

This installs the plugin with all 100+ tools and the 14.4KB SKILL.md instruction file bundled in. No separate skill or agent installation needed.

Authenticate with Adspirer

Web Login (OAuth)
API Key (Headless/Remote)

Generate an API key at adspirer.ai/keys, then authenticate:

openclaw adspirer login --token sk_live_your_token_here

See Remote Server Setup for Docker, CI/CD, and environment variable options.

Restart the Gateway

openclaw gateway restart

This loads the plugin and registers all 100+ ad management tools.

Connect Your Ad Platforms

openclaw adspirer connect

This opens adspirer.ai/connections where you can link:

Google Ads
Meta Ads (Facebook & Instagram)
LinkedIn Ads
TikTok Ads

Verify Your Setup

openclaw adspirer status

You should see your authentication status, connected platforms, and tool count.

Start Using

openclaw

Then ask the agent things like:

“Show me my Google Ads campaign performance for the last 30 days”
“What keywords are wasting spend?”
“Create a new search campaign for…”
“Pause campaign X”

Sign up for Adspirer — free to start

15 free tool calls/month. No credit card required. Connect your ad accounts in 2 minutes.

You’re connected. OpenClaw is now a fully configured advertising agent with built-in workflows.

Deploy OpenClaw on a Hostinger VPS with OpenClaw pre-installed. Your agent runs 24/7 and is accessible from WhatsApp, Telegram, Discord, or a web dashboard. No terminal experience required.

For a detailed walkthrough with agency use cases and cost breakdown, see the full Hostinger deployment guide.

Buy a Hostinger VPS with OpenClaw

Go to Hostinger’s VPS marketplace, select a plan, and click Deploy. OpenClaw is auto-selected as the pre-installed application.

Configure Environment Variables

Hostinger’s setup screen asks for configuration values:

OPENCLAW_GATEWAY_TOKEN — auto-generated. Copy and save this — it’s your login password.
WHATSAPP_NUMBER — optional. Enter your phone number to connect WhatsApp later.
AI API keys — optional. Leave blank if you’re only using Adspirer for ad management.

Complete the purchase and wait for the status to show Running (1–2 minutes).

Generate Your Adspirer API Key

In a new browser tab:

Go to adspirer.ai/keys
Click Generate New Key
Name it “Hostinger server”
Copy the key — it starts with sk_live_ and won’t be shown again

Access Your Server's Terminal

In Hostinger’s hPanel, open the Terminal or SSH Access for your VPS.

Install the Adspirer Plugin

openclaw plugins install openclaw-adspirer

Authenticate with Adspirer

Replace sk_live_your_token_here with your actual API key:

openclaw adspirer login --token sk_live_your_token_here

Restart the Gateway

openclaw gateway restart

Connect Your Ad Platforms

Go to adspirer.ai/connections from any browser and connect your Google Ads, Meta Ads, LinkedIn Ads, or TikTok Ads accounts via OAuth.

Log Into the Dashboard

Open http://your-server-ip:port in your browser (find the IP and port in Hostinger’s Docker Manager). Enter your OPENCLAW_GATEWAY_TOKEN to log in.

Connect WhatsApp (Optional)

In the OpenClaw dashboard, go to Channels → click Show QR code → scan with WhatsApp (Settings → Linked Devices → Link a Device).

Start Managing Ads

Send a message from WhatsApp, Telegram, or the web dashboard:

“Show me my Google Ads performance for the last 7 days”

Your always-on ad agent is live.

Sign up for Adspirer — free to start

15 free tool calls/month. No credit card required. Connect your ad accounts in 2 minutes.

Your agent is running 24/7 on Hostinger with Adspirer’s 100+ ad tools and the built-in SKILL.md instruction file. It’s accessible from WhatsApp, Telegram, Discord, or your web browser.

Remote Server Setup

If you’re running OpenClaw on a remote server (VPS, Docker, CI/CD), you can’t use the browser-based OAuth login. Instead, use a Personal Access Token (API key).

Generate an API Key

Go to adspirer.ai/keys
Click Generate New Key
Give it a name (e.g., “Hostinger server”, “CI/CD pipeline”)
Copy the token — it starts with sk_live_ and won’t be shown again

Store your API key securely. Treat it like a password. If compromised, revoke it immediately from the dashboard and generate a new one.

Authenticate with the API Key

CLI Flag
Environment Variable
Docker
CI/CD (GitHub Actions)

openclaw adspirer login --token sk_live_your_token_here

export ADSPIRER_API_KEY=sk_live_your_token_here

The environment variable takes priority over stored config. No login command needed.

ENV ADSPIRER_API_KEY=sk_live_your_token_here

Or pass it at runtime:

docker run -e ADSPIRER_API_KEY=sk_live_your_token_here your-image

env:
  ADSPIRER_API_KEY: ${{ secrets.ADSPIRER_API_KEY }}

Add your API key as a repository secret in GitHub Settings.

Connect Your Ad Platforms

API keys authenticate you with Adspirer, but you still need to connect your ad platforms from a browser:

Go to adspirer.ai/connections from any machine with a browser
Connect Google Ads, Meta Ads, LinkedIn Ads, or TikTok Ads via OAuth
Your remote server’s API key will then have access to those connected accounts

Verify

openclaw adspirer status

You should see:

✅ Authenticated via API Key
   Server: https://mcp.adspirer.com
   Key prefix: sk_live_a1b2...

API key limits are tier-based: Free (2 keys), Plus (5), Pro (10), Max (20). Each key can be named, set to expire, and revoked independently.

CLI Commands

Command	Description
`openclaw init`	Create `~/.openclaw/openclaw.json` with default settings
`openclaw config set tools.profile full`	Enable bash, file operations, and web tools
`openclaw plugins install openclaw-adspirer`	Install the Adspirer plugin
`openclaw gateway restart`	Reload plugins and register tools
`openclaw adspirer login`	Authenticate via OAuth PKCE (browser-based)
`openclaw adspirer login --token <key>`	Authenticate with an API key (headless/remote)
`openclaw adspirer logout`	Clear stored tokens and API keys
`openclaw adspirer status`	Show auth status, connections, tool count
`openclaw adspirer accounts`	List connected ad accounts
`openclaw adspirer tools`	List registered tools by platform
`openclaw adspirer connect`	Open Adspirer to connect ad platforms

What You Get: The Skill File

Most MCP integrations give you raw tool access. OpenClaw gives you a 14,400-character instruction manual that covers:

100+ tools documented: Every parameter, every return value, every edge case
6 complete workflows: Performance analysis, keyword research, campaign creation (per platform), budget optimization, account management, automation
Platform quick reference: When to use each platform, minimum budgets, best use cases
Safety rules: What to always check first, what requires user confirmation, what never to retry
Troubleshooting guide: Common errors and how to fix them
Example prompts: Real queries you can copy-paste to get started

This isn’t configuration. It’s training. OpenClaw reads the SKILL.md file and knows how to behave like an expert advertising manager.

What You Can Do

100+ tools across 4 ad platforms:

Platform	Tools	Key Capabilities
Google Ads	39	Keyword research with real CPC data, Search & PMax campaigns, wasted spend analysis, budget optimization, extensions, asset management
LinkedIn Ads	28	B2B targeting (job titles, industries, seniority), sponsored content, lead gen forms, performance analysis
Meta Ads	20	Image/video/carousel campaigns, audience targeting, creative fatigue detection, placement optimization
TikTok Ads	4	In-feed campaigns, asset validation, performance tracking

Plus 8 automation tools for scheduling, monitoring, and cross-platform reporting.

Example Commands

What to actually run once you’re set up:

Google Search Campaign

openclaw "Create a Google Search campaign for my consulting firm:
- Service: fractional CFO services for startups
- Target: startup founders and CEOs at Series A-B companies
- Budget: $80/day
- Research keywords with real CPC data
- Add negative keywords for 'jobs', 'salary', 'free'"

Google PMax Campaign

openclaw "Set up a Performance Max campaign:
- Product: standing desk, $549 retail price
- Target ROAS: 500%
- Product images: [paste URLs]
- Write compelling headlines and descriptions
- Use my Merchant Center product feed"

Meta Ads Campaign

openclaw "Create a Meta image campaign for my online course:
- Product: UX design bootcamp, $599 one-time
- Target: designers and career changers aged 24-38
- Interests: UX design, Figma, product design, career growth
- Budget: $55/day
- Image URL: [paste URL]
- Optimize for registrations"

LinkedIn Lead Gen Campaign

openclaw "Launch a LinkedIn sponsored content campaign:
- Product: employee engagement platform
- Target: HR VPs and CHROs at enterprises with 1,000+ employees
- Industries: tech, finance, healthcare
- Budget: $130/day
- Goal: book a product demo
- Image URL: [paste URL]"

Cross-Platform Performance Report

openclaw "Generate a full performance report for the last 30 days.
Pull data from all connected platforms.
Include:
- Executive summary with key wins and concerns
- Per-platform metrics: spend, conversions, CPA, ROAS
- Wasted spend analysis (Google keywords + Meta creative fatigue)
- Top 5 recommendations for next month
Format as markdown."

Tool Groups

Group	Platform	Tools
`google_ads`	Google Ads	40
`meta_ads`	Meta Ads	20
`tiktok_ads`	TikTok Ads	4
`linkedin_ads`	LinkedIn Ads	28
`manus`	Automation	8
`system`	Cross-Platform	4

Filtering

Enable only specific platforms:

config:
  enabledGroups: ["google_ads", "meta_ads"]

Or cherry-pick individual tools:

config:
  enabledTools: ["echo_test", "get_campaign_performance", "list_campaigns"]

Configuration

Field	Type	Default	Description
`serverUrl`	string	`https://mcp.adspirer.com`	MCP server URL
`accessToken`	string	—	OAuth access token (set by login)
`refreshToken`	string	—	OAuth refresh token (set by login)
`tokenExpiresAt`	number	—	Token expiry timestamp (set by login)
`apiKey`	string	—	Personal access token (`sk_live_...`) for headless auth. Set via `--token` flag or `ADSPIRER_API_KEY` env var.
`defaultAccountId`	string	—	Default ad account ID
`enabledGroups`	string[]	all groups	Platform groups to enable
`enabledTools`	string[]	`[]`	Cherry-pick specific tools (overrides groups)
`requestTimeoutMs`	number	`60000`	HTTP request timeout in ms

Tool Safety Model

Read tools (get_*, list_*, analyze_*, etc.) — auto-execute, no confirmation needed
Write tools (create_*, update_*, pause_*, etc.) — agent MUST ask user before executing

The claw.json Manifest

The plugin includes a manifest file that defines its metadata and permissions:

{
  "name": "adspirer-ads-agent",
  "version": "1.2.1",
  "displayName": "Adspirer Ads Agent",
  "keywords": [
    "advertising",
    "google-ads",
    "meta-ads",
    "linkedin-ads",
    "tiktok-ads",
    "ppc",
    "mcp"
  ],
  "permissions": {
    "network": [
      "mcp.adspirer.com",
      "www.adspirer.com"
    ]
  }
}

This tells OpenClaw that the plugin is an advertising agent, which keywords to associate with it, and which domains it’s allowed to access. The network permissions ensure the plugin can only connect to Adspirer’s servers — no other external services.

Safety Features

The skill file includes safety rules. OpenClaw enforces them automatically:

All campaigns created PAUSED: Review before they spend money
User confirmation required: OpenClaw asks before any action that affects spend
Read-before-write workflows: The agent researches keywords before creating campaigns, validates assets before launching
Connection status checks: Always verifies you’re managing the correct account first
No automatic retries: If a tool call fails, OpenClaw reports the error instead of retrying blindly
Platform-specific minimums: The agent knows Google Ads requires $10/day minimum, LinkedIn requires$ 10/day, Meta has no minimum — and won’t let you create campaigns below those thresholds

Troubleshooting

”Plugin not found” error

List your installed plugins:

openclaw plugins list

If you don’t see openclaw-adspirer, re-run the install command from Step 1.

”Not authenticated” error

Your login session may have expired. Re-authenticate:

openclaw adspirer login

“No ad platforms connected” warning

Run the connect command:

openclaw adspirer connect

Make sure you authorize at least one ad platform (Google, Meta, LinkedIn, or TikTok) in the OAuth flow.

Tools not working or returning errors

Check your account status at adspirer.ai. Free accounts get 15 tool calls/month. If you’ve hit the limit, upgrade to Plus (

49/mo for 150 calls) or Pro (

99/mo for 600 calls).

Skill file not loading

The skill file is bundled with the plugin. If OpenClaw isn’t following the documented workflows, try reinstalling:

openclaw plugins uninstall openclaw-adspirer
openclaw plugins install openclaw-adspirer

“Invalid or expired API key”

Your API key may have been revoked, expired, or mistyped:

Go to adspirer.ai/keys and check if the key is still Active
If revoked or expired, generate a new key
Re-authenticate: openclaw adspirer login --token sk_live_new_key_here

”No platform account connected” (with API key)

API keys authenticate you with Adspirer, but you still need to connect your ad platforms via OAuth from a browser:

Go to adspirer.ai/connections from any machine with a browser
Connect your Google Ads, Meta, LinkedIn, or TikTok accounts
Your remote server’s API key will then have access to those accounts

”API key authentication error”

Ensure the token starts with sk_live_
Check for extra whitespace or line breaks when copying
If using the environment variable, verify: echo $ADSPIRER_API_KEY
Try generating a new key from adspirer.ai/keys

Network permission errors

If your firewall blocks the plugin, whitelist these domains:

mcp.adspirer.com (MCP server)
www.adspirer.com (OAuth and account management)

FAQ

What's the difference between OpenClaw and other MCP clients?

Other clients (Claude Code, Cursor) give you access to Adspirer’s tools. OpenClaw gives you a pre-configured advertising agent with a 14KB instruction manual built in. Less setup, more intelligence out of the box.

Do I need to install skills separately?

No. The SKILL.md file is bundled with the plugin. Other clients require manual skill installation. OpenClaw does it automatically.

Can I edit the skill file to customize behavior?

Yes. The skill file is at node_modules/openclaw-adspirer/skills/adspirer-ads-agent/SKILL.md (if installed via NPM) or in the OpenClaw plugins directory. Edit it to change default behaviors, add custom workflows, or modify safety rules. Changes take effect on the next OpenClaw restart.

Can I manage multiple ad accounts?

Yes. Connect multiple Google Ads accounts, multiple Meta Business Managers, etc. Use the switch_primary_account command to change which account you’re managing, or specify the account ID in your commands.

How much does this cost?

Adspirer pricing is based on tool calls, not ad spend. Free tier: 15 calls/month. Plus:

49/mo for 150 calls. Pro:

99/mo for 600 calls. Max: $199/mo for 3,000 calls. See full pricing details.

Can I use OpenClaw on a remote server or in Docker?

Yes. Generate an API key from adspirer.ai/keys, then use openclaw adspirer login --token sk_live_... or set the ADSPIRER_API_KEY environment variable. See Remote Server Setup.

Getting Started

AI Clients

Ad Platforms

Agent Skills

Resources

OpenClaw Setup Guide

What Makes OpenClaw Different

Prerequisites

Setup

Sign up for Adspirer — free to start

Sign up for Adspirer — free to start

Remote Server Setup

CLI Commands

What You Get: The Skill File

What You Can Do

Example Commands

Google Search Campaign

Google PMax Campaign

Meta Ads Campaign

LinkedIn Lead Gen Campaign

Cross-Platform Performance Report

Tool Groups

Filtering

Configuration

Tool Safety Model

The claw.json Manifest

Safety Features

Troubleshooting

”Plugin not found” error

”Not authenticated” error

“No ad platforms connected” warning

Tools not working or returning errors

Skill file not loading

“Invalid or expired API key”

”No platform account connected” (with API key)

”API key authentication error”

Network permission errors

FAQ

Getting Started

AI Clients

Ad Platforms

Agent Skills

Resources

​What Makes OpenClaw Different

​Prerequisites

​Setup

Sign up for Adspirer — free to start

Sign up for Adspirer — free to start

​Remote Server Setup

​CLI Commands

​What You Get: The Skill File

​What You Can Do

​Example Commands

​Google Search Campaign

​Google PMax Campaign

​Meta Ads Campaign

​LinkedIn Lead Gen Campaign

​Cross-Platform Performance Report

​Tool Groups

​Filtering

​Configuration

​Tool Safety Model

​The claw.json Manifest

​Safety Features

​Troubleshooting

​”Plugin not found” error

​”Not authenticated” error

​“No ad platforms connected” warning

​Tools not working or returning errors

​Skill file not loading

​“Invalid or expired API key”

​”No platform account connected” (with API key)

​”API key authentication error”

​Network permission errors

​FAQ

​Related Documentation

What Makes OpenClaw Different

Prerequisites

Setup

Remote Server Setup

CLI Commands

What You Get: The Skill File

What You Can Do

Example Commands

Google Search Campaign

Google PMax Campaign

Meta Ads Campaign

LinkedIn Lead Gen Campaign

Cross-Platform Performance Report

Tool Groups

Filtering

Configuration

Tool Safety Model

The claw.json Manifest

Safety Features

Troubleshooting

”Plugin not found” error

”Not authenticated” error

“No ad platforms connected” warning

Tools not working or returning errors

Skill file not loading

“Invalid or expired API key”

”No platform account connected” (with API key)

”API key authentication error”

Network permission errors

FAQ

Related Documentation