Hoppa till huvudinnehåll

​
Konfigurering

Om du ställer in för första gången, börja med Komma igång. För information om guiden, se Onboarding Wizard.
Senast uppdaterad: 2026-01-01

​
TL;DR

  • Anpassning ligger utanför repot: ~/.openclaw/workspace (workspace) + ~/.openclaw/openclaw.json (konfig).
  • Stabilt arbetsflöde: installera macOS-appen; låt den köra den medföljande Gateway.
  • Bleeding edge-arbetsflöde: kör Gateway själv via pnpm gateway:watch, och låt sedan macOS-appen ansluta i lokalt läge.

​
Förutsättningar (från källkod)

  • Node >=22
  • pnpm
  • Docker (valfritt; endast för containeriserad setup/e2e — se Docker)

​
Anpassningsstrategi (så uppdateringar inte gör ont)

Om du vill ha ”100 % anpassat för mig” och enkla uppdateringar, behåll din anpassning i:
  • Konfig: ~/.openclaw/openclaw.json (JSON/JSON5‑likt)
  • Workspace: ~/.openclaw/workspace (Skills, prompts, minnen; gör det till ett privat git‑repo)
Bootstrap en gång: 
openclaw setup
Från insidan av detta repo, använd den lokala CLI‑ingången: 
openclaw setup
Om du inte har en global installation ännu, kör den via pnpm openclaw setup.

​
Kör Gateway från detta repo

Efter pnpm build kan du köra den paketerade CLI:n direkt: 
node openclaw.mjs gateway --port 18789 --verbose

​
Stabilt arbetsflöde (macOS‑appen först)

  1. Installera + starta OpenClaw.app (menyraden).
  2. Slutför introduktions-/behörighetschecklistan (TCC‑prompter).
  3. Säkerställ att Gateway är Local och körs (appen hanterar den).
  4. Länka ytor (exempel: WhatsApp):
openclaw channels login
  1. Rimlighetskontroll:
openclaw health
Om introduktionen inte är tillgänglig i din build:
  • Kör openclaw setup, sedan openclaw channels login, och starta därefter Gateway manuellt (openclaw gateway).

​
Bleeding edge‑arbetsflöde (Gateway i en terminal)

Mål: arbeta på TypeScript‑Gateway, få hot reload, behåll macOS‑appens UI anslutet.

​
0. (Valfritt) Kör macOS‑appen från källkod också

Om du även vill ha macOS‑appen på bleeding edge: 
./scripts/restart-mac.sh

​
1. Starta dev‑Gateway

pnpm install
pnpm gateway:watch
gateway:watch kör gateway i watch‑läge och laddar om vid TypeScript‑ändringar.

​
2. Peka macOS‑appen mot din körande Gateway

I OpenClaw.app:
  • Anslutningsläge: Local Appen ansluter till den körande gatewayn på den konfigurerade porten.

​
3. Verifiera

  • Gateway‑status i appen ska visa ”Using existing gateway …”
  • Eller via CLI:
openclaw health

​
Vanliga fallgropar

  • Fel port: Gateway WS har standard ws://127.0.0.1:18789; håll app + CLI på samma port.
  • Var tillstånd lagras:
    • Autentiseringsuppgifter: ~/.openclaw/credentials/
    • Sessioner: ~/.openclaw/agents/<agentId>/sessions/
    • Loggar: /tmp/openclaw/

​
Karta över lagring av autentiseringsuppgifter

Använd detta vid felsökning av autentisering eller när du bestämmer vad som ska säkerhetskopieras:
  • WhatsApp: ~/.openclaw/credentials/whatsapp/<accountId>/creds.json
  • Telegram bot token: konfig/env eller channels.telegram.tokenFile
  • Discord bot token: konfig/env (tokenfil stöds ännu inte)
  • Slack‑tokens: konfig/env (channels.slack.*)
  • Parnings‑tillåtelselistor: ~/.openclaw/credentials/<channel>-allowFrom.json
  • Autentiseringsprofiler för modeller: ~/.openclaw/agents/<agentId>/agent/auth-profiles.json
  • Import av legacy OAuth: ~/.openclaw/credentials/oauth.json Mer detaljer: Security.

​
Uppdatering (utan att förstöra din setup)

  • Behåll ~/.openclaw/workspace och ~/.openclaw/ som ”ditt”; lägg inte personliga prompts/konfig i openclaw‑repot.
  • Uppdatera källkod: git pull + pnpm install (när lockfilen ändras) + fortsätt använda pnpm gateway:watch.

​
Linux (systemd användartjänst)

Linux installerar använder en systemd användare tjänst. Som standard stoppar systemd användare tjänster på utloggning/inaktiv, vilket dödar Gateway. Onboarding försök att aktivera kvardröjande för dig (kan fråga om sudo). Om det fortfarande är borta, köra: 
sudo loginctl enable-linger $USER
För alltid på eller multi-user servrar, överväga ett system tjänst istället för en användartjänst (ingen kvardröjande behövs). Se Gateway runbook för systemd-anteckningarna.

​
Relaterad dokumentation