Skip to content

openrouter-plugin-install-and-run.md

Latest commit

 

History

History
65 lines (44 loc) · 1.79 KB

openrouter-plugin-install-and-run.md

File metadata and controls

65 lines (44 loc) · 1.79 KB

OpenRouter Plugin Install and Run

This guide runs Kelvin with the first-party OpenRouter model plugin on the SDK path.

Prerequisites

  • OPENROUTER_API_KEY set in your shell.
  • Installed plugin trust policy and plugin home (defaults are fine).
  • CLI plugin installed (required preflight in kelvin-sdk runtime composition).

Install Plugins

Install the CLI plugin:

kelvin plugin install kelvin.cli

Install the OpenRouter model plugin:

kelvin plugin install kelvin.openrouter

Default index URL:

  • https://raw.githubusercontent.com/agentichighway/kelvinclaw-plugins/main/index.json

Both use KELVIN_PLUGIN_HOME and KELVIN_TRUST_POLICY_PATH if set.

Run Kelvin with OpenRouter Provider

export OPENROUTER_API_KEY="<your_key>"

cargo run -p kelvin-host -- \
  --prompt "Summarize KelvinClaw in one sentence." \
  --model-provider kelvin.openrouter \
  --memory fallback

Expected behavior:

  • runtime loads installed plugins through signature + manifest checks
  • model provider is selected explicitly by plugin id (kelvin.openrouter)
  • request executes through the generic provider_profile_call guest ABI
  • host resolves the declarative openrouter.chat provider profile object
  • host normalizes the request through openai_chat_completions

Deterministic Mock Test (No Live API Key)

Run mock-backed SDK integration test:

cargo test -p kelvin-sdk --lib run_with_sdk_uses_installed_openrouter_model_plugin_via_mock_server -- --nocapture

Failure Modes

  • missing plugin id or install path: typed configuration/load error
  • missing OPENROUTER_API_KEY: typed invalid-input error before outbound call
  • host not in allowlist: typed invalid-input error
  • provider 4xx/5xx: typed backend error
  • malformed plugin output: typed invalid-input error