🦀 ZeroClaw — Personlig AI-assistent

Noll overhead. Noll kompromiss. 100% Rust. 100% Agnostisk.
⚡️ Körs på $10-hårdvara med <5MB RAM: Det är 99% mindre minne än OpenClaw och 98% billigare än en Mac mini!

Byggt av studenter och medlemmar i Harvard-, MIT- och Sundai.Club-gemenskaperna.

🌐 Språk: 🇺🇸 English · 🇨🇳 简体中文 · 🇯🇵 日本語 · 🇰🇷 한국어 · 🇻🇳 Tiếng Việt · 🇵🇭 Tagalog · 🇪🇸 Español · 🇧🇷 Português · 🇮🇹 Italiano · 🇩🇪 Deutsch · 🇫🇷 Français · 🇸🇦 العربية · 🇮🇳 हिन्दी · 🇷🇺 Русский · 🇧🇩 বাংলা · 🇮🇱 עברית · 🇵🇱 Polski · 🇨🇿 Čeština · 🇳🇱 Nederlands · 🇹🇷 Türkçe · 🇺🇦 Українська · 🇮🇩 Bahasa Indonesia · 🇹🇭 ไทย · 🇵🇰 اردو · 🇷🇴 Română · 🇸🇪 Svenska · 🇬🇷 Ελληνικά · 🇭🇺 Magyar · 🇫🇮 Suomi · 🇩🇰 Dansk · 🇳🇴 Norsk

ZeroClaw är en personlig AI-assistent som du kör på dina egna enheter. Den svarar dig via de kanaler du redan använder (WhatsApp, Telegram, Slack, Discord, Signal, iMessage, Matrix, IRC, Email, Bluesky, Nostr, Mattermost, Nextcloud Talk, DingTalk, Lark, QQ, Reddit, LinkedIn, Twitter, MQTT, WeChat Work med flera). Den har en webbpanel för realtidskontroll och kan ansluta till hårdvaruperiferienheter (ESP32, STM32, Arduino, Raspberry Pi). Gateway är bara kontrollplanet — produkten är assistenten.

Om du vill ha en personlig, enanvändarassistent som känns lokal, snabb och alltid tillgänglig, är det här lösningen.

Webbplats · Dokumentation · Arkitektur · Kom igång · Migrera från OpenClaw · Felsökning · Discord

Rekommenderad konfiguration: kör zeroclaw onboard i din terminal. ZeroClaw Onboard guidar dig steg för steg genom att konfigurera gateway, arbetsyta, kanaler och leverantör. Det är den rekommenderade installationsvägen och fungerar på macOS, Linux och Windows (via WSL2). Ny installation? Börja här: Kom igång

• OpenAI Codex (ChatGPT-prenumeration)
• Gemini (Google OAuth)
• Anthropic (API-nyckel eller autentiseringstoken)

Modellnotering: även om många leverantörer/modeller stöds, använd den starkaste senaste generationens modell som är tillgänglig för dig för bästa upplevelse. Se Onboarding.

Modellkonfiguration + CLI: Leverantörsreferens Autentiseringsprofil-rotation (OAuth vs API-nycklar) + failover: Modell-failover

Körmiljö: Rust stable toolchain. Enda binär, inga körtidsberoenden.

brew install zeroclaw

git clone https://github.com/zeroclaw-labs/zeroclaw.git
cd zeroclaw
./install.sh

zeroclaw onboard körs automatiskt efter installationen för att konfigurera din arbetsyta och leverantör.

Fullständig nybörjarguide (autentisering, parkoppling, kanaler): Kom igång

# Installera + onboard
./install.sh --api-key "sk-..." --provider openrouter

# Starta gateway (webhook-server + webbpanel)
zeroclaw gateway                # standard: 127.0.0.1:42617
zeroclaw gateway --port 0       # slumpmässig port (säkerhetshärdad)

# Prata med assistenten
zeroclaw agent -m "Hello, ZeroClaw!"

# Interaktivt läge
zeroclaw agent

# Starta full autonom körmiljö (gateway + kanaler + cron + hands)
zeroclaw daemon

# Kontrollera status
zeroclaw status

# Kör diagnostik
zeroclaw doctor

Uppgraderar du? Kör zeroclaw doctor efter uppdatering.

git clone https://github.com/zeroclaw-labs/zeroclaw.git
cd zeroclaw

cargo build --release --locked
cargo install --path . --force --locked

zeroclaw onboard

Utvecklar-fallback (ingen global installation): prefixera kommandon med cargo run --release -- (exempel: cargo run --release -- status).

ZeroClaw kan importera din OpenClaw-arbetsyta, minne och konfiguration:

