# Send AgentBox OpenRouter 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. 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. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "agentbox-openrouter",
    "name": "AgentBox OpenRouter",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/tenequm/agentbox-openrouter",
    "canonicalUrl": "https://clawhub.ai/tenequm/agentbox-openrouter",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/agentbox-openrouter",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=agentbox-openrouter",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "agentbox-openrouter",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-29T13:52:37.254Z",
      "expiresAt": "2026-05-06T13:52:37.254Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=agentbox-openrouter",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=agentbox-openrouter",
        "contentDisposition": "attachment; filename=\"agentbox-openrouter-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "agentbox-openrouter"
      },
      "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/agentbox-openrouter"
    },
    "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/agentbox-openrouter",
    "downloadUrl": "https://openagent3.xyz/downloads/agentbox-openrouter",
    "agentUrl": "https://openagent3.xyz/skills/agentbox-openrouter/agent",
    "manifestUrl": "https://openagent3.xyz/skills/agentbox-openrouter/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/agentbox-openrouter/agent.md"
  }
}
```
## Documentation

### OpenRouter Setup for AgentBox

This skill guides users through configuring OpenRouter as their LLM provider on this AgentBox instance. OpenRouter gives access to models from Anthropic, OpenAI, Google, Meta, and others through a single API key.

### When to use this skill

Invoke this when the user:

Wants to use a model through OpenRouter (e.g., "I want to use Claude Sonnet 4.5")
Asks about configuring a different LLM provider
Mentions OpenRouter
Wants access to models not available through the default blockrun provider

### Step 1: Check for OpenRouter account

Ask the user if they have an OpenRouter account. If not, guide them:

To use OpenRouter, you'll need an account and API key:

Go to https://openrouter.ai and sign up (Google/GitHub login works)
Go to https://openrouter.ai/keys
Click "Create Key"
Copy the key (starts with sk-or-)

Let me know when you have your API key.

### Step 2: Get the API key

Ask the user to provide their API key. It should start with sk-or-.

### Step 3: Ask which model they want

If the user already specified a model, use that. Otherwise, recommend:

Recommended: Claude Sonnet 4.5 (openrouter/anthropic/claude-sonnet-4-5) - best balance of capability and cost for most tasks.
Other popular options:

openrouter/anthropic/claude-opus-4-6 - most capable, higher cost
openrouter/openai/gpt-4o - OpenAI's flagship
openrouter/google/gemini-2.5-pro - Google's best

Which model would you like as your default?

### Step 4: Configure OpenClaw

Read the current config, modify it, and write it back:

# Read current config
cat ~/.openclaw/openclaw.json

Use jq to update the config. The two fields to set:

env.OPENROUTER_API_KEY - the API key
agents.defaults.model.primary - the default model

jq --arg key "sk-or-USER_KEY_HERE" \\
   --arg model "openrouter/anthropic/claude-sonnet-4-5" \\
   '.env.OPENROUTER_API_KEY = $key | .agents.defaults.model.primary = $model' \\
   ~/.openclaw/openclaw.json > /tmp/openclaw-update.json \\
   && mv /tmp/openclaw-update.json ~/.openclaw/openclaw.json

IMPORTANT: Always read the full config first, then modify. Never write a partial config file.

### Step 5: Restart the gateway

openclaw gateway restart

Wait a few seconds, then verify:

openclaw status

### Step 6: Confirm

Tell the user the setup is complete and their default model is now set to the chosen OpenRouter model. Suggest they send a test message to verify everything works.

### Model reference format

OpenRouter models use the format openrouter/<provider>/<model>:

openrouter/anthropic/claude-sonnet-4-5
openrouter/anthropic/claude-opus-4-6
openrouter/anthropic/claude-haiku-3-5
openrouter/openai/gpt-4o
openrouter/openai/o1
openrouter/google/gemini-2.5-pro
openrouter/meta-llama/llama-3.3-70b-instruct

Full model list at https://openrouter.ai/models

### Switching models later

To change the default model without re-entering the API key:

jq --arg model "openrouter/anthropic/claude-opus-4-6" \\
   '.agents.defaults.model.primary = $model' \\
   ~/.openclaw/openclaw.json > /tmp/openclaw-update.json \\
   && mv /tmp/openclaw-update.json ~/.openclaw/openclaw.json
openclaw gateway restart

### Troubleshooting

"Invalid API key": Verify the key starts with sk-or- and has credit on https://openrouter.ai/credits
Model not responding: Check if the model is available on https://openrouter.ai/models - some models have downtime
Config broken after edit: The issue is usually malformed JSON. Read the file with cat ~/.openclaw/openclaw.json | jq . to check syntax
Changes not taking effect: Must run openclaw gateway restart after any config change
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: tenequm
- 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-04-29T13:52:37.254Z
- Expires at: 2026-05-06T13:52:37.254Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/agentbox-openrouter)
- [Send to Agent page](https://openagent3.xyz/skills/agentbox-openrouter/agent)
- [JSON manifest](https://openagent3.xyz/skills/agentbox-openrouter/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/agentbox-openrouter/agent.md)
- [Download page](https://openagent3.xyz/downloads/agentbox-openrouter)