OpenClaw Plugin

Integrate agntdata as a native tool in your OpenClaw agent.

Overview

The agntdata OpenClaw plugin registers social media data tools directly in your agent’s tool registry. Your agent can then access LinkedIn, YouTube, X, and other platform data as native capabilities.

Installation

Install the plugin using the OpenClaw CLI:

openclaw plugins install @agntdata/openclaw-agnt-data

Configuration

Add your API key to your openclaw.json configuration:

{
  "plugins": {
    "entries": {
      "agnt-data": {
        "enabled": true,
        "config": {
          "apiKey": "${AGNTDATA_API_KEY}"
        }
      }
    }
  }
}

The ${AGNTDATA_API_KEY} syntax references an environment variable. Set it in your environment or .env file.

Environment Setup

Set your API key as an environment variable:

export AGNTDATA_API_KEY=agnt_live_your_key_here

Or add it to your .env file:

AGNTDATA_API_KEY=agnt_live_your_key_here

Available Tools

Once installed, your agent has access to tools for all supported platforms. Tools follow the naming pattern agntdata_{platform}_{operation}.

Supported Platforms

• LinkedIn
• YouTube
• X (Twitter)
• TikTok
• Instagram
• Reddit
• Facebook

Each platform provides tools for common operations like fetching profiles, posts, and search.

Usage Example

Once configured, your agent can use the tools naturally:

User prompt:

“What can you tell me about Microsoft’s LinkedIn presence?”

Agent response:

I’ll look up Microsoft’s LinkedIn profile.

[Uses agntdata_linkedin_get_company with username: “microsoft”]

Microsoft has 22 million followers on LinkedIn. They’re headquartered in Redmond, WA and have approximately 228,000 employees. Their recent posts focus on AI and cloud computing announcements.

Tool Schema

Each tool follows a consistent schema:

{
  name: "agntdata_linkedin_get_company",
  description: "Get detailed information about a company on LinkedIn",
  parameters: {
    type: "object",
    properties: {
      username: {
        type: "string",
        description: "The company's LinkedIn username or URL"
      }
    },
    required: ["username"]
  }
}

Error Handling

The plugin handles errors gracefully and returns structured error messages:

{
  "success": false,
  "error": {
    "code": "NOT_FOUND",
    "message": "Company not found with username: nonexistent"
  }
}

Your agent can interpret these errors and respond appropriately.

Credit Usage

Each tool call consumes credits from your agntdata balance. The plugin includes credit information in responses:

{
  "success": true,
  "data": { ... },
  "meta": {
    "costCents": 1,
    "purchasedBalanceCents": 949,
    "subscriptionRemainingCents": 500,
    "cached": false,
    "latencyMs": 245
  }
}

Updating the Plugin

To update to the latest version:

openclaw plugins update @agntdata/openclaw-agnt-data

Uninstalling

To remove the plugin:

openclaw plugins uninstall @agntdata/openclaw-agnt-data

Troubleshooting

Plugin not found

Ensure you’ve installed the plugin and restarted OpenClaw:

openclaw plugins list

Authentication errors

Verify your API key is set correctly:

echo $AGNTDATA_API_KEY

Tools not appearing

Check that the plugin is enabled in openclaw.json and restart OpenClaw.

Next Steps

OpenClaw Skill

Alternative: Use a ClawHub skill instead.

API Reference

Browse all available endpoints.