Awesome Openclaw Hermes Agents

README

<!-- <CENTERED SECTION FOR GITHUB DISPLAY> -->

<div align="center">

# Awesome OpenClaw + Hermes Agents

**Stop hunting across scattered agent repos. Start from one curated field manual.**

A semantically organized mega-collection for **Hermes Agent** and **OpenClaw**: real use cases, SOUL agent templates, skills, configs, demos, playbooks, and ecosystem guides.

[![Awesome](https://awesome.re/badge.svg)](https://awesome.re)
[![Semantic Content](https://img.shields.io/badge/semantic_content-615_files-369eff?labelColor=black&style=flat-square)](content/)
[![Catalog](https://img.shields.io/badge/catalog-1172_entries-c4f042?labelColor=black&style=flat-square)](CATALOG.md)
[![Agent Templates](https://img.shields.io/badge/agent_templates-199-ffcb47?labelColor=black&style=flat-square)](content/20-agent-templates/openclaw/)
[![Use Cases](https://img.shields.io/badge/use_cases-101-8ae8ff?labelColor=black&style=flat-square)](content/10-use-cases/)
[![License](https://img.shields.io/badge/license-MIT-white?labelColor=black&style=flat-square)](LICENSE)

[Browse Content](content/) · [Catalog](CATALOG.md) · [Reading Guide](docs/reading-guide.md) · [Sources](SOURCES.md)

</div>

<!-- </CENTERED SECTION FOR GITHUB DISPLAY> -->

> [!NOTE]
> **This is not a raw mirror.**
>
> The upstream projects were reorganized by how builders actually use the material: ecosystem guides, use cases, agent templates, skills, configs, demos, and playbooks. Every moved file is traceable through [`data/path-map.json`](data/path-map.json) and [`data/content-manifest.json`](data/content-manifest.json).

> [!TIP]
> **If you only have 30 seconds:** open [`content/10-use-cases/`](content/10-use-cases/) to find a real workflow, then jump to [`content/20-agent-templates/openclaw/`](content/20-agent-templates/openclaw/) for a reusable SOUL role.

---

## Skip This README

Paste this into your coding agent:

```text
Read this repository and help me pick the best Hermes/OpenClaw agent use case to build first:
https://github.com/zcxGGmu/awesome-openclaw-hermes-agents
```

If you are the agent, start with:

1. [`docs/reading-guide.md`](docs/reading-guide.md)
2. [`CATALOG.md`](CATALOG.md)
3. [`content/10-use-cases/`](content/10-use-cases/)
4. [`content/20-agent-templates/openclaw/`](content/20-agent-templates/openclaw/)

---

## What This Is

You have Hermes Agent resources in one place. OpenClaw templates in another. Chinese use cases somewhere else. Skills, configs, demos, deployment notes, and ecosystem maps scattered across multiple repos.

This project does the boring work:

- migrates the useful material,
- renames the structure around usage,
- preserves source provenance,
- builds a local catalog,
- gives builders one place to start.

No more guessing which repo contains the thing you need.

---

## Install Nothing. Browse the Library.

There is no package to install. Clone it and read it like a field manual.

```bash
git clone [email protected]:zcxGGmu/awesome-openclaw-hermes-agents.git
cd awesome-openclaw-hermes-agents
```

Then pick your path:

| You want | Go here | What you get |
| :--- | :--- | :--- |
| **A real workflow** | [`content/10-use-cases/`](content/10-use-cases/) | Hermes and OpenClaw scenarios you can adapt. |
| **A reusable agent role** | [`content/20-agent-templates/openclaw/`](content/20-agent-templates/openclaw/) | SOUL templates grouped by domain. |
| **Skills and reusable components** | [`content/30-skills/`](content/30-skills/) | Claude/Gemma skill examples and building blocks. |
| **Model/runtime config** | [`content/40-configs/`](content/40-configs/) | OpenClaw provider, model, Ollama, hybrid advisor configs. |
| **Runnable examples** | [`content/50-demos-and-playbooks/`](content/50-demos-and-playbooks/) | Demos, quickstarts, memory wiki, verification docs. |
| **The big searchable list** | [`CATALOG.md`](CATALOG.md) | 1172 generated entries with local paths. |

---

## Highlights

|       | Section | Count | Why it matters |
| :---: | :--- | ---: | :--- |
| 🧭 | **Ecosystem Guides** | 815 resources | Understand Hermes/OpenClaw tools, plugins, memory, integrations, docs, and trust boundaries. |
| ⚡ | **Use Cases** | 101 workflows | Start from real automations instead of blank prompts. |
| 🤖 | **Agent Templates** | 199 templates | Reuse OpenClaw SOUL roles across marketing, dev, finance, security, education, SaaS, and more. |
| 🧩 | **Skills** | 19 entries | Plug in reusable capabilities instead of rewriting workflows. |
| 🛠️ | **Configs** | 11 examples | Move faster on provider/model/runtime setup. |
| 🚀 | **Demos & Playbooks** | 27 items | Run, verify, and operationalize. |
| 🔎 | **Traceability** | 615 files | Every moved file keeps source repo, commit, original path, and new path. |

---

## Directory Map

```text
content/
├── 00-ecosystem-guides/        # ecosystem maps, docs, assets, security/contribution notes
├── 10-use-cases/               # Hermes and OpenClaw real-world workflows
├── 20-agent-templates/         # OpenClaw SOUL agents by domain
├── 30-skills/                  # reusable skill examples
├── 40-configs/                 # provider/model/runtime configs
└── 50-demos-and-playbooks/     # demos, quickstarts, verification docs, memory wiki, scripts
```

This structure intentionally avoids source-repo names at the top level. The project is organized for builders, not archivists.

---

## Fast Paths

### Build a Chinese platform automation demo

```text
content/10-use-cases/openclaw-cn
→ content/20-agent-templates/openclaw
→ content/40-configs/openclaw
```

### Build a Hermes deployment or workflow article

```text
content/10-use-cases/hermes-agent
→ content/50-demos-and-playbooks/hermes-agent
→ content/00-ecosystem-guides/hermes-agent
```

### Create a reusable OpenClaw agent

```text
content/20-agent-templates/openclaw
→ content/30-skills/openclaw
→ content/40-configs/openclaw
```

### Research the whole ecosystem

```text
content/00-ecosystem-guides
→ CATALOG.md
→ SOURCES.md
```

---

## Source Coverage

| Upstream project | Files | Catalog entries | Snapshot | License |
| :--- | ---: | ---: | :--- | :--- |
| [Awesome Hermes Agent Use Cases](https://github.com/aliaihub/awesome-hermes-usecases) | 100 | 80 | `8f5b79e5d161` | MIT |
| [Awesome OpenClaw Use Cases ZH](https://github.com/AlexAnys/awesome-openclaw-usecases-zh) | 60 | 62 | `bf9a8beb7211` | MIT |
| [Awesome OpenClaw Agents](https://github.com/mergisi/awesome-openclaw-agents) | 433 | 576 | `05820c51125e` | MIT |
| [Awesome Hermes Agent](https://github.com/0xNyk/awesome-hermes-agent) | 22 | 454 | `27389ad544f9` | CC BY 4.0 |

---

## For Maintainers

Refresh upstream clones, regenerate the semantic library, and validate:

```bash
cd /k/ai-projs/_awesome_sources
for repo in awesome-hermes-usecases awesome-openclaw-usecases-zh awesome-openclaw-agents awesome-hermes-agent; do
  git -C "$repo" pull --ff-only
done

cd /k/ai-projs/awesome-openclaw-hermes-agents
python scripts/sync_content.py --sources-dir ../_awesome_sources
python scripts/build_catalog.py
python scripts/validate_content.py
python scripts/validate_catalog.py
```

Generated metadata:

- [`data/path-map.json`](data/path-map.json) — original upstream path → semantic content path
- [`data/content-manifest.json`](data/content-manifest.json) — file-level provenance and destination path
- [`data/catalog.json`](data/catalog.json) — machine-readable catalog
- [`CATALOG.md`](CATALOG.md) — human-readable catalog

---

## Philosophy

Agents are getting easier to run, but good examples are still hard to find.

This repo is the shelf: not another framework, not another empty template, not another list of logos. It is a working map of what people are actually building with Hermes Agent and OpenClaw.

Pick a workflow. Pick an agent. Ship something.

---

## License & Attribution

Upstream files retain their original licenses. This repository's organizing docs, scripts, manifests, and generated navigation are MIT licensed unless otherwise noted.

See [`SOURCES.md`](SOURCES.md) for full provenance.