first commit

.github/workflows/update-badge.yml

@@ -0,0 +1,29 @@
+name: Update Use Case Count Badge
+
+on:
+  push:
+    branches: [main]
+    paths:
+      - 'usecases/*.md'
+
+jobs:
+  update-badge:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Count use cases and update badge
+        run: |
+          COUNT=$(ls usecases/*.md 2>/dev/null | wc -l | tr -d ' ')
+          sed -i "s|usecases-[0-9]*-blue|usecases-${COUNT}-blue|" README.md
+
+      - name: Commit if changed
+        run: |
+          git diff --quiet README.md && exit 0
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+          git add README.md
+          git commit -m "Update use case count badge to $(ls usecases/*.md | wc -l | tr -d ' ')"
+          git push

CONTRIBUTING.md

@@ -0,0 +1,21 @@
+# Contributing
+
+## Adding a Use Case
+
+1. Create a markdown in the `/usecases` folder with the name of your usecase.
+2. Add your usecase in detail. Here are a few suggested points to cover: 
+   - **Pain Point** — What problem does this solve?
+   - **What It Does** — Brief explanation of the use case
+   - **Prompts** — The actual prompts/config you'd give OpenClaw
+   - **Skills Needed** — Which OpenClaw skills are required
+   - **Related Links** — Relevant docs, APIs, tools
+3. Add a row to the relevant category table in the main [README.md](README.md)
+4. Open a PR
+
+## Guidelines
+
+- One use case per markdown
+- Keep descriptions concise but enough for someone to replicate
+- If your use case doesn't fit an existing category, suggest a new one in your PR
+- Duplicates are fine if the approach is meaningfully different
+- Don't use AI to come up with new use cases. Only suggest use cases you have actually tested and verified.

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -0,0 +1,59 @@
+<div align="center">
+
+<a href="">
+<img width="1500" height="500" alt="Image" src="https://github.com/user-attachments/assets/4ae57dfb-4f18-4677-9136-43bf93017250" />
+</a>
+
+<br/>
+<br/>
+
+<div align="center">
+    <strong>Discover ways of how people are really using OpenClaw (previously ClawdBot, MoltBot) in their daily life. 
+    </strong>
+    <br />
+    <br />
+</div>
+
+[![Awesome](https://awesome.re/badge.svg)](https://awesome.re)
+
+![Use Cases](https://img.shields.io/badge/usecases-4-blue?style=flat-square)
+![Last Update](https://img.shields.io/github/last-commit/hesamsheikh/awesome-openclaw-usecases?label=Last%20Update&style=flat-square)
+</div>
+
+# Awesome OpenClaw Use Cases
+
+Solving the bottleneck of OpenClaw adaptation: Not ~~skills~~, but finding **ways it can improve your life**. This is a community collection of real-life use cases for [OpenClaw](https://github.com/openclaw/openclaw).
+
+
+## Social Media
+
+| Name | Description |
+|------|-------------|
+| [Daily Reddit Digest](usecases/daily-reddit-digest.md) | Summarize a curated digest of your favourite subreddits, based on your preferences. |
+| [X Account Analysis](usecases/x-account-analysis.md) | Get a qualitative analysis of your X account.|
+
+## Creative & Building
+
+| Name | Description |
+|------|-------------|
+| [Overnight mini-App Builder](usecases/overnight-mini-app-builder.md) | Wake up to a fresh micro-app idea, built and ready to try |
+
+## Productivity
+
+| Name | Description |
+|------|-------------|
+| [Inbox De-clutter](usecases/inbox-declutter.md) | Summarize Newsletters and send you a digest as an email. |
+
+## Research & Learning
+
+| Name | Description |
+|------|-------------|
+
+## 🤝 Contributing
+
+We welcome contributions! See [CONTRIBUTING.md](CONTRIBUTING.md) for  guidelines.
+
+- Add a new usecase
+- Improve existing ones
+
+> Please only submit usecases you have already worked with and verified that works (at least for a day). We value real ideas that make our lives actually better, not worse!

usecases/daily-reddit-digest.md

@@ -0,0 +1,23 @@
+# Daily Reddit Digest
+Run a daily digest everyday to give you the top performing posts from your favourite subreddits.
+
+What to use it for:
+
+• Browsing subreddits (hot/new/top posts)
+• Searching posts by topic
+• Pulling comment threads for context
+• Building shortlists of posts to manually review/reply to later
+
+> It's read-only. No posting, voting, or commenting.
+
+## Skills you Need
+[reddit-readonly](https://clawhub.ai/buksan1950/reddit-readonly) skill. It doesn't need auth. 
+
+## How to Set it Up
+After installing the skill, prompt your OpenClaw:
+```text
+I want you to give me the top performing posts from the following subreddits.
+<paste the list here>
+Create a separate memory for the reddit processes, about the type of posts I like to see and every day ask me if I liked the list you provided. Save my preference as rules in the memory to use for a better digest curation. (e.g. do not include memes.)
+Every day at 5pm, run this process and give me the digest.
+```

usecases/inbox-declutter.md

@@ -0,0 +1,15 @@
+# Inbox De-clutter
+
+Newsletters can take up the inbox like nothing else. Often times they pile-up without being opened at all. 
+
+## Skills you Need
+[Gmail OAuth Setup](https://clawhub.ai/kai-jar/gmail-oauth).
+
+## How to Set it Up
+1. [optional] Create a new gmail specifically for OpenClaw.
+2. [optional] Unsubscribe from all newsletters from your main email and subscribe to them using the OpenClaw email.
+3. Install the skill and make sure it works. 
+4. Instruct OpenClaw:
+```txt
+I want you to run a cron job everyday at 8 p.m. to read all the newsletter emails of the past 24 hours and give me a digest of the most important bits along with links to read more. Then ask for my feedback on whether you picked good bits, and update your memory based on my preferences for better digests in the future jobs.
+```

usecases/overnight-mini-app-builder.md

@@ -0,0 +1,7 @@
+# Overnight mini-App Builder
+
+Inspired by [Alex Finn](https://www.youtube.com/watch?v=UTCi_q6iuCM&t=414s). Explicitly tell your open code to be proactive and explain your goals, interests, plans, or strategies so it has a better understanding of what you want to achieve. 
+
+Then ask it to build you overnight, a mini app idea that gets you closer to your goals. It could be a new SaaS idea for launching in the future, or something that automates a boring part of your life. And explicitly tell it to build the app as an MVP and not to overcomplicate it.
+
+You will wake up every morning with a new surprise.

usecases/x-account-analysis.md

@@ -0,0 +1,22 @@
+# X Account Analysis
+
+There are many websites designed to give you a qualitative analysis of your X account. While X already gives you an **analytics** section, it's more focused to show your numbers on your performance.
+
+But a qualitative analysis focuses on the quality of your posts, not the performance stats. Some insights you can get from this type of analysis:
+- What are the patterns that make my posts go viral?
+- What topics I talk about get me most engagement?
+- Why do I get posts with 1000+ likes but sometimes posts with <5 likes? What am I doing wrong?
+
+There are many websites and apps designed to give you X analytics, but they focus on the statistics. There are probably 1-2 websites that let you talk with an AI to understand your performance. 
+
+But now you can use OpenClaw to do this analysis for you, without needing to pay $10-$50 for subscriptions on these websites.
+
+## Skills you Need
+Bird Skill. `clawhub install bird` (it comes pre-bundled)
+
+## How to Set it Up
+Here's the flow:
+1. Make sure Bird skill is working.
+2. For security and isolation, you better create a new account for your ClawdBot.
+3. Auth with your X account. log into x.com in Chrome/Brave, and provide the right cookie information (`auth-token`, `ct0`) so OpenClaw can access your account.
+4. Ask OpenClaw to take a look at your real account, fetch the last N tweets, and ask it any questions you like. Alternatively, you can ask it to write you specific scripts.