nanoClaw/README.md

NanoClaw

基于 GLM 大语言模型的 AI 对话应用，支持工具调用、思维链和流式回复。

功能特性

• 💬 多轮对话 - 支持上下文管理的多轮对话
• 🔧 工具调用 - 网页搜索、代码执行、文件操作等
• 🧠 思维链 - 支持链式思考推理
• 📊 Token 统计 - 按日/周/月统计使用量
• 🔄 流式响应 - 实时 SSE 流式输出
• 💾 多数据库 - 支持 MySQL、SQLite、PostgreSQL

快速开始

1. 安装依赖

pip install -e .

2. 配置

复制并编辑 config.yml：

# Port
backend_port: 3000
frontend_port: 4000

# AI API
api_key: {{your-api-key}}
api_url: https://open.bigmodel.cn/api/paas/v4/chat/completions

# Available models
models:
  - id: glm-5
    name: GLM-5
  - id: glm-5-turbo
    name: GLM-5 Turbo
  - id: glm-4.5
    name: GLM-4.5
  - id: glm-4.6
    name: GLM-4.6
  - id: glm-4.7
    name: GLM-4.7

default_model: glm-5

# Database Configuration
# Supported types: mysql, sqlite, postgresql
db_type: sqlite

# MySQL/PostgreSQL Settings (ignored for sqlite)
db_host: localhost
db_port: 3306
db_user: root
db_password: "123456"
db_name: nano_claw

# SQLite Settings (ignored for mysql/postgresql)
db_sqlite_file: nano_claw.db

3. 启动后端

python -m backend.run

4. 启动前端

cd frontend
npm install
npm run dev

项目结构

backend/
├── models.py        # SQLAlchemy 数据模型
├── routes/          # API 路由
├── services/        # 业务逻辑
│   ├── chat.py      # 聊天补全服务
│   └── glm_client.py
├── tools/           # 工具系统
│   ├── core.py      # 核心类
│   ├── executor.py  # 工具执行器
│   └── builtin/     # 内置工具
└── utils/           # 辅助函数

frontend/
└── src/
    ├── api/         # API 请求层
    ├── components/  # Vue 组件
    └── views/       # 页面

API 概览

方法	路径	说明
POST	/api/conversations	创建会话
GET	/api/conversations	会话列表
GET	/api/conversations/:id/messages	消息列表
POST	/api/conversations/:id/messages	发送消息（SSE）
GET	/api/tools	工具列表
GET	/api/stats/tokens	Token 统计

内置工具

分类	工具
爬虫	web_search, fetch_page, crawl_batch
数据处理	calculator, text_process, json_process
代码执行	execute_python（沙箱环境）
文件操作	file_read, file_write, file_list 等
天气	get_weather

文档

• 后端设计 - 架构设计、类图、API 文档
• 工具系统 - 工具开发指南

技术栈

• 后端: Python 3.11+, Flask
• 前端: Vue 3
• 大模型: GLM API（智谱AI）