<div align="center">

JiuwenClaw

Your On-Call AI Butler — Bringing Intelligence to Your Fingertips

</div>

🌟 Overview

JiuwenClaw is an intelligent AI Agent built in Python. True to its name — "Claw" symbolizes precise reach and connection — it extends the power of large language models directly to your fingertips through the communication apps you already use every day.

✨ Key Features

• Ecosystem Compatible: Full support for Huawei Cloud MaaS and other mainstream model platforms
• Seamless Integration: Native integration with the Xiaoyi Open Platform, enabling Huawei phone users to invoke JiuwenClaw directly through the Xiaoyi assistant
• Flexible Deployment: Self-hosted deployment with full data sovereignty
• Multi-Platform Access: Interact via web interface, messaging apps, and more

🎯 Design Philosophy

Understands You. Evolves With You.

🤝 Your Personal Task Butler

Whether dealing with task additions, mid-flow interruptions, or shifting requirements, JiuwenClaw understands your intent precisely — intelligently scheduling and executing tasks in an orderly, stress-free manner.

🔄 Autonomous Evolution

When you express dissatisfaction or an error occurs, JiuwenClaw automatically refines the relevant skills based on your feedback — continuously improving, always working in your best interest.

<p align="center"> <strong>⚡ Your always-on, data-sovereign personal AI assistant ⚡</strong> </p>

🚀 Getting Started

📦 Installation

# Install JiuwenClaw
pip install jiuwenclaw

# Initialize JiuwenClaw (first-time setup)
jiuwenclaw-init

# Start JiuwenClaw
jiuwenclaw-start

💬 How to Use

1️⃣ Conversation Mode

| Method | Description | | ------------------ | ------------------------------------------------------------ | | Web Frontend | After starting the service, visit http://localhost:5173 to chat directly in your browser | | Xiaoyi Channel | Huawei phone users can invoke Xiaoyi to talk with JiuwenClaw directly | | Lark Channel | Once configured, chat with JiuwenClaw seamlessly inside Lark |

2️⃣ Scheduled Tasks

Set up heartbeat tasks with your to-do items, and JiuwenClaw will wake up on schedule to execute them automatically — making your time management smarter and more effortless.

📚 Documentation

| Document | Description | | :--------------------------------------------------- | :------------------------------------------------------- | | 📖 Quick Start | Get up and running with JiuwenClaw in 5 minutes | | ⚙️ Configuration & Workspace | Environment setup and workspace management | | 📁 Workspace Structure | workspace directory layout, presets, and dynamic content | | 🛠️ Skill System | Guide to developing custom skills | | 📱 Channel Configuration | Integrating Feishu, Xiaoyi, and other channels | | ⌨️ CLI Commands | Command-line tool usage guide | | ⏰ Scheduled Tasks | Scheduled task management | | 🧠 Memory | Intelligent memory and learning capabilities | | 🌐 Browser Automation | Web browsing and automation features | | 📋 Task Planning | Chat behavior and task flow | | 🔄 Skill Self-Evolution | Mechanism for automatic skill evolution | | 📦 Context Compression | Context compression and unloading | | 🚀 Development Practices | Development practices and experience sharing |

🤝 Contributing

We warmly welcome community contributions — whether it's filing bug reports, suggesting new features, or improving documentation, every bit of support means the world to us.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

📄 License

This project is licensed under the Apache License 2.0. See the LICENSE file for details.

---

<p align="center"> <strong>Making intelligence accessible. Making life simpler.</strong><br> _{✨ JiuwenClaw — Your Personal AI Assistant ✨} </p>