OpenClaw-mallintarjoajan määritys

OpenClaw asennetaan Appboxissa ilman, että mallin API-avainta vaaditaan.

Suositeltu tapa viimeistellä määritys on muodostaa yhteys OpenClaw-sovellukseesi SSH:n kautta ja suorittaa sisäänrakennettu openclaw onboard -ohjattu toiminto. Ohjattu toiminto on turvallisempi kuin koko määrityksen muokkaaminen käsin, koska se säilyttää Appbox-yhdyskäytävän asetukset samalla kun se opastaa mallintarjoajien, API-avainten, kanavien, terveystarkistusten ja taitojen läpi.

Jos et voi tai et halua käyttää SSH:ta, käytä sen sijaan varamenetelmää hallintapaneelissa.

Suositeltu menetelmä: muodosta SSH-yhteys OpenClaw'hun ja suorita käyttöönotto

Käytä tätä menetelmää uusissa asennuksissa sekä olemassa olevissa asennuksissa, joihin pitää lisätä tai vaihtaa mallintarjoajan tunnistetiedot.

Mitä tarvitset ensin

• OpenClaw-sovelluksesi tietosivu Appboxissa.
• Määritysosiossa näkyvä SSH Command.
• Gateway Token / SSH Password. Tämä on sama luotu salaisuus, jota käytetään OpenClaw-hallintapaneelin kirjautumiseen.
• Mallintarjoajan tili tai API-avain. Jos sinulla ei vielä ole sellaista, katso API-avainten hankkiminen.

Sovelluksen tietosivulla näkyy valmiiksi kopioitava SSH-komento:

Yhdistä macOS:stä

1. Avaa Terminal tai iTerm2.
2. Kopioi SSH Command OpenClaw-sovelluksen tietosivulta.
3. Liitä ja suorita se. Se näyttää suunnilleen tältä:

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

4. Jos macOS kysyy, luotetaanko isäntään, kirjoita yes ja paina Enter.
5. Kun salasanaa pyydetään, liitä Gateway Token / SSH Password ja paina Enter. Terminal ei näytä merkkejä, kun kirjoitat tai liität salasanan.

Yhdistä Windowsista

Windows 10 ja Windows 11 sisältävät OpenSSH-asiakasohjelman oletuksena.

1. Avaa Windows Terminal tai PowerShell.
2. Kopioi SSH Command OpenClaw-sovelluksen tietosivulta.
3. Liitä ja suorita se:

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

4. Jos Windows kysyy, luotetaanko isäntään, kirjoita yes ja paina Enter.
5. Kun salasanaa pyydetään, liitä Gateway Token / SSH Password ja paina Enter. PowerShell ei näytä liitettyä salasanaa.

Jos Windows ilmoittaa, ettei ssh-komentoa tunnisteta, asenna OpenSSH Client kohdasta Asetukset > Järjestelmä > Valinnaiset ominaisuudet, avaa Windows Terminal uudelleen ja yritä uudestaan.

Suorita OpenClaw'n käyttöönoton ohjattu toiminto

Kun SSH-yhteys on muodostettu, suorita:

openclaw onboard

Ohjattu toiminto on interaktiivinen. Käytä näitä Appbox-kohtaisia valintoja:

