Skip to content

openJiuwen-ai/jiuwenclaw

Repository files navigation

JiuwenClaw

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

Python Version License Huawei Cloud MaaS

🌟 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.

⚡ Your always-on, data-sovereign personal AI assistant ⚡

⚠️ Version Upgrade Notice

If you're upgrading from an earlier version to v0.1.7:

Due to breaking changes in this release, you must reinitialize JiuwenClaw after upgrading. The service will fail to start without reinitialization.

Backup Before Upgrading

Before running jiuwenclaw-init, please backup your existing data:

Data Type Source Path Description
Memory Data .jiuwenclaw/workspace/agent/memory All your conversation memories
Custom Skills .jiuwenclaw/workspace/agent/agent Your custom agent skills
Configuration .jiuwenclaw/config Your app settings

Migration Steps

After upgrading and running jiuwenclaw-init, manually migrate your data:

  1. Copy Memory:

    cp -r .jiuwenclaw/workspace/agent/memory .jiuwenclaw/agent/memory
  2. Copy Skills:

    cp -r .jiuwenclaw/workspace/agent/agent .jiuwenclaw/agent/skill

The new initialization process includes automatic migration of compatible configuration data from previous versions.

🚀 Getting Started

📦 Installation

# Install JiuwenClaw pip install jiuwenclaw # Initialize JiuwenClaw (first-time setup or after upgrading) # ⚠️ Remember to backup your data before running this command 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.


Making intelligence accessible. Making life simpler.
✨ JiuwenClaw — Your Personal AI Assistant ✨

About

JiuwenClaw is an intelligent AI Agent built on openJiuwen. It extends the powerful capabilities of large language models directly to your fingertips through various communication apps you use daily.

Resources

License

Stars

Watchers

Forks

Packages