The Prerequisites section uses #### headings inside <details> blocks, which triggers MD001 (heading increment skip) and MD024 (duplicate heading text). The English README is excluded from the docs quality gate; add markdownlint-disable/enable comments to match. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
38 KiB
🦀 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 onboardi 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
Prenumerationsautentisering (OAuth)
- 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
Installation (rekommenderad)
Körmiljö: Rust stable toolchain. Enda binär, inga körtidsberoenden.
Homebrew (macOS/Linuxbrew)
brew install zeroclaw
Ett-klicks-installation
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.
Snabbstart
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.
Från källkod (utveckling)
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).
Migrera från OpenClaw
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.
Säkerhetsstandarder (DM-åtkomst)
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 doctorför att hitta riskfyllda eller felkonfigurerade DM-policyer.
Autonominivåer:
| Nivå | Beteende |
|---|---|
ReadOnly |
Agenten kan observera men inte agera |
Supervised (standard) |
Agenten agerar med godkännande för medel-/högriskoperationer |
Full |
Agenten agerar autonomt inom policygränser |
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).
📢 Meddelanden
Använd denna tavla för viktiga meddelanden (brytande ändringar, säkerhetsrådgivningar, underhållsfönster och releaseblockerare).
| Datum (UTC) | Nivå | Meddelande | Åtgärd |
|---|---|---|---|
| 2026-02-19 | Kritisk | Vi är inte affilierade med openagen/zeroclaw, zeroclaw.org eller zeroclaw.net. Domänerna zeroclaw.org och zeroclaw.net pekar för närvarande till openagen/zeroclaw-forken, och den domänen/repositoryt utger sig för att vara vår officiella webbplats/projekt. |
Lita inte på information, binärer, insamlingar eller meddelanden från dessa källor. Använd bara detta repository och våra verifierade sociala konton. |
| 2026-02-21 | Viktigt | Vår officiella webbplats är nu live: zeroclawlabs.ai. Tack för ert tålamod medan vi förberedde lanseringen. Vi ser fortfarande imitationsförsök, så gå inte med i några investerings- eller insamlingsaktiviteter som hävdar ZeroClaw-namnet om de inte publicerats via våra officiella kanaler. | Använd detta repository som enda sanningskälla. Följ X (@zeroclawlabs), Facebook (Grupp) och Reddit (r/zeroclawlabs) för officiella uppdateringar. |
| 2026-02-19 | Viktigt | Anthropic uppdaterade villkoren för autentisering och inloggningsanvändning 2026-02-19. Claude Code OAuth-tokens (Free, Pro, Max) är avsedda uteslutande för Claude Code och Claude.ai; att använda OAuth-tokens från Claude Free/Pro/Max i någon annan produkt, verktyg eller tjänst (inklusive Agent SDK) är inte tillåtet och kan bryta mot Consumer Terms of Service. | Undvik tillfälligt Claude Code OAuth-integrationer för att förhindra potentiell förlust. Originalklausul: Authentication and Credential Use. |
Höjdpunkter
- 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.
Varför team väljer ZeroClaw
- 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.
Benchmarkögonblicksbild (ZeroClaw vs OpenClaw, Reproducerbar)
Lokal maskin-snabbtest (macOS arm64, feb 2026) normaliserat för 0.8GHz edge-hårdvara.
| OpenClaw | NanoBot | PicoClaw | ZeroClaw 🦀 | |
|---|---|---|---|---|
| Språk | TypeScript | Python | Go | Rust |
| RAM | > 1GB | > 100MB | < 10MB | < 5MB |
| Uppstart (0.8GHz kärna) | > 500s | > 30s | < 1s | < 10ms |
| Binärstorlek | ~28MB (dist) | N/A (Scripts) | ~8MB | ~8.8 MB |
| Kostnad | Mac Mini $599 | Linux SBC ~$50 | Linux Board $10 | Vilken hårdvara som helst $10 |
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.
Reproducerbar lokal mätning
cargo build --release
ls -lh target/release/zeroclaw
/usr/bin/time -l target/release/zeroclaw --help
/usr/bin/time -l target/release/zeroclaw status
Allt vi byggt hittills
Kärnplattform
- 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
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).
Webbpanel
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
Firmware-mål
| Mål | Plattform | Syfte |
|---|---|---|
| ESP32 | Espressif ESP32 | Trådlös periferienhetagent |
| ESP32-UI | ESP32 + Display | Agent med visuellt gränssnitt |
| STM32 Nucleo | STM32 (ARM Cortex-M) | Industriell periferienhet |
| Arduino | Arduino | Grundläggande sensor-/aktuatorbrygga |
| Uno Q Bridge | Arduino Uno | Seriell brygga till agent |
Verktyg + automatisering
- 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)
Körmiljö + säkerhet
- 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.
Drift + paketering
- 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).
Hur det fungerar (kort)
WhatsApp / Telegram / Slack / Discord / Signal / iMessage / Matrix / IRC / Email
Bluesky / Nostr / Mattermost / DingTalk / Lark / QQ / Reddit / MQTT / WebSocket
│
▼
┌───────────────────────────────┐
│ Gateway │
│ (kontrollplan) │
│ http://127.0.0.1:42617 │
├───────────────────────────────┤
│ Webbpanel (React 19) │
│ REST API + WebSocket + SSE │
│ Parkoppling + Hastighetsbegränsning │
└──────────────┬────────────────┘
│
┌──────────┼──────────┐
│ │ │
▼ ▼ ▼
┌────────┐ ┌────────┐ ┌────────┐
│ Agent │ │ Cron │ │ Hands │
│ Loop │ │Scheduler│ │ Swarm │
└───┬────┘ └───┬────┘ └───┬────┘
│ │ │
└──────────┼──────────┘
│
┌──────────┼──────────┐
│ │ │
▼ ▼ ▼
┌────────┐ ┌────────┐ ┌────────┐
│Provider│ │ Tools │ │ Memory │
│ (LLM) │ │ (70+) │ │(md/sql)│
└────────┘ └────────┘ └────────┘
│ │
▼ ▼
┌────────┐ ┌────────────┐
│Security│ │ Peripherals│
│ Policy │ │(ESP32/STM32)│
└────────┘ └────────────┘
Konfiguration
Minimal ~/.zeroclaw/config.toml:
default_provider = "anthropic"
api_key = "sk-ant-..."
Fullständig konfigurationsreferens: docs/reference/api/config-reference.md.
Kanalkonfiguration
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"
Tunnelkonfiguration
[tunnel]
kind = "cloudflare" # eller "tailscale", "ngrok", "openvpn", "custom", "none"
Detaljer: Kanalreferens · Konfigurationsreferens
Körmiljöstöd (nuvarande)
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.
Prenumerationsautentisering (OpenAI Codex / Claude Code / Gemini)
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"
Agentarbetsyta + färdigheter
Arbetsyterot: ~/.zeroclaw/workspace/ (konfigurerbart via config).
Injicerade promptfiler:
IDENTITY.md— agentpersonlighet och rollUSER.md— användarkontext och preferenserMEMORY.md— långtidsfakta och lärdomarAGENTS.md— sessionskonventioner och initieringsreglerSOUL.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
CLI-kommandon
# 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
Förutsättningar
Windows
Obligatoriskt
-
Visual Studio Build Tools (tillhandahåller MSVC-länkaren och Windows SDK):
winget install Microsoft.VisualStudio.2022.BuildToolsUnder installationen (eller via Visual Studio Installer), välj arbetsbelastningen "Desktop development with C++".
-
Rust toolchain:
winget install Rustlang.RustupEfter installationen, öppna en ny terminal och kör
rustup default stableför att säkerställa att stable-toolchainen är aktiv. -
Verifiera att båda fungerar:
rustc --version cargo --version
Valfritt
- Docker Desktop — krävs bara om du använder Docker sandboxad körmiljö (
runtime.kind = "docker"). Installera viawinget install Docker.DockerDesktop.
Linux / macOS
Obligatoriskt
-
Byggverktyg:
- Linux (Debian/Ubuntu):
sudo apt install build-essential pkg-config - Linux (Fedora/RHEL):
sudo dnf group install development-tools && sudo dnf install pkg-config - macOS: Installera Xcode Command Line Tools:
xcode-select --install
- Linux (Debian/Ubuntu):
-
Rust toolchain:
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | shSe rustup.rs för detaljer.
-
Verifiera att båda fungerar:
rustc --version cargo --version
Enradsinstallerare
Eller hoppa över stegen ovan och installera allt (systemberoenden, Rust, ZeroClaw) med ett enda kommando:
curl -LsSf https://raw.githubusercontent.com/zeroclaw-labs/zeroclaw/master/install.sh | bash
Kompileringsresurskrav
Att bygga från källkod kräver mer resurser än att köra den resulterande binären:
| Resurs | Minimum | Rekommenderat |
|---|---|---|
| RAM + swap | 2 GB | 4 GB+ |
| Ledigt disk | 6 GB | 10 GB+ |
Om din värd ligger under minimum, använd förbyggda binärer:
./install.sh --prefer-prebuilt
För att kräva enbart binärinstallation utan källkods-fallback:
./install.sh --prebuilt-only
Valfritt
- Docker — krävs bara om du använder Docker sandboxad körmiljö (
runtime.kind = "docker"). Installera via din pakethanterare eller docker.com.
Notering: Standard
cargo build --releaseanvändercodegen-units=1för att minska toppkompileringstrycket. För snabbare byggen på kraftfulla maskiner, användcargo build --profile release-fast.
Förbyggda binärer
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
Dokumentation
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.
Referensdokumentation
- 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
Samarbetsdokumentation
- 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
Distribution + drift
- Nätverksdistributionsguide: docs/ops/network-deployment.md
- Proxy-agentplaybook: docs/ops/proxy-agent-playbook.md
- Hårdvaruguider: docs/hardware/README.md
Smooth Crab 🦀
ZeroClaw byggdes för smooth crab 🦀, en snabb och effektiv AI-assistent. Byggd av Argenis De La Rosa och gemenskapen.
Stöd ZeroClaw
Om ZeroClaw hjälper ditt arbete och du vill stödja pågående utveckling kan du donera här:
🙏 Särskilt tack
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. 🦀❤️
Bidra
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>/
⚠️ Officiellt repository & varning för imitation
Detta är det enda officiella ZeroClaw-repositoryt:
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.
Licens
ZeroClaw är dubbellicensierat för maximal öppenhet och bidragsgivarskydd:
| Licens | Användningsfall |
|---|---|
| MIT | Öppen källkod, forskning, akademiskt, personligt bruk |
| Apache 2.0 | Patentskydd, institutionell, kommersiell distribution |
Du kan välja endera licens. Bidragsgivare beviljar automatiskt rättigheter under båda — se CLA.md för det fullständiga bidragsgivaravtalet.
Varumärke
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.
Bidragsgivarskydd
- 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. 🦀
Bidragsgivare
Denna lista genereras från GitHub-bidragsgivargrafen och uppdateras automatiskt.
