AI导哈

轻量级Python代理框架

Nano Claw是一个轻量级Python代理框架，专注于实用的本地工作流程，支持工具调用、MCP集成、技能管理、内存上下文和人工审批循环。

  • by KylinMountain
  • Python
  • 本地部署
  • 4 星标
  • 更新于
在 GitHub 查看 KylinMountain/nano-claw

使用说明

纳米爪

英语 | 简体中文

受Gemini CLI启发的轻量级Python代理框架，专注于实用的本地工作流：

  • 带有工具调用的代理循环
  • MCP集成
  • 技能（逐步披露）
  • 内存上下文
  • 人在环审批

快速开始

git clone https://github.com/yourusername/nano-claw.git
cd nano-claw
pip install -r requirements.txt
cp config.example.yaml config.yaml

在中设置API密钥 config.yaml （或环境变量），然后运行：

python main.py -c config.yaml

运行模式

1) main.py （推荐）

  • 阅读 config.yaml
  • 从配置初始化MCP
  • 支持以下命令 /mcp, /mode, /skills
python main.py -c config.yaml

2) cli.py （更轻的交互式外壳）

  • 主要使用环境变量
  • 更好的即时互动(prompt_toolkit)
export OPENAI_API_KEY="your-key"
python cli.py

配置

起点 config.example.yaml:

cp config.example.yaml config.yaml

重要字段：

  • llm.provider: openai 或 gemini
  • agent.approval_mode: plan / default / yolo / read_only
  • skills.directories：技能搜索路径
  • mcp.servers：MCP服务器定义

项目结构

core/         # agent loop, policy, llm client, types
tools/        # built-in / advanced / universal tools
skills/       # skill loader and activation
memory/       # memory manager
mcp_client/   # MCP connection and adapters
examples/     # demos
tests/        # tests

备注

  • config.yaml 默认情况下被git忽略（以避免密钥泄漏）。
  • 使用 config.example.yaml 用于共享配置结构。
  • 如果您以前使用过 nano_agent，此项目现在重命名为 nano_claw.

发展

python -m pytest tests/
python examples/basic_demo.py
python examples/mcp_demo.py

许可证

MIT。看 LICENSE.

相关 MCP