# Send Exa Tool to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "exa-tool",
    "name": "Exa Tool",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/ClaireAICodes/exa-tool",
    "canonicalUrl": "https://clawhub.ai/ClaireAICodes/exa-tool",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/exa-tool",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=exa-tool",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "README.md",
      "SKILL.md",
      "bin/exa-web-search.mjs",
      "package.json"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "exa-tool",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-03T00:47:19.094Z",
      "expiresAt": "2026-05-10T00:47:19.094Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=exa-tool",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=exa-tool",
        "contentDisposition": "attachment; filename=\"exa-tool-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "exa-tool"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/exa-tool"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/exa-tool",
    "downloadUrl": "https://openagent3.xyz/downloads/exa-tool",
    "agentUrl": "https://openagent3.xyz/skills/exa-tool/agent",
    "manifestUrl": "https://openagent3.xyz/skills/exa-tool/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/exa-tool/agent.md"
  }
}
```
## Documentation

### Exa MCP Tool

This skill provides access to Exa's powerful search and research capabilities through the Exa MCP server.

### General Purpose

exa-search <tool> '{"json":"args"}' - Generic wrapper for any Exa MCP tool

### Specialized Wrappers

exa-web-search '{"query":"...", "count":10, "freshness":"pw", ...}' - Web search with optional filters

### Full Tool List (via exa-search)

All tools from the Exa MCP server are available:

ToolDescriptionweb_search_exaSearch the web for any topic, get clean contentweb_search_advanced_exaAdvanced search with filters (domains, dates, content options)get_code_context_exaFind code examples, documentation, programming solutionscrawling_exaGet full content of a specific webpage from a known URLcompany_research_exaResearch any company for business information and newspeople_search_exaFind people and their professional profilesdeep_researcher_startStart an AI research agent that writes detailed reportsdeep_researcher_checkCheck status and get results from deep research task

### Setup

Get your Exa API key from https://dashboard.exa.ai/api-keys


Set the environment variable:
export EXA_API_KEY="your_exa_api_key_here"

Or add to your shell profile (~/.bashrc or ~/.zshrc):
export EXA_API_KEY="your_exa_api_key_here"

Or create a .env file in your workspace:
echo "EXA_API_KEY=your_exa_api_key_here" > ~/.openclaw/workspace/.env
source ~/.openclaw/workspace/.env



Restart OpenClaw to load the skill:
openclaw gateway restart

### Basic Web Search

exa-web-search '{"query":"Step-3.5 Flash benchmarks"}'

### Advanced Search with Filters

exa-search web_search_advanced_exa '{
  "query": "OpenClaw AI",
  "count": 10,
  "freshness": "pw",
  "includeDomains": ["github.com", "docs.openclaw.ai"]
}'

### Code Search

exa-search get_code_context_exa '{
  "query": "OpenClaw agent implementation",
  "count": 5
}'

### Crawl Specific URL

exa-search crawling_exa '{
  "url": "https://docs.openclaw.ai/",
  "maxPages": 10
}'

### Company Research

exa-search company_research_exa '{
  "company": "OpenClaw",
  "includeNews": true,
  "newsDays": 30
}'

### People Search

exa-search people_search_exa '{
  "query": "Phil openclaw creator",
  "count": 10
}'

### Deep Research (Two-Step)

# Start research
TASK_ID=$(exa-search deep_researcher_start '{
  "query": "Current state of AI agents in 2026",
  "maxSources": 20
}' | jq -r '.taskId')

# Check status (poll until complete)
while true; do
  exa-search deep_researcher_check '{"taskId":"'"$TASK_ID"'"}'
  sleep 5
done

### Output Format

All tools return JSON with the Exa MCP response structure. The actual content is in the result field, which varies by tool but typically includes:

content: Array of result items with title, url, text (snippet)
Sometimes additional metadata like cost, duration, sources

Example web search output:

{
  "content": [
    {
      "title": "Step 3.5 Flash - MathArena",
      "url": "https://matharena.ai/models/stepfun_3_5_flash",
      "text": "Step 3.5 Flash benchmarks and performance metrics..."
    }
  ]
}

### Using in OpenClaw Agents

Agents can use these tools directly:

// In an agent session
/exec exa-search web_search_exa '{"query":"latest news"}'

// Or via API
{
  "sessionTarget": "isolated",
  "payload": {
    "kind": "agentTurn",
    "message": "Search for recent AI developments using exa-search"
  }
}

### Notes

Rate limits apply based on your Exa plan
The MCP server uses Server-Sent Events (SSE) streaming; the wrapper handles this
All tools accept various optional parameters; see Exa docs for full schema
Errors are returned with proper exit codes and messages to stderr

### Troubleshooting

"EXA_API_KEY not set"

Ensure the environment variable is exported in the same session where OpenClaw runs
If using systemd/systemctl, set the key in the service file or /etc/environment

"406 Not Acceptable"

The tool already sets the correct Accept header; this shouldn't occur in the wrapper

Empty or no results

Verify your API key has credits/quota
Check the Exa dashboard: https://dashboard.exa.ai

### References

Exa MCP Docs: https://exa.ai/docs/reference/exa-mcp
MCP Server: https://mcp.exa.ai/mcp
API Keys: https://dashboard.exa.ai/api-keys
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: ClaireAICodes
- Version: 1.0.0
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-03T00:47:19.094Z
- Expires at: 2026-05-10T00:47:19.094Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/exa-tool)
- [Send to Agent page](https://openagent3.xyz/skills/exa-tool/agent)
- [JSON manifest](https://openagent3.xyz/skills/exa-tool/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/exa-tool/agent.md)
- [Download page](https://openagent3.xyz/downloads/exa-tool)