In an unremarkable repository, a lobster was born.

Its dreams have been big from day one.

Hello Claw 👋

Hello Claw: adopt your AI lobster assistant, learn Skills in Lobster University, and build your own intelligent agent from scratch

📌 Read Online | 💬 Join Community | 🚀 Want to Learn Vibe Coding Too?

<a href="https://github.com/datawhalechina/hello-claw/stargazers" target="_blank">
    <img src="https://img.shields.io/github/stars/datawhalechina/hello-claw?color=660874&style=for-the-badge&logo=star&logoColor=white&labelColor=1a1a2e" alt="Stars"></a>
<a href="https://github.com/datawhalechina/hello-claw/network/members" target="_blank">
    <img src="https://img.shields.io/github/forks/datawhalechina/hello-claw?color=660874&style=for-the-badge&logo=git-fork&logoColor=white&labelColor=1a1a2e" alt="Forks"></a>
<a href="https://github.com/datawhalechina/hello-claw/raw/v1.0.0/LICENSE" target="_blank">
    <img src="https://img.shields.io/badge/License-CC_BY_NC_SA_4.0-4ecdc4?style=for-the-badge&logo=creative-commons&logoColor=white&labelColor=1a1a2e" alt="License"></a>

[!WARNING] 🧪 Beta Notice: the main tutorial is complete, and we are now polishing the details. Issues and suggestions are very welcome.

Read Online

https://datawhalechina.github.io/hello-claw

Introduction

This project is a complete learning guide for OpenClaw, designed to help you master this powerful command-line AI assistant system from zero. Whether you want to use OpenClaw quickly to boost your productivity or deeply understand how it works and build your own version, this tutorial gives you a clear path forward.

This project contains three core modules:

1. Adopt Claw (User Guide): 11 chapters plus 7 appendices, covering installation (Ch. 1-3), core configuration (Ch. 4-6), operations and extensions (Ch. 7-9), and security plus client interfaces (Ch. 10-11)
2. Lobster University (Practical Scenarios): hands-on case studies centered on Skills selection and reusable workflow patterns
3. Build Claw (Developer Guide): 15 chapters that first break down OpenClaw source code and alternatives, then move into Skills, channels, and full customization

Who is this for:

• Beginners: want an always-available AI assistant without needing prior programming experience
• Productivity enthusiasts: want to control AI remotely through QQ, Feishu, or Telegram
• Technical explorers: are curious about OpenClaw's skill system and automation capabilities
• Developers: want to understand agent architecture deeply and build their own version

Suggested learning paths:

• Beginners: start with Part 1 "Adopt Claw" and get installation plus basic automation working first
• If you want scenario-driven outcomes fast: jump into "Lobster University" and pick 5-10 Skills by use case
• Developers: go to "Build Claw" to study the underlying implementation and customize your own Claw

🔥 News

• [2026-03-12] ✅ Completed Build Claw Ch. 1-10: core architecture analysis (prompt system, tool system, message loop, multi-channel integration), alternative solution exploration (lightweight, hardened security, hardware), and a summit-view retrospective
• [2026-03-10] ✅ Completed Build Claw Ch. 13: Skill file structure, frontmatter, async handling, and debugging
• [2026-03-10] ✅ Added Lobster University: a menu-style Skills elective guide to give your lobster "combat add-ons"
• [2026-03-08] ✅ Completed Adopt Claw Ch. 1-11: installation (AutoClaw + manual install + onboarding wizard), core configuration (chat platforms, models, agents), operations and extensions (tools and scheduled tasks, gateway, remote access), and security plus clients (security protection, web interface)
• [2026-03-04] 🦞 Project launched with two planned core modules: "Adopt Claw" and "Build Claw"

📖 Table of Contents

Part 1: Adopt Claw (User Guide, 11 Chapters + Appendices A-G)

Part 2: Build Claw (Developer Guide, 15 Chapters)

Part 3: Lobster University (Practical Scenarios)

🎉 We'd love case-study contributions!

If you have a unique OpenClaw scenario or practical experience to share, you are very welcome to contribute in any of these ways:

• Submit a PR to add your case study to this section
• Open an Issue describing your scenario
• Join the community discussion and exchange ideas with other developers

Every contribution helps more people discover what OpenClaw can do.

🦞 Use Case Gallery (Continuously Updated)

🙏 Contributors

More contributors are welcome

🤝 Contributing

• If you find an issue, feel free to open an Issue. If you do not receive a response, you can contact the support team for follow-up.
• If you would like to contribute, feel free to submit a Pull Request. If you do not receive a response, you can contact the support team for follow-up.
• If you are interested in Datawhale and want to start a new project, please follow the Datawhale Open Source Project Guide.

💬 Community

Join the Hello Claw community group and learn together with other developers:

📧 Follow Us

Scan the QR code below to follow the Datawhale official account on WeChat

📄 LICENSE

<img alt="Creative Commons License" style="border-width:0" src="https://img.s