दस्तऐवजDocumentationAppsOpenClaw model provider setup

OpenClaw model provider setup

Installation नंतर कोणत्याही model provider API key सह OpenClaw configure करा.

Appbox मध्ये OpenClaw install करण्यासाठी model API key आवश्यक नसते.

Setup पूर्ण करण्याचा शिफारस केलेला मार्ग म्हणजे SSH वरून तुमच्या OpenClaw app ला connect होणे आणि built-in openclaw onboard wizard चालवणे. पूर्ण config हाताने edit करण्यापेक्षा wizard सुरक्षित आहे, कारण तो Appbox gateway settings जपून ठेवतो आणि model providers, API keys, channels, health checks, आणि skills यांमधून तुम्हाला मार्गदर्शन करतो.

तुम्ही SSH वापरू शकत नसाल किंवा वापरू इच्छित नसाल, तर त्याऐवजी backup dashboard method वापरा.

शिफारस केलेली पद्धत: OpenClaw मध्ये SSH करून onboarding चालवा

नवीन installs साठी आणि model provider credentials जोडायची किंवा बदलायची असलेल्या existing installs साठी ही पद्धत वापरा.

आधी काय लागेल

Appbox मधील तुमचे OpenClaw app details page.
Configuration section मध्ये दाखवलेला SSH Command.
तुमचा Gateway Token / SSH Password. OpenClaw dashboard login साठी वापरला जाणारा हा तोच generated secret आहे.
Model provider account किंवा API key. अजून नसल्यास, API keys मिळवणे पहा.

App details page ready-to-copy SSH command दाखवते:

Appbox OpenClaw app details page with the SSH command highlighted

macOS वरून connect करा

Terminal किंवा iTerm2 उघडा.
OpenClaw app details page वरून SSH Command copy करा.
Paste करून run करा. तो साधारण असा दिसेल:

ssh node@your-openclaw-domain.example -p 12345

macOS host trust करायचा का विचारल्यास, yes type करा आणि Enter दाबा.
Password विचारल्यावर तुमचा Gateway Token / SSH Password paste करा आणि Enter दाबा. Password type किंवा paste करताना Terminal कोणतेही characters दाखवणार नाही.

Windows वरून connect करा

Windows 10 आणि Windows 11 मध्ये OpenSSH client default उपलब्ध असतो.

Windows Terminal किंवा PowerShell उघडा.
OpenClaw app details page वरून SSH Command copy करा.
Paste करून run करा:

ssh node@your-openclaw-domain.example -p 12345

Windows host trust करायचा का विचारल्यास, yes type करा आणि Enter दाबा.
Password विचारल्यावर तुमचा Gateway Token / SSH Password paste करा आणि Enter दाबा. PowerShell pasted password दाखवणार नाही.

Windows ने ssh recognized नाही असे सांगितल्यास, Settings > System > Optional features मधून OpenSSH Client install करा, नंतर Windows Terminal पुन्हा उघडून पुन्हा प्रयत्न करा.

OpenClaw onboarding wizard चालवा

SSH connect झाल्यावर चालवा:

openclaw onboard

iTerm2 on macOS connected to OpenClaw over SSH and running the openclaw onboard command

Wizard interactive आहे. Appbox-specific निवडी अशा ठेवा:

