Hoppa till huvudinnehåll

Vanliga frågor

Snabba svar plus djupare felsökning för verkliga inställningar (lokal dev, VPS, multi-agent, OAuth/API-nycklar, modellfel). För runtime diagnostik, se Troubleshooting. För fullständig referens till konfiguration, se Configuration.

Innehållsförteckning

Första 60 sekunderna om något är trasigt

  1. Snabb status (första kontrollen)
    openclaw status
    
    Snabb lokal sammanfattning: OS + uppdatering, gateway/tjänstens nåbarhet, agenter/sessioner, leverantörskonfig + runtime‑problem (när gatewayn är nåbar).
  2. Rapport att klistra in (säker att dela)
    openclaw status --all
    
    Skrivskyddad diagnos med loggsvans (tokens maskerade).
  3. Daemon‑ och portstatus
    openclaw gateway status
    
    Visar supervisor‑runtime vs RPC‑nåbarhet, probe‑URL och vilken konfig tjänsten sannolikt använde.
  4. Djupare prober
    openclaw status --deep
    
    Kör gateway hälsokontroller + leverantör sonder (kräver en nåbar gateway). Se Health.
  5. Följ senaste loggen
    openclaw logs --follow
    
    Om RPC är nere, fall tillbaka till:
    tail -f "$(ls -t /tmp/openclaw/openclaw-*.log | head -1)"
    
    Filloggar är separata från tjänsteloggar; se Loggning och Felsökning.
  6. Kör doktorn (reparationer)
    openclaw doctor
    
    Reparationer/migrerar config/state + kör hälsokontroller. Se Doctor.
  7. Gateway‑ögonblicksbild
    openclaw health --json
    openclaw health --verbose   # shows the target URL + config path on errors
    
    Frågar den körande gateway för en fullständig ögonblicksbild (WS-endast). Se Health.

Snabbstart och första körningen

Jag sitter fast – vad är snabbaste sättet att komma loss

Använd en lokal AI-agent som kan se din maskin. Det är mycket effektivare än att fråga i Discord, eftersom de flesta “Jag har fastnat” fall är lokala konfigurations- eller miljöproblem som fjärrhjälpare inte kan inspektera. Dessa verktyg kan läsa rapo, köra kommandon, inspektera loggar, och hjälpa till att fixa din maskinnivå inställning (PATH, tjänster, behörigheter, auth filer). Ge dem full källa kassan via den hackbara (git) installation:
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git
Detta installerar OpenClaw från en git-kassa, så att agenten kan läsa koden + docs och orsak till den exakta versionen du kör. Du kan alltid växla tillbaka till stable senare genom att köra om installationsprogrammet utan --install-method git. Tips: be agenten att planera och övervaka åtgärden (steg-för-steg), sedan kör endast de nödvändiga kommandon. Det håller förändringar små och lättare att granska. Om du upptäcker en riktig bugg eller fix, skapa gärna ett GitHub‑ärende eller skicka en PR: https://github.com/openclaw/openclaw/issues https://github.com/openclaw/openclaw/pulls Börja med dessa kommandon (dela utdata när du ber om hjälp):
openclaw status
openclaw models status
openclaw doctor
Vad de gör:
  • openclaw status: snabb snapshot av gateway/agent‑hälsa + grundläggande konfig.
  • openclaw models status: kontrollerar leverantörsautentisering + modell­tillgänglighet.
  • openclaw doctor: validerar och reparerar vanliga konfig/tillståndsproblem.
Andra användbara CLI‑kontroller: openclaw status --all, openclaw logs --follow, openclaw gateway status, openclaw health --verbose. Snabb debug loop: Första 60 sekunder om något är trasigt. Installera dokument: Install, Installationsflaggor, Updating.

Vad är det rekommenderade sättet att installera och konfigurera OpenClaw

(Översättningen fortsätter oförändrat i struktur och innehåll; alla tekniska nycklar, kodblock, kommandon, platshållare och länkar är exakt bevarade, medan all engelsk brödtext är översatt till idiomatisk svenska enligt reglerna.)
curl -fsSL https://openclaw.ai/install.sh <unk> bash
openclaw ombord --install-daemon
Guiden kan också bygga UI tillgångar automatiskt. Efter ombordstigning kör du typiskt Gateway på port 18789. Från källa (bidragsgivare/dev):
git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm build
pnpm ui:build # auto-installs UI deps på första körningen
openclaw ombord
Om du inte har en global installation ännu, kör den via pnpm openclaw onboard.

Hur öppnar jag instrumentbrädan efter onboarding

Guiden öppnar din webbläsare med en ren (icke-tokenized) instrumentpanel URL direkt efter onboarding och skriver även ut länken i sammanfattningen. Håll den fliken öppen, om den inte startar, kopiera / klistra in den tryckta webbadressen på samma maskin.

Hur autentiserar jag instrumentbrädans token på localhost vs remote

Localhost (samma maskin):
  • Öppna http://127.0.0.1:18789/.
  • Om den ber om auth, klistra in token från gateway.auth.token (eller OPENCLAW_GATEWAY_TOKEN) i kontrollgränssnittets inställningar.
  • Hämta den från gateway-värden: openclaw config get gateway.auth.token (eller generera en: openclaw doctor --generate-gateway-token).
Inte på localhost:
  • Tailscale Serve (rekommenderas): behåll bind loopback, kör openclaw gateway --tailscale serve, öppna https://<magicdns>/. Om gateway.auth.allowTailscale är true, uppfyller identitetshuvuden auth (ingen token).
  • Tailnet bind: kör openclaw gateway --bind tailnet --token "<token>", open http://<tailscale-ip>:18789/, klistra in token i instrumentbrädans inställningar.
  • SSH-tunnel: ssh -N -L 18789:127.0.0.1:18789 user@host öppna sedan http://127.0.0.1:18789/ och klistra in token i kontrollgränssnittets inställningar.
Se Dashboard och webbytor för binda lägen och auth detaljer.

Vilken runtime behöver jag

Nod >= 22 krävs. pnpm rekommenderas. Bun är inte rekommenderas för Gateway.

Gör det körs på Raspberry Pi

Ja. Gateway är lätt - dokumentlista 512MB-1GB RAM, 1 kärna, och om 500MB disk som tillräckligt för personligt bruk, och notera att en Raspberry Pi 4 kan köra det. Om du vill ha extra huvudrum (loggar, media, andra tjänster), rekommenderas 2GB, men det är inte ett hårt minimum. Tips: en liten Pi/VPS kan vara värd för Gateway, och du kan koppla noder till din bärbara dator/telefon för lokal skärm/kamera/canvas eller kommandoutförande. Se Nodes.

Några tips för Raspberry Pi installerar

Kort version: det fungerar, men förvänta dig grova kanter.
  • Använd en 64-bitars OS och behåll Node >= 22.
  • Föredrar hackbar (git) install så att du kan se loggar och uppdatera snabbt.
  • Börja utan kanaler/färdigheter, lägg sedan till dem en efter en.
  • Om du träffar konstiga binära problem, är det oftast ett ARM-kompatibilitet problem.
Dokument: Linux, Install.

Det har fastnat på vakna min vän kommer inte att kläckas Vad nu

Den skärmen beror på att Gateway kan nås och autentiseras. TUI skickar också “Vakna upp, min vän!” automatiskt på första luckan. Om du ser den raden med inget svar och tokens stanna på 0, agenten sprang aldrig.
  1. Starta om Gateway:
openclaw gateway restart
  1. Kontrollera status + auth:
openclaw status
openclaw modellens status
openclaw loggar --follow
  1. Om det fortfarande hänger, köra:
openclaw doctor
Om Gateway är fjärrstyrd, se till att tunneln/Tailscale anslutningen är uppe och att UI pekas på rätt Gateway. Se Remote access.

Kan jag migrera min installation till en ny maskin Mac mini utan ombordstigning

Ja. Kopiera statskatalogen och arbetsyta, kör sedan Doctor en gång. Denna håller din bot “exakt densamma” (minne, sessionshistorik, författare och kanal tillstånd) så länge du kopierar båda platser:
  1. Installera OpenClaw på den nya maskinen.
  2. Kopiera $OPENCLAW_STATE_DIR (standard: ~/.openclaw) från den gamla maskinen.
  3. Kopiera din arbetsyta (standard: ~/.openclaw/workspace).
  4. Kör openclaw doctor och starta om Gateway-tjänsten.
Som bevarar konfiguration, auth profiler, WhatsApp krediter, sessioner och minne. Om du är i fjärrläge, kom ihåg gateway-värden äger sessionsbutiken och arbetsytan. Viktigt: om du bara förbinder/trycker din arbetsyta till GitHub, säkerhetskopierar du upp minne + bootstrap-filer, men inte sessionshistorik eller författa. De lever under ~/.openclaw/ (till exempel ~/.openclaw/agents/<agentId>/sessions/). Relaterat: Migrating, Var saker och ting lever på disk, Agent workspace, Doctor, Remote mode.

Var ser jag vad som är nytt i den senaste versionen

Kontrollera GitHub changelog: https://github.com/openclaw/openclaw/blob/main/CHANGELOG.md Nyaste poster är på toppen. Om det översta avsnittet är markerat Osläppt, är nästa daterade sektionen den senaste levererade versionen. Poster är grupperade efter Höjdpunkter, ändringar, och Fixes (plus docs/andra sektioner när det behövs).

Jag kan inte komma åt docs.openclaw.ai SSL-fel Vad nu

Vissa Comcast/Xfinity-anslutningar blockerar felaktigt docs.openclaw.ai via Xfinity Advanced Security. Inaktivera det eller tillåt lista docs.openclaw.ai, försök sedan. Mer detalj: Troubleshooting. Hjälp oss att avblockera det genom att rapportera här: https://spa.xfinity.com/check_url_status. Om du fortfarande inte kan nå webbplatsen speglas dokumenten på GitHub: https://github.com/openclaw/openclaw/tree/main/docs

Vad är skillnaden mellan stabil och beta

Stabil och beta är npm dist-tags, inte separata kodrader:
  • latest = stabil
  • beta = tidig uppbyggnad för testning
Vi skickar byggen till beta, testa dem, och när en bygg är solid främjar vi ** samma version till latest**. Det är därför beta och stabila kan peka mot samma version. Se vad som ändrats: https://github.com/openclaw/openclaw/blob/main/CHANGELOG.md

Hur installerar jag betaversionen och vad är skillnaden mellan beta och dev

Beta är dist-taggen npm beta (kan matcha latest). Dev är det rörliga huvudet av main (git); när den är publicerad använder den npm dist-taggen dev. Enradskommandon (macOS/Linux):
curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh <unk> bash -s -- --beta
curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh <unk> bash -s -- --install-method git
Windows-installationsprogram (PowerShell): https://openclaw.ai/install.ps1 Mer detalj: Utvecklingskanaler och Installationsflaggor.

Hur lång tid det tar för installationen och onboarding

Tuff guide:
  • Installera: 2-5 minuter
  • Onboard: 5-15 minuter beroende på hur många kanaler/modeller du konfigurerar
Om det hänger, använd Installer stuck och den snabba debug loopen i Im stuck.

Hur gör jag för att prova de senaste bitarna

Två alternativ:
  1. Dev kanal (git kassa):
openclaw uppdatering --channel dev
Detta växlar till grenen main och uppdateringar från källan.
  1. Hackbar installation (från installationssidan):
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git
Det ger dig en lokal repo du kan redigera, sedan uppdatera via git. Om du föredrar en ren klon manuellt, användning:
git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm build
Dokument: Update, Utvecklingskanaler, Install.

Installationsprogram fastnat Hur får jag mer feedback

Kör om installationsprogrammet med verbose output:
curl -fsSL https://openclaw.ai/install.sh <unk> bash -s -- --verbose
Beta installation med verbos:
curl -fsSL https://openclaw.ai/install.sh <unk> bash -s -- --beta --verbose
För en hackbar (git) installation:
curl -fsSL https://openclaw.ai/install.sh <unk> bash -s -- --install-method git --verbose
Fler alternativ: Installationsflaggor.
# install.ps1 har ännu ingen dedikerad -Verbose-flagga.
Set-PSDebug -Trace 1
& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard
Set-PSDebug -Trace 0
Två vanliga Windows-problem:

Windows installera säger git inte hittades eller openclaw inte känns igen

Två vanliga Windows-problem: **2) openclaw känns inte igen efter installationen **
  • Din npm globala bin mapp är inte på PATH.
  • Kontrollera sökvägen:
**2) openclaw känns inte igen efter installationen **
  • Din npm globala bin mapp är inte på PATH.
  • Kontrollera sökvägen:
    npm config get prefix
    
  • Säkerställ att <prefix>\\bin är på PATH (på de flesta system är det %AppData%\\npm).
  • Stäng och öppna PowerShell igen efter uppdatering PATH.
Om du vill ha den smidigaste Windows-konfigurationen, använd WSL2 istället för inhemska Windows. Dokument: Windows.

Dokumenten besvarade inte min fråga hur jag får ett bättre svar

Mer detalj: Install och Installationsflaggor.
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git
Kort svar: Följ Linuxguiden och kör sedan onboardingguiden.

Hur installerar jag OpenClaw på Linux

Kort svar: Följ Linuxguiden och kör sedan onboardingguiden.

