← Home

Setup Guide

Agnes API Key on OpenClaw: Free Multimodal AI in Minutes

Agnes (by Sapiens AI) is a free OpenAI-compatible gateway that covers chat, image generation, and video — all under one sk- key. This guide shows you how to get your free Agnes key and add it on the API Keys page so your OpenClaw instances can use it immediately, with no redeploy needed.

What Is Agnes?

Agnes is a multimodal AI gateway built by Sapiens AI. It exposes an OpenAI-compatible REST API, which means any tool or framework that already speaks the OpenAI chat completions format — including OpenClaw — can use Agnes without any code changes. Agnes is fully free during its current public availability period: no credit card, no usage caps, no catch.

The flagship model, agnes-2.0-flash, supports both text and image inputs with a generous 256K token context window and full tool-calling support. Agnes also serves a dedicated image generation model and a video generation model, making it one of the few providers where a single free key covers all three modalities.

What Your Agnes Key Unlocks

Once you add your Agnes key on the API Keys page, the following models become available across your OpenClaw instances:

  • Agnes 2.0 Flash (agnes-2.0-flash) — Fast multimodal chat model, text + image input, 256K context window, tool calling supported. Free.
  • Agnes Image 2.0 Flash (agnes-image-2.0-flash) — Text-to-image generation. Free.
  • Agnes Video 2.0 (agnes-video-v2.0) — Text-to-video generation, 5-second clips at $0. Free.

Chat and image-input are handled through the standard completions endpoint. Image and video generation are available in your instance’s media settings once the key is saved.

How to Get an Agnes API Key

  1. Visit the Agnes platform — Go to platform.agnes-ai.com and click Sign Up.
  2. Create a free account — Register with your email address. No payment information is required.
  3. Navigate to API Keys — After logging in, open the API Keys section of your Agnes dashboard.
  4. Generate a new key — Click Create Key (or equivalent). Your key will be shown once — copy it immediately.
  5. Confirm the prefix — Agnes keys start with sk-. If the value you copied does not start with sk-, you may have copied the wrong field.

Add Your Agnes Key on OpenClaw Launch

  1. Sign in at openclawlaunch.com and open the API Keys page.
  2. Find the Agnes card. Paste your sk- key into the input field and click Save. We validate the key against the Agnes API live before storing it.
  3. For the chat model, click “Set as primary model” to point your running instances at agnes-2.0-flash immediately.
  4. For image and video generation, open your instance settings and pick agnes-image-2.0-flash or agnes-video-v2.0 in the image / video model selector.

Your Agnes key is encrypted at rest and applied to your existing running instances — no redeploy needed.

Prefer Hermes Agent? See the Agnes setup guide for Hermes Agent instances.

Troubleshooting

401 Unauthorized / Invalid Key

  • Confirm your key starts with sk-. Agnes keys are case-sensitive; no extra spaces or newlines should be present.
  • Try regenerating the key from the Agnes dashboard and saving the fresh value on the API Keys page.
  • If you signed up very recently, wait a minute and try again — account provisioning can take a moment.

Model Not Found

  • Use the exact model IDs from this guide: agnes-2.0-flash, agnes-image-2.0-flash, agnes-video-v2.0. Typos or guessed variants will return a 404.
  • Make sure you saved a valid Agnes key first — the models are only available once the key is confirmed on the API Keys page.

Quota or Rate Limit Errors

  • Agnes is currently free with no published hard quota. If you receive a 429, wait a few seconds and retry — short bursts may trigger per-minute rate limits.
  • For sustained high-volume usage, check the Agnes platform for any plan options or announcements.

Frequently Asked Questions

Is Agnes really free?

Yes. Agnes (Sapiens AI) is free during its current public availability period. Chat, image generation, and video generation all carry a $0 cost per request. No credit card is required to sign up or to generate a key.

What does an Agnes API key look like?

Agnes keys start with sk-, the same prefix used by OpenAI keys. The two are not interchangeable — an Agnes key only works with the Agnes API base URL, which OpenClaw Launch configures automatically when you save your key.

Does Agnes work with the standard OpenAI SDK?

Yes. Agnes exposes an OpenAI-compatible completions endpoint. Any client that accepts a custom baseURL — including the official OpenAI Python and Node.js SDKs — can be pointed at Agnes by changing the base URL and using your Agnes sk- key as the API key.

Will adding an Agnes key affect my other providers?

No. Each provider key is stored independently. Adding an Agnes key does not change your OpenRouter, Groq, or any other provider configuration. You choose which model is active per instance using the “Set as primary model” control or the instance settings panel.

What's Next?

Start Using Agnes for Free

Deploy an OpenClaw instance with Agnes pre-configured — free multimodal AI, 256K context, no credit card.

Deploy with OpenClaw Launch