GugaClaw
多模型 AI 助手，具备 Agent 能力、可扩展技能系统与 MCP 工具集成。
安装
PyPI 安装（推荐）
pip install gugaclaw
gugaclaw start
从 GitHub 安装
pip install git+https://github.com/IceSniperring/gugaclaw.git
gugaclaw start
从源码运行
macOS / Linux:
git clone https://github.com/IceSniperring/gugaclaw.git
cd gugaclaw
pip install -e .
gugaclaw start
Windows (PowerShell):
git clone https://github.com/IceSniperring/gugaclaw.git
cd gugaclaw
pip install -e .
gugaclaw start
前置要求
- Python 3.11+
- Node.js 18+（前端运行需要）
Windows 用户注意
如果 PowerShell 执行脚本报错，请先运行：
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
命令行用法
gugaclaw start # 后台启动服务
gugaclaw stop # 停止服务
gugaclaw restart # 重启服务
gugaclaw status # 查看状态
gugaclaw logs -f # 实时日志
gugaclaw dev # 前台开发模式
gugaclaw config # 管理配置
gugaclaw tools # 列出工具
gugaclaw --help # 查看帮助
功能一览
| 功能 | 说明 |
|---|---|
| 多提供商支持 | OpenAI、Anthropic、MiMo、DeepSeek、Moonshot 等 |
| 三种输入模式 | Chat · Agent · 命令 |
| Agent 模式 | 文件操作、终端、搜索等 14 个内置工具 |
| Skill 系统 | AI 可创建/编辑/热重载技能 |
| MCP 集成 | 支持 stdio / SSE / Streamable HTTP |
| 危险命令审批 | 危险命令拦截，支持三级永久允许 |
| 智能上下文 | 基于 Token 管理，优先级保留，摘要压缩 |
配置
配置目录: ~/.gugaclaw/
| 文件 | 说明 |
|---|---|
providers.json |
API 提供商配置 |
db_config.json |
数据库配置（可选） |
allowed_commands.json |
永久允许的命令 |
skills/ |
用户技能目录 |
项目结构
gugaclaw/
├── gugaclaw/ # CLI 入口
├── server/ # FastAPI 后端
├── client/ # Next.js 前端
├── pyproject.toml # PyPI 配置
└── README.md
技术栈
后端： Python 3.11 · FastAPI · LangChain · SQLAlchemy · Redis
前端： Next.js · React · TypeScript · Tailwind CSS
License
MIT
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
gugaclaw-1.0.7.tar.gz
(341.2 kB
view details)
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
gugaclaw-1.0.7-py3-none-any.whl
(343.2 kB
view details)
File details
Details for the file gugaclaw-1.0.7.tar.gz.
File metadata
- Download URL: gugaclaw-1.0.7.tar.gz
- Upload date:
- Size: 341.2 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.2.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
02bd78cd2efd0a778e189454583a930c0218fcfc228604c47b335ee38423df5e
|
|
| MD5 |
1b93746589712d21ecc395edb9bf7327
|
|
| BLAKE2b-256 |
ca87504fd3953b7d459666d6c487b9e182a206aa889e11f6a63f39dd4bfa5a46
|
File details
Details for the file gugaclaw-1.0.7-py3-none-any.whl.
File metadata
- Download URL: gugaclaw-1.0.7-py3-none-any.whl
- Upload date:
- Size: 343.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.2.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
5da56fa674c1cf5648957fe5f94b9b767f65971cb5876e97d7e974bd3450ff1c
|
|
| MD5 |
fb8b2dea43165863a30112129c260d2f
|
|
| BLAKE2b-256 |
1a98a5db620fd1e3e79a9dab4ed3a2d4c55671b05584078e757f309b0549b091
|
