Opsætning af OpenClaw-modeludbyder

OpenClaw installeres i Appbox uden at kræve en model-API-nøgle.

Den anbefalede måde at færdiggøre opsætningen på er at oprette forbindelse til din OpenClaw-app via SSH og køre den indbyggede openclaw onboard-guide. Guiden er sikrere end at redigere hele konfigurationen manuelt, fordi den bevarer Appbox-gatewayindstillingerne, mens den guider dig gennem modeludbydere, API-nøgler, kanaler, health checks og skills.

Hvis du ikke kan eller ikke vil bruge SSH, skal du i stedet bruge backup-dashboardmetoden.

Anbefalet metode: SSH ind i OpenClaw og kør onboarding

Brug denne metode til nye installationer og til eksisterende installationer, der har brug for at få tilføjet eller ændret legitimationsoplysninger til modeludbydere.

Det skal du bruge først

• Din OpenClaw-apps detaljeside i Appbox.
• Den SSH Command, der vises i sektionen Configuration.
• Din Gateway Token / SSH Password. Det er den samme genererede hemmelighed, der bruges til login på OpenClaw-dashboardet.
• En modeludbyderkonto eller API-nøgle. Hvis du endnu ikke har en, kan du se Hent API-nøgler.

Appens detaljeside viser den SSH-kommando, der er klar til at kopiere:

Opret forbindelse fra macOS

1. Åbn Terminal eller iTerm2.
2. Kopiér SSH Command fra OpenClaw-appens detaljeside.
3. Indsæt og kør den. Den vil ligne dette:

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

4. Hvis macOS spørger, om du vil stole på hosten, skal du skrive yes og trykke Enter.
5. Når du bliver bedt om en adgangskode, skal du indsætte din Gateway Token / SSH Password og trykke Enter. Terminal viser ingen tegn, mens du skriver eller indsætter adgangskoden.

Opret forbindelse fra Windows

Windows 10 og Windows 11 inkluderer OpenSSH-klienten som standard.

1. Åbn Windows Terminal eller PowerShell.
2. Kopiér SSH Command fra OpenClaw-appens detaljeside.
3. Indsæt og kør den:

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

4. Hvis Windows spørger, om du vil stole på hosten, skal du skrive yes og trykke Enter.
5. Når du bliver bedt om en adgangskode, skal du indsætte din Gateway Token / SSH Password og trykke Enter. PowerShell viser ikke den indsatte adgangskode.

Hvis Windows siger, at ssh ikke genkendes, skal du installere OpenSSH Client fra Settings > System > Optional features, derefter åbne Windows Terminal igen og prøve igen.

Kør OpenClaw-onboardingguiden

Når SSH-forbindelsen er oprettet, skal du køre:

openclaw onboard

Guiden er interaktiv. Brug disse Appbox-specifikke valg:

1. Eksisterende konfiguration: vælg muligheden for at gennemgå eller ændre den aktuelle konfiguration. Vælg ikke en fuld nulstilling, medmindre du bevidst vil genopbygge din OpenClaw-opsætning fra bunden.
2. Model og auth: vælg din udbyder, såsom OpenRouter, OpenAI, Anthropic, Google, xAI eller en brugerdefineret OpenAI-kompatibel udbyder. Indsæt API-nøglen, når guiden beder om den. OpenRouter er det nemmeste standardvalg for de fleste brugere, fordi én nøgle kan route til mange modeller. Hvis du har et OpenAI Codex-abonnement, skal du vælge OpenAI Codex på udbyderlisten, ikke en mulighed, der kun hedder codex.
3. Standardmodel: vælg den model, guiden anbefaler til den pågældende udbyder, eller indtast en provider/model-værdi manuelt, såsom openrouter/auto.
4. Workspace: behold standard-workspacet, medmindre du har en specifik grund til at ændre det.
5. Gatewayindstillinger: behold de eksisterende Appbox-gatewayindstillinger. Behold især token auth aktiveret, og behold de eksisterende gateway port/bind-indstillinger.
6. Kanaler: konfigurer WhatsApp, Telegram, Discord, Signal, iMessage eller andre kanaler nu, eller spring dem over og tilføj dem senere med openclaw configure.
7. Websøgning: vælg en søgeudbyder, hvis du har en, eller spring den over indtil videre.
8. Daemon/service-installation: Appbox overvåger allerede OpenClaw inde i containeren, så spring daemon-installation over, hvis guiden tilbyder det.
9. Health check: lad guiden køre health checket.
10. Skills: tillad guiden at tjekke medfølgende skills. Når den spørger om Preferred node manager for skill installs, skal du vælge npm.

Når onboarding er færdig, skal du vende tilbage til dit OpenClaw-dashboard. Hvis dashboardet allerede var åbent, skal du opdatere det og teste en kort chatprompt.

Nyttige opfølgende kommandoer via SSH:

openclaw configure
openclaw status --deep
openclaw health

Hent API-nøgler (med dashboardlinks)

Brug disse udbyderkonsoller til at generere nøgler. Med den anbefalede SSH-metode skal du indsætte nøglen, når openclaw onboard beder om den. Med backup-dashboardmetoden skal du flette nøglen ind i Config > Secrets > Raw.

Anbefalet først: OpenRouter (bedste standardvalg for de fleste brugere)

Derfor anbefaler vi den:

• Den giver én nøgle til mange modeludbydere.
• Du kan bruge openrouter/auto, som kan skifte modeller baseret på opgavens sværhedsgrad.
• auto kan reducere omkostninger ved at route enklere opgaver til billigere modeller.

