name: free-models

alias:

• free-models-for-openclaw
• free-models-of-openclaw
• free-models-for-agents

description: Discover free/cheap models from OpenRouter for AI agents (e.g. OpenClaw). Includes model discovery, filtering, and easy model selection for openclaw and other agent workflows.

metadata:

version: 0.2.0

homepage: https://openrouter.ai

free-models-for-agent

Discover free, cheap, and high-value models from OpenRouter for your OpenClaw and other AI agents.

Usage

Find free models

import { discoverFreeModels } from './scripts/free-models.js';

const models = await discoverFreeModels();
// Returns models with $0.00 or very low pricing

Filter by criteria

import { filterModels } from './scripts/free-models.js';

// High context + low price (best for tool calling)
const models = await filterModels({
  minContext: 200000,      // 200k+ tokens
  maxPromptPrice: 0.00001  // Under $0.00001/1M tokens
});

// Specific provider only
const openaiModels = await filterModels({
  author: 'openai',
  minContext: 100000
});

// Name contains filter
const flashModels = await filterModels({
  author: 'google',
  nameContains: 'flash'
});

// All filters combined
const cheapGoogle = await filterModels({
  author: 'google',
  minContext: 500000,
  maxPromptPrice: 0.000001
});

Get best free model for agent

import { getBestFreeModel } from './scripts/free-models.js';

// Best overall (highest context)
const bestModel = await getBestFreeModel();

// Best for reasoning tasks
const reasoningModel = await getBestFreeModel({
  needReasoning: true,
});

// Best for tool calling (high context is key)
const toolModel = await getBestFreeModel({
  preferReasoning: true,
  maxPrice: 0.00001
});

// Best for vision tasks
const visionModel = await getBestFreeModel({
  needVision: true,
});

CLI Usage

User should register and get a access key from https://openrouter.ai/settings/keys

Openclaw should export the key (or string with a prefix "sk-or-") as the value of Environment Variable OPENROUTER_API_KEY before calling the cli.

export OPENROUTER_API_KEY="sk-or-v1-..."
node scripts/free-models.js

Common Free Models

API Reference

fetchAllModels()

Returns all available models from OpenRouter.

discoverFreeModels()

Filters and returns only models with $0 or very low pricing (< $0.0001/1M).

filterModels(options)

Filters models by:

• maxPromptPrice: Maximum prompt price per 1M tokens
• minContext: Minimum context window (tokens)
• author or provider: Model provider (e.g., 'anthropic', 'openai', 'google', 'deepseek', 'minimax', 'kimi', 'z.ai')
• maxCompletionPrice: Maximum completion price per 1M tokens
• nameContains: Filter by name substring

getBestFreeModel(options)

Returns the best free model based on:

• needReasoning: Requires strong reasoning capability
• preferReasoning: Prefers models with reasoning
• needVision: Requires vision capabilities
• maxPrice: Maximum price threshold

getModelsByAuthor(author)

Returns all models from a specific provider.

getCheapestModels(limit)

Returns the cheapest models (default: 10).

Resources

• OpenRouter Models: https://openrouter.ai/models
• Models API: https://openrouter.ai/api/v1/models