[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-74622":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":14,"openIssues":15,"contributorsCount":16,"subscribersCount":16,"size":16,"stars1d":17,"stars7d":18,"stars30d":19,"stars90d":16,"forks30d":16,"starsTrendScore":20,"compositeScore":21,"rankGlobal":10,"rankLanguage":10,"license":22,"archived":23,"fork":23,"defaultBranch":24,"hasWiki":23,"hasPages":23,"topics":25,"createdAt":10,"pushedAt":10,"updatedAt":28,"readmeContent":29,"aiSummary":30,"trendingCount":16,"starSnapshotCount":16,"syncStatus":31,"lastSyncTime":32,"discoverSource":33},74622,"HiClaw","agentscope-ai\u002FHiClaw","agentscope-ai","An open-source Collaborative Multi-Agent OS for transparent, human-in-the-loop task coordination via Matrix rooms.","https:\u002F\u002Fhiclaw.io",null,"Go",4772,573,28,230,0,22,62,257,66,30.28,"Apache License 2.0",false,"main",[26,27],"agent-teams","openclaw","2026-06-12 02:03:26","\u003Ch1 align=\"center\">\n    \u003Cimg src=\"https:\u002F\u002Fimg.alicdn.com\u002Fimgextra\u002Fi2\u002FO1CN01hTYQMO28B3H9qP7RV_!!6000000007893-2-tps-1490-392.png\" alt=\"HiClaw\"  width=\"290\" height=\"72.5\">\n  \u003Cbr>\n\u003C\u002Fh1>\n\n[English](.\u002FREADME.md) | [中文](.\u002FREADME.zh-CN.md) | [日本語](.\u002FREADME.ja-JP.md)\n\n\u003Cp align=\"center\">\n  \u003Ca href=\"https:\u002F\u002Fdeepwiki.com\u002Fhigress-group\u002Fhiclaw\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FDeepWiki-Ask_AI-navy.svg?logo=data:image\u002Fpng;base64,iVBORw0KGgoAAAANSUhEUgAAACwAAAAyCAYAAAAnWDnqAAAAAXNSR0IArs4c6QAAA05JREFUaEPtmUtyEzEQhtWTQyQLHNak2AB7ZnyXZMEjXMGeK\u002FAIi+QuHrMnbChYY7MIh8g01fJoopFb0uhhEqqcbWTp06\u002Fuv1saEDv4O3n3dV60RfP947Mm9\u002FSQc0ICFQgzfc4CYZoTPAswgSJCCUJUnAAoRHOAUOcATwbmVLWdGoH\u002F\u002FPB8mnKqScAhsD0kYP3j\u002FYt5LPQe2KvcXmGvRHcDnpxfL2zOYJ1mFwrryWTz0advv1Ut4CJgf5uhDuDj5eUcAUoahrdY\u002F56ebRWeraTjMt\u002F00Sh3UDtjgHtQNHwcRGOC98BJEAEymycmYcWwOprTgcB6VZ5JK5TAJ+fXGLBm3FDAmn6oPPjR4rKCAoJCal2eAiQp2x0vxTPB3ALO2CRkwmDy5WohzBDwSEFKRwPbknEggCPB\u002FimwrycgxX2NzoMCHhPkDwqYMr9tRcP5qNrMZHkVnOjRMWwLCcr8ohBVb1OMjxLwGCvjTikrsBOiA6fNyCrm8V1rP93iVPpwaE+gO0SsWmPiXB+jikdf6SizrT5qKasx5j8ABbHpFTx+vFXp9EnYQmLx02h1QTTrl6eDqxLnGjporxl3NL3agEvXdT0WmEost648sQOYAeJS9Q7bfUVoMGnjo4AZdUMQku50McDcMWcBPvr0SzbTAFDfvJqwLzgxwATnCgnp4wDl6Aa+Ax283gghmj+vj7feE2KBBRMW3FzOpLOADl0Isb5587h\u002FU4gGvkt5v60Z1VLG8BhYjbzRwyQZemwAd6cCR5\u002FXFWLYZRIMpX39AR0tjaGGiGzLVyhse5C9RKC6ai42ppWPKiBagOvaYk8lO7DajerabOZP46Lby5wKjw1HCRx7p9sVMOWGzb\u002FvA1hwiWc6jm3MvQDTogQkiqIhJV0nBQBTU+3okKCFDy9WwferkHjtxib7t3xIUQtHxnIwtx4mpg26\u002FHfwVNVDb4oI9RHmx5WGelRVlrtiw43zboCLaxv46AZeB3IlTkwouebTr1y2NjSpHz68WNFjHvupy3q8TFn3Hos2IAk4Ju5dCo8B3wP7VPr\u002FFGaKiG+T+v+TQqIrOqMTL1VdWV1DdmcbO8KXBz6esmYWYKPwDL5b5FA1a0hwapHiom0r\u002FcKaoqr+27\u002FXcrS5UwSMbQAAAABJRU5ErkJggg==\" alt=\"DeepWiki\">\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fdiscord.com\u002Finvite\u002FNVjNA4BAVw\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FDiscord-Join_Us-blueviolet.svg?logo=discord\" alt=\"Discord\">\u003C\u002Fa>\n\u003C\u002Fp>\n\n**HiClaw is an open-source collaborative multi-agent runtime platform. It enables multiple Agents to collaborate in a controlled and auditable room, with full human visibility and intervention capabilities throughout the process..**\n\nBuilt on a **Manager-Workers architecture**, HiClaw features a Manager that centrally orchestrates multiple Workers, focusing on collaboration scenarios between humans and Agents, as well as among Agents within enterprise environments.\n\nHiClaw does not compete with other xxClaw projects. Instead of implementing Agent logic itself, it orchestrates and manages multiple Agent containers (including the Manager and numerous Workers).\n\n## Key Features\n\n- 🧬 **Manager-Workers Architecture**: Eliminates the need for human oversight of individual Worker Claws by enabling Agents to manage other Agents.\n\n- 🤝 **Multi-Runtime Collaboration**: OpenClaw, QwenPaw, and Hermes Workers coexist in the same IM room. Use deterministic agents (OpenClaw\u002FQwenPaw) as Leaders to orchestrate tasks, and Hermes Workers for autonomous code execution — each runtime does what it's best at.\n\n- 📦 **MinIO Shared File System**: Introduces a shared file system for inter-Agent information exchange, significantly reducing token consumption in multi-Agent collaboration scenarios.\n\n- 🔐 **Higress AI Gateway**: Centralizes traffic management and mitigates credential-related risks, alleviating user concerns about security vulnerabilities in the native Lobster framework.\n\n- ☎️ **Element IM Client + Tuwunel IM Server (both Matrix protocol-based)**: Eliminating DingTalk\u002FLark integration overhead and enterprise approval workflows. Enables rapid user onboarding to experience the \"delight\" of model services within an IM environment, while maintaining compatibility with native OpenClaw IM integration.\n\n## News\n\n- **2026-04-24**: [English](blog\u002Fhiclaw-1.1.0-release.md) | [中文](blog\u002Fzh-cn\u002Fhiclaw-1.1.0-release.md) — HiClaw v1.1.0: Kubernetes-native control plane, Hermes autonomous coding agent runtime, 1.7 GB image shrink, hiclaw CLI replaces shell scripts.\n- **2026-04-14**: [English](blog\u002Fhiclaw-k8s-native-multi-agent-collaboration.md) | [中文](blog\u002Fzh-cn\u002Fhiclaw-k8s-native-multi-agent-collaboration.zh-CN.md) — Deep dive: HiClaw as a Kubernetes-native multi-agent collaboration orchestration system.\n- **2026-04-03**: [English](docs\u002Fdeclarative-resource-management.md) | [中文](docs\u002Fzh-cn\u002Fdeclarative-resource-management.md) — HiClaw 1.0.9: Kubernetes-style declarative resource management (YAML for Worker, Team, Human); Worker Template Marketplace; Manager QwenPaw runtime; Nacos Skills Registry and more.\n- **2026-03-14**: [English](blog\u002Fhiclaw-1.0.6-release.md) | [中文](blog\u002Fzh-cn\u002Fhiclaw-1.0.6-release.md) — HiClaw 1.0.6: enterprise-grade MCP Server management, zero credential exposure.\n- **2026-03-10**: [English](blog\u002Fhiclaw-1.0.4-release.md) | [中文](blog\u002Fzh-cn\u002Fhiclaw-1.0.4-release.md) — HiClaw 1.0.4: QwenPaw (formerly CoPaw) Worker support, 80% less memory.\n- **2026-03-04**: [English](blog\u002Fhiclaw-announcement.md) | [中文](blog\u002Fzh-cn\u002Fhiclaw-announcement.md) — HiClaw open sourced.\n\n## Why HiClaw\n\n- **Enterprise-Grade Security**: Worker Agents operate with consumer tokens only. Real credentials (API keys, GitHub PATs) stay in the gateway — Workers can't see them, and neither can attackers.\n\n- **Fully Private**: Matrix is a decentralized, open protocol. Host it yourself, federate with others if you want. No vendor lock-in, no data harvesting.\n\n- **Human-in-the-Loop by Default**: Every Matrix room includes you, the Manager, and the relevant Workers. Watch everything. Jump in anytime. No black boxes.\n\n- **Zero Configuration IM**: Built-in Matrix server means no bot applications, no API approvals, no waiting. Just open Element Web and start chatting.\n\n- **One Command Setup**: `curl | bash` and you're done — AI gateway, Matrix server, file storage, web client, and Manager Agent.\n\n- **Skills Ecosystem**: Workers pull from [skills.sh](https:\u002F\u002Fskills.sh) (80,000+ community skills) on demand. Safe because Workers can't access real credentials.\n\n## Quick Start\n\n**Prerequisites**: Docker Desktop (Windows\u002FmacOS) or Docker Engine (Linux).\n\n**Resources**: 2 CPU cores + 4 GB RAM minimum. For multiple Workers, 4 cores + 8 GB recommended.\n\n### Install\n\n**macOS \u002F Linux:**\n```bash\nbash \u003C(curl -sSL https:\u002F\u002Fhigress.ai\u002Fhiclaw\u002Finstall.sh)\n```\n\n**Windows (PowerShell 7+ recommended):**\n```powershell\nSet-ExecutionPolicy Bypass -Scope Process -Force; $wc=New-Object Net.WebClient; $wc.Encoding=[Text.Encoding]::UTF8; iex $wc.DownloadString('https:\u002F\u002Fhigress.ai\u002Fhiclaw\u002Finstall.ps1')\n```\n\nThe installer walks you through:\n1. Choose your LLM provider (OpenAI-compatible APIs supported)\n2. Enter your API key\n3. Select network mode (local-only or external access)\n4. Wait for setup to complete\n\n### Access\n\nOpen http:\u002F\u002F127.0.0.1:18088 in your browser and log in to Element Web. The Manager will greet you and explain how to create your first Worker.\n\n**Mobile**: Use any Matrix client (Element, FluffyChat) and connect to your server address.\n\n**That's it.** No bot applications. No external services. Your AI team runs entirely on your machine.\n\n## Upgrade\n\n```bash\n# Upgrade to latest (preserves all data)\nbash \u003C(curl -sSL https:\u002F\u002Fhigress.ai\u002Fhiclaw\u002Finstall.sh)\n\n# Upgrade to specific version\nHICLAW_VERSION=v1.0.5 bash \u003C(curl -sSL https:\u002F\u002Fhigress.ai\u002Fhiclaw\u002Finstall.sh)\n```\n\n## Uninstall\n\n**macOS \u002F Linux:**\n```bash\nbash \u003C(curl -fsSL https:\u002F\u002Fraw.githubusercontent.com\u002Fhigress-group\u002Fhiclaw\u002Fmain\u002Finstall\u002Fhiclaw-install.sh) uninstall\n```\n\n**Windows (PowerShell):**\n```powershell\nSet-ExecutionPolicy Bypass -Scope Process -Force; $wc=New-Object Net.WebClient; $wc.Encoding=[Text.Encoding]::UTF8; $s=$wc.DownloadString('https:\u002F\u002Fraw.githubusercontent.com\u002Fhigress-group\u002Fhiclaw\u002Fmain\u002Finstall\u002Fhiclaw-install.ps1'); & ([scriptblock]::Create($s)) uninstall\n```\n\nThis removes all HiClaw containers (Manager, Workers, docker-proxy), Docker volume, network, env file, workspace directory, and install log.\n\n## Install on Kubernetes (Helm)\n\nFor shared \u002F production deployments you can install HiClaw on any Kubernetes cluster via the official Helm chart. The default profile bundles the Higress AI gateway, Tuwunel (Matrix), MinIO and the HiClaw controller — no external dependencies required.\n\n**Prerequisites**\n\n- Kubernetes 1.24+ (kind \u002F minikube \u002F k3s \u002F managed K8s — all work)\n- Helm 3.7+\n- A default StorageClass (for the Tuwunel + MinIO PVCs)\n\n**Install (OpenAI \u002F OpenAI-compatible)**\n\n```bash\nhelm repo add higress.io https:\u002F\u002Fhigress.io\u002Fhelm-charts\nhelm repo update\n\nhelm install hiclaw higress.io\u002Fhiclaw \\\n  -n hiclaw-system --create-namespace \\\n  --render-subchart-notes \\\n  --set credentials.llmApiKey=\u003Cyour-api-key> \\\n  --set credentials.adminPassword=\u003Cyour-admin-password> \\\n  --set gateway.publicURL=http:\u002F\u002Flocalhost:18080\n```\n\nFor non-OpenAI providers that expose an OpenAI-compatible API, also set `llmBaseUrl`:\n\n```bash\nhelm install hiclaw higress.io\u002Fhiclaw \\\n  -n hiclaw-system --create-namespace \\\n  --render-subchart-notes \\\n  --set credentials.llmApiKey=\u003Cyour-api-key> \\\n  --set credentials.llmBaseUrl=https:\u002F\u002Fyour-provider.example.com\u002Fv1 \\\n  --set credentials.defaultModel=your-model-name \\\n  --set credentials.adminPassword=\u003Cyour-admin-password> \\\n  --set gateway.publicURL=http:\u002F\u002Flocalhost:18080\n```\n\n\u003Cdetails>\n\u003Csummary>Using Qwen (通义千问) instead\u003C\u002Fsummary>\n\n```bash\nhelm install hiclaw higress.io\u002Fhiclaw \\\n  -n hiclaw-system --create-namespace \\\n  --render-subchart-notes \\\n  --set credentials.llmApiKey=\u003Cyour-qwen-api-key> \\\n  --set credentials.llmProvider=qwen \\\n  --set credentials.defaultModel=qwen3.5-plus \\\n  --set credentials.adminPassword=\u003Cyour-admin-password> \\\n  --set gateway.publicURL=http:\u002F\u002Flocalhost:18080\n```\n\n\u003C\u002Fdetails>\n\n| Value | Required | Description |\n|---|---|---|\n| `credentials.llmApiKey` | yes | API key for your LLM provider |\n| `gateway.publicURL` | yes | Public URL where users will reach Element Web (e.g. `http:\u002F\u002Flocalhost:18080` for port-forward, or `https:\u002F\u002Fhiclaw.example.com` for an Ingress) |\n| `credentials.adminPassword` | recommended | Matrix admin password; auto-generated if left empty (you'll have to read it back from the Secret) |\n| `credentials.llmProvider` | no | LLM provider name, defaults to `openai-compat` |\n| `credentials.defaultModel` | no | Default model, defaults to `gpt-5.4` |\n| `credentials.llmBaseUrl` | no | OpenAI-compatible base URL (e.g. `https:\u002F\u002Fapi.deepseek.com\u002Fv1`). Leave empty for official OpenAI API |\n| `manager.runtime` | no | Manager agent runtime: `openclaw` (default), `copaw`, or `hermes` |\n| `worker.defaultRuntime` | no | Default Worker runtime: `openclaw` (default), `copaw`, or `hermes` |\n\n\u003Cdetails>\n\u003Csummary>Using alternative runtimes (QwenPaw Manager + Hermes Workers)\u003C\u002Fsummary>\n\n```bash\nhelm install hiclaw higress.io\u002Fhiclaw \\\n  -n hiclaw-system --create-namespace --devel \\\n  --set manager.runtime=copaw \\\n  --set worker.defaultRuntime=hermes \\\n  --set credentials.llmApiKey=\u003Cyour-api-key> \\\n  --set credentials.llmBaseUrl=https:\u002F\u002Fyour-provider.example.com\u002Fv1 \\\n  --set credentials.defaultModel=your-model-name \\\n  --set credentials.adminPassword=\u003Cyour-admin-password> \\\n  --set gateway.publicURL=http:\u002F\u002Flocalhost:18080\n```\n\nThe image for each component is automatically selected based on the runtime (`hiclaw-manager` \u002F `hiclaw-manager-copaw` for Manager; `hiclaw-worker` \u002F `hiclaw-copaw-worker` \u002F `hiclaw-hermes-worker` for Workers).\n\n\u003C\u002Fdetails>\n\n**Multi-Region Image Registry**\n\nThe default `global.imageRegistry` points to the China region (`higress-registry.cn-hangzhou.cr.aliyuncs.com\u002Fhigress`). If you are deploying outside China, override it for faster image pulls:\n\n| Region | Registry |\n|---|---|\n| China (default) | `higress-registry.cn-hangzhou.cr.aliyuncs.com\u002Fhigress` |\n| North America | `higress-registry.us-west-1.cr.aliyuncs.com\u002Fhigress` |\n| Southeast Asia | `higress-registry.ap-southeast-7.cr.aliyuncs.com\u002Fhigress` |\n\n```bash\n# Example: deploy from the North America registry\nhelm install hiclaw higress.io\u002Fhiclaw \\\n  -n hiclaw-system --create-namespace \\\n  --render-subchart-notes \\\n  --set global.imageRegistry=higress-registry.us-west-1.cr.aliyuncs.com\u002Fhigress \\\n  --set credentials.llmApiKey=\u003Cyour-api-key> \\\n  --set credentials.adminPassword=\u003Cyour-admin-password> \\\n  --set gateway.publicURL=http:\u002F\u002Flocalhost:18080\n```\n\nFor all configurable values (gateway\u002Fstorage providers, image tags, resources, persistence, etc.) see [`helm\u002Fhiclaw\u002Fvalues.yaml`](helm\u002Fhiclaw\u002Fvalues.yaml).\n\n**Access**\n\n```bash\nkubectl port-forward -n hiclaw-system svc\u002Fhigress-gateway 18080:80\n```\n\nThen open http:\u002F\u002Flocalhost:18080 in your browser and log in to Element Web. For an actual cluster, configure an Ingress \u002F LoadBalancer \u002F DNS record pointing at `svc\u002Fhigress-gateway` and set `gateway.publicURL` accordingly.\n\n**Upgrade**\n\n```bash\nhelm repo update\nhelm upgrade hiclaw higress.io\u002Fhiclaw -n hiclaw-system --reuse-values\n```\n\n**Uninstall**\n\n```bash\nhelm uninstall hiclaw -n hiclaw-system\nkubectl delete namespace hiclaw-system\n```\n\nFor the Kubernetes-native architecture (CRDs, controller, declarative `Worker` \u002F `Team` \u002F `Human` resources), see [docs\u002Fk8s-native-agent-orch.md](docs\u002Fk8s-native-agent-orch.md).\n\n## How It Works\n\n### Manager as Your AI Chief of Staff\n\n```\nYou: Create a Worker named alice for frontend development\n\nManager: Done. Worker alice is ready.\n         Room: Worker: Alice\n         Tell alice what to build.\n\nYou: @alice implement a login page with React\n\nAlice: On it... [a few minutes later]\n       Done. PR submitted: https:\u002F\u002Fgithub.com\u002Fxxx\u002Fpull\u002F1\n```\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"https:\u002F\u002Fimg.alicdn.com\u002Fimgextra\u002Fi4\u002FO1CN01wHWaJQ29KV3j5vryD_!!6000000008049-0-tps-589-1280.jpg\" width=\"240\" \u002F>\n      \n  \u003Cimg src=\"https:\u002F\u002Fimg.alicdn.com\u002Fimgextra\u002Fi2\u002FO1CN01q9L67J245mFT0fPXH_!!6000000007340-0-tps-589-1280.jpg\" width=\"240\" \u002F>\n\u003C\u002Fp>\n\u003Cp align=\"center\">\n  \u003Csub>① Manager creates a Worker and assigns tasks\u003C\u002Fsub>\n                    \n  \u003Csub>② You can also direct Workers directly in the room\u003C\u002Fsub>\n\u003C\u002Fp>\n\n### Security Model\n\n```\nWorker (consumer token only)\n    → Higress AI Gateway (holds real API keys, GitHub PAT)\n        → LLM API \u002F GitHub API \u002F MCP Servers\n```\n\nWorkers see only their consumer token. The gateway handles all real credentials. The Manager knows what Workers are doing but never touches the actual keys.\n\n### Human in the Loop\n\nEvery Matrix Room includes you, the Manager, and relevant Workers:\n\n```\nYou: @bob wait, change the password rule to minimum 8 chars\nBob: Got it, updated.\nAlice: Frontend validation updated too.\n```\n\nNo hidden agent-to-agent calls. Everything is visible and intervenable.\n\n## Multi-Runtime Collaboration\n\nHiClaw supports three Worker runtimes that can **coexist in the same IM room**, collaborating on tasks together:\n\n- **OpenClaw** (Node.js) — General-purpose agent with rich skills ecosystem, ideal for task orchestration and tool calling\n- **QwenPaw** (Python) — Lightweight runtime, suited for browser automation and quick tasks\n- **Hermes** ([hermes-agent](https:\u002F\u002Fgithub.com\u002FNousResearch\u002Fhermes-agent)) — Autonomous coding agent with terminal sandbox, self-improving skills, and persistent memory\n\nEach runtime excels at different tasks. A common pattern: use deterministic agents (OpenClaw\u002FQwenPaw) as Leaders to decompose and assign work, and Hermes Workers for autonomous code execution. All runtimes communicate via Matrix `m.mentions` in the same room — fully visible, fully intervenable.\n\n```bash\n# Switch any worker's runtime in place\nhiclaw update worker --runtime hermes\n```\n\n## Architecture\n\n```\n┌───────────────────────────────────────────────┐\n│            hiclaw-controller                  │\n│  Higress │ Tuwunel │ MinIO │ Element Web      │\n└──────────────────┬────────────────────────────┘\n                   │ Matrix + HTTP Files\n┌──────────────────┴──────────┐\n│     hiclaw-manager-agent     │\n│     Manager (OpenClaw\u002F       │\n│       QwenPaw)               │\n└──────────────────┬──────────┘\n                   │\n┌──────────────────┼────────────────────────────┐\n│                  │                            │\n▼                  ▼                            ▼\nWorker Alice    Worker Bob              Worker Charlie\n(OpenClaw)      (QwenPaw)               (Hermes)\n```\n\n| Component | Role |\n|-----------|------|\n| hiclaw-controller | Kubernetes-native control plane, reconciles Worker\u002FTeam\u002FManager CRs |\n| Higress AI Gateway | LLM proxy, MCP Server hosting, credential management |\n| Tuwunel (Matrix) | Self-hosted IM server for all Agent + Human communication |\n| Element Web | Browser client, zero setup |\n| MinIO | Centralized file storage, Workers are stateless |\n\n## HiClaw vs OpenClaw Native\n\n| | OpenClaw Native | HiClaw |\n|---|---|---|\n| Deployment | Single process | Distributed containers |\n| Agent creation | Manual config + restart | Conversational |\n| Credentials | Each agent holds real keys | Workers only hold consumer tokens |\n| Human visibility | Optional | Built-in (Matrix Rooms) |\n| Mobile access | Depends on channel setup | Any Matrix client, zero config |\n| Monitoring | None | Manager heartbeat, visible in Room |\n\n## Documentation\n\n| | |\n|---|---|\n| [docs\u002Fquickstart.md](docs\u002Fquickstart.md) | Step-by-step guide |\n| [docs\u002Farchitecture.md](docs\u002Farchitecture.md) | System architecture deep dive |\n| [docs\u002Fmanager-guide.md](docs\u002Fmanager-guide.md) | Manager configuration |\n| [docs\u002Fworker-guide.md](docs\u002Fworker-guide.md) | Worker deployment |\n| [docs\u002Fdevelopment.md](docs\u002Fdevelopment.md) | Contributing and local dev |\n\n## Troubleshooting\n\n```bash\ndocker exec -it hiclaw-manager cat \u002Fvar\u002Flog\u002Fhiclaw\u002Fmanager-agent.log\n```\n\nSee [docs\u002Fzh-cn\u002Ffaq.md](docs\u002Fzh-cn\u002Ffaq.md) for common issues.\n\n### Reporting Bugs\n\nExport your Matrix message logs and let an AI tool analyze them against the codebase before filing an issue — this helps us fix bugs much faster.\n\n```bash\n# Export debug logs (Matrix messages + agent sessions, PII auto-redacted)\npython scripts\u002Fexport-debug-log.py --range 1h\n```\n\nThen open the HiClaw repo in Cursor, Claude Code, or similar AI tool and ask:\n\n> \"Read the JSONL files in debug-log\u002F. Analyze the Matrix message logs and agent session logs together. Cross-reference with the HiClaw codebase to identify the root cause of [describe your bug].\"\n\nInclude the AI's analysis in your [bug report](https:\u002F\u002Fgithub.com\u002Falibaba\u002Fhiclaw\u002Fissues\u002Fnew?template=bug_report.yml).\n\nYou can also let the AI tool submit the issue or PR directly. Install [GitHub CLI](https:\u002F\u002Fcli.github.com\u002F), run `gh auth login` to authenticate in your browser, then add the [OpenClaw GitHub skill](https:\u002F\u002Fgithub.com\u002Fopenclaw\u002Fopenclaw\u002Fblob\u002Fmain\u002Fskills\u002Fgithub\u002FSKILL.md) to your AI coding tool (Cursor, Claude Code, etc.). After that, just ask it to file the issue or open a PR based on its analysis.\n\n## Build & Test\n\n```bash\nmake build          # Build all images\nmake test           # Build + run all integration tests\nmake test-quick     # Smoke test only\n```\n\n## Other Commands\n\n```bash\nmake replay TASK=\"Create a Worker named alice for frontend development\"\nmake uninstall\nmake help\n```\n\n## Community\n\n- [Discord](https:\u002F\u002Fdiscord.gg\u002FNVjNA4BAVw)\n- [GitHub Issues](https:\u002F\u002Fgithub.com\u002Falibaba\u002Fhiclaw\u002Fissues)\n\n## License\n\nApache License 2.0\n","HiClaw 是一个开源的多代理协作运行时平台，通过Matrix房间实现透明、可审计的任务协调，并允许人类全程参与和干预。项目基于Manager-Workers架构构建，其中Manager负责集中调度多个Worker，适用于企业环境中的人机协作及代理间协作场景。其主要特点包括：Manager-Workers架构简化了对单个Worker的直接管理；支持OpenClaw、QwenPaw和Hermes等多种运行时在同一即时消息房间内协同工作，各司其职以提高效率；引入MinIO作为共享文件系统，促进数据交换与存储。HiClaw适合需要高度可控且灵活的多智能体协作解决方案的应用场合。",2,"2026-06-11 03:50:10","high_star"]