# Förhandsgranska vad som migreras (säkert, skrivskyddat)
zeroclaw migrate openclaw --dry-run

# Kör migreringen
zeroclaw migrate openclaw

Detta migrerar dina minnesposter, arbetsytefiler och konfiguration från ~/.openclaw/ till ~/.zeroclaw/. Konfiguration konverteras automatiskt från JSON till TOML.

ZeroClaw ansluter till riktiga meddelandeytor. Behandla inkommande DM som opålitlig indata.

Fullständig säkerhetsguide: SECURITY.md

Standardbeteende på alla kanaler:

• DM-parkoppling (standard): okända avsändare får en kort parkopplingskod och boten behandlar inte deras meddelande.
• Godkänn med: zeroclaw pairing approve <channel> <code> (sedan läggs avsändaren till i en lokal tillåtlista).
• Offentliga inkommande DM kräver ett explicit opt-in i config.toml.
• Kör zeroclaw doctor för att hitta riskfyllda eller felkonfigurerade DM-policyer.

Autonominivåer:

Sandboxlager: arbetsyteisolering, sökvägstraversblockering, kommandotillåtlistor, förbjudna sökvägar (/etc, /root, ~/.ssh), hastighetsbegränsning (max åtgärder/timme, kostnad/dag-gränser).

Använd denna tavla för viktiga meddelanden (brytande ändringar, säkerhetsrådgivningar, underhållsfönster och releaseblockerare).

• Lean körmiljö som standard — vanliga CLI- och statusarbetsflöden körs i ett fåmegabyte-minnesutrymme på release-byggen.
• Kostnadseffektiv distribution — designad för $10-kort och små molninstanser, inga tunga körtidsberoenden.
• Snabba kallstarter — enkel binär Rust-körmiljö håller kommando- och daemon-uppstart nära ögonblicklig.
• Portabel arkitektur — en binär över ARM, x86 och RISC-V med utbytbara providers/channels/tools.
• Lokal-först Gateway — enda kontrollplan för sessioner, kanaler, verktyg, cron, SOP:er och händelser.
• Multikanalinkorg — WhatsApp, Telegram, Slack, Discord, Signal, iMessage, Matrix, IRC, Email, Bluesky, Nostr, Mattermost, Nextcloud Talk, DingTalk, Lark, QQ, Reddit, LinkedIn, Twitter, MQTT, WeChat Work, WebSocket med flera.
• Multiagentorkestrering (Hands) — autonoma agentsvärmar som körs på schema och blir smartare med tiden.
• Standardoperationsprocedurer (SOPs) — händelsedriven arbetsflödesautomatisering med MQTT, webhook, cron och periferiutlösare.
• Webbpanel — React 19 + Vite webb-UI med realtidschatt, minnesutforskare, konfigurationsredigerare, cron-hanterare och verktygsinspektor.
• Hårdvaruperiferienheter — ESP32, STM32 Nucleo, Arduino, Raspberry Pi GPIO via Peripheral-traiten.
• Förstklassiga verktyg — shell, fil-I/O, webbläsare, git, web fetch/search, MCP, Jira, Notion, Google Workspace och 70+ fler.
• Livscykelkrokar — fånga upp och modifiera LLM-anrop, verktygsexekveringar och meddelanden i varje steg.
• Färdighetsplattform — medföljande, community- och arbetsytefärdigheter med säkerhetsgranskning.
• Tunnelstöd — Cloudflare, Tailscale, ngrok, OpenVPN och anpassade tunnlar för fjärråtkomst.

• Lean som standard: liten Rust-binär, snabb start, lågt minnesavtryck.
• Säker från grunden: parkoppling, strikt sandboxning, explicita tillåtlistor, arbetsyteavgränsning.
• Fullt utbytbar: kärnssystem är traits (providers, channels, tools, memory, tunnels).
• Inget leverantörslås: OpenAI-kompatibelt leverantörsstöd + pluggbara anpassade endpoints.

Lokal maskin-snabbtest (macOS arm64, feb 2026) normaliserat för 0.8GHz edge-hårdvara.

Noteringar: ZeroClaw-resultat mäts på release-byggen med /usr/bin/time -l. OpenClaw kräver Node.js-körmiljö (typiskt ~390MB extra minnesoverhead), medan NanoBot kräver Python-körmiljö. PicoClaw och ZeroClaw är statiska binärer. RAM-siffrorna ovan är körtidsminne; kompileringskrav vid byggtid är högre.

cargo build --release
ls -lh target/release/zeroclaw

/usr/bin/time -l target/release/zeroclaw --help
/usr/bin/time -l target/release/zeroclaw status