Existing config: current config review किंवा modify करण्याचा option निवडा. तुमचा OpenClaw setup जाणीवपूर्वक सुरुवातीपासून rebuild करायचा नसेल तर full reset निवडू नका.
Model and auth: OpenRouter, OpenAI, Anthropic, Google, xAI, किंवा custom OpenAI-compatible provider असा provider निवडा. Wizard विचारेल तेव्हा API key paste करा. बहुतेक users साठी OpenRouter हा सोपा default आहे, कारण एक key अनेक models कडे route करू शकते. तुमच्याकडे OpenAI Codex subscription असल्यास, provider list मध्ये OpenAI Codex निवडा; फक्त codex नावाचा option निवडू नका.
Default model: त्या provider साठी wizard recommend करतो तो model निवडा, किंवा openrouter/auto सारखी provider/model value manually enter करा.
Workspace: बदलण्याचे विशिष्ट कारण नसेल तर default workspace ठेवा.
Gateway settings: विद्यमान Appbox gateway settings तसेच ठेवा. विशेषतः token auth enabled ठेवा आणि existing gateway port/bind settings जपून ठेवा.
Channels: WhatsApp, Telegram, Discord, Signal, iMessage, किंवा इतर channels आत्ताच configure करा, किंवा skip करून नंतर openclaw configure ने जोडा.
Web search: search provider असल्यास निवडा, नाहीतर सध्या skip करा.
Daemon/service install: Appbox आधीच container च्या आत OpenClaw supervise करते, त्यामुळे wizard ने daemon installation दिल्यास skip करा.
Health check: wizard ला health check run करू द्या.
Skills: wizard ला bundled skills तपासू द्या. Preferred node manager for skill installs विचारल्यास npm निवडा.

Onboarding पूर्ण झाल्यावर तुमच्या OpenClaw dashboard वर परत जा. Dashboard आधीच open असेल तर refresh करा आणि छोटा chat prompt test करा.

SSH वरून उपयुक्त follow-up commands:

openclaw configure
openclaw status --deep
openclaw health

API keys मिळवणे (dashboard links सह)

Keys generate करण्यासाठी हे provider consoles वापरा. शिफारस केलेल्या SSH method मध्ये, openclaw onboard विचारेल तेव्हा key paste करा. Backup dashboard method मध्ये, key Config > Secrets > Raw मध्ये merge करा.

आधी शिफारस: OpenRouter (बहुतेक users साठी सर्वोत्तम default)

आम्ही याची शिफारस का करतो:

अनेक model vendors साठी एकच key मिळते.
तुम्ही openrouter/auto वापरू शकता, जे task difficulty नुसार models switch करू शकते.
auto सोपी tasks स्वस्त models कडे route करून खर्च कमी करू शकते.

Key कशी मिळवावी:

OpenRouter वर जा आणि sign in करा.
API Keys settings उघडा.
Create क्लिक करा आणि key copy करा (ती एकदाच दाखवली जाते).
OpenClaw wizard तुमची OpenRouter API key विचारेल तेव्हा ती वापरा. Backup dashboard method साठी config key models.providers.openrouter.apiKey आहे.

OpenRouter API keys page screenshot from a public tutorial

Source tutorial: How to Get an OpenRouter API Key

OpenAI

Key कशी मिळवावी:

OpenAI Platform मध्ये sign in करा.
API Keys उघडा.
Create new secret key क्लिक करा.
ती लगेच copy करा (OpenAI पूर्ण value फक्त एकदाच दाखवते).

OpenAI API key settings screenshot from a public tutorial

Source tutorial: How to Get an OpenAI API Key

Anthropic

Key कशी मिळवावी:

Anthropic Console मध्ये sign in करा.
API Keys उघडा.
Create Key क्लिक करा.
Key लगेच copy करा (एकदाच दाखवली जाते).

Anthropic API key creation screenshot from a public tutorial

Source tutorial: How to get your Claude API key

Google (Gemini via AI Studio)

Key कशी मिळवावी:

Google AI Studio उघडा.
API Keys वर जा.
Create API key क्लिक करा (new किंवा existing project).
Key copy करून save करा.

Google AI Studio API key creation screenshot from a public tutorial

Source tutorial: Get Google AI API Key

Note: provider dashboards वारंवार बदलू शकतात आणि तुमच्या session state नुसार login prompt दाखवू शकतात.

Backup method: dashboard मध्ये provider auth configure करा

SSH उपलब्ध नसल्यास किंवा manual configuration पसंत असल्यासच ही पद्धत वापरा. Dashboard Raw editor चालतो, पण तो संपूर्ण OpenClaw config object एकाच वेळी edit करतो. Provider settings existing file मध्ये merge करताना Appbox gateway आणि skills defaults replace होणार नाहीत याची काळजी घ्या.