1. Olemassa oleva määritys: valitse vaihtoehto nykyisen määrityksen tarkistamiseen tai muokkaamiseen. Älä valitse täyttä nollausta, ellet tarkoituksella halua rakentaa OpenClaw-määritystäsi uudelleen alusta.
2. Malli ja todennus: valitse tarjoajasi, kuten OpenRouter, OpenAI, Anthropic, Google, xAI tai mukautettu OpenAI-yhteensopiva tarjoaja. Liitä API-avain, kun ohjattu toiminto pyytää sitä. OpenRouter on helpoin oletus useimmille käyttäjille, koska yhdellä avaimella voi reitittää moniin malleihin. Jos sinulla on OpenAI Codex -tilaus, valitse tarjoajaluettelosta OpenAI Codex, ei vaihtoehtoa, jonka nimi on vain codex.
3. Oletusmalli: valitse malli, jota ohjattu toiminto suosittelee kyseiselle tarjoajalle, tai syötä provider/model-arvo käsin, kuten openrouter/auto.
4. Työtila: pidä oletustyötila, ellei sinulla ole erityistä syytä muuttaa sitä.
5. Yhdyskäytävän asetukset: säilytä olemassa olevat Appbox-yhdyskäytävän asetukset. Pidä erityisesti token-todennus käytössä ja säilytä olemassa olevat yhdyskäytävän portti- ja bind-asetukset.
6. Kanavat: määritä WhatsApp, Telegram, Discord, Signal, iMessage tai muut kanavat nyt, tai ohita ne ja lisää ne myöhemmin komennolla openclaw configure.
7. Verkkohaku: valitse hakutarjoaja, jos sinulla on sellainen, tai ohita se toistaiseksi.
8. Daemonin/palvelun asennus: Appbox valvoo OpenClaw'ta jo kontin sisällä, joten ohita daemonin asennus, jos ohjattu toiminto tarjoaa sitä.
9. Terveystarkistus: anna ohjatun toiminnon suorittaa terveystarkistus.
10. Taidot: anna ohjatun toiminnon tarkistaa mukana toimitetut taidot. Kun se kysyy Preferred node manager for skill installs, valitse npm.

Kun käyttöönotto valmistuu, palaa OpenClaw-hallintapaneeliin. Jos hallintapaneeli oli jo auki, päivitä se ja testaa lyhyellä chat-kehotteella.

Hyödyllisiä jatkokomentoja SSH:n kautta:

openclaw configure
openclaw status --deep
openclaw health

API-avainten hankkiminen (hallintapaneelilinkkien avulla)

Luo avaimet näissä tarjoajien konsoleissa. Suositellussa SSH-menetelmässä liitä avain, kun openclaw onboard pyytää sitä. Varamenetelmässä hallintapaneelissa yhdistä avain kohtaan Config > Secrets > Raw.

Suositus ensin: OpenRouter (paras oletus useimmille käyttäjille)

Miksi suosittelemme sitä:

• Se antaa yhden avaimen monille mallitoimittajille.
• Voit käyttää openrouter/auto-arvoa, joka voi vaihtaa mallia tehtävän vaikeuden mukaan.
• auto voi pienentää kustannuksia reitittämällä yksinkertaisemmat tehtävät halvempiin malleihin.

Näin hankit avaimen:

1. Siirry OpenRouteriin ja kirjaudu sisään.
2. Avaa API Keys -asetukset.
3. Napsauta Create ja kopioi avain (näytetään kerran).
4. Käytä sitä, kun OpenClaw'n ohjattu toiminto pyytää OpenRouter API -avaintasi. Varamenetelmässä hallintapaneelissa määritysavain on models.providers.openrouter.apiKey.

OpenAI

Näin hankit avaimen:

1. Kirjaudu OpenAI Platformiin.
2. Avaa API Keys.
3. Napsauta Create new secret key.
4. Kopioi se heti (OpenAI näyttää koko arvon vain kerran).

Anthropic

Näin hankit avaimen:

1. Kirjaudu Anthropic Consoleen.
2. Avaa API Keys.
3. Napsauta Create Key.
4. Kopioi avain heti (näytetään kerran).

Google (Gemini AI Studion kautta)

Näin hankit avaimen:

1. Avaa Google AI Studio.
2. Siirry kohtaan API Keys.
3. Napsauta Create API key (uusi tai olemassa oleva projekti).
4. Kopioi ja tallenna avain.

Huomautus: tarjoajien hallintapaneelit voivat muuttua usein ja saattavat näyttää kirjautumiskehotteen istuntosi tilan mukaan.

Varamenetelmä: määritä tarjoajan todennus hallintapaneelissa

Käytä tätä menetelmää vain, jos SSH ei ole käytettävissä tai haluat tehdä määrityksen käsin. Hallintapaneelin Raw-editori toimii, mutta se muokkaa koko OpenClaw-määritysoliota kerralla. Ole huolellinen ja yhdistä tarjoajan asetukset olemassa olevaan tiedostoon sen sijaan, että korvaisit Appboxin yhdyskäytävän ja taitojen oletukset.

