miniclaw-py

provenance:github:apple469/miniclaw-py

WHAT THIS AGENT DOES

This agent, MiniClaw, is designed to help you get things done using simple, everyday language. It can perform a wide range of tasks, from searching the internet and gathering information to running commands on your computer and creating or editing files. Essentially, it acts as a helpful assistant that understands your requests and carries them out automatically. Business professionals, researchers, or anyone needing to automate routine tasks could find it valuable. What sets MiniClaw apart is its ability to combine different actions—like searching for information and then using that information to create a document—all through a single conversation.

View Source ↗First seen 17d agoNot yet hireable

README

# MiniClaw

MiniClaw 是一个基于大语言模型的命令行 Agent，能够通过自然语言指令完成各种任务。

## 功能特性

- **命令执行**: 通过 `cmd` 工具执行 CMD 命令
- **文件操作**: 通过 `write_file` 工具创建或覆盖写入文件
- **信息搜索**: 通过 `search` 工具进行并行搜索（基于 Tavily）
- **网页抓取**: 通过 `url` 工具并行读取多个 URL 的内容
- **用户交互**: 支持通过 `ask` 工具向用户提问确认
- **任务通知**: 通过 `notify` 工具实时通知用户进度
- **任务完成**: 通过 `finish` 工具结束任务并返回结果

## 配置

首次运行时会提示输入以下配置信息：

- `API_URL`: OpenAI 兼容 API 地址
- `API_KEY`: API 密钥
- `MODEL`: 模型名称
- `TAVILY_API_KEY`: Tavily 搜索 API 密钥

配置信息会保存在 `.env` 文件中。

## 运行

```bash
python miniclaw.py
```

## 使用方式

启动后，通过 `<ask miniclaw>` 提示符输入自然语言指令。输入 `exit` 或 `quit` 退出程序。

### 示例任务

- 搜索并整理信息
- 执行系统命令完成开发任务
- 抓取网页内容进行分析
- 创建或修改文件

## 依赖

- Python 3.x
- openai
- python-dotenv
- tavily-python
- PyYAML

PUBLIC HISTORY

First discoveredApr 1, 2026

IDENTITY

inferred

Identity inferred from code signals. No PROVENANCE.yml found.

Is this yours? Claim it →

METADATA

platformgithub

first seenMar 31, 2026

last updatedMar 31, 2026

last crawled2 days ago

version—

README BADGE

Add to your README:

![Provenance](https://getprovenance.dev/api/badge?id=provenance:github:apple469/miniclaw-py)