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
- [Snabbstart och första körningen]
- Jag sitter fast – vad är snabbaste sättet att komma loss?
- Vad är det rekommenderade sättet att installera och konfigurera OpenClaw?
- Hur öppnar jag instrumentpanelen efter introduktionen?
- Hur autentiserar jag instrumentpanelen (token) på localhost jämfört med remote?
- Vilken runtime behöver jag?
- Kör det på Raspberry Pi?
- Några tips för Raspberry Pi‑installationer?
- Det är fastnat på “vakna upp min vän” / onboarding kommer inte kläckas. Vad nu?
- Kan jag migrera min installation till en ny maskin (Mac mini) utan att göra om introduktionen?
- Var ser jag vad som är nytt i senaste versionen?
- Jag kan inte komma åt docs.openclaw.ai (SSL-fel). Vad nu?
- Vad är skillnaden mellan stable och beta?
- Hur installerar jag beta‑versionen, och vad är skillnaden mellan beta och dev?
- Hur provar jag de senaste ändringarna?
- Hur lång tid tar installation och introduktion vanligtvis?
- Installationsprogrammet fastnar? Hur får jag mer feedback?
- Windows‑installationen säger att git saknas eller att openclaw inte känns igen
- Dokumentationen svarade inte på min fråga – hur får jag ett bättre svar?
- Hur installerar jag OpenClaw på Linux?
- Hur installerar jag OpenClaw på en VPS?
- Var finns guiderna för moln/VPS‑installationer?
- Kan jag be OpenClaw att uppdatera sig själv?
- Vad gör introduktionsguiden egentligen?
- Behöver jag en Claude‑ eller OpenAI‑prenumeration för att köra detta?
- Kan jag använda Claude Max‑prenumeration utan API‑nyckel
- Hur fungerar Anthropic ”setup‑token”‑autentisering?
- Var hittar jag en Anthropic setup‑token?
- Stöder ni Claude‑prenumerationsautentisering (Claude Pro eller Max)?
- Varför ser jag HTTP 429 ratelimiterror från Anthropic?
- Stöds AWS Bedrock?
- Hur fungerar Codex‑autentisering?
- Stöder ni OpenAI‑prenumerationsautentisering (Codex OAuth)?
- Hur konfigurerar jag Gemini CLI OAuth
- Är en lokal modell okej för vardagliga chattar?
- Hur håller jag trafik till hostade modeller inom en specifik region?
- Måste jag köpa en Mac mini för att installera detta?
- Behöver jag en Mac mini för iMessage‑stöd?
- Om jag köper en Mac mini för att köra OpenClaw, kan jag ansluta den till min MacBook Pro?
- Kan jag använda Bun?
- Telegram: vad ska stå i allowFrom?
- Kan flera personer använda ett WhatsApp‑nummer med olika OpenClaw‑instanser?
- Kan jag köra en ”snabb chatt”‑agent och en ”Opus för kodning”‑agent?
- Fungerar Homebrew på Linux?
- Vad är skillnaden mellan hackbar (git)‑installation och npm‑installation?
- Kan jag byta mellan npm‑ och git‑installationer senare?
- Bör jag köra Gateway på min laptop eller på en VPS?
- Hur viktigt är det att köra OpenClaw på en dedikerad maskin?
- Vilka är minimikraven för VPS och rekommenderat OS?
- Kan jag köra OpenClaw i en VM och vilka är kraven?
- Vad är OpenClaw?
- Vad är OpenClaw, i ett stycke?
- Vad är värdeerbjudandet?
- Jag har precis installerat det – vad ska jag göra först?
- Vilka är de fem vanligaste vardagsanvändningarna för OpenClaw?
- Kan OpenClaw hjälpa med lead gen, outreach, annonser och bloggar för ett SaaS?
- Vilka är fördelarna jämfört med Claude Code för webbutveckling?
- Skills och automatisering
- Hur anpassar jag Skills utan att smutsa ned repot?
- Kan jag ladda Skills från en egen mapp?
- Hur kan jag använda olika modeller för olika uppgifter?
- Botten fryser medan man gör tungt arbete. Hur avlastar jag det?
- Cron eller påminnelser brinner inte. Vad ska jag kontrollera?
- Hur installerar jag Skills på Linux?
- Kan OpenClaw köra uppgifter enligt schema eller kontinuerligt i bakgrunden?
- Kan jag köra Apple macOS‑endast‑Skills från Linux?
- Har ni en Notion‑ eller HeyGen‑integration?
- Hur installerar jag Chrome‑tillägget för webbläsarövertagande?
- Sandboxing och minne
- Var saker ligger på disk
- Sparas all data som används med OpenClaw lokalt?
- Var lagrar OpenClaw sin data?
- Var ska AGENTS.md / SOUL.md / USER.md / MEMORY.md ligga?
- Vilken är den rekommenderade backup‑strategin?
- Hur avinstallerar jag OpenClaw helt?
- Kan agenter arbeta utanför arbetsytan?
- Jag är i remote‑läge – var finns sessionslagret?
- Grundläggande konfig
- Vilket format är konfigurationen? Var finns det?
- Jag satte gatewaybind lan eller tailnet och nu lyssnar inget / UI säger obehörig
- Varför behöver jag en token på localhost nu?
- Måste jag starta om efter att ha ändrat konfig?
- Hur aktiverar jag webbsökning (och web fetch)?
- config.apply rensade min konfiguration. Hur återhämtar jag mig och undviker detta?
- Hur kör jag en central Gateway med specialiserade workers över flera enheter?
- Kan OpenClaw‑webbläsaren köras headless?
- Hur använder jag Brave för webbläsarstyrning?
- Fjärr‑Gateways och noder
- Hur propagerar kommandon mellan Telegram, gatewayn och noder?
- Hur kan min agent komma åt min dator om Gateway är hostad remote?
- Tailscale är ansluten, men jag får inga svar. Vad nu?
- Kan två OpenClaw‑instanser prata med varandra (lokal + VPS)?
- Behöver jag separata VPS:er för flera agenter?
- Finns det en fördel med att använda en nod på min personliga laptop istället för SSH från en VPS?
- Kör noder en gateway‑tjänst?
- Finns det ett API/RPC‑sätt att applicera konfig?
- Vad är en minimal ”rimlig” konfig för en första installation?
- Hur konfigurerar jag Tailscale på en VPS och ansluter från min Mac?
- Hur ansluter jag en Mac‑nod till en remote Gateway (Tailscale Serve)?
- Bör jag installera på en andra laptop eller bara lägga till en nod?
- Miljövariabler och .env‑laddning
- Sessioner och flera chattar
- Hur startar jag en ny konversation?
- Återställs sessioner automatiskt om jag aldrig skickar ”new”?
- Finns det ett sätt att göra ett team av OpenClaw‑instanser med en VD och många agenter?
- Varför blev kontext stympad mitt i uppgiften? Hur förhindrar jag det?
- Hur återställer jag OpenClaw helt men behåller installationen?
- Jag får ”context too large”‑fel – hur återställer eller komprimerar jag?
- Varför ser jag ”LLM request rejected: messages.N.content.X.tool_use.input: Field required”?
- Varför får jag heartbeat‑meddelanden var 30:e minut?
- Behöver jag lägga till ett ”bot‑konto” i en WhatsApp‑grupp?
- Hur får jag JID för en WhatsApp‑grupp?
- Varför svarar inte OpenClaw i en grupp?
- Delar grupper/trådar kontext med DM?
- Hur många arbetsytor och agenter kan jag skapa?
- Kan jag köra flera bottar eller chattar samtidigt (Slack), och hur bör jag sätta upp det?
- Modeller: standarder, val, alias, växling
- Vad är ”standardmodellen”?
- Vilken modell rekommenderar ni?
- Hur byter jag modell utan att radera min konfig?
- Kan jag använda självhostade modeller (llama.cpp, vLLM, Ollama)?
- Vilka modeller använder OpenClaw, Flawd och Krill?
- Hur byter jag modell i farten (utan omstart)?
- Kan jag använda GPT 5.2 för dagliga uppgifter och Codex 5.3 för kodning?
- Varför ser jag “Modell … är inte tillåtet” och sedan inget svar?
- Varför ser jag ”Unknown model: minimax/MiniMax-M2.1”?
- Kan jag använda MiniMax som standard och OpenAI för komplexa uppgifter?
- Är opus / sonnet / gpt inbyggda genvägar?
- Hur definierar/åsidosätter jag modellgenvägar (alias)?
- Hur lägger jag till modeller från andra leverantörer som OpenRouter eller Z.AI?
- Modell‑failover och ”All models failed”
- Autentiseringsprofiler: vad de är och hur du hanterar dem
- Gateway: portar, ”already running” och remote‑läge
- Vilken port använder Gateway?
- Varför säger openclaw gateway status ”Runtime running” men ”RPC probe failed”?
- Varför visar openclaw gateway status ”Config cli” och ”Config service” olika?
- Vad betyder ”another gateway instance is already listening”?
- Hur kör jag OpenClaw i remote‑läge (klient ansluter till en Gateway någon annanstans)?
- Kontroll UI säger “obehörig” (eller håller på att återanslutas). Vad nu?
- Jag satte gatewaybind tailnet men den kan inte binda / inget lyssnar
- Kan jag köra flera Gateways på samma värd?
- Vad betyder ”invalid handshake” / kod 1008?
- Loggning och felsökning
- Var finns loggar?
- Hur startar/stoppar/startar jag om Gateway‑tjänsten?
- Jag stängde min terminal på Windows – hur startar jag om OpenClaw?
- The Gateway är uppe men svar kommer aldrig. Vad ska jag kontrollera?
- ”Disconnected from gateway: no reason” – vad nu?
- Telegram setMyCommands misslyckas med nätverksfel. Vad ska jag kontrollera?
- TUI visar ingen utgång. Vad ska jag kontrollera?
- Hur stoppar jag helt och startar sedan Gateway?
- ELI5: openclaw gateway restart vs openclaw gateway
- Vad är snabbaste sättet att få mer detaljer när något misslyckas?
- Media och bilagor
- Säkerhet och åtkomstkontroll
- Är det säkert att exponera OpenClaw för inkommande DM?
- Är prompt injection bara ett problem för publika bottar?
- Bör min bot ha sitt eget e‑post‑/GitHub‑konto eller telefonnummer?
- Kan jag ge den autonomi över mina textmeddelanden och är det säkert?
- Kan jag använda billigare modeller för personliga assistentuppgifter?
- Jag körde start i Telegram men fick ingen parningskod
- WhatsApp: kommer det att skicka meddelanden till mina kontakter? Hur fungerar parkoppling?
- Chattkommandon, avbryta uppgifter och ”den slutar inte”
Första 60 sekunderna om något är trasigt
-
Snabb status (första kontrollen)
Snabb lokal sammanfattning: OS + uppdatering, gateway/tjänstens nåbarhet, agenter/sessioner, leverantörskonfig + runtime‑problem (när gatewayn är nåbar).
-
Rapport att klistra in (säker att dela)
Skrivskyddad diagnos med loggsvans (tokens maskerade).
-
Daemon‑ och portstatus
Visar supervisor‑runtime vs RPC‑nåbarhet, probe‑URL och vilken konfig tjänsten sannolikt använde.
-
Djupare prober
Kör gateway hälsokontroller + leverantör sonder (kräver en nåbar gateway). Se Health.
-
Följ senaste loggen
Om RPC är nere, fall tillbaka till:Filloggar är separata från tjänsteloggar; se Loggning och Felsökning.
-
Kör doktorn (reparationer)
Reparationer/migrerar config/state + kör hälsokontroller. Se Doctor.
-
Gateway‑ögonblicksbild
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.- Claude Code: https://www.anthropic.com/claude-code/
- OpenAI Codex: https://openai.com/codex/
--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: snabb snapshot av gateway/agent‑hälsa + grundläggande konfig.openclaw models status: kontrollerar leverantörsautentisering + modelltillgänglighet.openclaw doctor: validerar och reparerar vanliga konfig/tillståndsproblem.
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.)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(ellerOPENCLAW_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).
- Tailscale Serve (rekommenderas): behåll bind loopback, kör
openclaw gateway --tailscale serve, öppnahttps://<magicdns>/. Omgateway.auth.allowTailscaleärtrue, uppfyller identitetshuvuden auth (ingen token). - Tailnet bind: kör
openclaw gateway --bind tailnet --token "<token>", openhttp://<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 sedanhttp://127.0.0.1:18789/och klistra in token i kontrollgränssnittets inställningar.
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.
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.- Starta om Gateway:
- Kontrollera status + auth:
- Om det fortfarande hänger, köra:
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:- Installera OpenClaw på den nya maskinen.
- Kopiera
$OPENCLAW_STATE_DIR(standard:~/.openclaw) från den gamla maskinen. - Kopiera din arbetsyta (standard:
~/.openclaw/workspace). - Kör
openclaw doctoroch starta om Gateway-tjänsten.
~/.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 felaktigtdocs.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= stabilbeta= tidig uppbyggnad för testning
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 npmbeta (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):
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
Hur gör jag för att prova de senaste bitarna
Två alternativ:- Dev kanal (git kassa):
main och uppdateringar från källan.
- Hackbar installation (från installationssidan):
Installationsprogram fastnat Hur får jag mer feedback
Kör om installationsprogrammet med verbose output: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:
- Din npm globala bin mapp är inte på PATH.
-
Kontrollera sökvägen:
-
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.
Dokumenten besvarade inte min fråga hur jag får ett bättre svar
Mer detalj: Install och Installationsflaggor.Hur installerar jag OpenClaw på Linux
Kort svar: Följ Linuxguiden och kör sedan onboardingguiden.- Linux quick path + service install: Linux.
- Fullständig genomgång: Komma igång.
- Installer + uppdateringar: Installera & uppdateringar.
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:- VPS hosting (alla leverantörer på ett ställe)
- Fly.io
- Hetzner
- exe.dev
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: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
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 CLI på alla maskiner: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 tillopenai-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 iopenclaw.json.
Hur ställer jag in Gemini CLI OAuth
Gemini CLI använder ett plugin auth flow, inte ett klient-id eller hemligt iopenclaw.json.
Steg
- Aktivera plugin: ‘openclaw plugins aktivera google-gemini-cli-auth’
- Logga in:
openclaw models auth login --provider google-gemini-cli --set-default
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ändamodels.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.
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 ochsystem.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 listför att se den.
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 --followoch läsfrom.id.
- DM din bot och anropa sedan
https://api.telegram.org/bot<bot_token>/getUpdatesoch läsmessage.from.id.
- DM
@userinfoboteller@getidsbot.
Kan flera personer använda ett WhatsApp-nummer med olika OpenClaw instanser
Ja, via multi-agent routing. Bind each sender’s WhatsApp DM (peerkind: "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:/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.
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:
--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.
- 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.
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.
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.
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.
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.
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.
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
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 viaskills.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
/modelför att växla den aktuella sessionsmodellen när som helst.
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) ochOPENCLAW_SKIP_CRONär inte inställd. - Kontrollera att Gateway körs 24/7 (ingen viloläge/omstart).
- Verifiera tidzoninställningar för jobbet (
--tzvs värdtidszon).
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):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.
Kan jag köra endast kunskaper i Apple macOS-system från Linux?
Inte direkt. macOS färdigheter är gated avmetadata.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.
-
Skapa en SSH-omvandlare för binären (exempel:
memoför Apple Notes): -
Sätt omslaget på
PATHpå Linux-värden (till exempel~/bin/memo). -
Åsidosätt skicklighetsmetadata (arbetsyta eller
~/.openclaw/skills) för att tillåta Linux: - 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.
- En Notion sida per klient (kontext + inställningar + aktivt arbete).
- Be agenten att hämta den sidan i början av en session.
. 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äggchrome://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 somnode-användaren, så den innehåller inte
systempaket, Homebrew, eller medföljande webbläsare. För en fylligare inställning:
- Beständig
/home/nodemedOPENCLAW_HOME_VOLUMEså 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_PATHoch se till att sökvägen kvarstår.
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
Angeagents.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)
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 iMEMORY.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.
Var lagrar OpenClaw sina data
Allt lever under$OPENCLAW_STATE_DIR (standard: ~/.openclaw):
| Sökväg | Syfte |
|---|---|
$OPENCLAW_STATE_DIR/openclaw.json | Huvudkonfigurationen (JSON5) |
$OPENCLAW_STATE_DIR/credentials/oauth.json | Legacy OAuth import (kopieras till auth profiler vid första användning) |
$OPENCLAW_STATE_DIR/agents/<agentId>/agent/auth-profiles.json | Auth profiler (OAuth + API-nycklar) |
$OPENCLAW_STATE_DIR/agents/<agentId>/agent/auth.json | Runtime 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/<agentId>/sessions/ | Konversationshistorik & tillstånd (per agent) |
$OPENCLAW_STATE_DIR/agents/<agentId>/sessions/sessions.json | Session metadata (per agent) |
~/.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(ellermemory.md),memory/YYY-MM-DD.md, valfrittHEARTBEAT.md. - State dir (
~/.openclaw): config, credentials, auth profiles, sessioner, loggar, och delade färdigheter (~/.openclaw/skills).
~/.openclaw/workspace, konfigurerbar via:
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ändagents.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):
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/workspace).
Jag sätter gatewaybind lan eller tailnet och nu inget lyssnar UI säger obehörig
Icke-loopback binder kräver auth. Konfigureragateway.auth.mode + gateway.auth.token (eller använd OPENCLAW_GATEWAY_TOKEN).
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 bortgateway.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 kritiskahot,restart,offstö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.
- Om du använder tillåtna listor, lägg till
web_search/web_fetchellergroup:web. web_fetchär aktiverat som standard (om det inte uttryckligen inaktiveras).- Daemons läste env vars från
~/.openclaw/.env(eller servicemiljön).
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.
Kan OpenClaw-webbläsaren köra huvudlöst
Ja. Det är ett konfigurationsalternativ: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 inbrowser.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 anropanode.* verktyg (skärm, kamera, system) på din lokala maskin över Gateway WebSocket.
Typisk inställning:
- Kör Gateway på den alltid på-värd (VPS/home server).
- Sätt Gateway värd + din dator på samma tailnet.
- Se till att Gateway WS är nåbar (tailnet bind eller SSH tunnel).
- Ö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.
-
Godkänn noden på Gateway:
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
- 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.
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 medopenclaw 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.
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, ochscreenutöversystem.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.
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örgateway, 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örgateway, 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 doctoroch 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.
- Använd
openclaw config setför små ändringar. - Använd
openclaw configureför interaktiva redigeringar.
Hur ställer jag in Tailscale på en VPS och ansluter från min Mac
Hur ställer jag in Tailscale på en VPS och ansluter från min Mac
Minimala steg:-
Installera + logga in på VPS
-
Installera + logga in på din Mac
- Använd appen Tailscale och logga in på samma tailnet.
-
Aktivera MagicDNS (rekommenderas)
- I Tailscale adminkonsolen, aktivera MagicDNS så att VPS har ett stabilt namn.
-
Använd tailnet värdnamn
- SSH:
ssh [email protected] - Gateway WS:
ws://your-vps.tailnet-xxxx.ts.net:18789
- SSH:
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:- Se till att VPS + Mac är på samma tailnet.
- 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.
-
Godkänn noden på gateway:
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:.envfrån den aktuella arbetskatalogen- a global fallback
.envfrom~/.openclaw/.env(aka$OPENCLAW_STATE_DIR/.env)
.env file overrides existing env vars.
Du kan också definiera inline env vars i config (tillämpas endast om saknas från processen env):
Jag startade Gateway via tjänsten och mina env vars försvann Vad nu
Två vanliga rättelser:- Sätt de saknade nycklarna i
~/.openclaw/.envså de plockas upp även när tjänsten inte ärver ditt skal env. - Aktivera skalimport (opt-in bekvämlighet):
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:
-
Sätt token i
~/.openclaw/.env: -
Eller aktivera skalimport (
env.shellEnv.enabled: true). -
Eller lägg till den i ditt config
env-block (gäller endast om det saknas).
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 eftersession.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.
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
/compactföre långa uppgifter och/newvid 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:- 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):
eller
/compact <instructions>för att vägleda sammanfattningen. -
Återställ (nytt sessions-ID för samma chattnyckel):
- Aktivera eller trimma sessionsbeskärning (
agents.defaults.contextPruning) för att trimma gamla verktygsutmatningar. - Använd en modell med ett större sammanhangsfönster.
/new (fristående meddelande).
Varför får jag hjärtslag var 30 minut
Detta är ett leverantörsvalideringsfel: modellen släppte ut etttool_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: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:
Hur får jag JID för en WhatsApp-grupp
Alternativ 2 (om redan konfigurerad/tillåten): listgrupper från config: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.groupsutan"*"och gruppen är inte tillåten.
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.
- 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 doctorfö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.
Modeller: standardinställningar, urval, alias, växlar
Vad är standardmodellen
OpenClaws standardmodell är vad du anger 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./modeli chatt (snabb, per session)openclaw models set ...(uppdateringar bara modell config)openclaw konfigurera --section model(interaktiv)- redigera
agents.defaults.modeli~/.openclaw/openclaw.json
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 (och /model list) visar en kompakt, numrerad väljare. Välj efter nummer:
/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 (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.2för dagliga uppgifter,/model gpt-5.3-codexför kodning. - Standard + switch: sätt
agents.defaults.model.primarytillopenai/gpt-5.2, byt sedan tillopenai-codex/gpt-5.3-codexvid kodning (eller tvärtom). - Underagenter: ruttkodningsuppgifter till underagenter med en annan standardmodell.
Varför ser jag Modell är inte tillåtet och då inget svar
Omagents.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:
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:-
Uppgradera till 2026.1.12 (eller kör från källan
main), starta sedan om gateway. - 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.
-
Använd det exakta modell-id (skiftlägeskänslig):
minimax/MiniMax-M2.1ellerminimax/MiniMax-M2.1-blixtar. -
Run:
och välj från listan (eller
/model listi chat).
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
- Agent A default: MiniMax
- Agent B standard: OpenAI
- Rutt av agent eller använd
/agentför att växla
Är opus sonnet gpt inbyggda genvägar
Ja. OpenClaw fartyg några standard-shorthands (tillämpas endast när modellen finns iagents.defaults.models):
opus→antrop/claude-opus-4-6sonnet→anthropic/claude-sonnet-4-5gpt→openai/gpt-5.2gpt-mini→openai/gpt-5-minigemini→google/gemini-3-pro-previewgemini-flash→google/gemini-3-flash-preview
Hur definierar jag modellens genvägar alias
Alias kommer frånagents.defaults.models.<modelId>.alias. Exempel:
/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):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:
- Kör
openclaw agenter addera <id>och konfigurera auth under guiden. - Eller kopiera
auth-profiles.jsonfrån huvudagentensagentDirtill den nya agentensagentDir.
Modell failover och “Alla modeller misslyckades”
Hur fungerar failover
Misslyckandet sker i två steg:- Auth profilrotation inom samma leverantör.
- Modellfallback till nästa modell i
agents.defaults.model.fallbacks.
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
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 medopenclaw models auth setup-token --provider anthropic. - Om token skapades på en annan maskin, använd
openclaw models auth paste-token --provider anthropic.
- Kör
- Om du vill använda en API-nyckel istället
- Om du anger
ANTHROPIC_API_KEYi ditt skal men kör Gateway via system/launchd, kan det inte ärva det. Sätt den i~/.openclaw/.enveller aktiveraenv.shellEnv.
- Om du anger
- 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 statusför att se konfigurerade modeller och om leverantörer är autentiserade.
- Använd
-
Använd en setup-token
- Kör
claude setup-token, klistra sedan in den medopenclaw models auth setup-token --provider anthropic. - Om token skapades på en annan maskin, använd
openclaw models auth paste-token --provider anthropic.
- Kör
-
Om du vill använda en API-nyckel istället
-
Sätt
ANTHROPIC_API_KEYi~/.openclaw/.envpå gateway host. -
Rensa alla pinnade order som tvingar fram en saknad profil:
-
Sätt
-
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 duNo 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: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:
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:
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 anropastatus.
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 --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 (standardws://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
Setgateway.mode: "remote" och peka på en fjärr-WebSocket URL, eventuellt med ett token/lösenord:
gateway.auth.*), men UI skickar inte matchande token/lösenord.
openclaw gatewaystartar bara närgateway.modeärlocal(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.
- 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 sedanhttp://127.0.0.1:18789/. - Ange
gateway.auth.token(ellerOPENCLAW_GATEWAY_TOKEN) på gatewayvärden. - I inställningarna för Kontroll UI, klistra in samma token.
- Fortfarande fastnar? Kör
openclaw status --alloch 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".
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)
- Använd
openclaw --profile <name> …per instans (auto-create~/.openclaw-<name>). - Ange en unik
gateway.porti varje profilkonfiguration (eller passera--portför manuella körningar). - Install a per-profile service:
openclaw --profile <name> gateway install.
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 enconnect-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.
- Använd WS URL:
ws://<host>:18789(ellerwss://...om HTTPS). - Öppna inte WS-porten i en normal webbläsarflik.
- Om auth är på, inkludera token/lösenord i
connect-ramen.
Loggning och felsökning
Var finns loggar
Snabbaste loggen svans:logging.file. Filloggnivån styrs av logging.level. Konsolverbositet kontrolleras av --verbose och logging.consoleLevel.
Snabbaste loggen svans:
- macOS:
$OPENCLAW_STATE_DIR/logs/gateway.logochgateway.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
Hur startar jag Gateway-tjänsten
Använd gateway hjälpare: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:Gateway är uppe men svar kommer aldrig Vad ska jag kontrollera
Börja med ett snabbt hälsosvep:- 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.
Frånkopplad från gateway ingen anledning vad som nu
Detta innebär vanligtvis att UI förlorade WebSocket anslutningen. Kontroll:- Kör Gatewayen?
openclaw gateway status - Är Gateway frisk?
openclaw status - Har UI rätt token?
openclaw dashboard - Om fjärrkontroll, är tunneln/skal länken upp?
Telegram setMyCommands misslyckas med nätverksfel Vad ska jag kontrollera
Dokument: Telegram, Kanalfelsökning.TUI visar ingen utgång Vad ska jag kontrollera
Dokument: TUI, Slash kommandon./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: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.
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 enMEDIA:<path-or-url> -linje (på egen rad). Se OpenClaw assistent setup och Agent send.
CLI skickar:
- 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).
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"*").
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/browseravstängd för verktygsaktiverade agenter - sandlåda och strikta verktygslistor
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.
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 ochdmPolicy: "parkoppling" är aktiverat. /start i sig själv genererar ingen kod.
Kontrollera väntande förfrågningar:
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: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.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:/, men några genvägar (som /status) fungerar också inline för tillåtna avsändare.
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: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 uppgiftenfollowup- kör meddelanden en åt gångencollect- batch-meddelanden och svara en gång (standard)steer-backlog- styra nu, sedan bearbeta eftersläpninginterrupt- avbryt nuvarande körning och starta nytt
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 inANTHROPIC_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.