1. Avaa OpenClaw-hallintapaneelin URL asennetun sovelluksen tietosivulta.
2. Siirry kohtaan Config > Secrets.
3. Valitse Raw Form-vaihtoehdon sijaan.
4. Napsauta Reveal sensitive values -painiketta (se näyttää yliviivatulta silmältä).
5. Yhdistä alla olevien esimerkkien tarjoaja-asetukset olemassa olevaan määritykseesi (katso Miten manuaalinen tarjoajamääritys sopii koko tiedostoon) — älä korvaa koko tiedostoa, ellet aio nollata yhdyskäytävää, taitoja ja muita Appbox-oletuksia.
6. Tallenna ja ota määritysmuutokset käyttöön.

Miten manuaalinen tarjoajamääritys sopii koko tiedostoon

Config > Secrets > Raw muokkaa koko OpenClaw-määritystä yhtenä oliona. Appboxissa kyseinen tiedosto sisältää jo esimerkiksi gateway-asetuksia (bind, token auth, Control UI), skills.load.extraDirs-asetuksen (mukana toimitetut taidot), commands-asetuksia ja joskus meta-tietoja. Tärkeimpien tarjoajien esimerkit -osion katkelmat näyttävät vain mallien kannalta tarvittavat osat: models-puun ja agents.defaults.model.primary-arvon.

Mitä tehdä: säilytä olemassa olevat ylätason avaimet (gateway, skills, commands jne.) ja lisää tai päivitä nämä kaksi osiota:

• models.providers — lisää tarjoajasi (esim. openrouter) ja sen apiKey, tarvittaessa baseUrl, sekä models-luettelo.
• agents.defaults.model.primary — aseta oletusmallin merkkijono (esim. openrouter/auto), jotta agentti käyttää kyseistä tarjoajaa.

Jos models tai agents ovat jo olemassa, yhdistä uudet avaimet näihin olioihin sen sijaan, että loisit ne kahdesti.

Alla on esimerkki yhden kokonaisen Raw-tiedoston muodosta JSON-muodossa (editori voi käytännössä hyväksyä myös JSON5-tyyliset lainausmerkit). Todellinen tiedostosi voi sisältää enemmän kenttiä (esim. rikkaampaa mallimetadataa, meta). Alempana olevien esimerkkien tarjoajalohkot ovat osat, jotka sovitat tässä models- ja agents-osioihin.

{
  "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 tarjoajan API-avain: gateway.auth.token on tarkoitettu vain kirjautumiseen OpenClaw Control UI:hin / yhdyskäytävään. models.providers.*.apiKey on LLM-toimittajasi avain (OpenRouter, OpenAI jne.) — ne ovat eri asioita.

Tärkeimpien tarjoajien esimerkit

Käytä aluksi yhtä tarjoajalohkoa kerrallaan, varmista että se toimii, ja lisää sitten lisää tarjoajia. Jokainen alla oleva esimerkki on yhdistettävä katkelma: ... tarkoittaa pois jätettyä määritystä (rivejä ylä- tai alapuolella), ja }, ennen "models"-avainta sulkee sen avaimen, joka tiedostossasi on models-avaimen yläpuolella (esimerkiksi skills tai commands). Katkelmat eivät ole yksinään kelvollista JSONia — yhdistä models- ja agents-osiot juuriolioon.

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-huomautus (ei API-avainta)

Amazon Bedrock käyttää AWS-tunnistetietoja (esimerkiksi AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY, AWS_REGION) API-avaimen sijaan. Vähimmäismuotoinen tarjoajamerkintä näyttää tältä:

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

Huomautukset

• Yhdyskäytävän todennustoken ja mallintarjoajan API-avaimet ovat eri asetuksia.
• Jos saat tarjoajavirheen (esimerkiksi puuttuva Anthropic-avain), päivitä oletusmalliksi tarjoaja, jonka olet määrittänyt.
• Jos tarjoajan validointi epäonnistuu, varmista ensin, että vaaditut tarjoajakentät ovat mukana (baseUrl, models ja apiKey tarvittaessa).

Viralliset tarjoajadokumentit

• OpenClaw-tarjoajahakemisto
• OpenRouter-tarjoaja
• OpenAI-tarjoaja
• Anthropic-tarjoaja
• Google-tarjoaja
• xAI-tarjoaja
• Mistral-tarjoaja
• Together AI -tarjoaja
• Amazon Bedrock -tarjoaja