Mintplex-Labs/anything-llm · error · Error

OpenRouter API key must be provided to use agents.

Error message

OpenRouter API key must be provided to use agents.

What it means

Provider setup guard in AgentHandler.checkSetup: the selected agent provider is 'openrouter' but OPENROUTER_API_KEY is empty/unset, so agent initialization aborts because the provider has no credential to run with.

Solutions

  1. Set the OPENROUTER_API_KEY environment variable.
  2. Or select a different agent provider.
Defensive patterns

Strategy: validation

When it happens

Trigger: OpenRouter was selected as the agent provider but no API key is configured.

Common situations: This error is raised at runtime in server/utils/agents/index.js. It occurs when the required configuration for this provider is missing or invalid (unset environment variables, empty API key or base path), when the external service is unreachable or returns an unexpected response, or when invalid input reaches the call site. To prevent it, validate the relevant provider settings and environment variables at startup and confirm the service is reachable before this code path executes.

AI-assisted analysis of Mintplex-Labs/anything-llm@20f6d3546c (2026-08-18). Data as JSON: /api/errors/bc1b62c517a911c7. Report an issue: GitHub.

Appendix: source

Thrown at server/utils/agents/index.js:174

          throw new Error(
            "Azure OpenAI API endpoint and key must be provided to use agents."
          );
        break;
      case "koboldcpp":
        if (!process.env.KOBOLD_CPP_BASE_PATH)
          throw new Error(
            "KoboldCPP must have a valid base path to use for the api."
          );
        break;
      case "localai":
        if (!process.env.LOCAL_AI_BASE_PATH)
          throw new Error(
            "LocalAI must have a valid base path to use for the api."
          );
        break;
      case "openrouter":
        if (!process.env.OPENROUTER_API_KEY)
          throw new Error("OpenRouter API key must be provided to use agents.");
        break;
      case "mistral":
        if (!process.env.MISTRAL_API_KEY)
          throw new Error("Mistral API key must be provided to use agents.");
        break;
      case "generic-openai":
        if (!process.env.GENERIC_OPEN_AI_BASE_PATH)
          throw new Error("API base path must be provided to use agents.");
        break;
      case "perplexity":
        if (!process.env.PERPLEXITY_API_KEY)
          throw new Error("Perplexity API key must be provided to use agents.");
        break;
      case "textgenwebui":
        if (!process.env.TEXT_GEN_WEB_UI_BASE_PATH)
          throw new Error(
            "TextWebGenUI API base path must be provided to use agents."
          );

View on GitHub (pinned to 20f6d3546c)