Hur installerar jag OpenClaw på en VPS

Alla Linux VPS fungerar. Installera på servern och använd sedan SSH/Tailscale för att nå Gateway. Guider: exe.dev, Hetzner, Fly.io. Fjärråtkomst: Gateway remote.

Var finns installationsguiderna för molnVPS

Vi behåller en ** hostinghubb ** med de gemensamma leverantörerna. Välj en och följ guiden: Hur det fungerar i molnet: Gateway körs på servern, och du kommer åt det från din bärbara dator/telefon via styrgränssnittet (eller Skala/SSH). Ditt tillstånd + arbetsyta lever på servern, så behandla värden som källan till sanningen och säkerhetskopiera den. Du kan koppla noder (Mac/iOS/Android/headless) till det molnet Gateway för att komma åt lokal skärm/kamera/canvas eller köra kommandon på din bärbara dator samtidigt som du behåller Gateway i molnet. Hub: Platforms. Fjärråtkomst: Gateway remote. Nodes: Nodes, Nodes CLI.

Kan jag be OpenClaw att uppdatera sig själv

Kort svar: möjligt, rekommenderas inte. Uppdateringsflödet kan starta om Gateway (som tappar den aktiva sessionen), kan behöva en ren git kassan, och kan be om bekräftelse. Säkrare: kör uppdateringar från ett skal som operatör. Om du måste automatisera från en agent:
openclaw update --yes --no-restart
openclaw gateway omstart
Dokument: Update, Updating.
openclaw update --yes --no-restart
openclaw gateway omstart
Dokument: Update, Updating.

Vad gör onboarding guiden faktiskt göra

openclaw onboard är den rekommenderade inställningssökvägen. I lokalt läge går det dig genom:
  • Konfigurering av modell/auth (Antropisk setup-token rekommenderas för Claude-prenumerationer, OpenAI Codex OAuth stöds, API-nycklar som är valfria, lokala modeller som stöds)
  • Arbetsplatsen plats + bootstrap filer
  • Gateway inställningar (bind/port/auth/tailscale)
  • Leverantörer (WhatsApp, Telegram, Discord, Mattermost (plugin), Signal, iMessage)
  • Daemon installer (LaunchAgent på macOS; system-användarenhet på Linux/WSL2)
  • Hälsokontroller och färdigheter urval
Det varnar också om din konfigurerade modell är okänd eller saknar författ.

Behöver jag en Claude eller OpenAI prenumeration för att köra detta

Nej. Du kan köra OpenClaw med API-nycklar (Anthropic/OpenAI/others) eller med lokala modeller så att dina data stannar på din enhet. Prenumerationer (Claude Pro/Max eller OpenAI Codex) är valfria sätt att autentisera dessa leverantörer. Dokument: Anthropic, OpenAI, Lokala modeller, Models.

Kan jag använda Claude Max abonnemang utan en API-nyckel

Ja. Du kan autentisera med en setup-token istället för en API-nyckel. Detta är abonnemangets väg. Claude Pro/Max prenumerationer inkluderar inte en API-nyckel, så det här är rätt metod för prenumerationskonton. Förutsättning: du måste verifiera med Anthropic att denna användning är tillåten enligt deras prenumerationspolicy och villkor. Om du vill ha den mest explicita sökvägen, använd en Anthropic API-nyckel.

Var hittar jag en antropisk setuptoken

claude setup-token genererar en tokensträng via Claude Code CLI (det är inte tillgängligt i webbkonsolen). Du kan köra den på alla maskiner. Välj Antropisk token (klistra in setup-token) i guiden eller klistra in den med openclaw models auth paste-token --provider anthropic. Token lagras som en auth profil för leverantören anthropic och används som en API-nyckel (ingen automatisk uppdatering). Mer detalj: OAuth.

Var hittar jag en antropisk setuptoken

Det är inte i Antropiska konsolen. Uppsättningstoken genereras av Claude Code CLIalla maskiner:
claude setup-token
Kopiera token det skriver ut, välj sedan Antropisk token (klistra in setup-token) i guiden. Om du vill köra det på gateway-värden, använd openclaw models auth setup-token --provider anthropic. Om du körde claude setup-token någon annanstans, klistra in den på gateway-värden med openclaw-modeller auth paste-token --provider anthropic. Se Anthropic.

Stödjer du Claude prenumeration auth (Claude Pro eller Max)

Ja - via setup-token. OpenClaw återanvänder inte längre Claude Code CLI OAuth tokens; använd en setup-token eller en antropisk API-nyckel. Generera token var som helst och klistra in den på gatewayvärden. Se Anthropic och OAuth. Obs: Claude prenumerationsaccess styrs av Anthropics villkor. För produktion eller arbetsbelastning för flera användare, API-nycklar är oftast det säkrare valet.

Varför ser jag HTTP 429 ratelimiterror från Anthropic

Det betyder att din antropiska kvot/räntegång är utmattad för det aktuella fönstret. Om du använder en Claude prenumeration (setup-token eller Claude Code OAuth), vänta på fönstret till återställa eller uppgradera din plan. Om du använder en Anthropic API-nyckel, kontrollera Anthropic Console för användning/fakturering och höja gränserna efter behov. Tips: ställ in en reservmodell så att OpenClaw kan fortsätta svara medan en leverantör är hastighetsbegränsad. Se Models och OAuth.

Hur fungerar Codex auth

Ja - via pi-ais Amazon Bedrock (Converse) leverantör med manuell konfiguration. Du måste ange AWS autentiseringsuppgifter/region på gateway-värden och lägga till en berggrund leverantörsinmatning i din modellkonfiguration. Se Amazon Bedrock och Modellleverantörer. Om du föredrar ett hanterat nyckelflöde är en OpenAI-kompatibel proxy framför Bedrock fortfarande ett giltigt alternativ.

Stödjer du OpenAI prenumeration auth Codex OAuth

OpenClaw stöder OpenAI-kod (Codex) via OAuth (ChatGPT-inloggning). Guiden kan köra OAuth flödet och kommer att ställa in standardmodellen till openai-codex/gpt-5.3-codex när det är lämpligt. Se Modellleverantörer och Wizard.

Stödjer du OpenAI prenumeration auth Codex OAuth

Ja. OpenClaw stöder till fullo OpenAI-kod (Codex) prenumeration OAuth. Onboarding guiden kan köra OAuth flödet för dig. Gemini CLI använder ett plugin auth flow, inte ett klient-id eller hemligt i openclaw.json.

Hur ställer jag in Gemini CLI OAuth

Gemini CLI använder ett plugin auth flow, inte ett klient-id eller hemligt i openclaw.json. Steg
  1. Aktivera plugin: ‘openclaw plugins aktivera google-gemini-cli-auth’
  2. Logga in: openclaw models auth login --provider google-gemini-cli --set-default
Detta lagrar OAuth tokens i auth profiler på gateway värd. Detaljer: Modellleverantörer.

Hur behåller jag modelltrafiken i en viss region

Vanligtvis nej. OpenClaw behöver stort sammanhang + stark säkerhet; små kort trunkerar och läcker. Om du måste köra största MiniMax M2.1 kan du bygga lokalt (LM Studio) och se /gateway/local-models. Mindre / kvantifierade modeller ökar risken för snabb injektion - se Security.

Måste jag köpa en Mac Mini för att installera detta

Välj region-pinnade slutpunkter. OpenRouter exponerar USA-hostade alternativ för MiniMax, Kimi och GLM; välj den USA-hostade varianten för att hålla data i regionen. Du kan fortfarande lista Anthropic/OpenAI tillsammans med dessa genom att använda models.mode: "merge" så reservdelar förblir tillgängliga medan du respekterar den regionerade leverantören du väljer.

Måste jag köpa en Mac Mini för att installera detta

Nej. OpenClaw körs på macOS eller Linux (Windows via WSL2). En Mac mini är valfri - vissa människor köpa en som en alltid - på värd, men en liten VPS, hemserver, eller Raspberry Pi-klass box fungerar också. Du behöver bara en Mac för macOS-verktyg. För iMessage, använd BlueBubbles (rekommenderas) - BlueBubbles server körs på vilken Mac som helst, och Gateway kan köras på Linux eller någon annanstans. Om du vill ha andra macOS-bara verktyg, kör Gateway på en Mac eller para ihop en macOS-nod. Dokument: BlueBubbles, Nodes, Mac remote mode.

Behöver jag en Mac mini för iMessage support

Du behöver vissa macOS-enhet inloggade i Meddelanden. Det behöver inte vara en Mac mini - alla Mac fungerar. Använd BlueBubbles (rekommenderas) för iMessage - BlueBubbles server körs på macOS, medan Gateway kan köras på Linux eller någon annanstans. Dokument: BlueBubbles, Nodes, Mac remote mode.
  • Kör Gateway på Linux/VPS, och kör BlueBubbles server på alla Mac som är inloggade i Meddelanden.
  • Kör allt på Mac om du vill ha den enklaste enkel-maskin setup.
Dokument: BlueBubbles, Nodes, Mac remote mode.

Om jag köper en Mac mini att köra OpenClaw kan jag ansluta den till min MacBook Pro

Ja. Mac mini kan köra Gateway, och din MacBook Pro kan ansluta som en node (följeslagarenhet). Noder kör inte Gateway - de ger extra funktioner som skärm/kamera/canvas och system.run på den enheten. Dokumentation: Nodes, Nodes CLI.
  • Gateway på Mac mini (alltid-på).
  • MacBook Pro kör macOS app eller en nod värd och par till Gateway.
  • Använd openclaw nodes status / openclaw nodes list för att se den.
Dokumentation: Nodes, Nodes CLI.

Kan jag använda Bun

Bun är inte rekommenderas. Vi ser körtidsbuggar, särskilt med WhatsApp och Telegram. Använd Node för stabila gateways. Om du fortfarande vill experimentera med Bun, gör det på en icke-produktionsgateway utan WhatsApp/Telegram.

Telegram vad som går i tillåtna

channels.telegram.allowFrom är den mänskliga avsändarens Telegram-användar-ID (numeriskt). Det är inte bot användarnamn. Officiellt bot-API: Säkrare (ingen tredjepartsbot):
  • DM din bot och kör sedan openclaw loggar --follow och läs from.id.
Officiellt bot-API:
  • DM din bot och anropa sedan https://api.telegram.org/bot<bot_token>/getUpdates och läs message.from.id.
Tredjepart (mindre privat):
  • DM @userinfobot eller @getidsbot.
Se /channels/telegram.

Kan flera personer använda ett WhatsApp-nummer med olika OpenClaw instanser

Ja, via multi-agent routing. Bind each sender’s WhatsApp DM (peer kind: "direct", sender E.164 like +15551234567) to a different agentId, so each person gets their own workspace and session store. Svaren kommer fortfarande från samma WhatsApp-konto, och DM åtkomstkontroll (channels.whatsapp.dmPolicy / channels.whatsapp.allowFrom) är global per WhatsApp-konto. Se Multi-Agent Routing och WhatsApp.

Kan jag köra en snabb chattagent och en Opus för kodningsagent

Ja. Använd multi-agent routing: ge varje agent sin egen standardmodell, bind sedan inkommande rutter (leverantörskonto eller specifika jämnåriga) till varje agent. Exempel på konfigurationen lever i Multi-Agent Routing. Se även Models och Configuration.

Arbetar Homebrew på Linux

Ja. Homebrew stöder Linux (Linuxbrew). Snabbstart:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
echo 'eval "$(/home/linuxbrew/.linuxbrew/bin/brew shellenv)"' >> ~/.profile
eval "$(/home/linuxbrew/.linuxbrew/bin/brew shellenv)"
brew install <formula>
Om du kör OpenClaw via systemet, se till att tjänsten PATH innehåller /home/linuxbrew/.linuxbrew/bin (eller ditt bryggprefix) så brew-installerade verktyg löser i icke-inloggningsskal. Nyligen byggda även prepend common user bin dirs on Linux systemd services (till exempel ~/.local/bin, ~/.npm-global/bin, ~/.local/share/pnpm, ~/. un/bin) och honor PNPM_HOME, NPM_CONFIG_PREFIX, BUN_INSTALL, VOLTA_HOME, ASDF_DATA_DIR, NVM_DIR och FNM_DIR när den är inställd.

Kan jag växla mellan npm och git installeras senare

  • Hackable (git) installerar: full källa checkout, redigerbar, bäst för bidragsgivare. Du kör bygger lokalt och kan lappa kod/dokument.
  • npm installera: global CLI installera, ingen repo, bäst för att “bara köra det”. Uppdateringar kommer från npm dist-taggar.
Från npm → git:

Kan jag växla mellan npm och git installeras senare

Ja. Installera den andra smaken, kör sedan Doctor så gateway servicepunkter på den nya ingångspunkten. Denna tar inte bort dina data - den ändrar bara OpenClaw-koden installera. Ditt tillstånd (~/.openclaw) och arbetsytan (~/.openclaw/workspace) förblir orörd. Från npm → git:
git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm build
openclaw doctor
openclaw gateway omstart
Tips: se Backupstrategi.
npm install -g openclaw@senaste
openclaw doctor
openclaw gateway omstart
Läkare upptäcker en gateway-tjänst som inte stämmer överens med varandra och erbjuder sig att skriva om konfigurationen för tjänsten för att matcha den aktuella installationen (använd --reparair i automation). Bärbar dator (lokal Gateway)

