> Contributing? Read **[CONTRIBUTING.md](./CONTRIBUTING.md)** before opening a PR.
**The most Token-efficient open-source AI Agent.**
OpenClacky matches Claude Code on capability at comparable cost, and saves significantly against other open-source agents (~50% vs OpenClaw, ~3× cheaper than Hermes). 100% open source (MIT), BYOK with any OpenAI-compatible model, built on two years of Agentic R&D and harness engineering.
> Website: https://www.openclacky.com/ · Backed by **MiraclePlus · ZhenFund · Sequoia China · Hillhouse Capital**
## Why OpenClacky?
Same task, how much do you pay? Under comparable agent workloads, OpenClacky saves a large amount of Token spend compared to mainstream alternatives.
| Agent | Relative cost | Notes |
|---|---|---|
| **OpenClacky** | **~0.8** | 16 tools · ~100% cache hit · subagent routing |
| Claude Code | 1.0× (baseline) | World-class harness, closed-source subscription |
| OpenClaw | ~1.5× | Comparable harness agent |
| Hermes | ~3× | 52 built-in tools — schema bloat ~3–4× |
*Numbers are averages measured on internal common agent tasks, using Claude Code as the baseline. Full benchmark reports will be published on GitHub.*
## Feature comparison
Core agent capability is roughly on par across the field — the real differentiators are **cost, openness, Skill evolution, and integrations**.
| Feature | Claude Code | OpenClaw | Hermes | **OpenClacky** |
|---|:---:|:---:|:---:|:---:|
| Token cost | 1.0× | ~1.5× | ~3× | **~0.8** |
| Open source | ❌ Closed | ✅ Open | ✅ Open | ✅ MIT |
| BYOK / model freedom | ❌ Anthropic only | ✅ | ✅ | ✅ |
| Skill self-evolution | ❌ | ❌ | ✅ | ✅ |
| IM integration (Feishu/WeCom/WeChat/Discord/Telegram) | ❌ | ✅ | ✅ | ✅ |
## How we get the cost down
Not by cutting features — by compounding the right choice at every layer.
### 1. Ultra-high cache hit rate
Sessions never restart, double cache markers, **Insert-then-Compress** — the system prompt is never mutated, so compression still reuses the cache. **Measured cache hit rate: near 100%.**
### 2. Minimal tool set
Only **16 core tools**. Capabilities are offloaded to the Skill ecosystem via a single `invoke_skill` meta-tool. Tool count is not the metric — task completion rate is.
| OpenClacky | Claude Code | OpenClaw | Hermes |
|:--:|:--:|:--:|:--:|
| **16** | 40+ | 23 | 52 |
### 3. Idle-time auto-compression
Go to a meeting, grab coffee — the agent compresses long context in the background and pre-warms the cache. Your first message back hits the cache directly. **Cold-start first-token cost reduced by 50%+.**
### 4. BYOK — you pick the model, you set the cost
Any OpenAI-compatible API, plug and play. Official direct, aggregate routing, compatible relays — the choice is 100% yours. Use Claude for code, auto-route subtasks to DeepSeek, save another chunk of tokens.
Built on **2 years · 3 generations of agentic architecture · 6 core harness engineering decisions**.
## Skills — the soul of the agent
- **Invoke with `/`** — instant browse, fuzzy search, direct call. Hundreds of Skills at your fingertips.
- **Create Skills in natural language** — just describe what you want; the agent drafts `SKILL.md`, breaks down steps, and runs validation. No code required.
- **Self-evolving** — after each run, the agent updates the Skill based on execution context and results. The next call is more stable and more accurate.
- **Open & compatible** — supports Claude Skills / Markdown Pack / custom formats.
- **Monetizable** — polished Skills can be packaged for sale, with encrypted distribution, License management, and creator-defined pricing.
## Installation
### Desktop installer (recommended)
Double-click to install — environment, dependencies, and Skills all set up automatically.
- **macOS** — [Download `.dmg`](https://oss.1024code.com/openclacky-installer/official/openclacky-installer.dmg) (Apple Silicon / Intel)
- **Windows** — [Download `.exe`](https://oss.1024code.com/openclacky-installer/official/openclacky-installer.exe) (Windows 10 2004+ / Windows 11)
More options: https://www.openclacky.com/
### Command line
One-line install(Mac/Ubuntu):
```bash
/bin/bash -c "$(curl -sSL https://raw.githubusercontent.com/clacky-ai/openclacky/main/scripts/install.sh)"
```
Windows:
```bash
powershell -c "& ([scriptblock]::Create((irm 'https://raw.githubusercontent.com/clacky-ai/openclacky/main/scripts/install.ps1')))"
```
or using Ruby(3.x/4.x):
**Requirements:** Ruby >= 3.1.0
```bash
gem install openclacky
```
see more: https://www.openclacky.com/docs/installation
### Docker
Build:
```bash
git clone https://github.com/clacky-ai/openclacky.git
cd openclacky
docker build -t openclacky .
```
**Linux:**
```bash
docker run -d --network=host -e CLACKY_ACCESS_KEY="" openclacky
```
`--network=host` is required so the agent inside the container can reach Chrome's remote debugging port running on the host.
**macOS / Windows:**
```bash
docker run -d -p 7070:7070 -e CLACKY_ACCESS_KEY="" openclacky
```
> **Note:** On macOS/Windows, `--network=host` is not supported — browser automation may be limited.
Open **http://localhost:7070** after starting.
Environment variables:
| Variable | Description |
|---|---|
| `CLACKY_ACCESS_KEY` | Protect the Web UI with an access key (empty = public mode) |
## Quick Start
### Terminal (CLI)
```bash
openclacky # start interactive agent in current directory
```
### Web UI
```bash
openclacky server # default: http://localhost:7070
```
Open **http://localhost:7070** for a full chat interface with multi-session support — run coding, copywriting, research sessions in parallel.
Options:
```bash
openclacky server --port 8080 # custom port
openclacky server --host 0.0.0.0 # listen on all interfaces (remote access)
```
## Configuration
```bash
$ openclacky
> /config
```
Set your **API Key**, **Model**, and **Base URL** (any OpenAI-compatible provider).
Supported out of the box: **Claude (Anthropic) · GPT (OpenAI) · DeepSeek · Kimi (Moonshot) · MiniMax · OpenRouter** — or any custom endpoint.
## Coding use case
OpenClacky works as a general AI coding assistant — scaffold full-stack apps, add features, or explore unfamiliar codebases:
```bash
$ openclacky
> /new my-app # scaffold a new project
> Add user auth with email and password
> How does the payment module work?
```
## Star History
## Advanced — Creator Program
Already power users are turning their workflows into vertical AI experts on OpenClacky — encrypted distribution, License management, self-set pricing. Legal, healthcare, financial planning, and more.
Learn more: https://www.openclacky.com/ → Creators
## Install from Source
```bash
git clone https://github.com/clacky-ai/openclacky.git
cd openclacky
bundle install
bin/clacky
```
## Trust & Credibility
- **100% open source** — MIT License, all code public, all decisions traceable
- **2 years of Agentic R&D** — 3 generations of architecture
- **16 core tools** — minimal by design
- **Backed by** MiraclePlus · ZhenFund · Sequoia China · Hillhouse Capital
## Contributors
Every line of code, bug report, and thoughtful review matters. Thank you for making OpenClacky better.
## Contributing
Bug reports and pull requests are welcome on GitHub at https://github.com/clacky-ai/openclacky. Contributors are expected to adhere to the [code of conduct](https://github.com/clacky-ai/openclacky/blob/main/CODE_OF_CONDUCT.md).
## License
Available as open source under the [MIT License](https://opensource.org/licenses/MIT).