English · 简体中文

🖥 Mac · 🪟 Windows · 🐧 Linux · 📱 iOS · 🤖 Android

• Cross-device collaboration — Supports Mac, Windows, Linux, iOS, and Android, so you can keep working wherever you go
• Remote agent workspace — Run OpenClaw or Hermes on a cloud server, Mac mini, or home machine, then control it from Clawke on desktop or mobile
• Multi-agent management — Manage OpenClaw, Hermes, Nanobot, and other AI agents at the same time
• Media — Image/PDF/text file upload and inline rendering
• Relay — Built-in tunnel for remote access without port forwarding

curl -fsSL https://raw.githubusercontent.com/clawke/clawke/main/scripts/install.sh | bash

Works on macOS, Linux, and WSL2. The installer handles compiling the server, detecting your environment, and setting up the global CLI for you.

Windows: Native Windows is not supported. Please install WSL2 and run the command above.

Prerequisites: Node.js >= 18, Flutter >= 3.x (for client)

git clone https://github.com/clawke/clawke.git
cd clawke/server
npm install                           # Installs dependencies + compiles TypeScript
npx clawke gateway install             # Auto-detect and install gateway plugin
npx clawke server start                # Start Clawke Server

The server will:

1. Start WebSocket server on port 8765 (client) and 8766 (upstream)
2. Start HTTP/media server on port 8781

clawke --version          # Show installed Clawke version
clawke doctor             # Check local Clawke setup and runtime status
clawke update             # Update Clawke to the latest version
clawke update --check     # Check for updates without installing
clawke gateway install    # Auto-detect and install gateway plugin
clawke gateway update     # Update configured gateway plugin code (no restart)
clawke server start       # Start Clawke Server
clawke server stop        # Stop Clawke Server
clawke server restart     # Restart Clawke Server
clawke server status      # Check server status

• iOS: Download from the App Store.
• Android: Download the APK directly from the Releases page.
• macOS / Windows / Linux: Download compiled binaries from the Releases page.

Alternatively, you can build it yourself from source:

cd client
flutter pub get
flutter build macos  # Or: ios, apk, windows, linux

To run in debug mode, use flutter run -d macos (replace macos with your target platform).

Have questions or want to discuss Clawke? Scan the QR code below to join the Clawke WeChat discussion group.

clawke/
├── client/              # Flutter app (iOS, macOS, Android)
├── server/              # Clawke Server (TypeScript/Node.js)
│   ├── src/             # Source code
│   ├── config/          # Config templates
│   └── test/            # Tests (42 cases)
├── gateways/            # Gateway plugins
│   ├── openclaw/clawke/ # OpenClaw gateway
│   └── hermes/clawke/   # Hermes gateway
└── relay-server/        # Relay server config

📖 For advanced configuration, see CONFIGURATION.md.
🔌 To build your own gateway, see GATEWAY_INTEGRATION.md.

[Enhancement] Centered and simplified the welcome screen across desktop and mobile. [Bug Fix] Prevented false update prompts when the server advertises the same semantic version as the installed client.

[New Feature] Added server-client version compatibility checks and clearer version visibility during update flows. [Bug Fix] Fixed internal macOS DMG packaging metadata and improved SkillHub built-in path hints on touch devices.

[New Feature] Added SkillHub browsing, filtering, and managed installation with gateway-aware refresh. [Bug Fix] Fixed SkillHub category requests, managed skill install metadata, Hermes/OpenClaw skill search, and release/development token state handling.

[New Feature] Added gateway usage visibility, automatic gateway restart handling, and clearer local server connection hints. [Bug Fix] Fixed OpenClaw gateway config merging, improved GatewayClient guidance, and hardened server PID lifecycle checks.

[Bug Fix] Stabilized OpenClaw gateway integration and UI E2E regression checks. [Enhancement] Improved Linux desktop registration, setup compatibility, icon/font fallback, and gateway install guidance.

[Bug Fix] Fixed Mac App Store build behavior for Apple/Google sign-in, production APNs, and App Store-managed updates. [Enhancement] Hardened Mac App Store package validation and improved debug runtime path safety on mobile.

[Bug Fix] Fixed macOS Google Sign-In keychain access for GitHub release builds. [Enhancement] Unified desktop package entry names so macOS, Windows, and Linux expose Clawke consistently.

[Bug Fix] Preserved native macOS Google Sign-In and hid unavailable Apple login until the release profile supports it. [Enhancement] Polished desktop OAuth packaging, refreshed desktop icons, and updated release workflows for the current GitHub Actions runtime.

[Bug Fix] Fixed macOS release signing for macOS 26 validation and added Windows desktop Google OAuth via browser loopback flow.

[Bug Fix] Bundled Windows Visual C++ runtime DLLs and hid unsupported desktop Google sign-in so official Windows packages start reliably.

[Bug Fix] Restored Android release signing and added certificate verification to prevent Google login failures caused by debug-signed APKs.

[Enhancement] Stabilized runtime path handling and task UI E2E setup for release validation. [Architecture] Renamed upstream listener boundaries to gateway listener and moved private planning docs out of public documentation.

[New Feature] Added Hermes cron result sync with persistent task delivery tracking and retry handling. [Enhancement] Improved task management delivery status, validation feedback, and gateway alerts. [Enhancement] Updated Hermes media routing and per-session working directory isolation.

[New Feature] Added clawke doctor runtime and gateway diagnostics. [Enhancement] Clarified multi-agent online management across OpenClaw, Hermes, and mobile clients. [Bug Fix] Fixed streamed reply recovery after disconnect so Thinking, tool state, and stop button no longer get stuck.

[New Feature] Hermes gateway support. [New Feature] Native Skills Center and task management pages. [Enhancement] Gateway-backed model, skill, and translation refresh flows. [Bug Fix] OpenClaw model routing and startup configuration fixes. [Architecture] Expanded gateway and UI E2E regression coverage.

[New Feature] One-click installation and unified CLI commands.
[New Feature] AI typing status indicators.
[Enhancement] Gateway pipeline optimizations.
[Bug Fix] Comprehensive abort (stop generation) pipeline overhaul.
[Bug Fix] Fixed concurrent message and delivery state issues.

[New Feature] Multi-session support with per-conversation AI configuration.
[New Feature] Gateway selector for new conversations.
[Enhancement] Complete internationalization (i18n) for all screens.
[Enhancement] Desktop UI polish — unified AppBar styling and spacing.
[Bug Fix] Fix cross-conversation message leakage.
[Bug Fix] Fix port conflict detection on startup.
[Architecture] Server-side conversation auto-creation.

Full Changelog

1. Fork this repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit changes (git commit -m 'Add amazing feature')
4. Push to branch (git push origin feature/amazing-feature)
5. Open a Pull Request

MIT