# guclaw

**Repository Path**: wukhai/guclaw

## Basic Information

- **Project Name**: guclaw
- **Description**:  GuClaws (金谷龙虾) - AI 智能体量化交易系统。支持自然语言对话生成策略、多市场（A股/期货/MT5）高性能回测与实盘对接。纯本地部署，数据私有，助力交易者低门槛量化。

- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-31
- **Last Updated**: 2026-08-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: 量化交易, AI智能体, 本地部署, 回测引擎

## README

#  GuClaws (金谷龙虾) - AI 智能体量化交易系统

> 🚀 **当前版本**: v1.2.22 (2026.08)  
> 🐍 **核心框架**: Python 3.12+ | QwenPaw (AgentScope) | 本地化部署  
>  **支持市场**: A 股 (通达信/QMT) / 期货 (天勤) / MT5 (外汇/加密)

## 📖 项目简介
**GuClaws (金谷龙虾)** 是一款专为个人交易者和量化爱好者打造的**本地化 AI 智能体交易系统**。

它打破了传统量化开发的高代码门槛，通过深度集成 **QwenPaw (AgentScope)** 智能体框架，让你能用自然语言与 AI 对话，自动生成策略代码、执行回测、并对接实盘。系统采用**纯本地架构**，数据不出域，兼顾隐私安全与极速回测。

## ✨ 核心亮点
*   🤖 **AI 对话生成策略**: 无需精通 Python，告诉 AI 你的交易思路，它帮你写代码、查 Bug、做参数优化。
*    **全市场无缝接入**: 
    *   **A 股**: 支持通达信模拟盘 & 讯投 QMT 实盘对接。
    *   **期货**: 集成天勤量化 (TqSDK)，支持主力合约连续回测。
    *   **MT5**: 原生支持外汇、贵金属、加密货币 CFD 交易。
*   🛡️ **100% 本地运行**: 核心数据 (DuckDB/SQLite) 和策略逻辑均保存在本地，无云端依赖，回测速度提升 1000x。
*    **高性能回测引擎**: 内置分钟级/日线级回测，支持多标的池化架构与 T+0/T+1 双模交易机制。
*   🧠 **智能体协作**: 支持自定义 AI Bot 角色，可辅助盯盘、解读热点、甚至帮你写 Python 办公脚本。

## 🖥️ 系统架构
![输入图片说明](%E6%9E%B6%E6%9E%84.png)
整体架构逻辑自下而上分为四大核心层级：

1. 基础设施与数据层 (Infrastructure & Data Layer)
   • 数据存储：采用 DuckDB 与MongoDB混合存储方案，兼顾行情数据的高吞吐写入与业务数据的复杂查询。
   • 通信总线：基于 Redis 与 ZeroMQ 构建的消息队列，负责各微服务模块间的指令分发与状态同步。

2. 智能体核心层 (Agent Core - ClawM)
   • 意图引擎：集成大语言模型（LLM），负责解析用户自然语言指令，提取关键参数与操作意图。
   • 记忆中枢：包含短期上下文窗口（Context Window）与长期向量记忆库（Vector DB），支持跨会话的知识继承。
   • 任务编排：负责将复杂目标拆解为子任务 DAG（有向无环图），并调度给执行层。

3. 技能与执行层 (Skills & Execution Layer)
   • 量化引擎 (QuantM)：提供回测计算、信号生成与风控拦截功能。
   • 自动化执行 (BotM)：负责 API 对接（券商/交易所）、指令发送与结果回执。
   • 工具箱：包含代码解释器、网络爬虫、文件处理等通用工具。

4. 交互应用层 (Interaction Layer - Frontend)
   • 控制台：基于 Web 的可视化大屏，提供实时监控、日志审计与图表分析。
   • 对话终端：支持多模态输入，提供沉浸式的 AI 助手交互体验。


## 📦 快速开始 (安装指南)

### 1. 下载安装
*   *Full版*: [百度网盘链接](https://guclaw.hb.cn/download.html)
*   *STD版* [Gitee Releases](https://gitee.com/wukhai/guclaw/releases/download/v1.2.20/GuClaws_Setup_Std_1.2.22.exe)  `GuClaws_Setup_STD_1.2.22.exe` (约 85MB)

### 2. 环境要求
*   **OS**: Windows 10/11 (64 位)
*   **内存**: 16GB+ (推荐 32GB 以运行本地大模型)
*   **硬盘**: 256GB SSD (行情数据占用较大)

### 3. 安装步骤
1. 双击安装包运行，按提示完成安装。
2. ⚠️ **注意**: 若安装过程弹出 **Tesseract-OCR** 提示，请手动安装并确认路径为 `C:\Program Files\Tesseract-OCR`。
3. 安装完成后，桌面会生成 `GuClaws` (管理中心) 和 `GuClaw` (前端系统) 两个图标。
4. **首次启动**: 系统会自动采集全市场历史数据，预计耗时约 3 小时。请保持电脑常亮并关闭睡眠模式。

### 4. 开始量化
1. 打开 `GuClaws 管理中心` -> 点击 `启动 GuClaw`。
2. 使用默认账号登录 -> `新建 Bot` -> 配置量化。
3. 进入 `量化策略` 页面 -> 点击 `系统策略` -> 一键回测。

## 📸 界面预览
![输入图片说明](main.png)![输入图片说明](%E5%B9%B4%E5%8C%9675.png)
![输入图片说明](%E7%AE%A1%E7%90%86%E4%B8%AD%E5%BF%83.png)

## ⚠️ 风险提示与免责声明
*   **工具属性**: 本系统仅为技术辅助工具，提供策略编写与回测环境，**不提供任何投资建议或收益承诺**。
*   **回测实盘**: 历史回测数据不代表未来表现。实盘交易受滑点、流动性、网络延迟等影响，可能与回测存在较大差异。
*   **自主决策**: 用户需独立判断并自行承担交易风险。市场有风险，投资需谨慎。
*   **合规使用**: 请确保您对接第三方平台 (通达信/QMT/MT5) 的行为符合相关协议及当地法律法规。

##  交流与支持
*   📖 **官方文档**: 详见安装包内 `help.pdf` 或 [在线帮助](https://guclaw.hb.cn/help)
*   🐛 **问题反馈**: 请提交 [Gitee Issues](https://gitee.com/your_username/guclaws/issues)
*   💬 **技术交流群**: [QQ 群号预留] / 微信:w14104172 联系作者

---
© 2026 金谷龙虾研发团队. Powered by QwenPaw (AgentScope).