gugaclaw 1.0.2

多模型 AI 助手，具备 Agent 能力、可扩展技能系统与 MCP 工具集成

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