Installed app details page वरून तुमचा OpenClaw dashboard URL उघडा.
Config > Secrets वर जा.
Form ऐवजी Raw निवडा.
Reveal sensitive values button क्लिक करा (डोळ्यावर रेघ असलेल्या icon सारखा दिसतो).
खालील examples मधील provider settings तुमच्या existing config मध्ये Merge करा (How manual provider config fits in the full file पहा). Gateway, skills, आणि इतर Appbox defaults reset करायचा हेतू नसेल तर संपूर्ण file replace करू नका.
Configuration changes save आणि apply करा.

Manual provider config full file मध्ये कसे बसते

Config > Secrets > Raw एकाच object मध्ये संपूर्ण OpenClaw config edit करते. Appbox वर त्या file मध्ये आधीच gateway (bind, token auth, Control UI), skills.load.extraDirs (bundled skills), commands, आणि कधी कधी meta सारख्या गोष्टी असतात. Major provider examples section मधील snippets फक्त models साठी लागणारे भाग दाखवतात: models tree आणि agents.defaults.model.primary.

काय करावे: तुमच्या existing top-level keys (gateway, skills, commands, इ.) जपून ठेवा आणि या दोन sections add किंवा update करा:

models.providers — तुमचा provider (उदा. openrouter) आणि त्याचा apiKey, आवश्यक असल्यास baseUrl, आणि models list जोडा.
agents.defaults.model.primary — agent ने तो provider वापरावा म्हणून default model string (उदा. openrouter/auto) set करा.

models किंवा agents आधीच असतील, तर नवीन keys duplicate करण्याऐवजी त्या objects मध्ये merge करा.

खाली एक full Raw file shape चे JSON उदाहरण आहे (editor प्रत्यक्षात JSON5-style quotes देखील accept करू शकतो). तुमच्या real file मध्ये अधिक fields असू शकतात (उदा. richer model metadata, meta). पुढील examples मधील provider blocks हे येथे models आणि agents शी align करायचे भाग आहेत.