• Gateway HTTP/WS/SSE-kontrollplan med sessioner, närvaro, konfiguration, cron, webhooks, webbpanel och parkoppling.
• CLI-yta: gateway, agent, onboard, doctor, status, service, migrate, auth, cron, channel, skills.
• Agentorkestreringsloop med verktygsdistribution, promptkonstruktion, meddelandeklassificering och minnesinläsning.
• Sessionsmodell med säkerhetspolicyefterlevnad, autonominivåer och godkännandeportar.
• Motståndskraftig leverantörswrapper med failover, retry och modellroutning över 20+ LLM-backends.

Kanaler: WhatsApp (nativ), Telegram, Slack, Discord, Signal, iMessage, Matrix, IRC, Email, Bluesky, DingTalk, Lark, Mattermost, Nextcloud Talk, Nostr, QQ, Reddit, LinkedIn, Twitter, MQTT, WeChat Work, WATI, Mochat, Linq, Notion, WebSocket, ClawdTalk.

Funktionsgated: Matrix (channel-matrix), Lark (channel-lark), Nostr (channel-nostr).

React 19 + Vite 6 + Tailwind CSS 4 webbpanel serverad direkt från Gateway:

• Dashboard — systemöversikt, hälsostatus, drifttid, kostnadsspårning
• Agentchatt — interaktiv chatt med agenten
• Minne — bläddra och hantera minnesposter
• Konfiguration — visa och redigera konfiguration
• Cron — hantera schemalagda uppgifter
• Verktyg — bläddra tillgängliga verktyg
• Loggar — visa agentaktivitetsloggar
• Kostnad — tokenanvändning och kostnadsspårning
• Doktor — systemhälsodiagnostik
• Integrationer — integrationsstatus och konfiguration
• Parkoppling — hantering av enhetsparkoppling

• Kärna: shell, filläsning/skrivning/redigering, git-operationer, glob-sökning, innehållssökning
• Webb: webbläsarkontroll, web fetch, webbsökning, skärmdump, bildinformation, PDF-läsning
• Integrationer: Jira, Notion, Google Workspace, Microsoft 365, LinkedIn, Composio, Pushover
• MCP: Model Context Protocol-verktygs-wrapper + uppskjutna verktygsuppsättningar
• Schemaläggning: cron add/remove/update/run, schemaverktyg
• Minne: recall, store, forget, knowledge, project intel
• Avancerat: delegate (agent-till-agent), swarm, modellväxling/routing, säkerhetsoperationer, molnoperationer
• Hårdvara: board info, memory map, memory read (funktionsgated)

• Autonominivåer: ReadOnly, Supervised (standard), Full.
• Sandboxning: arbetsyteisolering, sökvägstraversblockering, kommandotillåtlistor, förbjudna sökvägar, Landlock (Linux), Bubblewrap.
• Hastighetsbegränsning: max åtgärder per timme, max kostnad per dag (konfigurerbart).
• Godkännandeportar: interaktivt godkännande för medel-/högriskoperationer.
• E-stopp: nödavstängningskapacitet.
• 129+ säkerhetstester i automatiserad CI.

• Webbpanel serverad direkt från Gateway.
• Tunnelstöd: Cloudflare, Tailscale, ngrok, OpenVPN, anpassat kommando.
• Docker-körmiljöadapter för containeriserad exekvering.
• CI/CD: beta (automatiskt vid push) → stable (manuell dispatch) → Docker, crates.io, Scoop, AUR, Homebrew, tweet.
• Förbyggda binärer för Linux (x86_64, aarch64, armv7), macOS (x86_64, aarch64), Windows (x86_64).

Minimal ~/.zeroclaw/config.toml:

default_provider = "anthropic"
api_key = "sk-ant-..."

Fullständig konfigurationsreferens: docs/reference/api/config-reference.md.

Telegram:

[channels.telegram]
bot_token = "123456:ABC-DEF..."

Discord:

[channels.discord]
token = "your-bot-token"

Slack:

[channels.slack]
bot_token = "xoxb-..."
app_token = "xapp-..."

WhatsApp:

[channels.whatsapp]
enabled = true

Matrix:

[channels.matrix]
homeserver_url = "https://matrix.org"
username = "@bot:matrix.org"
password = "..."

Signal:

[channels.signal]
phone_number = "+1234567890"

[tunnel]
kind = "cloudflare"  # eller "tailscale", "ngrok", "openvpn", "custom", "none"

Detaljer: Kanalreferens · Konfigurationsreferens

• native (standard) — direkt processexekvering, snabbaste vägen, idealisk för betrodda miljöer.
• docker — full containerisolering, tvingade säkerhetspolicyer, kräver Docker.

