Skip to main content
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

  • OpenClaw CLI installed (download here)
  • Node.js 18+ (for npm installation method)
  • An Adspirer account (free to start)
  • At least one ad platform account: Google Ads, Meta Ads, LinkedIn Ads, or TikTok Ads

​
Setup (3 Minutes)

1

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.
2

Authenticate with Adspirer

openclaw adspirer login
Your browser opens for OAuth 2.1 sign-in. Authorize OpenClaw to access your Adspirer account. No API keys, no passwords stored locally.
3

Connect Your Ad Platforms

openclaw adspirer connect
This opens adspirer.com in your browser. Connect Google Ads, Meta Ads, LinkedIn Ads, TikTok Ads — or any combination. Each platform has its own OAuth flow. Authorize the platforms you want to manage.
4

Verify Your Setup

openclaw adspirer status
You’ll see a table showing:
  • Connected platforms (Google, Meta, LinkedIn, TikTok)
  • Account names and IDs
  • Connection status (active/expired)
  • Available tool count per platform
If everything shows “active,” you’re ready.
5

Try It Now

Sign up for Adspirer — free to start

10 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.

​
CLI Commands

CommandDescription
openclaw adspirer loginAuthenticate via OAuth PKCE
openclaw adspirer logoutClear stored tokens
openclaw adspirer statusShow auth status, connections, tool count
openclaw adspirer accountsList connected ad accounts
openclaw adspirer toolsList registered tools by platform
openclaw adspirer connectOpen 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:
PlatformToolsKey Capabilities
Google Ads39Keyword research with real CPC data, Search & PMax campaigns, wasted spend analysis, budget optimization, extensions, asset management
LinkedIn Ads28B2B targeting (job titles, industries, seniority), sponsored content, lead gen forms, performance analysis
Meta Ads20Image/video/carousel campaigns, audience targeting, creative fatigue detection, placement optimization
TikTok Ads4In-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

GroupPlatformTools
google_adsGoogle Ads40
meta_adsMeta Ads20
tiktok_adsTikTok Ads4
linkedin_adsLinkedIn Ads28
manusAutomation8
systemCross-Platform4

​
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

FieldTypeDefaultDescription
serverUrlstringhttps://mcp.adspirer.comMCP server URL
accessTokenstring—OAuth access token (set by login)
refreshTokenstring—OAuth refresh token (set by login)
tokenExpiresAtnumber—Token expiry timestamp (set by login)
defaultAccountIdstring—Default ad account ID
enabledGroupsstring[]all groupsPlatform groups to enable
enabledToolsstring[][]Cherry-pick specific tools (overrides groups)
requestTimeoutMsnumber60000HTTP 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/dayminimum,LinkedInrequires10/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 10 tool calls/month. If you’ve hit the limit, upgrade to Plus (25/mofor50calls)orPro(25/mo for 50 calls) or Pro (75/mo for 100 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

​
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

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.
No. The SKILL.md file is bundled with the plugin. Other clients require manual skill installation. OpenClaw does it automatically.
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.
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.
Adspirer pricing is based on tool calls, not ad spend. Free tier: 10 calls/month. Plus: 25/mofor50calls.Pro:25/mo for 50 calls. Pro: 75/mo for 100 calls. See full pricing details.
Last modified on February 25, 2026