{
  "models": {
    "providers": {
      "openrouter": {
        "baseUrl": "https://openrouter.ai/api/v1",
        "apiKey": "YOUR_OPENROUTER_KEY",
        "models": [
          {
            "id": "auto",
            "name": "Auto (OpenRouter)",
            "reasoning": false,
            "input": ["text"],
            "cost": {
              "input": 0,
              "output": 0,
              "cacheRead": 0,
              "cacheWrite": 0
            },
            "contextWindow": 200000,
            "maxTokens": 8192
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "openrouter/auto"
      }
    }
  },
  "commands": {
    "native": "auto",
    "nativeSkills": "auto",
    "restart": true,
    "ownerDisplay": "raw"
  },
  "gateway": {
    "bind": "lan",
    "controlUi": {
      "dangerouslyAllowHostHeaderOriginFallback": true,
      "dangerouslyDisableDeviceAuth": true
    },
    "auth": {
      "mode": "token",
      "token": "YOUR_GATEWAY_TOKEN"
    }
  },
  "skills": {
    "load": {
      "extraDirs": ["/app/skills"]
    }
  }
}

Gateway token vs provider API key: gateway.auth.token फक्त OpenClaw Control UI / gateway मध्ये login करण्यासाठी आहे. models.providers.*.apiKey ही तुमची LLM vendor key (OpenRouter, OpenAI, इ.) आहे. त्या वेगळ्या आहेत.

Major provider examples

आधी एक provider block वापरा, तो चालतोय याची खात्री करा, मग अधिक providers जोडा. खालील प्रत्येक example हा merge fragment आहे: ... म्हणजे omitted config (वरच्या किंवा खालच्या lines), आणि "models" आधीचा }, म्हणजे तुमच्या file मध्ये models च्या वर असलेल्या key चा close (उदा. skills किंवा commands). Snippets स्वतःहून valid JSON नाहीत. models आणि agents sections तुमच्या root object मध्ये merge करा.

OpenRouter

...
  },
  "models": {
    "providers": {
      "openrouter": {
        "baseUrl": "https://openrouter.ai/api/v1",
        "apiKey": "sk-or-...",
        "models": [
          {
            "id": "auto",
            "name": "Auto (OpenRouter)"
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "openrouter/auto"
      }
    }
  },
...

OpenAI

...
  },
  "models": {
    "providers": {
      "openai": {
        "baseUrl": "https://api.openai.com/v1",
        "apiKey": "sk-...",
        "models": [
          {
            "id": "gpt-5.4",
            "name": "GPT-5.4"
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "openai/gpt-5.4"
      }
    }
  },
...

Anthropic

...
  },
  "models": {
    "providers": {
      "anthropic": {
        "baseUrl": "https://api.anthropic.com/v1",
        "apiKey": "sk-ant-...",
        "models": [
          {
            "id": "claude-opus-4-6",
            "name": "Claude Opus 4.6"
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "anthropic/claude-opus-4-6"
      }
    }
  },
...

Google (Gemini)

...
  },
  "models": {
    "providers": {
      "google": {
        "apiKey": "AIza...",
        "models": [
          {
            "id": "gemini-3.1-pro-preview",
            "name": "Gemini 3.1 Pro Preview"
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "google/gemini-3.1-pro-preview"
      }
    }
  },
...

xAI (Grok)

...
  },
  "models": {
    "providers": {
      "xai": {
        "apiKey": "xai-...",
        "models": [
          {
            "id": "grok-4",
            "name": "Grok 4"
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "xai/grok-4"
      }
    }
  },
...

Mistral

...
  },
  "models": {
    "providers": {
      "mistral": {
        "baseUrl": "https://api.mistral.ai/v1",
        "apiKey": "sk-...",
        "models": [
          {
            "id": "mistral-large-latest",
            "name": "Mistral Large Latest"
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "mistral/mistral-large-latest"
      }
    }
  },
...

Together AI

...
  },
  "models": {
    "providers": {
      "together": {
        "baseUrl": "https://api.together.xyz/v1",
        "apiKey": "together-...",
        "models": [
          {
            "id": "moonshotai/Kimi-K2.5",
            "name": "Kimi K2.5"
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "together/moonshotai/Kimi-K2.5"
      }
    }
  },
...

Bedrock note (API key नाही)

Amazon Bedrock API key ऐवजी AWS credentials (उदा. AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY, AWS_REGION) वापरते. Minimal provider entry अशी दिसते:

...
  },
  "models": {
    "providers": {
      "amazon-bedrock": {
        "baseUrl": "https://bedrock-runtime.us-east-1.amazonaws.com",
        "api": "bedrock-converse-stream",
        "auth": "aws-sdk",
        "models": [
          {
            "id": "us.anthropic.claude-opus-4-6-v1:0",
            "name": "Claude Opus 4.6 (Bedrock)"
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "amazon-bedrock/us.anthropic.claude-opus-4-6-v1:0"
      }
    }
  },
...

Notes

Gateway auth token आणि model provider API keys या वेगळ्या settings आहेत.
Provider error मिळाल्यास (उदा. missing Anthropic key), तुमचे default model तुम्ही configure केलेल्या provider वर update करा.
Provider validation fail झाल्यास, आधी required provider fields उपस्थित आहेत का ते पहा (baseUrl, models, आणि लागू असल्यास apiKey).

Official provider docs

Introduction

हे पृष्ठ GitHub वर edit करा GitHub वर चर्चा सुरू करा

उत्पादन

संसाधने

Apps

Contributing

MdxNew

Tutorials

OpenClaw model provider setup

शिफारस केलेली पद्धत: OpenClaw मध्ये SSH करून onboarding चालवा

आधी काय लागेल

macOS वरून connect करा

Windows वरून connect करा

OpenClaw onboarding wizard चालवा

API keys मिळवणे (dashboard links सह)

आधी शिफारस: OpenRouter (बहुतेक users साठी सर्वोत्तम default)

OpenAI

Anthropic

Google (Gemini via AI Studio)

Backup method: dashboard मध्ये provider auth configure करा

Manual provider config full file मध्ये कसे बसते

Major provider examples

OpenRouter

OpenAI

Anthropic

Google (Gemini)

xAI (Grok)

Mistral

Together AI

Bedrock note (API key नाही)

Notes

Official provider docs