Integration
Wikiclaw
By The free encyclopedia for the OpenClaw AI agent ecosystem. Browse 199+ agents, 5,400+ skills, plugins, and integrations.
Install
npm install
```README
<div align="center">
<img src="public/banner.png" alt="WikiClaw — The OpenClaw Encyclopedia" width="600" />
### The free encyclopedia for the [OpenClaw](https://openclaw.ai) AI agent ecosystem.
A Wikipedia-style wiki documenting **199+ production-ready agents**, **5,400+ skills**, plugins, and integrations from the OpenClaw community — all in one beautifully designed, lightning-fast site.
[**Live demo →**](https://wikiclaw.dev) · [**GitHub**](https://github.com/wikiclaw-org/wikiclaw) · [**Follow on X**](https://x.com/allankjensen) · [**Report issue**](https://github.com/wikiclaw-org/wikiclaw/issues)
</div>
---
## ✨ What is WikiClaw?
[OpenClaw](https://openclaw.ai) is the most popular open-source personal AI agent framework, with 247k+ GitHub stars. It runs on your machine, connects through messaging apps you already use (WhatsApp, Telegram, Slack, Discord, iMessage), and takes action on your behalf.
**WikiClaw** is the community-maintained encyclopedia for that ecosystem. It indexes every agent, skill, and plugin in one place, with a clean reading experience inspired by Wikipedia and a modern aesthetic borrowed from OpenClaw itself.
---
## 🎯 Features
- 📚 **199+ agents** seeded from [`awesome-openclaw-agents`](https://github.com/mergisi/awesome-openclaw-agents) with full SOUL.md content
- 🗂️ **25+ categories** spanning business, creative, engineering, healthcare, and more
- 🔍 **Instant search** across all agents — names, roles, categories
- 📖 **Wikipedia-style article pages** with infoboxes, table of contents, "See also" sections, and external links
- 🌐 **Portal homepage** with featured agent, "Did you know" facts, quick start, and visual category grid
- ⚡ **Edge-fast** — Upstash Redis + Next.js ISR for sub-100ms page loads anywhere in the world
- 📱 **Mobile-first responsive design** — works beautifully on every screen size
- 🎨 **Eye-catching design** — dark hero with glowing orb, OpenClaw red accents, Wikipedia-clean article body
- 🤖 **SEO-ready** — sitemap, robots, OpenGraph images, structured metadata for every page
- 🚀 **Deploy in one click** to Vercel
---
## 🏗️ Architecture
```
┌───────────────────────────────────────────────┐
│ Next.js 16 App Router + React Server Comps │
│ ───────────────────────────────────────── │
│ • Static page generation (ISR) │
│ • Dynamic OG image rendering │
│ • Client-side filter & search │
└────────────────────┬──────────────────────────┘
│
▼
┌───────────────────────────────────────────────┐
│ Upstash Redis (REST API) │
│ ───────────────────────────────────────── │
│ • agent:{slug} — agent data hash │
│ • agents:all — sorted set index │
│ • category:{slug} — category metadata │
│ • category:{slug}:agents — set membership │
│ • stats — global counts │
└────────────────────┬──────────────────────────┘
│
▼
┌───────────────────────────────────────────────┐
│ scripts/seed.ts │
│ ───────────────────────────────────────── │
│ Pulls agents.json + SOUL.md files from │
│ awesome-openclaw-agents on GitHub and │
│ populates Redis with a single pipeline. │
└───────────────────────────────────────────────┘
```
**No PostgreSQL. No backend server. No complex ORM.** Just Redis hashes, server components, and ISR. The entire database is ~500 KB.
---
## 🚀 Quick start
### 1. Clone and install
```bash
git clone https://github.com/wikiclaw-org/wikiclaw.git
cd wikiclaw
npm install
```
### 2. Set up Upstash Redis
WikiClaw uses [Upstash Redis](https://upstash.com/) — a serverless Redis with a generous free tier and native Vercel integration.
1. Create a free database at [upstash.com](https://upstash.com/)
2. Copy your `KV_REST_API_URL` and `KV_REST_API_TOKEN`
3. Create `.env.local` from the example:
```bash
cp .env.example .env.local
# then paste your credentials
```
### 3. Seed the database
```bash
npm run seed
```
This pulls all 199 agents and their SOUL.md files from GitHub and writes them to Redis in a single batched pipeline. Takes about 30 seconds.
### 4. Run the dev server
```bash
npm run dev
```
Open [http://localhost:3000](http://localhost:3000). 🎉
---
## 📁 Project structure
```
wikiclaw/
├── public/
│ ├── logo.png # WikiClaw mascot (primary logo)
│ ├── banner.png # Wordmark + mascot banner
│ ├── icon-192.png # PWA icon 192x192
│ └── icon-512.png # PWA icon 512x512
│
├── scripts/
│ └── seed.ts # Fetch agents.json → Redis
│
├── src/
│ ├── app/
│ │ ├── layout.tsx # Root layout, metadata, fonts
│ │ ├── page.tsx # Portal homepage (hero + cards)
│ │ ├── globals.css # Wikipedia + OpenClaw styles
│ │ ├── icon.png # Favicon (from mascot)
│ │ ├── apple-icon.png # iOS home screen icon
│ │ ├── opengraph-image.tsx # Dynamic OG image
│ │ ├── manifest.ts # PWA manifest
│ │ ├── robots.ts # robots.txt
│ │ ├── sitemap.ts # Auto-generated sitemap
│ │ ├── agents/
│ │ │ ├── page.tsx # Alphabetical agent index
│ │ │ ├── AgentsListClient.tsx # Filter + group-by-letter UI
│ │ │ └── [slug]/page.tsx # Wikipedia-style agent article
│ │ ├── categories/
│ │ │ ├── page.tsx # Visual category grid
│ │ │ └── [slug]/page.tsx # Pages-in-category listing
│ │ └── search/page.tsx # Server-side search results
│ │
│ ├── components/
│ │ ├── layout/ # Header, Footer
│ │ ├── agents/ # AgentCard, AgentInfobox, AgentGrid
│ │ ├── categories/ # CategoryBadge, CategoryFilter
│ │ ├── search/ # SearchBar, HeroSearchBar
│ │ └── content/ # MarkdownRenderer
│ │
│ ├── lib/
│ │ ├── redis.ts # Upstash client singleton
│ │ ├── agents.ts # Agent data access
│ │ ├── categories.ts # Category data access
│ │ ├── types.ts # TypeScript interfaces
│ │ └── utils.ts # slugify, formatters
│ │
│ └── config/
│ ├── site.ts # Site metadata constants
│ └── categories.ts # Category color map
│
├── .env.example # Required env vars template
└── package.json
```
---
## 🛠️ Tech stack
| Layer | Choice |
| ---------------- | ----------------------------------------------------- |
| **Framework** | [Next.js 16](https://nextjs.org/) (App Router, Turbopack) |
| **Language** | TypeScript 5 |
| **Styling** | [Tailwind CSS 4](https://tailwindcss.com/) |
| **Typography** | Inter (sans) + Crimson Pro (serif headings) |
| **Database** | [Upstash Redis](https://upstash.com/) (REST API) |
| **Markdown** | `react-markdown` + `remark-gfm` |
| **Hosting** | [Vercel](https://vercel.com/) |
| **Data source** | [`awesome-openclaw-agents`](https://github.com/mergisi/awesome-openclaw-agents) |
---
## ☁️ Deploy to Vercel
WikiClaw is built to deploy to Vercel in under a minute.
1. **Fork this repo**
2. Click the Vercel deploy button (or import the repo manually):
[](https://vercel.com/new/clone?repository-url=https://github.com/wikiclaw-org/wikiclaw)
3. Add your Upstash Redis env vars in Vercel project settings:
- `KV_REST_API_URL`
- `KV_REST_API_TOKEN`
4. Deploy!
5. Run the seed script locally once to populate your Upstash database — it's a one-time operation.
That's it. No servers to manage, no databases to spin up, no DevOps nightmare.
---
## 🤝 Contributing
Contributions are very welcome! WikiClaw is a community wiki and we want it to grow with the OpenClaw ecosystem.
**Easy ways to contribute:**
- 📝 **Fix typos or improve descriptions** — open a PR against `scripts/seed.ts` or the upstream `awesome-openclaw-agents` repo
- 🎨 **Polish the UI** — there's always room to make things prettier
- 🐛 **File bugs** — open an issue with steps to reproduce
- 💡 **Suggest features** — community ratings, edit history, "Submit Agent" form, plugins page, skills page (Phase 2)
**Roadmap:**
- [x] Phase 1 — Agent Wiki (current)
- [ ] Phase 2 — Skills, Plugins & Integrations pages
- [ ] Phase 3 — Community features (auth, ratings, wiki-style edits, "Submit Agent" form)
---
## 🙏 Acknowledgements
- The [**OpenClaw**](https://openclaw.ai) team and community for building an amazing agent framework
- [**mergisi/awesome-openclaw-agents**](https://github.com/mergisi/awesome-openclaw-agents) for the agent dataset
- [**VoltAgent/awesome-openclaw-skills**](https://github.com/VoltAgent/awesome-openclaw-skills) for the skills catalogue (used in Phase 2)
- The thousands of community contributors who built and shared their agents
---
## 📄 License
[MIT](LICENSE) — free to use, modify, and d
... (truncated)
integration
Comments
Sign in to leave a comment