Ställ in runtime.kind = "docker" för strikt sandboxning eller nätverksisolering.

ZeroClaw stöder prenumerationsnativa autentiseringsprofiler (multikonto, krypterat i vila).

• Lagringsfil: ~/.zeroclaw/auth-profiles.json
• Krypteringsnyckel: ~/.zeroclaw/.secret_key
• Profil-ID-format: <provider>:<profile_name> (exempel: openai-codex:work)

# OpenAI Codex OAuth (ChatGPT-prenumeration)
zeroclaw auth login --provider openai-codex --device-code

# Gemini OAuth
zeroclaw auth login --provider gemini --profile default

# Anthropic setup-token
zeroclaw auth paste-token --provider anthropic --profile default --auth-kind authorization

# Kontrollera / uppdatera / byt profil
zeroclaw auth status
zeroclaw auth refresh --provider openai-codex --profile default
zeroclaw auth use --provider openai-codex --profile work

# Kör agenten med prenumerationsautentisering
zeroclaw agent --provider openai-codex -m "hello"
zeroclaw agent --provider anthropic -m "hello"

Arbetsyterot: ~/.zeroclaw/workspace/ (konfigurerbart via config).

Injicerade promptfiler:

• IDENTITY.md — agentpersonlighet och roll
• USER.md — användarkontext och preferenser
• MEMORY.md — långtidsfakta och lärdomar
• AGENTS.md — sessionskonventioner och initieringsregler
• SOUL.md — kärnidentitet och operationsprinciper

Färdigheter: ~/.zeroclaw/workspace/skills/<skill>/SKILL.md eller SKILL.toml.

# Lista installerade färdigheter
zeroclaw skills list

# Installera från git
zeroclaw skills install https://github.com/user/my-skill.git

# Säkerhetsgranskning före installation
zeroclaw skills audit https://github.com/user/my-skill.git

# Ta bort en färdighet
zeroclaw skills remove my-skill

# Arbetsytehantering
zeroclaw onboard              # Guidad installationsguide
zeroclaw status               # Visa daemon-/agentstatus
zeroclaw doctor               # Kör systemdiagnostik

# Gateway + daemon
zeroclaw gateway              # Starta gateway-server (127.0.0.1:42617)
zeroclaw daemon               # Starta full autonom körmiljö

# Agent
zeroclaw agent                # Interaktivt chattläge
zeroclaw agent -m "message"   # Enstaka meddelandeläge

# Tjänstehantering
zeroclaw service install      # Installera som OS-tjänst (launchd/systemd)
zeroclaw service start|stop|restart|status

# Kanaler
zeroclaw channel list         # Lista konfigurerade kanaler
zeroclaw channel doctor       # Kontrollera kanalhälsa
zeroclaw channel bind-telegram 123456789

# Cron + schemaläggning
zeroclaw cron list            # Lista schemalagda jobb
zeroclaw cron add "*/5 * * * *" --prompt "Check system health"
zeroclaw cron remove <id>

# Minne
zeroclaw memory list          # Lista minnesposter
zeroclaw memory get <key>     # Hämta ett minne
zeroclaw memory stats         # Minnesstatistik

# Autentiseringsprofiler
zeroclaw auth login --provider <name>
zeroclaw auth status
zeroclaw auth use --provider <name> --profile <profile>

# Hårdvaruperiferienheter
zeroclaw hardware discover    # Sök efter anslutna enheter
zeroclaw peripheral list      # Lista anslutna periferienheter
zeroclaw peripheral flash     # Flasha firmware till enhet

# Migrering
zeroclaw migrate openclaw --dry-run
zeroclaw migrate openclaw

# Shell-kompletteringar
source <(zeroclaw completions bash)
zeroclaw completions zsh > ~/.zfunc/_zeroclaw

Fullständig kommandoreferens: docs/reference/cli/commands-reference.md

curl -LsSf https://raw.githubusercontent.com/zeroclaw-labs/zeroclaw/master/install.sh | bash

./install.sh --prefer-prebuilt

./install.sh --prebuilt-only

Release-tillgångar publiceras för:

• Linux: x86_64, aarch64, armv7
• macOS: x86_64, aarch64
• Windows: x86_64

Ladda ner de senaste tillgångarna från: https://github.com/zeroclaw-labs/zeroclaw/releases/latest

Använd dessa när du är förbi onboarding-flödet och vill ha den djupare referensen.

