# Send Kagi to your agent
Use the source page and any available docs to guide the install because the item is currently unstable or timing out.
## Fast path
- Open the source page via Review source status.
- If you can obtain the package, extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the source page and extracted files.
## Suggested prompts
### New install

```text
I tried to install a skill package from Yavira, but the item is currently unstable or timing out. Inspect the source page and any extracted docs, then tell me what you can confirm and any manual steps still required. Then review README.md for any prerequisites, environment setup, or post-install checks.
```
### Upgrade existing

```text
I tried to upgrade a skill package from Yavira, but the item is currently unstable or timing out. Compare the source page and any extracted docs with my current installation, then summarize what changed and what manual follow-up I still need. Then review README.md for any prerequisites, environment setup, or post-install checks.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "kagi",
    "name": "Kagi",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/michaelasper/kagi",
    "canonicalUrl": "https://clawhub.ai/michaelasper/kagi",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/kagi",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=kagi",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "README.md",
      "SKILL.md",
      "references/kagi-api.md",
      "scripts/kagi_client.py",
      "scripts/kagi_fastgpt.py",
      "scripts/kagi_search.py"
    ],
    "downloadMode": "manual_only",
    "sourceHealth": {
      "source": "tencent",
      "slug": "kagi",
      "status": "unstable",
      "reason": "timeout",
      "recommendedAction": "retry_later",
      "checkedAt": "2026-05-04T16:23:20.571Z",
      "expiresAt": "2026-05-05T04:23:20.571Z",
      "httpStatus": null,
      "finalUrl": null,
      "contentType": null,
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=kagi",
        "error": "Timed out after 5000ms",
        "slug": "kagi"
      },
      "scope": "item",
      "summary": "Item is unstable.",
      "detail": "This item is timing out or returning errors right now. Review the source page and try again later.",
      "primaryActionLabel": "Review source status",
      "primaryActionHref": "https://clawhub.ai/michaelasper/kagi"
    },
    "validation": {
      "installChecklist": [
        "Wait for the source to recover or retry later.",
        "Review SKILL.md only after the download returns a real package.",
        "Treat this source as transient until the upstream errors clear."
      ],
      "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/kagi",
    "downloadUrl": "https://openagent3.xyz/downloads/kagi",
    "agentUrl": "https://openagent3.xyz/skills/kagi/agent",
    "manifestUrl": "https://openagent3.xyz/skills/kagi/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/kagi/agent.md"
  }
}
```
## Documentation

### Kagi (API)

Use the bundled Python scripts to call Kagi’s API from the OpenClaw host.

### Quick start

Create a token in https://kagi.com/settings/api
Export it for your shell/session:

export KAGI_API_TOKEN='…'

Run a search:

python3 scripts/kagi_search.py "haaps glass" --limit 10 --json

Or ask FastGPT (LLM + web search):

python3 scripts/kagi_fastgpt.py "Summarize the latest Haaps glass mentions" --json

### 1) Web search (Kagi Search API)

Use when you need a normal ranked list of results (URLs/titles/snippets).

Command:

python3 scripts/kagi_search.py "<query>" [--limit N] [--json]

Notes:

Defaults to printing a readable digest; use --json for raw API output.
The script automatically sets Authorization: Bot <token>.

### 2) Answer/summarize with citations (FastGPT)

Use when you want a short answer grounded in web results, including reference URLs.

Command:

python3 scripts/kagi_fastgpt.py "<question>" [--cache true|false] [--json]

### 3) Using Kagi as a drop-in for web_search

If Brave Search is rate-limited (429) or you want better results:

Use scripts/kagi_search.py to fetch results
Then use the main agent model to synthesize / summarize based on the returned URLs/snippets

### Files

API reference snippets: references/kagi-api.md
Python client + CLIs: scripts/kagi_client.py, scripts/kagi_search.py, scripts/kagi_fastgpt.py
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: michaelasper
- Version: 0.1.0
## Source health
- Status: unstable
- Item is unstable.
- This item is timing out or returning errors right now. Review the source page and try again later.
- Health scope: item
- Reason: timeout
- Checked at: 2026-05-04T16:23:20.571Z
- Expires at: 2026-05-05T04:23:20.571Z
- Recommended action: Review source status
## Links
- [Detail page](https://openagent3.xyz/skills/kagi)
- [Send to Agent page](https://openagent3.xyz/skills/kagi/agent)
- [JSON manifest](https://openagent3.xyz/skills/kagi/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/kagi/agent.md)
- [Download page](https://openagent3.xyz/downloads/kagi)