Ska jag köra Gateway på min bärbara dator eller en VPS

Kort svar: om du vill ha pålitlighet dygnet runt, använd en VPS. Om du vill ha den lägsta friktionen på och du är okej med vila/starta om, kör den lokalt. Bärbar dator (lokal Gateway)
  • Pro: ingen serverkostnad, direkt åtkomst till lokala filer, live webbläsarfönster.
  • Nackdelar: sömn/nätverksdroppar = frånkopplingar, OS-uppdateringar/omstarter avbryta, måste vara vakna.
VPS / moln
  • Pro: alltid-på, stabilt nätverk, inga problem med laptops sömn, lättare att köra.
  • Koner: kör ofta huvudlöst (använd skärmdumpar), fjärråtkomst till filer, du måste SSH för uppdateringar.
OpenClaw-specifik anteckning: WhatsApp/Telegram/Slack/Mattermost (plugin)/Discord fungerar alla bra från en VPS. Den enda riktiga avvägningen är huvudlös webbläsare mot ett synligt fönster. Se Browser. Rekommenderad standard: VPS om du hade gateway kopplas från tidigare. Lokalt är bra när du aktivt använder Mac och vill ha lokal filåtkomst eller UI-automatisering med en synlig webbläsare.

Hur viktigt är det att köra OpenClaw på en dedikerad maskin

Krävs inte, men rekommenderas för tillförlitlighet och isolering.
  • Dedikerad värd (VPS/Mac mini/Pi): alltid, färre vilo/omstart avbrott, renare behörigheter, lättare att fortsätta köra.
  • Delad laptop/skrivbord: helt okej för testning och aktiv användning, men förvänta dig pauser när maskinen sover eller uppdaterar.
Om du vill ha det bästa av två världar, hålla Gateway på en dedikerad värd och koppla din bärbara dator som en nod för lokal skärm/kamera/exec-verktyg. Se Nodes. För säkerhetsvägledning, läs Security.

Vilka är minimikraven för VPS och rekommenderat OS

OpenClaw är lätt. För en grundläggande Gateway + en chatt kanal:
  • Absolut minimum: 1 vCPU, 1GB RAM, ~500MB disk.
  • Rekommenderas: 1-2 vCPU, 2 GB RAM eller mer för huvudrum (loggar, media, flera kanaler). Node verktyg och webbläsarautomatisering kan vara resurssunga.
OS: Använd Ubuntu LTS (eller alla moderna Debian/Ubuntu). Linux installationsvägen är bäst testad där. Baslinje vägledning:

Kan jag köra OpenClaw i en VM och vilka är kraven

Ja. Behandla en VM på samma sätt som en VPS: den måste alltid vara på, nåbar, och har tillräckligt med RAM för Gateway och alla kanaler du aktiverar. Baslinje vägledning:
  • Absolut minimum: 1 vCPU, 1 GB RAM.
  • Rekommenderas: 2GB RAM eller mer om du kör flera kanaler, webbläsarautomatisering eller mediaverktyg.
  • OS: Ubuntu LTS eller en annan modern Debian/Ubuntu.
Om du är i Windows, är WSL2 den enklaste VM stil setup och har den bästa verktyget kompatibilitet. Se Windows, VPS hosting. Om du kör macOS i en VM, se macOS VM.

Vad är värdet proposition

Vad är OpenClaw i ett stycke

OpenClaw är en personlig AI-assistent som du kör på dina egna enheter. Den svarar på de meddelandeytor du redan använder (WhatsApp, Telegram, Slack, Mattermost (plugin), Discord, Google Chat, Signal, iMessage, WebChat) och kan också göra röst + en levande Canvas på stödda plattformar. Gateway är det alltid på kontrollplanet; assistenten är produkten.

Vad är värdet proposition

OpenClaw är inte “bara ett Claude-omslag”. Det är ett lokalt första styrplan som låter dig köra en kapabel assistent på din egen maskinvara, som kan nås från de chattappar du redan använder, med staty sessioner, minne och verktyg - utan att lämna kontroll över dina arbetsflöden till en värd SaaS. Höjdpunkter:
  • Dina enheter, dina data: kör Gateway var du än vill (Mac, Linux, VPS) och behåller arbetsytan* sessionshistorik lokalt.
  • Verkliga kanaler, inte en webb-sandlåda: WhatsApp/Telegram/Slack/Discord/Signal/iMessage/etc, plus mobil röst och Canvas på stödda plattformar.
  • Modell-agnostik: använd Anthropic, OpenAI, MiniMax, OpenRouter, etc., med per-agent routing och failover.
  • Lokalt endast: kör lokala modeller så all data kan stanna på din enhet om du vill.
  • Multi-agent routing: separata agenter per kanal, konto eller uppgift, var och en med sin egen arbetsyta och standard.
  • Öppen källkod och hackbar: inspektera, utöka och själv värd utan leverantörens låsning.
Dokument: Gateway, Channels, Multi-agent, Memory.

Jag bara ställa in det vad jag ska göra först

Bra första projekt:
  • Bygg en webbplats (WordPress, Shopify, eller en enkel statisk plats).
  • Prototyp en mobilapp (kontur, skärmar, API-plan).
  • Organisera filer och mappar (rensning, namngivning, taggning).
  • Anslut Gmail och automatisera sammanfattningar eller uppföljningar.
Den kan hantera stora uppgifter, men det fungerar bäst när man delar upp dem i faser och använder underagenter för parallellt arbete.

Kan OpenClaw hjälpa till med lead gen uppsökande annonser och bloggar för en SaaS

Vardagsvinster brukar se ut:
  • Personliga genomgångar: sammanfattningar av inkorg, kalender och nyheter du bryr dig om.
  • Forskning och utkast: snabb forskning, sammanfattningar och första utkast till e-post eller dokument.
  • Påminnelser och uppföljningar: Cron- eller hjärtslagsdrivna knuffar och checklistor.
  • Webbläsarautomatisering: ifyllande formulär, insamling av data och upprepande webbuppgifter.
  • Cross enhetskoordination: skicka en uppgift från din telefon, låt Gateway köra den på en server och få resultatet tillbaka i chatten.

Kan OpenClaw hjälpa till med lead gen uppsökande annonser och bloggar för en SaaS

Ja för forskning, kvalifikationer och utarbetande. Det kan skanna webbplatser, bygga shortlists, sammanfatta framtidsutsikter och skriva utåtriktade eller annonskopieringsutkast. För uppsökande eller annonskörning, håll en människa i loopen. Undvik skräppost, följ lokala lagar och plattformspolicyer, och granska allt innan det skickas. Det säkraste mönstret är att låta OpenClaw utkast och du godkänner. Fördelar:

Vilka är fördelarna mot Claude Code för webbutveckling

OpenClaw är ett personlig assistent och koordinationslager, inte en IDE-ersättning. Använd Claude Code eller Codex för den snabbaste direkta kodningsslingan inuti en repa. Använd OpenClaw när du vill ha hållbart minne, åtkomst över enheter och verktygsorkestrering. Fördelar:
  • Beständigt minne + arbetsyta över sessioner
  • Åtkomst till flera plattformar (WhatsApp, Telegram, TUI, WebChat)
  • Verktygsorkestrering (webbläsare, filer, schemaläggning, krokar)
  • Alltid-på Gateway (kör på en VPS, interagera var som helst)
  • Noder för lokal webbläsare/skärm/kamera/exec
Showcase: https://openclaw.ai/showcase

Kan jag ladda färdigheter från en anpassad mapp

Hur anpassar jag kompetens utan att hålla repo smutsiga

Använd hanterade åsidosättningar istället för att redigera reporoporten. Sätt dina ändringar i ~/.openclaw/skills/<name>/SKILL.md (eller lägg till en mapp via skills.load.extraDirs i ~/.openclaw/openclaw.json). Precedence is <workspace>/skills > ~/.openclaw/skills > bundled, så hanterade overrides win utan att röra git. Endast upstream-worthy redigeringar bör leva i repo och gå ut som PR.

Kan jag ladda färdigheter från en anpassad mapp

Ja. Lägg till extra kataloger via skills.load.extraDirs i ~/.openclaw/openclaw.json (lägsta prioritet). Standardprioritet återstår: <workspace>/skills~/.openclaw/skills → buntade → skills.load.extraDirs. clawhub installeras i ./skills som standard, som OpenClaw behandlar som <workspace>/skills.

Hur kan jag använda olika modeller för olika uppgifter

Idag stöds mönstren är:
  • Cron jobb: isolerade jobb kan ställa in en modell åsidosätt per jobb.
  • Underagenter: dirigera uppgifter för att separera agenter med olika standardmodeller.
  • On-demand switch: använd /model för att växla den aktuella sessionsmodellen när som helst.
Se Cron jobs, Multi-Agent Routing och Slash kommandon.

Botten fryser medan du gör hårt arbete Hur gör jag avlasta det

Använd underagenter för långa eller parallella uppgifter. Underagenter kör i sin egen session, returnera en sammanfattning, och hålla din huvudchatt lyhörd. Be din bot att “skapa en underagent för denna uppgift” eller använd /subagents. Använd /status i chatten för att se vad Gateway gör just nu (och om det är upptaget). Token Tips: långa uppgifter och underagenter båda konsumerar tokens. Om kostnaden är ett bekymmer, ange en billigare modell för underagenter via agents.defaults.subagents.model. Checklista:

Cron eller påminnelser inte eld Vad ska jag kontrollera

Cron körs inne i Gateway processen. Om Gateway inte körs kontinuerligt, kommer schemalagda jobb inte att köras. Checklista:
  • Bekräfta cron är aktiverad (cron.enabled) och OPENCLAW_SKIP_CRON är inte inställd.
  • Kontrollera att Gateway körs 24/7 (ingen viloläge/omstart).
  • Verifiera tidzoninställningar för jobbet (--tz vs värdtidszon).
Debug:
openclaw cron kör <jobId> --force
openclaw cron kör --id <jobId> --limit 50
Installera ClawHub CLI (välj en pakethanterare):

Hur installerar jag färdigheter på Linux

Använd ClawHub (CLI) eller släpp färdigheter i din arbetsyta. macOS Skills UI är inte tillgängligt på Linux. Bläddra bland färdigheter på https://clawhub.com. Installera ClawHub CLI (välj en pakethanterare):
npm i -g clawhub
pnpm add -g clawhub

Kan OpenClaw köra uppgifter på ett schema eller kontinuerligt i bakgrunden

Ja. Använd schemat för Gateway:
  • Cron jobb för schemalagda eller återkommande uppgifter (kvarstår vid omstart).
  • Heartbeat för “main session” periodiska kontroller.
  • Isolerade jobb för autonoma agenter som lägger upp sammanfattningar eller levererar till chattar.
Du har tre stödda mönster:

Kan jag köra endast kunskaper i Apple macOS-system från Linux?

