ДокументацијаDocumentationAppsOpenClaw model provider setup

Подешавање OpenClaw провајдера модела

Конфигуришите OpenClaw са API кључем било ког провајдера модела након инсталације.

OpenClaw се у Appbox инсталира без обавезног API кључа за модел.

Препоручени начин да завршите подешавање је да се повежете са својом OpenClaw апликацијом преко SSH и покренете уграђени чаробњак openclaw onboard. Чаробњак је безбеднији од ручног уређивања целе конфигурације зато што чува Appbox gateway подешавања док вас води кроз провајдере модела, API кључеве, канале, health check провере и skills.

Ако не можете или не желите да користите SSH, употребите резервни метод преко контролне табле.

Препоручени метод: SSH у OpenClaw и покретање уводног подешавања

Користите овај метод за нове инсталације и за постојеће инсталације у којима треба додати или променити акредитиве провајдера модела.

Шта вам је прво потребно

Страница са детаљима ваше OpenClaw апликације у Appbox.
SSH Command приказана у одељку Configuration.
Ваш Gateway Token / SSH Password. То је исти генерисани секрет који се користи за пријаву на OpenClaw контролну таблу.
Налог код провајдера модела или API кључ. Ако га још немате, погледајте Добијање API кључева.

Страница са детаљима апликације приказује SSH команду спремну за копирање:

Страница са детаљима Appbox OpenClaw апликације са истакнутом SSH командом

Повезивање са macOS-а

Отворите Terminal или iTerm2.
Копирајте SSH Command са странице са детаљима OpenClaw апликације.
Налепите је и покрените. Изгледаће слично овоме:

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

Ако macOS пита да ли да верује хосту, унесите yes и притисните Enter.
Када се затражи лозинка, налепите свој Gateway Token / SSH Password и притисните Enter. Terminal неће приказивати никакве знакове док куцате или лепите лозинку.

Повезивање са Windows-а

Windows 10 и Windows 11 подразумевано укључују OpenSSH клијент.

Отворите Windows Terminal или PowerShell.
Копирајте SSH Command са странице са детаљима OpenClaw апликације.
Налепите је и покрените:

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

Ако Windows пита да ли да верује хосту, унесите yes и притисните Enter.
Када се затражи лозинка, налепите свој Gateway Token / SSH Password и притисните Enter. PowerShell неће приказати налепљену лозинку.

Ако Windows каже да ssh није препознат, инсталирајте OpenSSH Client из Settings > System > Optional features, затим поново отворите Windows Terminal и покушајте поново.

Покретање OpenClaw чаробњака за уводно подешавање

Када се SSH повеже, покрените:

openclaw onboard

iTerm2 на macOS-у повезан са OpenClaw преко SSH и покреће команду openclaw onboard

Чаробњак је интерактиван. Користите ове Appbox специфичне изборе:

Existing config: изаберите опцију за преглед или измену тренутне конфигурације. Немојте бирати потпуно ресетовање осим ако намерно желите да изнова изградите своје OpenClaw подешавање.
Model and auth: изаберите свог провајдера, као што су OpenRouter, OpenAI, Anthropic, Google, xAI или прилагођени OpenAI-компатибилан провајдер. Налепите API кључ када чаробњак то затражи. OpenRouter је најлакши подразумевани избор за већину корисника јер један кључ може да усмерава ка многим моделима. Ако имате OpenAI Codex претплату, изаберите OpenAI Codex на листи провајдера, а не опцију која се зове само codex.
Default model: изаберите модел који чаробњак препоручује за тог провајдера или ручно унесите вредност provider/model, као што је openrouter/auto.
Workspace: задржите подразумевани workspace осим ако имате конкретан разлог да га промените.
Gateway settings: задржите постојећа Appbox gateway подешавања. Посебно задржите укључену token auth и постојећа gateway port/bind подешавања.
Channels: конфигуришите WhatsApp, Telegram, Discord, Signal, iMessage или друге канале сада, или их прескочите и додајте касније помоћу openclaw configure.
Web search: изаберите провајдера претраге ако га имате или га за сада прескочите.
Daemon/service install: Appbox већ надгледа OpenClaw унутар контејнера, па прескочите daemon инсталацију ако је чаробњак понуди.
Health check: дозволите чаробњаку да покрене health check.
Skills: дозволите чаробњаку да провери уграђене skills. Када пита Preferred node manager for skill installs, изаберите npm.

Када се уводно подешавање заврши, вратите се на OpenClaw контролну таблу. Ако је контролна табла већ била отворена, освежите је и тестирајте кратак chat prompt.

Корисне накнадне команде преко SSH:

openclaw configure
openclaw status --deep
openclaw health

Добијање API кључева (са линковима ка контролним таблама)

Користите ове конзоле провајдера да генеришете кључеве. Уз препоручени SSH метод, налепите кључ када openclaw onboard то затражи. Уз резервни метод преко контролне табле, спојите кључ у Config > Secrets > Raw.

Прво препоручено: OpenRouter (најбољи подразумевани избор за већину корисника)

Зашто га препоручујемо:

Даје један кључ за многе добављаче модела.
Можете користити openrouter/auto, који може да мења моделе на основу тежине задатка.
auto може да смањи трошкове усмеравањем једноставнијих задатака ка јефтинијим моделима.

Како да добијете кључ:

Идите на OpenRouter и пријавите се.
Отворите подешавања API кључева.
Кликните Create и копирајте кључ (приказује се једном).
Користите га када OpenClaw чаробњак затражи ваш OpenRouter API кључ. За резервни метод преко контролне табле, конфигурациони кључ је models.providers.openrouter.apiKey.

Снимак екрана OpenRouter странице API кључева из јавног водича