• Börja med dokumentationsindexet för navigering och "vad finns var."
• Läs arkitekturöversikten för den fullständiga systemmodellen.
• Använd konfigurationsreferensen när du behöver varje nyckel och exempel.
• Kör Gateway enligt boken med operationsrunbook.
• Följ ZeroClaw Onboard för en guidad installation.
• Felsök vanliga problem med felsökningsguiden.
• Granska säkerhetsvägledning innan du exponerar något.

• Dokumentationshubb: docs/README.md
• Enhetlig dokumentations-TOC: docs/SUMMARY.md
• Kommandoreferens: docs/reference/cli/commands-reference.md
• Konfigurationsreferens: docs/reference/api/config-reference.md
• Leverantörsreferens: docs/reference/api/providers-reference.md
• Kanalreferens: docs/reference/api/channels-reference.md
• Operationsrunbook: docs/ops/operations-runbook.md
• Felsökning: docs/ops/troubleshooting.md

• Bidragsguide: CONTRIBUTING.md
• PR-arbetsflödespolicy: docs/contributing/pr-workflow.md
• CI-arbetsflödesguide: docs/contributing/ci-map.md
• Granskningsplaybook: docs/contributing/reviewer-playbook.md
• Säkerhetsutlämnandepolicy: SECURITY.md
• Dokumentationsmall: docs/contributing/doc-template.md

• Nätverksdistributionsguide: docs/ops/network-deployment.md
• Proxy-agentplaybook: docs/ops/proxy-agent-playbook.md
• Hårdvaruguider: docs/hardware/README.md

ZeroClaw byggdes för smooth crab 🦀, en snabb och effektiv AI-assistent. Byggd av Argenis De La Rosa och gemenskapen.

• zeroclawlabs.ai
• @zeroclawlabs

Om ZeroClaw hjälper ditt arbete och du vill stödja pågående utveckling kan du donera här:

Ett hjärtligt tack till de gemenskaper och institutioner som inspirerar och driver detta open source-arbete:

• Harvard University — för att främja intellektuell nyfikenhet och tänja gränserna för vad som är möjligt.
• MIT — för att försvara öppen kunskap, öppen källkod och tron att teknologi bör vara tillgänglig för alla.
• Sundai Club — för gemenskapen, energin och den outtröttliga driften att bygga saker som spelar roll.
• Världen & bortom 🌍✨ — till varje bidragsgivare, drömmare och byggare där ute som gör öppen källkod till en kraft för gott. Det här är för er.

Vi bygger öppet eftersom de bästa idéerna kommer från överallt. Om du läser detta är du en del av det. Välkommen. 🦀❤️

Ny till ZeroClaw? Leta efter ärenden märkta good first issue — se vår Bidragsguide för hur du kommer igång. AI/vibe-kodade PR:er är välkomna! 🤖

Se CONTRIBUTING.md och CLA.md. Implementera en trait, skicka in en PR:

• CI-arbetsflödesguide: docs/contributing/ci-map.md
• Ny Provider → src/providers/
• Ny Channel → src/channels/
• Ny Observer → src/observability/
• Nytt Tool → src/tools/
• Nytt Memory → src/memory/
• Ny Tunnel → src/tunnel/
• Ny Peripheral → src/peripherals/
• Ny Skill → ~/.zeroclaw/workspace/skills/<name>/

Detta är det enda officiella ZeroClaw-repositoryt:

https://github.com/zeroclaw-labs/zeroclaw

Alla andra repositorier, organisationer, domäner eller paket som hävdar att vara "ZeroClaw" eller antyder anslutning till ZeroClaw Labs är obehöriga och inte affilierade med detta projekt. Kända obehöriga forkar listas i TRADEMARK.md.

Om du stöter på imitation eller varumärkesmissbruk, vänligen öppna ett ärende.

ZeroClaw är dubbellicensierat för maximal öppenhet och bidragsgivarskydd:

Du kan välja endera licens. Bidragsgivare beviljar automatiskt rättigheter under båda — se CLA.md för det fullständiga bidragsgivaravtalet.

ZeroClaw-namnet och logotypen är varumärken som tillhör ZeroClaw Labs. Denna licens beviljar inte tillstånd att använda dem för att antyda stöd eller anslutning. Se TRADEMARK.md för tillåtna och förbjudna användningar.

• Du behåller upphovsrätten till dina bidrag
• Patentbeviljande (Apache 2.0) skyddar dig från patentkrav från andra bidragsgivare
• Dina bidrag är permanent tillskrivna i commit-historik och NOTICE
• Inga varumärkesrättigheter överförs genom att bidra

ZeroClaw — Noll overhead. Noll kompromiss. Distribuera var som helst. Byt ut vad som helst. 🦀

Denna lista genereras från GitHub-bidragsgivargrafen och uppdateras automatiskt.