Sådan får du en nøgle:

1. Gå til OpenRouter og log ind.
2. Åbn API Keys-indstillinger.
3. Klik på Create, og kopier nøglen (vises én gang).
4. Brug den, når OpenClaw-guiden beder om din OpenRouter API key. Ved backup-dashboardmetoden er konfigurationsnøglen models.providers.openrouter.apiKey.

Kildetutorial: Sådan får du en OpenRouter API Key

OpenAI

Sådan får du en nøgle:

1. Log ind på OpenAI Platform.
2. Åbn API Keys.
3. Klik på Create new secret key.
4. Kopiér den med det samme (OpenAI viser kun hele værdien én gang).

Kildetutorial: Sådan får du en OpenAI API Key

Anthropic

Sådan får du en nøgle:

1. Log ind på Anthropic Console.
2. Åbn API Keys.
3. Klik på Create Key.
4. Kopiér nøglen med det samme (vises én gang).

Kildetutorial: Sådan får du din Claude API key

Google (Gemini via AI Studio)

Sådan får du en nøgle:

1. Åbn Google AI Studio.
2. Gå til API Keys.
3. Klik på Create API key (nyt eller eksisterende projekt).
4. Kopiér og gem nøglen.

Kildetutorial: Hent Google AI API Key

Bemærk: udbyderdashboards kan ændre sig ofte og kan vise en loginprompt afhængigt af din sessionsstatus.

Backupmetode: konfigurer udbyder-auth i dashboardet

Brug kun denne metode, hvis SSH ikke er tilgængelig, eller hvis du foretrækker manuel konfiguration. Dashboardets Raw-editor virker, men den redigerer hele OpenClaw-konfigurationsobjektet på én gang. Vær omhyggelig med at flette udbyderindstillinger ind i den eksisterende fil i stedet for at erstatte Appbox' gateway- og skills-standarder.

1. Åbn din OpenClaw-dashboard-URL fra den installerede apps detaljeside.
2. Gå til Config > Secrets.
3. Vælg Raw i stedet for Form.
4. Klik på knappen Reveal sensitive values (som ligner et øje med en streg igennem).
5. Flet udbyderindstillingerne fra eksemplerne nedenfor ind i din eksisterende konfiguration (se Hvordan manuel udbyderkonfiguration passer ind i hele filen) — erstat ikke hele filen, medmindre du har til hensigt at nulstille gateway, skills og andre Appbox-standarder.
6. Gem og anvend konfigurationsændringerne.

Hvordan manuel udbyderkonfiguration passer ind i hele filen

Config > Secrets > Raw redigerer hele OpenClaw-konfigurationen i ét objekt. På Appbox indeholder den fil allerede ting som gateway (bind, token auth, Control UI), skills.load.extraDirs (medfølgende skills), commands og nogle gange meta. Snippets i sektionen Eksempler på større udbydere viser kun de dele, du har brug for til modeller: models-træet og agents.defaults.model.primary.

Det skal du gøre: behold dine eksisterende top-level-nøgler (gateway, skills, commands osv.) og tilføj eller opdater disse to sektioner:

• models.providers — tilføj din udbyder (f.eks. openrouter) og dens apiKey, baseUrl hvor det kræves, samt models-listen.
• agents.defaults.model.primary — angiv standardmodelstrengen (f.eks. openrouter/auto), så agenten bruger den udbyder.

Hvis models eller agents allerede findes, skal du flette nye nøgler ind i disse objekter i stedet for at duplikere dem.

Nedenfor er et eksempel på formen for én komplet Raw-fil som JSON (editoren kan i praksis også acceptere JSON5-lignende anførselstegn). Din rigtige fil kan indeholde flere felter (f.eks. mere omfattende modelmetadata, meta). Udbyderblokkene i eksemplerne længere nede er de dele, du skal tilpasse til models og agents her.

{
  "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 kontra udbyderens API-nøgle: gateway.auth.token er kun til login på OpenClaw Control UI / gateway. models.providers.*.apiKey er din LLM-udbydernøgle (OpenRouter, OpenAI osv.) — de er forskellige.

Eksempler på større udbydere

Brug først én udbyderblok ad gangen, bekræft at den virker, og tilføj derefter flere udbydere. Hvert eksempel nedenfor er et merge-fragment: ... er udeladt konfiguration (linjer over eller under), og }, før "models" er afslutningen på den nøgle, der ligger over models i din fil (for eksempel skills eller commands). Snippets er ikke gyldig JSON i sig selv — flet sektionerne models og agents ind i dit rodobjekt.

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 (ingen API-nøgle)

Amazon Bedrock bruger AWS-legitimationsoplysninger (for eksempel AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY, AWS_REGION) i stedet for en API-nøgle. En minimal udbyderpost ser sådan ud:

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

Noter

• Gateway auth-token og modeludbyderes API-nøgler er forskellige indstillinger.
• Hvis du får en udbyderfejl (for eksempel manglende Anthropic-nøgle), skal du opdatere din standardmodel til en udbyder, du har konfigureret.
• Hvis en udbyder fejler validering, skal du først sikre, at de påkrævede udbyderfelter er til stede (baseUrl, models og apiKey, hvor det er relevant).

Officiel udbyderdokumentation

• OpenClaw-udbyderoversigt
• OpenRouter-udbyder
• OpenAI-udbyder
• Anthropic-udbyder
• Google-udbyder
• xAI-udbyder
• Mistral-udbyder
• Together AI-udbyder
• Amazon Bedrock-udbyder