Skip to main content

A powerful AI agent with skills system

Project description

QRClaw

PyPI version Python License: MIT

A powerful AI agent with skills system

English | 中文


English

Features

  • 🤖 AI Agent - Powered by OpenAI, with intelligent context management
  • 🎯 Skills System - Extend functionality with modular skills
  • 🔄 OpenClaw Compatible - Fully compatible with OpenClaw skills ecosystem
  • 💾 Session Management - Persistent conversation history
  • 🎨 Rich UI - Beautiful terminal interface with syntax highlighting
  • 📦 Easy to Use - Simple installation and configuration

Installation

# Install from PyPI
pip install qrclaw

# Or install from GitHub
pip install git+https://github.com/fu-qingrong/qrclaw.git

Quick Start

  1. Set up API Key

    # Create .env file
    echo "OPENAI_API_KEY=your-api-key-here" > ~/.qrclaw/.env
    
  2. Run QRClaw

    qrclaw
    
  3. Start Chatting

    > Hello, how can you help me?
    > Analyze this project for me
    > Review the code in src/main.py
    

Skills System

QRClaw comes with built-in skills:

  • review-code - Review code and provide improvement suggestions
  • generate-docs - Generate README, API docs, etc.
  • analyze-project - Analyze project structure and code quality
  • install-skill - Install new skills from GitHub/ClawHub

Install New Skills

# In QRClaw chat
> 导入 skill meow-finder

# Or use CLI
/skill import meow-finder

Configuration

Configuration file: ~/.qrclaw/config

[DEFAULT]
model = gpt-4o-mini
max_tokens = 128000
log_level = INFO

Commands

  • exit - Exit QRClaw
  • clear - Clear conversation history
  • /skill list - List installed skills
  • /skill import <name> - Import a new skill

Development

# Clone repository
git clone https://github.com/fu-qingrong/qrclaw.git
cd qrclaw

# Create virtual environment
python -m venv .venv
source .venv/bin/activate  # Windows: .venv\Scripts\activate

# Install dependencies
pip install -e .

# Run
python -m qrclaw.cli

中文

特性

  • 🤖 AI 代理 - 基于 OpenAI,智能上下文管理
  • 🎯 技能系统 - 模块化技能扩展功能
  • 🔄 OpenClaw 兼容 - 完全兼容 OpenClaw 技能生态
  • 💾 会话管理 - 持久化对话历史
  • 🎨 精美界面 - 终端界面美观,支持语法高亮
  • 📦 易于使用 - 简单安装和配置

安装

# 从 PyPI 安装
pip install qrclaw

# 或从 GitHub 安装
pip install git+https://github.com/fu-qingrong/qrclaw.git

快速开始

  1. 设置 API Key

    # 创建 .env 文件
    echo "OPENAI_API_KEY=your-api-key-here" > ~/.qrclaw/.env
    
  2. 运行 QRClaw

    qrclaw
    
  3. 开始对话

    > 你好,你能帮我做什么?
    > 帮我分析一下这个项目
    > 审查 src/main.py 的代码
    

技能系统

QRClaw 内置技能:

  • review-code - 代码审查和改进建议
  • generate-docs - 生成 README、API 文档等
  • analyze-project - 分析项目结构和代码质量
  • install-skill - 从 GitHub/ClawHub 安装新技能

安装新技能

# 在 QRClaw 对话中
> 导入 skill meow-finder

# 或使用 CLI
/skill import meow-finder

配置

配置文件:~/.qrclaw/config

[DEFAULT]
model = gpt-4o-mini
max_tokens = 128000
log_level = INFO

命令

  • exit - 退出 QRClaw
  • clear - 清除对话历史
  • /skill list - 列出已安装技能
  • /skill import <name> - 导入新技能

开发

# 克隆仓库
git clone https://github.com/fu-qingrong/qrclaw.git
cd qrclaw

# 创建虚拟环境
python -m venv .venv
source .venv/bin/activate  # Windows: .venv\Scripts\activate

# 安装依赖
pip install -e .

# 运行
python -m qrclaw.cli

License

This project is licensed under the MIT License - see the LICENSE file for details.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Acknowledgments

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

qrclaw-0.5.3.tar.gz (1.5 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

qrclaw-0.5.3-py3-none-any.whl (67.1 kB view details)

Uploaded Python 3

File details

Details for the file qrclaw-0.5.3.tar.gz.

File metadata

  • Download URL: qrclaw-0.5.3.tar.gz
  • Upload date:
  • Size: 1.5 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.3

File hashes

Hashes for qrclaw-0.5.3.tar.gz
Algorithm Hash digest
SHA256 509f9eb177b60a51006b1269a803cba830435a3f144a9199df8574625c6f845f
MD5 3c03f391ae972d4f11291df99b209c6e
BLAKE2b-256 3469928c107d8114368d954245bc1f7d9558a312187e34f702cd19e5bd5d1ab8

See more details on using hashes here.

File details

Details for the file qrclaw-0.5.3-py3-none-any.whl.

File metadata

  • Download URL: qrclaw-0.5.3-py3-none-any.whl
  • Upload date:
  • Size: 67.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.3

File hashes

Hashes for qrclaw-0.5.3-py3-none-any.whl
Algorithm Hash digest
SHA256 9bea407d5dbbe0e5500ada41a6ad401c8c3da882e8b4795d8a3d68fccf01694b
MD5 9484abb718a8b06378b92681f3d14469
BLAKE2b-256 f0cfca36e55fc5b1ee53640faf5a6576de1740c95a8b45eabe19b3a0522fbc2a

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page