Hoppa till huvudinnehåll

​
CLI-backends (reservruntime)

OpenClaw kan köra lokala AI CLI:er som en text-only fallback när API-leverantörer är nere, hastighetsbegränsade, eller tillfälligt missköter sig. Detta är avsiktligt konservativt:
  • Verktyg är inaktiverade (inga verktygsanrop).
  • Text in → text ut (pålitligt).
  • Sessioner stöds (så att uppföljande turer förblir sammanhängande).
  • Bilder kan skickas vidare om CLI:t accepterar bildsökvägar.
Detta är utformat som ett säkerhetsnät snarare än en primär väg. Använd den när du vill att “alltid fungerar” textsvar utan att förlita sig på externa API:er.

​
Nybörjarvänlig snabbstart

Du kan använda Claude Code CLI utan någon konfig (OpenClaw levereras med ett inbyggt standardval): 
openclaw agent --message "hi" --model claude-cli/opus-4.6
Codex CLI fungerar också direkt: 
openclaw agent --message "hi" --model codex-cli/gpt-5.3-codex
Om din gateway körs under launchd/systemd och PATH är minimal, lägg bara till kommandosökvägen: 
{
  agents: {
    defaults: {
      cliBackends: {
        "claude-cli": {
          command: "/opt/homebrew/bin/claude",
        },
      },
    },
  },
}
Det är det. Inga nycklar, ingen extra auth konfiguration behövs utöver CLI själv.

​
Använda det som reserv

Lägg till en CLI-backend i din reservlista så att den bara körs när primära modeller fallerar: 
{
  agents: {
    defaults: {
      model: {
        primary: "anthropic/claude-opus-4-6",
        fallbacks: ["claude-cli/opus-4.6", "claude-cli/opus-4.5"],
      },
      models: {
        "anthropic/claude-opus-4-6": { alias: "Opus" },
        "claude-cli/opus-4.6": {},
        "claude-cli/opus-4.5": {},
      },
    },
  },
}
Noteringar:
  • Om du använder agents.defaults.models (tillåtelselista) måste du inkludera claude-cli/....
  • Om den primära leverantören fallerar (autentisering, rate limits, timeouts) kommer OpenClaw att prova CLI-backenden härnäst.

​
Översikt över konfiguration

Alla CLI-backends finns under: 
agents.defaults.cliBackends
Varje post är knappad av ett leverantörs-id (t.ex. claude-cli, my-cli). Leverantörs-id blir den vänstra sidan av din modell ref: 
<provider>/<model>

​
Exempelkonfiguration

{
  agents: {
    defaults: {
      cliBackends: {
        "claude-cli": {
          command: "/opt/homebrew/bin/claude",
        },
        "my-cli": {
          command: "my-cli",
          args: ["--json"],
          output: "json",
          input: "arg",
          modelArg: "--model",
          modelAliases: {
            "claude-opus-4-6": "opus",
            "claude-opus-4-5": "opus",
            "claude-sonnet-4-5": "sonnet",
          },
          sessionArg: "--session",
          sessionMode: "existing",
          sessionIdFields: ["session_id", "conversation_id"],
          systemPromptArg: "--system",
          systemPromptWhen: "first",
          imageArg: "--image",
          imageMode: "repeat",
          serialize: true,
        },
      },
    },
  },
}

​
Hur det fungerar

  1. Väljer en backend baserat på leverantörsprefixet (claude-cli/...).
  2. Bygger en systemprompt med samma OpenClaw-prompt + arbetsytekontext.
  3. Kör CLI:t med ett sessions-id (om det stöds) så att historiken förblir konsekvent.
  4. Tolkar utdata (JSON eller ren text) och returnerar den slutliga texten.
  5. Består sessions-id:n per backend, så att uppföljningar återanvänder samma CLI-session.

​
Sessioner

  • Om CLI stöder sessioner, ange sessionArg (t.ex. --session-id) eller sessionArgs (platshållare {sessionId}) när ID måste infogas i flera flaggor.
  • Om CLI:t använder ett resume-underkommando med andra flaggor, sätt resumeArgs (ersätter args vid återupptagning) och valfritt resumeOutput (för icke-JSON-återupptagningar).
  • sessionMode:
    • always: skicka alltid ett sessions-id (ny UUID om ingen är lagrad).
    • existing: skicka bara ett sessions-id om ett tidigare har lagrats.
    • none: skicka aldrig ett sessions-id.

​
Bilder (vidarebefordran)

Om ditt CLI accepterar bildsökvägar, sätt imageArg: 
imageArg: "--image",
imageMode: "repeat"
OpenClaw kommer att skriva base64-bilder till temp-filer. Om imageArg är satt, dessa vägar skickas som CLI args. Om imageArg saknas, lägger OpenClaw till filsökvägarna till prompten (sökvägsinjektion), vilket är tillräckligt för CLIs som auto- ladda lokala filer från vanliga sökvägar (Claude Code CLI beteende).

​
In- / utdata

  • output: "json" (standard) försöker tolka JSON och extrahera text + sessions-id.
  • output: "jsonl" tolkar JSONL-strömmar (Codex CLI --json) och extraherar det sista agentmeddelandet plus thread_id när det finns.
  • output: "text" behandlar stdout som det slutliga svaret.
Indatalägen:
  • input: "arg" (standard) skickar prompten som sista CLI-argument.
  • input: "stdin" skickar prompten via stdin.
  • Om prompten är mycket lång och maxPromptArgChars är satt används stdin.

​
Standardvärden (inbyggda)

OpenClaw levereras med ett standardval för claude-cli:
  • command: "claude"
  • args: ["-p", "--output-format", "json", "--dangerously-skip-permissions"]
  • resumeArgs: ["-p", "--output-format", "json", "--dangerously-skip-permissions", "--resume", "{sessionId}"]
  • modelArg: "--model"
  • systemPromptArg: "--append-system-prompt"
  • sessionArg: "--session-id"
  • systemPromptWhen: "first"
  • sessionMode: "always"
OpenClaw levereras också med ett standardval för codex-cli:
  • command: "codex"
  • args: ["exec","--json","--color","never","--sandbox","read-only","--skip-git-repo-check"]
  • resumeArgs: ["exec","resume","{sessionId}","--color","never","--sandbox","read-only","--skip-git-repo-check"]
  • output: "jsonl"
  • resumeOutput: "text"
  • modelArg: "--model"
  • imageArg: "--image"
  • sessionMode: "existing"
Åsidosätt endast vid behov (vanligt: absolut command-sökväg).

​
Begränsningar

  • Inga OpenClaw-verktyg (CLI-backend tar aldrig emot verktygssamtal). Vissa CLI:er kan fortfarande köra sin egen agent verktyg.
  • Ingen streaming (CLI-utdata samlas in och returneras sedan).
  • Strukturerade utdata beror på CLI:ts JSON-format.
  • Codex CLI-sessioner återupptas via textutmatning (ingen JSONL), vilket är mindre strukturerat än den initiala --json körningen. OpenClaw-sessioner fungerar fortfarande normalt.

​
Felsökning

  • CLI hittas inte: sätt command till en fullständig sökväg.
  • Fel modellnamn: använd modelAliases för att mappa provider/model → CLI-modell.
  • Ingen sessionskontinuitet: säkerställ att sessionArg är satt och att sessionMode inte är none (Codex CLI kan för närvarande inte återuppta med JSON-utdata).
  • Bilder ignoreras: sätt imageArg (och verifiera att CLI:t stöder filsökvägar).