Изворни водич: Како добити OpenRouter API кључ

OpenAI

Како да добијете кључ:

Пријавите се на OpenAI Platform.
Отворите API Keys.
Кликните Create new secret key.
Одмах га копирајте (OpenAI приказује пуну вредност само једном).

Снимак екрана OpenAI подешавања API кључа из јавног водича

Изворни водич: Како добити OpenAI API кључ

Anthropic

Како да добијете кључ:

Пријавите се на Anthropic Console.
Отворите API Keys.
Кликните Create Key.
Одмах копирајте кључ (приказује се једном).

Снимак екрана креирања Anthropic API кључа из јавног водича

Изворни водич: Како добити свој Claude API кључ

Google (Gemini преко AI Studio)

Како да добијете кључ:

Отворите Google AI Studio.
Идите на API Keys.
Кликните Create API key (нови или постојећи пројекат).
Копирајте и сачувајте кључ.

Снимак екрана креирања API кључа у Google AI Studio из јавног водича

Изворни водич: Добијте Google AI API кључ

Напомена: контролне табле провајдера могу често да се мењају и могу приказати захтев за пријаву у зависности од стања ваше сесије.

Резервни метод: конфигурисање аутентификације провајдера у контролној табли

Користите овај метод само ако SSH није доступан или више волите ручну конфигурацију. Raw уређивач у контролној табли ради, али уређује цео OpenClaw конфигурациони објекат одједном. Пазите да спојите подешавања провајдера у постојећу датотеку уместо да замените Appbox подразумевана подешавања за gateway и skills.

Отворите URL своје OpenClaw контролне табле са странице са детаљима инсталиране апликације.
Идите на Config > Secrets.
Изаберите Raw уместо Form.
Кликните дугме Reveal sensitive values (изгледа као око прецртано линијом).
Спојите подешавања провајдера из примера испод у своју постојећу конфигурацију (погледајте Како се ручна конфигурација провајдера уклапа у целу датотеку) — немојте заменити целу датотеку осим ако намеравате да ресетујете gateway, skills и друга Appbox подразумевана подешавања.
Сачувајте и примените измене конфигурације.

Како се ручна конфигурација провајдера уклапа у целу датотеку

Config > Secrets > Raw уређује цео OpenClaw config у једном објекту. На Appbox-у та датотека већ садржи ствари као што су gateway (bind, token auth, Control UI), skills.load.extraDirs (уграђени skills), commands, а понекад и meta. Исечци у одељку Примери главних провајдера приказују само делове који су вам потребни за моделе: стабло models и agents.defaults.model.primary.

Шта треба да урадите: задржите постојеће кључеве највишег нивоа (gateway, skills, commands итд.) и додајте или ажурирајте ова два одељка:

models.providers — додајте свог провајдера (нпр. openrouter) и његов apiKey, baseUrl где је потребно, као и листу models.
agents.defaults.model.primary — подесите подразумевани model string (нпр. openrouter/auto) како би агент користио тог провајдера.

Ако models или agents већ постоје, спојите нове кључеве у те објекте уместо да их дуплирате.

Испод је пример облика једне целе Raw датотеке као JSON (уређивач у пракси може прихватити и JSON5 стил навођења). Ваша стварна датотека може садржати више поља (нпр. богатије metadata модела, meta). Блокови провајдера у примерима ниже су делови које овде усклађујете са models и agents.

{
  "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 насупрот API кључу провајдера: gateway.auth.token служи само за пријаву у OpenClaw Control UI / gateway. models.providers.*.apiKey је кључ вашег LLM добављача (OpenRouter, OpenAI итд.) — то су различите ствари.

Примери главних провајдера

Прво користите један блок провајдера, потврдите да ради, па онда додајте још провајдера. Сваки пример испод је фрагмент за спајање: ... је изостављена конфигурација (линије изнад или испод), а }, пре "models" затвара било који кључ који у вашој датотеци стоји изнад models (на пример skills или commands). Исечци сами по себи нису важећи JSON — спојите одељке models и agents у корени објекат.

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 (без API кључа)

Amazon Bedrock користи AWS акредитиве (на пример AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY, AWS_REGION) уместо API кључа. Минимални унос провајдера изгледа овако:

...
  },
  "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"
      }
    }
  },
...

Напомене

Gateway auth token и API кључеви провајдера модела су различита подешавања.
Ако добијете грешку провајдера (на пример недостаје Anthropic кључ), ажурирајте подразумевани модел на провајдера који сте конфигурисали.
Ако провајдер не прође валидацију, прво проверите да ли су присутна обавезна поља провајдера (baseUrl, models и apiKey где је применљиво).

Званична документација провајдера

Introduction

Измени ову страницу на GitHub-у Покрени дискусију на GitHub-у

Производ

Ресурси

Apps

Contributing

MdxNew

Tutorials

Подешавање OpenClaw провајдера модела

Препоручени метод: SSH у OpenClaw и покретање уводног подешавања

Шта вам је прво потребно

Повезивање са macOS-а

Повезивање са Windows-а

Покретање OpenClaw чаробњака за уводно подешавање

Добијање API кључева (са линковима ка контролним таблама)

Прво препоручено: OpenRouter (најбољи подразумевани избор за већину корисника)

OpenAI

Anthropic

Google (Gemini преко AI Studio)

Резервни метод: конфигурисање аутентификације провајдера у контролној табли

Како се ручна конфигурација провајдера уклапа у целу датотеку

Примери главних провајдера

OpenRouter

OpenAI

Anthropic

Google (Gemini)

xAI (Grok)

Mistral

Together AI

Напомена за Bedrock (без API кључа)

Напомене

Званична документација провајдера