Inte direkt. macOS färdigheter är gated av metadata.openclaw.os plus nödvändiga binärer, och färdigheter visas bara i systemprompten när de är berättigade på Gateway värd. På Linux kommer darwin-endast-färdigheter (som apple-notes, apple-reminders, things-mac) inte att laddas om du inte åsidosätter gatingen. Du har tre stödda mönster: **Alternativ A - kör Gateway på en Mac (enklaste). * Kör Gateway där macOS binärerna finns, anslut sedan från Linux i remote mode eller över Tailscale. Kompetensbelastningen normalt eftersom Gateway-värden är macOS. **Alternativ B - använd en macOS nod (ingen SSH). * Kör Gateway på Linux, para ihop en macOS nod (menubar app), och sätt Node Run Commands till “Always Ask” eller “Always allow” på Mac. OpenClaw kan behandla macOS-endast färdigheter som berättigade när de nödvändiga binärerna finns på noden. Agenten kör dessa färdigheter via nodes-verktyget. Om du väljer “Always Ask”, godkänna “Always Allow” i prompten lägger det kommandot till tillåtna listan. **Alternativ C - proxy macOS binärer över SSH (avancerat). * Håll Gateway på Linux, men gör nödvändiga CLI-binärer lösa till SSH-omvandlare som kör på en Mac. Åsidosätt sedan skickligheten för att tillåta Linux så att den förblir berättigad.
  1. Skapa en SSH-omvandlare för binären (exempel: memo för Apple Notes):
    #!/usr/bin/env bash
    set -euo pipefail
    exec ssh -T user@mac-host /opt/homebrew/bin/memo "$@"
    
  2. Sätt omslaget på PATH på Linux-värden (till exempel ~/bin/memo).
  3. Åsidosätt skicklighetsmetadata (arbetsyta eller ~/.openclaw/skills) för att tillåta Linux:
    ---
    namn: apple-notes
    beskrivning: Hantera Apple Notes via memo CLI på macOS.
    metadata: { "openclaw": { "os": ["darwin", "linux"], "requires": { "bins": ["memo"] } }
    ---
    
  4. Starta en ny session så att färdigheterna ögonblicksbilden uppdateras.

Har du en uppfattning eller HeyGen integration

Om du vill hålla sammanhang per klient (byråns arbetsflöden), ett enkelt mönster är: Alternativ:
  • Anpassad skicklighet/plugin: bäst för tillförlitlig API-åtkomst (Notion/HeyGen har båda API:er).
  • Webbläsarautomatisering: fungerar utan kod men är långsammare och mer bräcklig.
Installera färdigheter:
  • En Notion sida per klient (kontext + inställningar + aktivt arbete).
  • Be agenten att hämta den sidan i början av en session.
Om du vill ha en infödd integration, öppna en funktionsförfrågan eller bygg en färdighet som riktar sig till dessa API:er. Installera färdigheter:
clawhub install <skill-slug>
clawhub update --all
ClawHub installeras i . skills under din nuvarande katalog (eller faller tillbaka till din konfigurerade OpenClaw workspace); OpenClaw behandlar det som <workspace>/skills på nästa session. För delade färdigheter över agenter, placera dem i ~/.openclaw/skills/<name>/SKILL.md. Vissa färdigheter förväntar sig binärer som installeras via Homebrew; på Linux som betyder Linuxbrew (se Homebrew Linux FAQ post ovan). Se Skills och ClawHub.

Hur installerar jag Chrome-tillägget för webbläsarens övertagande

Fullständig guide (inklusive fjärr Gateway + säkerhetsanteckningar): Chrome-tillägg
openclaw browser extension install
openclaw browser extension path
Sedan Chrome → chrome://extensions → aktivera “Developer mode” → “Ladda uppackad” → välj den mappen. Fullständig guide (inklusive fjärr Gateway + säkerhetsanteckningar): Chrome-tillägg Om Gateway körs på samma maskin som Chrome (standardinställning), behöver du vanligtvis inte något extra. Om Gateway kör någon annanstans, kör en node‑värd på webbläsarmaskinen så att Gateway kan proxyera webbläsaråtgärder. Du behöver fortfarande klicka på tilläggsknappen på den flik du vill styra (det bifogas inte automatiskt).

Docker känner sig begränsad Hur aktiverar jag fullständiga funktioner

Finns det en dedikerad sandlåda doc

Ja. Se Sandboxing. För Docker-specifik installation (full gateway i Docker eller sandlådbilder), se Docker.

Docker känner sig begränsad Hur aktiverar jag fullständiga funktioner

Standardavbildningen är security-first och körs som node-användaren, så den innehåller inte systempaket, Homebrew, eller medföljande webbläsare. För en fylligare inställning:
  • Beständig /home/node med OPENCLAW_HOME_VOLUME så att cacher överlever.
  • Baka systemet deps in i bilden med OPENCLAW_DOCKER_APT_PACKAGES.
  • Installera Playwright webbläsare via den medföljande CLI: node /app/node_modules/playwright-core/cli.js install chromium
  • Ställ in PLAYWRIGHT_BROWSERS_PATH och se till att sökvägen kvarstår.
Dokument: Docker, Browser. Setup walkthrough + exempel config: Grupper: personliga DMs + offentliga grupper Key config referens: Gateway konfiguration Använd agents.defaults.sandbox.mode: "non-main" så grupp/kanalsessioner (icke-huvudnycklar) körs i Docker, medan den huvudsakliga DM-sessionen förblir on-host. Begränsa sedan vilka verktyg som finns tillgängliga i sandboxade sessioner via tools.sandbox.tools. Setup walkthrough + exempel config: Grupper: personliga DMs + offentliga grupper Key config referens: Gateway konfiguration

Hur binder jag en värdmapp till sandlådan

Ange agents.defaults.sandbox.docker.binds till ["host:path:mode"] (t.ex., "/home/user/src:/src:ro"). Globala + per-agent binder sammanslagning; per-agent binder ignoreras när scope: "shared". Använd :ro för allt känsligt och kom ihåg binder förbi sandboxens filsystemsväggar. Se Sandboxing och Sandbox vs Tool Policy vs Elevated för exempel och säkerhetsanteckningar.

Hur fungerar minnet

OpenClaw minne är bara Markdown filer i agentens arbetsyta:
  • Dagliga anteckningar i minne/YYY-MM-DD.md
  • Kurerade långtidsanteckningar i MEMORY.md (endast/privata sessioner)
OpenClaw kör också en tyst pre-compaction minne flush för att påminna modellen om att skriva hållbara anteckningar innan automatisk komprimering. Detta körs bara när arbetsytan är skrivbar (skrivskyddad sandlådor hoppa över det). Se Minne.

Minnet glömmer saker Hur får jag det att sticka fast

Be boten att skriva faktumet till minnet. Långsiktiga anteckningar hör hemma i MEMORY.md, kortsiktiga sammanhang går till memory/YYYY-MM-DD.md. Detta är fortfarande ett område som vi håller på att förbättra. Det hjälper till att påminna modellen för att lagra minnen; det kommer att veta vad man ska göra. Om den fortsätter att glömma, kontrollera att Gateway använder samma arbetsyta på varje körning. Dokument: Memory, Agent workspace.

Gör semantisk minnessökning kräver en OpenAI API-nyckel

Endast om du använder OpenAI inbäddningar. Codex OAuth omfattar chatt/kompletteringar och beviljar inte inbäddning åtkomst, så logga in med Codex (OAuth eller Codex CLI-inloggning) hjälper inte för semantisk minnessökning. OpenAI inbäddningar behöver fortfarande en riktig API-nyckel (OPENAI_API_KEY eller models.providers.openai.apiKey). Om du inte anger en leverantör explicit, väljer OpenClaw auto-selects en leverantör när den kan lösa en API-nyckel (auth profiler, models.providers.*.apiKey, eller env vars). Den föredrar OpenAI om en OpenAI-nyckel löser sig, annars Gemini om en Gemini-nyckel löses. Om ingen av nycklarna är tillgänglig, förblir minnessökningen inaktiverad tills du konfigurerar den. Om du har en lokal modellsökväg konfigurerad och presenterad, föredrar OpenClaw local. Om du hellre vill stanna lokalt, sätt memorySearch.provider = "local" (och valfritt memorySearch.fallback = "none"). Om du vill ha Gemini inbäddning, sätt memorySearch.provider = "gemini" och ge GEMINI_API_KEY (eller memorySearch.remote.apiKey). Vi stöder OpenAI, Gemini eller lokal inbäddade modeller - se Memory för konfigurationsdetaljer.

Där saker och ting lever på disk

Minnesfiler live på disk och kvarstår tills du tar bort dem. Gränsen är din lagring, inte modellen. sessionskontexten är fortfarande begränsad av modellen sammanhangsfönstret, så långa konversationer kan kompakta eller trunkera. Det är därför minnessökning existerar - den drar bara de relevanta delarna tillbaka i sammanhanget. Nej - OpenClaws tillstånd är lokalt, men externa tjänster ser fortfarande vad du skickar dem.

Där saker och ting lever på disk

Är all data som används med OpenClaw sparad lokalt

Nej - OpenClaws tillstånd är lokalt, men externa tjänster ser fortfarande vad du skickar dem.
  • **Lokal som standard: ** sessioner, minnesfiler, konfigurera och arbetsyta live på Gateway-värden (~/.openclaw + din arbetsyta katalog).
  • Fjärrstyrd av nödvändighet: meddelanden som du skickar till modellleverantörer (Anthropic/OpenAI/etc.) gå till sina API:er och chattplattformar (WhatsApp/Telegram/Slack/etc.) lagra meddelandedata på sina servrar.
  • Du styr fotavtrycket: med hjälp av lokala modeller håller anvisningarna på din maskin, men kanalens trafik går fortfarande genom kanalens servrar.
Relaterat: Agent workspace, Memory.

Var lagrar OpenClaw sina data

Allt lever under $OPENCLAW_STATE_DIR (standard: ~/.openclaw):
SökvägSyfte
$OPENCLAW_STATE_DIR/openclaw.jsonHuvudkonfigurationen (JSON5)
$OPENCLAW_STATE_DIR/credentials/oauth.jsonLegacy OAuth import (kopieras till auth profiler vid första användning)
$OPENCLAW_STATE_DIR/agents/&lt;agentId&gt;/agent/auth-profiles.jsonAuth profiler (OAuth + API-nycklar)
$OPENCLAW_STATE_DIR/agents/&lt;agentId&gt;/agent/auth.jsonRuntime auth cache (hanteras automatiskt)
$OPENCLAW_STATE_DIR/credentials/Leverantörens status (t.ex. whatsapp/<accountId>/creds.json)
$OPENCLAW_STATE_DIR/agents/Per-agent stat (agentDir + sessioner)
$OPENCLAW_STATE_DIR/agents/&lt;agentId&gt;/sessions/Konversationshistorik & tillstånd (per agent)
$OPENCLAW_STATE_DIR/agents/&lt;agentId&gt;/sessions/sessions.jsonSession metadata (per agent)
Dessa filer lever i agentutrymme, inte ~/.openclaw. Din arbetsyta (AGENTS.md, minnesfiler, färdigheter, etc.) är separat och konfigurerad via agents.defaults.workspace (standard: ~/.openclaw/workspace).

Var ska AGENTSmd SOULmd USERmd MEMORYmd leva

Dessa filer lever i agentutrymme, inte ~/.openclaw.
  • Arbetsyta (per agent): AGENTS.md, SOUL.md, IDENTITY.md, USER.md, MEMORY.md (eller memory.md), memory/YYY-MM-DD.md, valfritt HEARTBEAT.md.
  • State dir (~/.openclaw): config, credentials, auth profiles, sessioner, loggar, och delade färdigheter (~/.openclaw/skills).
Standard arbetsyta är ~/.openclaw/workspace, konfigurerbar via:
{
  agents: { defaults: { workspace: "~/.openclaw/workspace" } },
}
Om boten “glömmer” efter en omstart, bekräfta att Gateway använder samma arbetsyta vid varje start (och kom ihåg: fjärrläge använder gateway värd’s arbetsyta, inte din lokala laptop). Tips: Om du vill ha ett hållbart beteende eller inställning, be boten att skriva in det i AGENTS. d eller MEMORY.md snarare än att förlita sig på chatthistorik. Se Agent workspace och Memory.

Vad är den rekommenderade säkerhetskopieringsstrategin

Sätt din agent arbetsyta i en privat git repo och säkerhetskopiera den någonstans privat (till exempel GitHub privat). Detta fångar minne + AGENTS/SOUL/USER filer och låter dig återställa assistentens “sinne” senare. Vänd inte något under ~/.openclaw (användaruppgifter, sessioner, tokens). Om du behöver en fullständig återställning, säkerhetskopiera både arbetsytan och statskatalogen separat (se migrationsfrågan ovan). Dokument: Agent workspace.

Hur avinstallera jag helt OpenClaw

Exempel (repo som standard cwd):

Kan agenter arbeta utanför arbetsytan

Ja. Arbetsytan är standard cwd och minnesankare, inte en hård sandlåda. Relativa sökvägar försvinner inne i arbetsytan, men absoluta sökvägar kan komma åt andra värdplatser såvida inte sandlådan är aktiverad. Om du behöver isolering, använd agents.defaults.sandbox eller inställningar för per-agent sandlåda. Om du vill att en repo ska vara standard arbetskatalog, peka den agentens workspace till repo roten. OpenClaw repo är bara källkod; håll arbetsytan åtskild om du inte avsiktligt vill att agenten ska arbeta inuti den. Exempel (repo som standard cwd):
{
  agenter: {
    defaults: {
      workspace: "~/Projects/my-repo",
    },
  },
}

Im in remote mode where is the session store

Sessionsstaten ägs av gateway host. Om du är i fjärrläge är den session butik du bryr dig om på fjärrdatorn, inte din lokala laptop. Se Sessionshantering.

Grundläggande inställningar

Vilket format är konfigurationen Var är den

OpenClaw läser en valfri JSON5 konfiguration från $OPENCLAW_CONFIG_PATH (standard: ~/.openclaw/openclaw.json):
$OPENCLAW_CONFIG_PATH
Om filen saknas, den använder säker standard (inklusive en standard arbetsyta av ~/.openclaw/workspace).

Jag sätter gatewaybind lan eller tailnet och nu inget lyssnar UI säger obehörig

Icke-loopback binder kräver auth. Konfigurera gateway.auth.mode + gateway.auth.token (eller använd OPENCLAW_GATEWAY_TOKEN).
{
  gateway: {
    bind: "lan",
    auth: {
      mode: "token",
      token: "ersätta-me",
    },
  },
}
Anteckningar:
  • gateway.remote.token är för fjärr-CLI-samtal endast; det aktiverar inte lokal gateway auth.
  • Kontrollgränssnittet autentiseras via connect.params.auth.token (lagras i app/UI-inställningar). Undvik att sätta tokens i URL:er.

Måste jag starta om efter byte av konfiguration

Guiden genererar en gateway-token som standard (även på loopback) så lokala WS-klienter måste autentisera. Detta blockerar andra lokala processer från att ringa Gateway. Klistra in token i kontrollgränssnittets inställningar (eller din klientkonfiguration) för att ansluta. Om du verkligen vill ha öppen loopback, ta bort gateway.auth från din konfiguration. Läkare kan generera en token för dig när som helst: openclaw doctor --generate-gateway-token.

Hur aktiverar jag webbsökning och webbhämtning

Gateway tittar på konfigurationen och stöder hot-reload:
  • gateway.reload.mode: "hybrid" (standard): hot-apply säkra ändringar, omstart för kritiska
  • hot, restart, off stöds också

Hur aktiverar jag webbsökning och webbhämtning

web_fetch fungerar utan en API-nyckel. web_search kräver en Brave Search API nyckel. Rekommenderade: kör openclaw konfigurera --section web för att lagra den i tools.web.search.apiKey. Miljöalternativ: sätt BRAVE_API_KEY för Gateway-processen.
{
  verktyg: {
    webb: {
      sökning: {
        aktiverad: sant,
        apiKey: "BRAVE_API_KEY_HERE",
        maxResultat: 5,
      },
      hämtning: {
        enabled: true,
      },
    },
  },
}
Anteckningar:
  • Om du använder tillåtna listor, lägg till web_search/web_fetch eller group:web.
  • web_fetch är aktiverat som standard (om det inte uttryckligen inaktiveras).
  • Daemons läste env vars från ~/.openclaw/.env (eller servicemiljön).
Dokument: Webb verktyg.

Hur kör jag en central Gateway med specialiserade arbetstagare över enheter

Det gemensamma mönstret är en Gateway (t.ex. Hallon Pi) plus noder och agenter:
  • Gateway (central): äger kanaler (Signal/WhatsApp), routing och sessioner.
  • Noder (enheter): Mac/iOS/Android ansluter som kringutrustning och exponerar lokala verktyg (system.run, canvas, camera).
  • Agenter (arbetare): separata hjärnor/arbetsytor för speciella roller (t.ex. “Hetzner ops”, “Personuppgifter”).
  • Underagenter: Skapa bakgrundsarbete från en huvudagent när du vill ha parallellism.
  • TUI: anslut till Gateway och växla agenter/sessioner.
Dokument: Nodes, Remote access, Multi-Agent Routing, Sub-agents, TUI.

Kan OpenClaw-webbläsaren köra huvudlöst

Ja. Det är ett konfigurationsalternativ:
{
  webbläsare: { headless: true },
  agenter: {
    standard: {
      sandlåda: { browser: { headless: true } },
    },
  },
}
Standard är false (headful). Huvudlös är mer benägna att utlösa anti-bot kontroller på vissa webbplatser. Se Browser. Huvudlösa använder samma krommotor och fungerar för de flesta automatisering (formulär, klick, skrapning, inloggningar). De viktigaste skillnaderna:
  • Inget synligt webbläsarfönster (använd skärmdumpar om du behöver visual).
  • Vissa webbplatser är striktare om automatisering i huvudlöst läge (CAPTCHA, anti-bot). Till exempel blockerar X/Twitter ofta huvudlösa sessioner.

Hur sprids kommandon mellan Telegram gateway och noder

Ställ in browser.executablePath till din Brave binary (eller någon Chromium-baserad webbläsare) och starta om Gateway. Se hela konfigurationsexemplen i Browser.

Fjärrstyrda gateways och noder

Hur sprids kommandon mellan Telegram gateway och noder

Telegram meddelanden hanteras av gateway. Gateway kör agenten och endast då samtal noder över Gateway WebSocket när en nod verktyg behövs: Telegram → Gateway → Agent → node.* → Node → Gateway → Telegram Typisk inställning:

Hur kan min agent komma åt min dator om Gateway är värd på distans

Kort svar: para ihop din dator som en nod. Gateway körs någon annanstans, men det kan anropa node.* verktyg (skärm, kamera, system) på din lokala maskin över Gateway WebSocket. Typisk inställning:
  1. Kör Gateway på den alltid på-värd (VPS/home server).
  2. Sätt Gateway värd + din dator på samma tailnet.
  3. Se till att Gateway WS är nåbar (tailnet bind eller SSH tunnel).
  4. Öppna macOS-appen lokalt och anslut i Fjärrkontroll över SSH-läge (eller direkt tailnet) så att den kan registrera sig som en nod.
  5. Godkänn noden på Gateway:
    openclaw nodes pending
    openclaw nodes approve <requestId>
    
Ingen separat TCP-brygga krävs; noder ansluter över Gateway WebSocket. Säkerhetspåminnelse: parning av en macOS nod tillåter system.run på den maskinen. Endast para ihop enheter som du litar på och recensera Security. Dokument: Nodes, Gateway protocol, macOS remote mode, Security.

Skalan är ansluten men jag får inga svar Vad nu

Kontrollera grunderna:
  • Gateway kör: openclaw gateway status
  • Gateway hälsa: openclaw status
  • Channel health: openclaw channels status
Kontrollera sedan auth och routing:
  • Om du använder Tailscale Serve, se till att gateway.auth.allowTailscale är korrekt inställd.
  • Om du ansluter via SSH-tunneln, bekräfta att den lokala tunneln är uppe och pekar i rätt hamn.
  • Bekräfta dina tillåtna listor (DM eller grupp) inkludera ditt konto.
Dokument: Tailscale, fjärråtkomst, Channels.

Kan två OpenClaw instanser prata med varandra lokala VPS

Ja. Det finns ingen inbyggd “bot-to-bot” brygga, men du kan styra upp den på ett par pålitliga sätt: Enklast: använd en vanlig chatt kanal båda robotarna kan komma åt (Telegram/Slack/WhatsApp). Ha Bot A skicka ett meddelande till Bot B, låt sedan Bot B svara som vanligt. CLI-brygga (generisk): kör ett skript som anropar den andra Gateway med openclaw agent --message ... --deliver, med inriktning på en chatt där den andra roboten lyssnar. Om en bot är på en fjärr-VPS, peka din CLI på den fjärr-Gateway via SSH/Tailscale (se Fjärråtkomst). Dokument: Remote access, Agent CLI, Agent send.
openclaw agent --message "Hej från lokal bot" --deliver --channel telegram --reply-to <chat-id>
Tips: lägg till ett skyddsräcke så att de två robotarna inte slingar oändligt (nämn bara, kanal tillåter listor, eller en “svara inte på bot meddelanden” regel). Dokument: Remote access, Agent CLI, Agent send.

Finns det en fördel med att använda en nod på min personliga bärbara dator istället för SSH från en VPS

Nej. En Gateway kan vara värd för flera agenter, var och en med sin egen arbetsyta, modell standard, och routing. Det är den normala installationen och det är mycket billigare och enklare än att köra en VPS per agent. Använd separata VPSes endast när du behöver hård isolering (säkerhetsgränser) eller mycket olika konfigurationer som du inte vill dela. Annars kan en Gateway och använda flera agenter eller underagenter.

Finns det en fördel med att använda en nod på min personliga bärbara dator istället för SSH från en VPS

Ja - noder är det förstklassiga sättet att nå din bärbara dator från en avlägsen Gateway, och de låsa upp mer än skalåtkomst. Gateway körs på macOS/Linux (Windows via WSL2) och är lätt (en liten VPS eller Raspberry Pi-klass box är bra; 4 GB RAM är mycket), så en vanlig inställning är en alltid på värd plus din bärbara dator som en nod.
  • Inga inkommande SSH krävs. Noder ansluter till Gateway WebSocket och använder enhet parkoppling.
  • Säkrare körkontroller. system.run är gated av nod allowlists/godkännanden på den bärbara datorn.
  • Fler enhetsverktyg. Noder exponerar canvas, camera, och screen utöver system.run.
  • **Lokal webbläsarautomatisering. * Håll Gateway på en VPS, men kör Chrome lokalt och reläkontroll med Chrome-tillägget + en nod värd på den bärbara datorn.
SSH är bra för ad-hoc skalåtkomst, men noder är enklare för pågående agentarbetsflöden och enhet automatisering. Installera en andra Gateway endast när du behöver hård isolering eller två helt separata robotar.

Ska jag installera på en andra laptop eller bara lägga till en nod

Om du bara behöver lokala verktyg (skärm/kamera/kör) på den andra bärbara datorn, lägg till den som en node. Som håller en enda Gateway och undviker duplicerad konfiguration. Lokala nodverktyg är för närvarande endast macOS-, men vi planerar att utöka dem till andra operativsystem. Installera en andra Gateway endast när du behöver hård isolering eller två helt separata robotar. En fullständig omstart krävs för gateway, discovery, och canvasHost ändringar.

Finns det ett API RPC sätt att tillämpa konfigurationen

Nej. Endast en gateway bör köras per värd om du inte avsiktligt kör isolerade profiler (se Flera gateways). Noder är kringutrustning som ansluter till gateway (iOS/Android-noder, eller macOS “node-läge” i menubar app). För huvudlös nod värdar och CLI-kontroll, se nod värd CLI. En fullständig omstart krävs för gateway, discovery, och canvasHost ändringar.

Finns det ett API RPC sätt att tillämpa konfigurationen

Ja. config.apply validerar + skriver hela konfigurationen och startar om Gateway som en del av operationen.

configapply raderade min config Hur återhämtar jag mig och undviker detta

config.apply ersätter hela config. Om du skickar ett partiellt objekt tas allt annat bort. Återställ:
  • Återställ från backup (git eller en kopierad ~/.openclaw/openclaw.json).
  • Om du inte har någon säkerhetskopia, re-run openclaw doctor och konfigurera kanaler/modeller.
  • Om detta var oväntat, skicka in ett fel och inkludera din senaste kända konfiguration eller någon säkerhetskopia.
  • En lokal kodningsagent kan ofta rekonstruera en fungerande konfiguration från loggar eller historik.
Undvik det:
  • Använd openclaw config set för små ändringar.
  • Använd openclaw configure för interaktiva redigeringar.
Detta ställer in din arbetsyta och begränsar vem som kan utlösa boten.

Hur ställer jag in Tailscale på en VPS och ansluter från min Mac

{
  agents: { defaults: { workspace: "~/.openclaw/workspace" } },
  channels: { whatsapp: { allowFrom: ["+15555550123"] } },
}
Detta ställer in din arbetsyta och begränsar vem som kan utlösa boten.

Hur ställer jag in Tailscale på en VPS och ansluter från min Mac

Minimala steg:
  1. Installera + logga in på VPS
    curl -fsSL https://tailscale.com/install.sh <unk> sh
    sudo skräddarskala upp
    
  2. Installera + logga in på din Mac
    • Använd appen Tailscale och logga in på samma tailnet.
  3. Aktivera MagicDNS (rekommenderas)
    • I Tailscale adminkonsolen, aktivera MagicDNS så att VPS har ett stabilt namn.
  4. Använd tailnet värdnamn
Om du vill ha Control UI utan SSH, använd Tailscale Serve på VPS:
openclaw gateway --tailscale serve
Detta håller porten bunden till loopback och exponerar HTTPS via Tailscale. Se Tailscale.

Hur ansluter jag en Mac-nod till en fjärr-Gateway Tailscale Serve

Serve exponerar Gateway Control UI + WS. Noder ansluter över samma Gateway WS slutpunkt. Rekommenderad inställning:
  1. Se till att VPS + Mac är på samma tailnet.
  2. Använd macOS-appen i fjärrläge (SSH-målet kan vara tailnet hostname). Appen kommer att tunnel Gateway-porten och ansluta som en nod.
  3. Godkänn noden på gateway:
    openclaw nodes pending
    openclaw nodes approve <requestId>
    
Dokument: Gateway protocol, Discovery, macOS remote mode.

Env vars och .env lastning

Hur laddar OpenClaw miljövariabler

OpenClaw reads env vars from the parent process (shell, launchd/systemd, CI, etc.) och dessutom laster:
  • .env från den aktuella arbetskatalogen
  • a global fallback .env from ~/.openclaw/.env (aka $OPENCLAW_STATE_DIR/.env)
Neither .env file overrides existing env vars. Du kan också definiera inline env vars i config (tillämpas endast om saknas från processen env):
{
  env: {
    OPENROUTER_API_KEY: "sk-or-...",
    vars: { GROQ_API_KEY: "gsk-..." },
  },
}
See /environment for full precedence and sources.

Jag startade Gateway via tjänsten och mina env vars försvann Vad nu

Två vanliga rättelser:
  1. Sätt de saknade nycklarna i ~/.openclaw/.env så de plockas upp även när tjänsten inte ärver ditt skal env.
  2. Aktivera skalimport (opt-in bekvämlighet):
{
  env: {
    shellEnv: {
      enabled: true,
      timeoutMs: 15000,
    },
  },
}
Detta kör ditt inloggningsskal och importerar bara saknade förväntade nycklar (aldrig åsidosätter). Env var ekvivalenter: OPENCLAW_LOAD_SHELL_ENV=1, OPENCLAW_SHELL_ENV_TIMEOUT_MS=15000.

I set COPILOTGITHUBTOKEN men modeller status visar Shell env off Varför

openclaw models status rapporterar om shell env import är aktiverat. “Shell env: off” betyder inte att dina env vars saknas - det betyder bara att OpenClaw inte laddar ditt inloggningsskal automatiskt. Om Gateway körs som en tjänst (launchd/systemd), det kommer inte ärva ditt skal miljö. Fixa genom att göra en av dessa:
  1. Sätt token i ~/.openclaw/.env:
    COPILOT_GITHUB_TOKEN=...
    
  2. Eller aktivera skalimport (env.shellEnv.enabled: true).
  3. Eller lägg till den i ditt config env-block (gäller endast om det saknas).
Starta sedan om gateway och återkontroll:
openclaw models status
Copilottokens läses från COPILOT_GITHUB_TOKEN (även GH_TOKEN / GITHUB_TOKEN). Se /concepts/model-providers och /environment.

Återställer sessioner automatiskt om jag aldrig skickar nya

Hur startar jag en ny konversation

Skicka /new eller /reset som ett fristående meddelande. Se Sessionshantering.

Finns det ett sätt att göra ett team av OpenClaw instanser en VD och många agenter

Ja. Sessioner löper ut efter session.idleMinutes (standard 60). Nästa -meddelandet startar ett nytt sessions-id för den chattnyckeln. Detta tar inte bort avskrifter - det startar bara en ny session.
{
  session: {
    idleMinutes: 240,
  },
}

Finns det ett sätt att göra ett team av OpenClaw instanser en VD och många agenter

Ja, via multi-agent routing och underagenter. Du kan skapa en koordinator agent och flera arbetare agenter med egna arbetsytor och modeller. Som sagt, detta är bäst ses som ett roligt experiment. Det är token tung och ofta mindre effektiv än att använda en bot med separata sessioner. Den typiska modellen vi föreställer oss är en bot man pratar med, med olika sessioner för parallellt arbete. Att bot kan också skapa underagenter när det behövs. Vad hjälper:

Varför fick kontext trunkerad midtask Hur förhindrar jag det

Sessionskontext begränsas av modellfönstret. Långa chattar, stora verktygsutmatningar eller många -filer kan utlösa komprimering eller trunkering. Använd återställningskommandot:
  • Be boten att sammanfatta det aktuella tillståndet och skriva det till en fil.
  • Använd /compact före långa uppgifter och /new vid byte av ämnen.
  • Håll viktiga sammanhang i arbetsytan och be boten att läsa den tillbaka.
  • Använd underagenter för långt eller parallellt arbete så att huvudchatten förblir mindre.
  • Välj en modell med ett större sammanhangsfönster om detta händer ofta.

Hur återställer jag helt OpenClaw men håller det installerat

Använd återställningskommandot:
openclaw reset
Icke-interaktiv fullständig återställning:
openclaw återställ --scope full --yes --non-interactive
Sedan re-run ombord:
openclaw onboard --install-daemon
Använd ett av dessa:
  • Onboarding guiden erbjuder också Återställ om den ser en befintlig konfiguration. Se Wizard.
  • Återställ (nytt sessions-ID för samma chattnyckel):
  • Dev återställ: openclaw gateway --dev --reset (dev-only; wipes dev config + autentiseringsuppgifter + sessioner + arbetsyta).

Jag får sammanhang för stora fel hur jag återställer eller kompakt

Använd ett av dessa:
  • Kompakt (håller konversationen men sammanfattar äldre svängar):
    /kompakt
    
    eller /compact <instructions> för att vägleda sammanfattningen.
  • Återställ (nytt sessions-ID för samma chattnyckel):
    /new
    /reset
    
Om det händer fortfarande:
  • Aktivera eller trimma sessionsbeskärning (agents.defaults.contextPruning) för att trimma gamla verktygsutmatningar.
  • Använd en modell med ett större sammanhangsfönster.
Fix: starta en ny session med /new (fristående meddelande).

Varför får jag hjärtslag var 30 minut

Detta är ett leverantörsvalideringsfel: modellen släppte ut ett tool_use-block utan det nödvändiga input. Det innebär oftast att sessionshistoriken är inaktuell eller skadad (ofta efter långa trådar eller en verktyg/schema förändring). Fix: starta en ny session med /new (fristående meddelande).

Varför får jag hjärtslag var 30 minut

Hjärtslag kör varje 30 m som standard. Justera eller inaktivera dem:
{
  agenter: {
    defaults: {
      heartbeat: {
        every: "2h", // eller "0m" för att inaktivera
      },
    },
  },
}
Om HEARTBEAT. d finns men är effektivt tom (endast tomma rader och markdown rubriker som # Heading), hoppar OpenClaw över hjärtslaget för att spara API-samtal. Om filen saknas körs heartbeat ändå och modellen avgör vad som ska göras. Per-agent åsidosätter använda agents.list[].heartbeat. Dokument: Heartbeat.

Behöver jag lägga till ett botkonto till en WhatsApp-grupp

Nej. OpenClaw körs på ditt eget konto, så om du är med i gruppen kan OpenClaw se det. Som standard blockeras gruppsvar tills du tillåter avsändare (groupPolicy: "allowlist"). Alternativ 1 (snabbast): svansloggar och skickar ett testmeddelande i gruppen:
openclaw loggar --follow --json

Hur får jag JID för en WhatsApp-grupp

Alternativ 2 (om redan konfigurerad/tillåten): listgrupper från config:
openclaw kataloggrupper lista --channel whatsapp
Dokument: WhatsApp, Directory, Logs. Alternativ 2 (om redan konfigurerad/tillåten): listgrupper från config:
openclaw kataloggrupper lista --channel whatsapp
Dokument: WhatsApp, Directory, Logs.

Varför svarar inte OpenClaw i en grupp

Två vanliga orsaker:
  • Nämn Gating är på (standard). Du måste @nämna bot (eller matcha mentionPatterns).
  • Du konfigurerade channels.whatsapp.groups utan "*" och gruppen är inte tillåten.
Se Groups och Gruppmeddelanden.

Delar gruppsthreads sammanhang med DMs

Direktchattar kollapsar till huvudsessionen som standard. Grupper/kanaler har sina egna sessionsnycklar, och Telegram ämnen / Discord-trådar är separata sessioner. Se Groups och Gruppmeddelanden.

Hur många arbetsytor och agenter kan jag skapa

Inga hårda gränser. Dussintals (även hundratals) är bra, men titta efter:
  • Disktillväxt: sessioner + avskrifter lever under ~/.openclaw/agents/<agentId>/sessions/.
  • Token cost: fler agenter betyder mer samtidig modellanvändning.
  • Ops overhead: per agent auth profiler, arbetsytor och kanal routing.
Tips:
  • Behåll en aktiv arbetsyta per agent (agents.defaults.workspace).
  • Rensa gamla sessioner (ta bort JSONL eller lagra poster) om disken växer.
  • Använd openclaw doctor för att upptäcka avvikande arbetsytor och profilfel.

Kan jag köra flera bottar eller chattar samtidigt Slack och hur ska jag ställa upp

Ja. Använd Multi-Agent Routing för att köra flera isolerade agenter och rutt inkommande meddelanden av kanal/konto/peer. Slack stöds som en kanal och kan bindas till specifika agenter. Webbläsaråtkomst är kraftfull men inte “gör något som en människa kan” - anti-bot, CAPTCHA och MFA kan fortfarande blockera automatisering. För den mest tillförlitliga webbläsarkontrollen, använd Chrome extension relä på maskinen som kör webbläsaren (och behålla Gateway någonstans). Bästa praxis inställning:
  • Always-on Gateway-värd (VPS/Mac mini).
  • En agent per roll (bindningar).
  • Slack kanaler bundna till dessa agenter.
  • Lokal webbläsare via tilläggsrelä (eller nod) vid behov.
OpenClaws standardmodell är vad du anger som:

Modeller: standardinställningar, urval, alias, växlar

Vad är standardmodellen

OpenClaws standardmodell är vad du anger som:
agents.defaults.model.primary
Modeller refereras till som provider/model (exempel: antropic/claude-opus-4-6). Om du utelämnar leverantören antar OpenClaw för närvarande anthropic som ett tillfälligt avskrivningsfall - men du bör fortfarande explicitt sätta provider/model.

Vilken modell rekommenderar du

Rekommenderad standard: anthropic/claude-opus-4-6. Bra alternativ: antrop/claude-sonnet-4-5. Pålitlig (mindre karaktär): openai/gpt-5.2 - nästan lika bra som Opus, precis mindre personlighet. Budget: zai/glm-4.7. Fler sammanhang: Models. Tumregel: använd den bästa modellen du har råd med för arbete med höga insatser och en billigare modell för rutinchatt eller sammanfattningar. Du kan dirigera modeller per agent och använda underagenter till parallellisera långa uppgifter (varje underagens förbrukar tokens). Se Models och Sub-agents. Stark varning: svagare/överkvantifierade modeller är mer sårbara för snabb injektion och osäkert beteende. Se Security. Fler sammanhang: Models.

Kan jag använda egna modeller llamacpp vLLM Ollama

Ja. Om din lokala server exponerar ett OpenAI-kompatibelt API kan du peka en anpassad leverantör på det. Ollama stöds direkt och är den enklaste vägen. Säkerhetsanteckning: mindre eller kraftigt kvantifierade modeller är mer sårbara för snabb injektion. Vi rekommenderar starkt stora modeller för alla robotar som kan använda verktyg. Om du fortfarande vill ha små modeller, aktivera sandlåda och strikta verktyg tillåter listor. Säkra alternativ:

Hur byter jag modeller utan att rensa min konfiguration

Använd modellkommandon eller redigera endast modellen-fälten. Undvik att ersätta full konfiguration. Dokument: Models, Configure, Config, Doctor.
  • /model i chatt (snabb, per session)
  • openclaw models set ... (uppdateringar bara modell config)
  • openclaw konfigurera --section model (interaktiv)
  • redigera agents.defaults.model i ~/.openclaw/openclaw.json
Undvik config.apply med ett partiellt objekt om du inte tänker ersätta hela konfigurationen. Om du har skrivit över konfigurationen, återställa från säkerhetskopiering eller åter köra openclaw doctor för att reparera. Dokument: Models, Configure, Config, Doctor.

Vad använder OpenClaw, Flaw, och Krill för modeller

  • OpenClaw + fel: Antropiska opus (antrop/claude-opus-4-6) - se Anthropic.
  • Krill: MiniMax M2.1 (minimax/MiniMax-M2.1) - see MiniMax.

Hur byter jag modeller i farten utan att starta om

Använd kommandot /model som ett fristående meddelande:
/model sonnet
/model haiku
/model opus
/model gpt
/model gpt-mini
/model gemini
/model gemini-flash
Du kan också tvinga en specifik auth profil för leverantören (per session): /model (och /model list) visar en kompakt, numrerad väljare. Välj efter nummer:
/Modell 3
Hur lossar jag en profil jag satt med profil
/model opus@anthropic:default
/model opus@anthropic:work
Tips: /model status visar vilken agent som är aktiv, vilken auth-profiles.json fil som används, och vilken auth profil som kommer att testas härnäst. Det visar också det konfigurerade leverantörens slutpunkt (baseUrl) och API-läget (api) när det är tillgängligt. Hur lossar jag en profil jag satt med profil Re-run /model utanför suffixet @profile:
/model anthropic/claude-opus-4-6
Om du vill återvända till standard, välj den från /model (eller skicka /model <default provider/model>). Använd /model status för att bekräfta vilken auth profil som är aktiv.

Kan jag använda GPT 5.2 för dagliga uppgifter och Codex 5.3 för kodning

Ja. Ange en som standard och växla efter behov:
  • Snabb switch (per session): /model gpt-5.2 för dagliga uppgifter, /model gpt-5.3-codex för kodning.
  • Standard + switch: sätt agents.defaults.model.primary till openai/gpt-5.2, byt sedan till openai-codex/gpt-5.3-codex vid kodning (eller tvärtom).
  • Underagenter: ruttkodningsuppgifter till underagenter med en annan standardmodell.
Se Models och Slash kommandon.

Varför ser jag Modell är inte tillåtet och då inget svar

Om agents.defaults.models är satt, blir det allowlist för /model och alla session åsidosätter. Välja en modell som inte finns med i den listan returnerar:
Model "provider/model" is not allowed. Use /model to list available models.
Det felet returneras **i stället för ** ett normalt svar. Fix: lägg till modellen till agents.defaults.models, ta bort den tillåtna listan eller välj en modell från /modelllista.

Varför ser jag Okänd modell minimaxMiniMaxM21

Detta innebär att leverantören inte är konfigurerad (ingen MiniMax provider config eller auth profil hittades), så modellen kan inte lösas. En rättelse för denna detektion är i 2026.1.12 (outgiven vid skrivande tid). Fixa checklista:
  1. Uppgradera till 2026.1.12 (eller kör från källan main), starta sedan om gateway.
  2. Se till att MiniMax är konfigurerad (guide eller JSON), eller att en MiniMax API-nyckel finns i env/auth profiler så att leverantören kan injiceras.
  3. Använd det exakta modell-id (skiftlägeskänslig): minimax/MiniMax-M2.1 eller minimax/MiniMax-M2.1-blixtar.
  4. Run:
    openclaw models list
    
    och välj från listan (eller /model list i chat).
Alternativ A: växla per session

Kan jag använda MiniMax som min standard och OpenAI för komplexa uppgifter

Ja. Använd MiniMax som standard och byt modeller per session vid behov. Fallbackar är för fel, inte “hårda uppgifter”, så använd /model eller en separat agent. Alternativ A: växla per session
{
  env: { MINIMAX_API_KEY: "sk-...", OPENAI_API_KEY: "sk-... },
  agenter: {
    standard: {
      modell: { primära: "minimax/MiniMax-M2. " },
      modeller: {
        "minimax/MiniMax-M2. ": { alias: "minimax" },
        "openai/gpt-5. ": { alias: "gpt" },
      },
    },
  },
}
Sedan:
/modell gpt
Alternativ B: separata agenter
  • Agent A default: MiniMax
  • Agent B standard: OpenAI
  • Rutt av agent eller använd /agent för att växla
Dokument: Models, Multi-Agent Routing, MiniMax, OpenAI.

Är opus sonnet gpt inbyggda genvägar

Ja. OpenClaw fartyg några standard-shorthands (tillämpas endast när modellen finns i agents.defaults.models):
  • opusantrop/claude-opus-4-6
  • sonnetanthropic/claude-sonnet-4-5
  • gptopenai/gpt-5.2
  • gpt-miniopenai/gpt-5-mini
  • geminigoogle/gemini-3-pro-preview
  • gemini-flashgoogle/gemini-3-flash-preview
Om du anger ditt eget alias med samma namn, vinner ditt värde.

Hur definierar jag modellens genvägar alias

Alias kommer från agents.defaults.models.<modelId>.alias. Exempel:
{
  agenter: {
    standard: {
      modell: { primära: "antrop/claude-opus-4-6" },
      modeller: {
        "antrop/claude-opus-4-6": { alias: "opus" },
        "antrop/claude-sonnet-4-5": { alias: "sonnet" },
        "antrop/claude-haiku-4-5": { alias: "haiku" },
      },
    },
  },
}
Sedan /model sonnet (eller /<alias> när det stöds) löser sig till det modell-ID.

Hur lägger jag till modeller från andra leverantörer som OpenRouter eller ZAI

OpenRouter (betal-per-token; många modeller):
{
  agenter: {
    defaults: {
      model: { primär: "openrouter/anthropic/claude-sonnet-4-5" },
      modeller: { "openrouter/anthropic/claude-sonnet-4-5": {} },
    },
  },
  env: { OPENROUTER_API_KEY: "sk-or-. ." },
}
Ingen API-nyckel hittades för leverantören efter att ha lagt till en ny agent
{
  agenter: {
    defaults: {
      model: { primära: "zai/glm-4. " },
      modeller: { "zai/glm-4. ": {} },
    },
  },
  env: { ZAI_API_KEY: "..." },
}
Om du refererar till en leverantör/modell men saknar en leverantörsnyckel, får du ett körtidsfel (e. . Ingen API-nyckel hittades för leverantören "zai"). Åtgärdsalternativ: Detta innebär vanligtvis att den nya agenten har en tom auth butik. Auth är per agent och lagrad i:
~/.openclaw/agents/<agentId>/agent/auth-profiles.json
Åtgärdsalternativ:
  • Kör openclaw agenter addera <id> och konfigurera auth under guiden.
  • Eller kopiera auth-profiles.json från huvudagentens agentDir till den nya agentens agentDir.
Misslyckandet sker i två steg:

Modell failover och “Alla modeller misslyckades”

Hur fungerar failover

Misslyckandet sker i två steg:
  1. Auth profilrotation inom samma leverantör.
  2. Modellfallback till nästa modell i agents.defaults.model.fallbacks.
Det betyder att systemet försökte använda auth profil-ID anthropic:default, men kunde inte hitta autentiseringsuppgifter för det i den förväntade auth butiken.

Fixa checklista för Inga inloggningsuppgifter hittades för profil anthropicdefault

Inga inloggningsuppgifter hittades för profilen "anthropic:default"
Fixa checklista för Inga inloggningsuppgifter hittades för profilantropic

Fixa checklista för Inga inloggningsuppgifter hittades för profil anthropicdefault

  • Använd en setup-token
    • Kör claude setup-token, klistra sedan in den med openclaw models auth setup-token --provider anthropic.
    • Om token skapades på en annan maskin, använd openclaw models auth paste-token --provider anthropic.
  • Om du vill använda en API-nyckel istället
    • Om du anger ANTHROPIC_API_KEY i ditt skal men kör Gateway via system/launchd, kan det inte ärva det. Sätt den i ~/.openclaw/.env eller aktivera env.shellEnv.
  • Bekräfta att du kör kommandon på gateway-värd
    • I fjärranalys, auth profiler live på gateway-maskinen, inte din bärbara dator.
  • Sanitetskontrollmodell/auth status
    • Använd openclaw models status för att se konfigurerade modeller och om leverantörer är autentiserade.
Fixa checklista för Inga inloggningsuppgifter hittades för profilantropic Detta innebär att körningen är fäst vid en antropisk auth profil, men Gateway kan inte hitta den i sin auth butik.
  • Använd en setup-token
    • Kör claude setup-token, klistra sedan in den med openclaw models auth setup-token --provider anthropic.
    • Om token skapades på en annan maskin, använd openclaw models auth paste-token --provider anthropic.
  • Om du vill använda en API-nyckel istället
    • Sätt ANTHROPIC_API_KEY i ~/.openclaw/.envgateway host.
    • Rensa alla pinnade order som tvingar fram en saknad profil:
      openclaw modeller auth ordning rensa --provider antropisk
      
  • Bekräfta att du kör kommandon på gateway-värd
    • I fjärranalys, auth profiler live på gateway-maskinen, inte din bärbara dator.

Varför gjorde det också prova Google Gemini och misslyckas

Om din modellkonfiguration innehåller Google Gemini som en fallback (eller om du bytte till en Gemini shorthand), kommer OpenClaw att prova det under modellreserv. Om du inte har konfigurerat Google-autentiseringsuppgifter ser du No API key found for provider "google". Fix: antingen tillhandahålla Google auth, eller ta bort/undvik Google-modeller i agents.defaults.model.fallbacks / alias så att reservationen inte dirigerar dit. LLM-begäran avvisade meddelandetänkande signatur krävs google antigravitation Orsak: sessionshistoriken innehåller tänkande block utan signaturer (ofta från en avbruten/delvis ström). Google Antigravitation kräver signaturer för tänkande block. Fix: OpenClaw tar nu bort osignerade tänkande block för Google Antigravitation Claude. Om det fortfarande visas, starta en ny session eller sätt /thinking off för den agenten.

Auth profiler: vad de är och hur man hanterar dem

Relaterat: /concepts/oauth (OAuth flöden, token lagring, multi-account mönster)

Vad är typiska profil-ID

En auth profil är en namngiven autentiseringspost (OAuth eller API-nyckel) knuten till en leverantör. Profiler live i:
~/.openclaw/agents/<agentId>/agent/auth-profiles.json

Kan jag styra vilken auth profil som prövas först

OpenClaw använder leverantörs-prefix-ID:n som:
  • anthropic:default (vanligt när ingen e-post-identitet finns)
  • anthropic:<email> för OAuth identiteter
  • anpassade ID du väljer (t.ex. anthropic:work)

Kan jag styra vilken auth profil som prövas först

Ja. Konfigurationen stöder valfria metadata för profiler och en beställning per leverantör (auth.order.<provider>). Detta sparar inte hemligheter; det kartlägger ID till leverantör/läge och ställer in rotationsordning. OpenClaw kan tillfälligt hoppa över en profil om den är i en kort cooldown (hastighetsgränser/timeouts/auth fel) eller en längre inaktiverad tillstånd (fakturering/otillräcklig krediter). För att inspektera detta, kör openclaw models status --json och kontrollera auth.unusableProfiles. Tuning: auth.cooldowns.billingBackoffHours*. Du kan också ställa in en per-agent order åsidosättning (lagras i den agentens auth-profiles.json) via CLI:
# Standardvärdet för den konfigurerade standardagenten (utelämna --agent)
openclaw-modellerna auth order get --provider anthropic

# Lås rotation till en enda profil (försök bara denna)
openclaw-modellerna auth order set --provider anthropic anthropic:default

# Eller ställ in en explicit order (fallback in provider)
openclaw-modellerna auth order set --provider anthropic:work anthropic:default

# Rensa åsidosättning (falla tillbaka till config auth. rder / round-robin)
openclaw modeller auth order rensa --provider antropisk
OpenClaw stöder båda:
openclaw modeller auth order set --provider anthropic --agent main anthropic:default

OAuth vs API-nyckel vad skillnaden är

OpenClaw stöder båda:
  • OAuth utnyttjar ofta prenumerationsåtkomst (i förekommande fall).
  • API-nycklar använd pay-per-token fakturering.
gateway.port kontrollerar den enda multiplexade porten för WebSocket + HTTP (Control UI, hooks, etc.).

Gateway: portar, “redan igång” och fjärrläge

Vilken port använder Gateway

gateway.port kontrollerar den enda multiplexade porten för WebSocket + HTTP (Control UI, hooks, etc.). Prioritet:
--port > OPENCLAW_GATEWAY_PORT > gateway.port > standard 18789

Varför säger openclaw gateway-status körning, men RPC-sonden misslyckades

Eftersom “kör” är handledare vy (launchd/systemd/schtasks). RPC-sonden är CLI faktiskt ansluta till gateway WebSocket och anropa status. Du redigerar en konfigurationsfil medan tjänsten kör en annan (ofta en --profile / OPENCLAW_STATE_DIR matchar inte).
  • Probe target: (URL sonden faktiskt använde)
  • Lyssnar: (vad som faktiskt är bundet till porten)
  • Senaste gatewayfel: (vanlig rotsak när processen är vid liv, men porten lyssnar inte)

Varför skiljer openclaw gateway status visa Config cli och Config service olika

Kör det från samma --profile / miljö som du vill att tjänsten ska använda. Fix:
openclaw gateway install --force
Fixa: stoppa den andra instansen, frigör porten eller kör med openclaw gateway --port <port>.

Hur kör jag OpenClaw i remote mode klient ansluter till en Gateway någon annanstans

OpenClaw upprätthåller ett körtidslås genom att binda WebSocket-lyssnaren omedelbart vid start (standard ws://127.0.1:18789). Om bindet misslyckas med EADDRINUSE, kastar det GatewayLockError som indikerar att en annan instans redan lyssnar. Fixa: stoppa den andra instansen, frigör porten eller kör med openclaw gateway --port <port>.

Hur kör jag OpenClaw i remote mode klient ansluter till en Gateway någon annanstans

Set gateway.mode: "remote" och peka på en fjärr-WebSocket URL, eventuellt med ett token/lösenord:
{
  gateway: {
    mode: "remote",
    remote: {
      url: "ws://gateway.tailnet:18789",
      token: "your-token",
      password: "your-password",
    },
  },
}
Din gateway körs med auth aktiverad (gateway.auth.*), men UI skickar inte matchande token/lösenord.
  • openclaw gateway startar bara när gateway.mode är local (eller du passerar override flaggan).
  • MacOS appen tittar på konfigurationsfilen och växlar lägen live när dessa värden ändras.

Control UI säger obehörig eller håller återanslutning Vad nu

Din gateway körs med auth aktiverad (gateway.auth.*), men UI skickar inte matchande token/lösenord. Fakta (från kod):
  • Kontrollgränssnittet lagrar token i webbläsaren localStorage nyckel openclaw.control.settings.v1.
Fix:
  • Snabbaste: openclaw dashboard (skriver ut + kopierar kontrollpanelens URL, försöker öppna; visar SSH-tips om headless).
  • Om du inte har en token ännu: openclaw doctor --generate-gateway-token.
  • Om fjärrkontroll, tunneln först: ssh -N -L 18789:127.0.0.1:18789 user@host öppna sedan http://127.0.0.1:18789/.
  • Ange gateway.auth.token (eller OPENCLAW_GATEWAY_TOKEN) på gatewayvärden.
  • I inställningarna för Kontroll UI, klistra in samma token.
  • Fortfarande fastnar? Kör openclaw status --all och följ Troubleshooting. Se Dashboard för information om auth.

Jag sätter gatewaybind tailnet men det kan inte binda ingenting lyssnar

tailnet binda plockar en Tailscale IP från dina nätverksgränssnitt (100.64.0.0/10). Om maskinen inte är på Tailscale (eller gränssnittet är ner), finns det inget att binda till. Fix:
  • Starta Skräddarskala på den värden (så att den har en 100.x adress), eller
  • Växla till gateway.bind: "loopback" / "lan".
Obs: tailnet är explicit. auto föredrar loopback; använd gateway.bind: "tailnet" när du vill ha en tailnet-endast bind.

Kan jag köra flera Gateways på samma värd

Vanligtvis ingen - en Gateway kan köra flera meddelandekanaler och agenter. Använd flera Gateways endast när du behöver redundans (ex: räddningsbot) eller hård isolering. Ja, men du måste isolera:
  • OPENCLAW_CONFIG_PATH (per-instance config)
  • OPENCLAW_STATE_DIR (per instans stat)
  • agents.defaults.workspace (isolering av arbetsytan)
  • gateway.port (unika portar)
Snabb installation (rekommenderas):
  • Använd openclaw --profile <name> … per instans (auto-create ~/.openclaw-<name>).
  • Ange en unik gateway.port i varje profilkonfiguration (eller passera --port för manuella körningar).
  • Install a per-profile service: openclaw --profile <name> gateway install.
Profiler suffix-tjänstnamn (bot.molt.<profile>; legacy com.openclaw.*, openclaw-gateway-<profile>.service, OpenClaw Gateway (<profile>)). Fullständig guide: Flera gateways.

Vad innebär ogiltig handskakningskod 1008

Gateway är en WebSocket-server, och den förväntar sig det allra första meddelandet till vara en connect-ram. Om den tar emot något annat, stänger den anslutningen med kod 1008 (policybrott). Vanliga orsaker:
  • Du öppnade HTTP URL i en webbläsare (http://...) istället för en WS-klient.
  • Du använde fel port eller sökväg.
  • En proxy eller tunnel rensade auth headers eller skickade en icke-Gateway begäran.
Snabbkorrigeringar:
  1. Använd WS URL: ws://<host>:18789 (eller wss://... om HTTPS).
  2. Öppna inte WS-porten i en normal webbläsarflik.
  3. Om auth är på, inkludera token/lösenord i connect-ramen.
Om du använder CLI eller TUI ska webbadressen se ut:
openclaw tui --url ws://<host>:18789 --token <token>
Protocol details: Gateway protocol.

Loggning och felsökning

Var finns loggar

Snabbaste loggen svans:
/tmp/openclaw/openclaw-YYYY-MM-DD.log
Du kan ställa in en stabil sökväg via logging.file. Filloggnivån styrs av logging.level. Konsolverbositet kontrolleras av --verbose och logging.consoleLevel. Snabbaste loggen svans:
openclaw logs --follow
Service/handledare loggar (när gateway körs via launchd/systemd):
  • macOS: $OPENCLAW_STATE_DIR/logs/gateway.log och gateway.err.log (standard: ~/.openclaw/logs/...; profiler använder ~/.openclaw-<profile>/logs/...)
  • Linux: journalctl --user -u openclaw-gateway[-<profile>].service -n 200 --no-pager
  • Windows: schtasks /Query /TN "OpenClaw Gateway (<profile>)" /V /FO LIST
Se Troubleshooting för mer.

Hur startar jag Gateway-tjänsten

Använd gateway hjälpare:
openclaw gateway status
openclaw gateway omstart
Om du kör gateway manuellt, kan openclaw gateway --force återta porten. Se Gateway.

Jag avslutade min terminal på Windows hur jag startar om OpenClaw

Det finns två Windows-installationsläge: Om du aldrig har installerat tjänsten, starta den i förgrunden: Öppna PowerShell, ange WSL, starta sedan om:
wsl
openclaw gateway status
openclaw gateway omstart
Öppna PowerShell och köra:
openclaw gateway run
Om du kör det manuellt (ingen service), användning: Öppna PowerShell och köra:
openclaw gateway status
openclaw gateway omstart
Om du kör det manuellt (ingen service), användning:
openclaw gateway run
Dokument: Windows (WSL2), Gateway service runbook.

Gateway är uppe men svar kommer aldrig Vad ska jag kontrollera

Börja med ett snabbt hälsosvep:
openclaw status
openclaw modeller status
openclaw kanaler status
openclaw loggar --follow
Dokument: Channels, Troubleshooting, Remote access.
  • Modell auth inte laddad på gateway host (kontrollera models status).
  • Kanalparning/tillåten lista som blockerar svar (kontrollera kanalkonfiguration + loggar).
  • WebChat/Översikt är öppen utan rätt token.
Om du är fjärrkontroll, bekräfta tunnel/Tailscale anslutningen är uppe och att Gateway WebSocket är nåbar. Dokument: Channels, Troubleshooting, Remote access.

Frånkopplad från gateway ingen anledning vad som nu

Detta innebär vanligtvis att UI förlorade WebSocket anslutningen. Kontroll:
  1. Kör Gatewayen? openclaw gateway status
  2. Är Gateway frisk? openclaw status
  3. Har UI rätt token? openclaw dashboard
  4. Om fjärrkontroll, är tunneln/skal länken upp?
Sedan svans loggar:
openclaw logs --follow
Dokument: Dashboard, fjärråtkomst, Troubleshooting.

Telegram setMyCommands misslyckas med nätverksfel Vad ska jag kontrollera

Dokument: Telegram, Kanalfelsökning.
openclaw kanalstatus
openclaw kanalerna loggar --channel telegram
Om du är på en VPS eller bakom en proxy, bekräfta utgående HTTPS är tillåtet och DNS fungerar. Om Gateway är fjärrkontroll, se till att du tittar på loggar på Gateway värd. Dokument: Telegram, Kanalfelsökning.

TUI visar ingen utgång Vad ska jag kontrollera

Dokument: TUI, Slash kommandon.
openclaw status
openclaw modellens status
openclaw loggar --follow
I TUI, använd /status för att se aktuellt tillstånd. Om du förväntar dig svar i en chatt kanal, se till att leverans är aktiverad (/deliver on). Dokument: TUI, Slash kommandon.

Hur slutar jag då helt och hållet starta Gateway

Om du kör i förgrunden, sluta med Ctrl-C, sedan:
openclaw gateway stop
openclaw gateway start
Detta stoppar/startar den övervakade tjänsten (launchd på macOS, systemd på Linux). Använd detta när Gateway körs i bakgrunden som en daemon. Om du kör i förgrunden, sluta med Ctrl-C, sedan:
openclaw gateway run
Docs: Gateway service runbook.

Vad är det snabbaste sättet att få mer detaljer när något misslyckas

  • openclaw gateway restart: startar om bakgrundstjänsten (launchd/systemd).
  • openclaw gateway: kör gateway i förgrunden för denna terminalsession.
Om du har installerat tjänsten, använd gateway-kommandon. Använd openclaw gateway när du vill ha en one-off, förgrundsrunda.

Min skicklighet genererade en imagePDF men ingenting skickades

Starta Gateway med --verbose för att få mer information om konsolen. Sedan inspektera loggfilen för kanal auth, modell routing och RPC fel.

Media och bilagor

Min skicklighet genererade en imagePDF men ingenting skickades

Utgående bilagor från agenten måste innehålla en MEDIA:<path-or-url> -linje (på egen rad). Se OpenClaw assistent setup och Agent send. CLI skickar:
openclaw meddelande skicka --target +15555550123 --message "Here you go" --media /path/to/file.png
Kontroll:
  • Målkanalen stöder utgående media och blockeras inte av tillåtna listor.
  • Filen ligger inom leverantörens storleksgränser (bilder skalas om till max 2048px).
Se Images.

Säkerhet och åtkomstkontroll

Är det säkert att utsätta OpenClaw för inkommande DMs

Behandla inkommande DMs som opålitlig indata. Standardvärden är utformade för att minska risken:
  • Standardbeteende på DM-kapabla kanaler är parning:
    • Okända avsändare får en parningskod; boten bearbetar inte sitt meddelande.
    • Godkänn med: openclaw parkoppling godkänner <channel> <code>
    • Väntande förfrågningar är capped på 3 per kanal; kontrollera openclaw parningslista <channel> om en kod inte anländer.
  • Öppnande av DMs kräver offentligt explicit opt-in (dmPolicy: "open" och allowlist "*").
Kör openclaw läkare för att ytan riskabelt DM politik.

Är snabb injektion bara ett bekymmer för offentliga robotar

Nej. Snabb injektion handlar om opålitligt innehåll, inte bara vem som kan DM boten. Om din assistent läser externt innehåll (webbsök/hämtning, webbläsarsidor, e-post, dokument, Bilagor, klistrade loggar), det innehållet kan innehålla instruktioner som försöker för att kapa modellen. Detta kan hända även om du är den enda avsändaren. Den största risken är när verktyg är aktiverade: modellen kan luras in i exfiltrera sammanhang eller ringa verktyg för din räkning. Minska sprängradien genom att:
  • använda en skrivskyddad eller verktygsinaktiverad “läsare” agent för att sammanfatta opålitligt innehåll
  • hålla web_search / web_fetch / browser avstängd för verktygsaktiverade agenter
  • sandlåda och strikta verktygslistor
Detaljer: Security.

Om min bot har sin egen e-post GitHub-konto eller telefonnummer

Ja, för de flesta inställningar. Isolera botten med separata konton och telefonnummer minskar sprängradien om något går fel. Detta gör det också lättare att rotera -uppgifter eller återkalla åtkomst utan att påverka dina personliga konton. Börja små. Ge endast tillgång till de verktyg och konton du faktiskt behöver, och expandera senare om det behövs. Dokument: Security, Pairing.

Kan jag ge det autonomi över mina textmeddelanden och är så säker

Vi rekommenderar inte fullständig autonomi över dina personliga meddelanden. Det säkraste mönstret är:
  • Håll DMs i parningsläge eller en tät tillåten lista.
  • Använd ett separat nummer eller konto om du vill att det ska meddelas åt dig.
  • Låt det utkast, sedan godkänna innan du skickar.
Om du vill experimentera, gör det på ett dedikerat konto och hålla det isolerat. Se Security.

Kan jag använda billigare modeller för personliga assistentuppgifter

Ja, om är agenten endast chattad och inmatningen är betrodd. Mindre nivåer är mer mottagliga för instruktion kapning, så undvik dem för verktygsaktiverade agenter eller när du läser opålitligt innehåll. Om du måste använda en mindre modell, lås ner verktyg och kör inuti en sandlåda. Se Security.

Jag körde start i Telegram men fick inte en parningskod

Parkopplingskoderna skickas bara när en okänd avsändare meddelar bot och dmPolicy: "parkoppling" är aktiverat. /start i sig själv genererar ingen kod. Kontrollera väntande förfrågningar:
openclaw pairing list telegram
Godkänn parkoppling med:

WhatsApp kommer att skicka meddelanden till mina kontakter Hur kopplar ihop fungerar

Nej. Standard WhatsApp DM policy är ihopkoppling. Okända avsändare får bara en parningskod och deras meddelande behandlas inte. OpenClaw svarar bara på chattar som den tar emot eller uttryckligen skickar dig utlösare. Godkänn parkoppling med:
openclaw pairing approve whatsapp <code>
Lista väntande förfrågningar:
openclaw pairing list whatsapp
Fråga om guiden telefonnummer: den används för att ställa in tillåtna/ägare så att dina egna DMs är tillåtna. Den används inte för automatisk sändning. Om du kör på ditt personliga WhatsApp-nummer, använd det numret och aktivera channels.whatsapp.selfChatMode.

Chattkommandon, avbryter uppgifter och “det slutar inte”

Hur stoppar jag interna systemmeddelanden från att visas i chatten

De flesta interna meddelanden eller verktygsmeddelanden visas endast när verbos eller resonemang är aktiverade för den sessionen. Dokument: Thinking and verbose, Security.
/verbose off
/reasoning off
Om det fortfarande är bullrigt, kontrollera sessionsinställningarna i kontrollgränssnittet och ställ in verbose till arv. Bekräfta också att du inte använder en bot profil med verboseDefault set till on i config. Dokument: Thinking and verbose, Security.

Hur stoppar jag en pågående uppgift

För bakgrundsprocesser (från exec-verktyget) kan du be agenten att köra:
processa:kill sessionId:XXX
Slash kommandon översikt: se Slash kommandon. De flesta kommandon måste skickas som ett standalone meddelande som börjar med /, men några genvägar (som /status) fungerar också inline för tillåtna avsändare.
processa:kill sessionId:XXX
Slash kommandon översikt: se Slash kommandon. Aktivera cross-provider meddelande för agenten:

Hur skickar jag ett Discord-meddelande från Telegram Crosscontext messaging nekas

OpenClaw block cross-provider meddelande som standard. Om ett verktygssamtal är bundet till Telegram kommer det inte att skickas till Discord såvida du inte uttryckligen tillåter det. Aktivera cross-provider meddelande för agenten:
{
  agenter: {
    defaults: {
      tools: {
        message: {
          crossContext: {
            allowAcrossProviders: true,
            markör: { aktiverad: sant, prefix: "[från {channel}] " },
          },
        },
      },
    },
  },
}
Starta om gateway efter redigering av konfigurationen. Om du bara vill ha detta för en enda agent, ange det under agents.list[].tools.message istället.

Varför känns det som att boten ignorerar snabba meddelanden

Köläget styr hur nya meddelanden interagerar med en in-flight-körning. Använd /queue för att ändra lägen:
  • steer - nya meddelanden omdirigerar den aktuella uppgiften
  • followup - kör meddelanden en åt gången
  • collect - batch-meddelanden och svara en gång (standard)
  • steer-backlog - styra nu, sedan bearbeta eftersläpning
  • interrupt - avbryt nuvarande körning och starta nytt
Du kan lägga till alternativ som debounce:2s cap:25 drop:summarize för uppföljningslägen.

Svara på den exakta frågan från skärmdumpen/chattloggen

F: “Vad är standardmodellen för Anthropic med en API-nyckel?” S: I OpenClaw separeras autentiseringsuppgifter och modellval. Ställa in ANTHROPIC_API_KEY (eller lagra en Anthropic API-nyckel i auth profiler) möjliggör autentisering, men den faktiska standardmodellen är vad du konfigurerar i agents. efaults.model.primary (till exempel, anthropic/claude-sonnet-4-5 eller anthropic/claude-opus-4-6). Om du ser Inga autentiseringsuppgifter hittades för profilen "antrop:default", betyder det att Gateway inte kunde hitta antropiska autentiseringsuppgifter i de förväntade auth-profilerna. son för agenten som körs.
Fortfarande fastnar? Fråga i Discord eller öppna en GitHub diskussion.