mini-claw
经 AI Skill Hub 精选评估，mini-claw 获评「强烈推荐」。这款Agent工作流在功能完整性、社区活跃度和易用性方面表现出色，AI 评分 8.0 分，适合有一定技术背景的用户使用。
📚 深度解析
mini-claw 工作流的设计遵循"最小配置，最大复用"原则：核心逻辑已经封装好，用户只需配置自己的 API Key 和业务参数即可快速上手。工作流内置错误处理和重试机制，在网络波动或 API 限速等情况下仍能稳定运行，适合作为生产环境的自动化基础设施。
在实际部署时，建议先在测试环境中运行 3-5 次，验证各个环节的输出结果符合预期，再部署到生产环境。AI Skill Hub 评分 8.0 分，是同类 Agent 工作流中的精选推荐。
📋 工具概览
mini-claw 是一套完整的 AI Agent 自动化工作流方案。通过可视化的节点编排，将复杂的多步骤任务拆解为清晰的自动化流程，实现全程无人值守的智能处理。支持与数百种外部服务和 API 无缝集成，适合构建数据处理管线、业务自动化和 AI 辅助决策系统。
📖 中文文档
mini-claw 是一套完整的 AI Agent 自动化工作流方案。通过可视化的节点编排，将复杂的多步骤任务拆解为清晰的自动化流程，实现全程无人值守的智能处理。支持与数百种外部服务和 API 无缝集成，适合构建数据处理管线、业务自动化和 AI 辅助决策系统。
- 可视化 Agent 工作流编排，无需编写复杂代码
- 支持多步骤自动化任务链，实现全流程无人值守
- 与外部 API、数据库和第三方服务无缝集成
- 内置错误处理与自动重试机制，保障稳定运行
- 提供可复用的自动化模板，快速在同类场景部署
- 自动化日常重复性工作，将精力集中于创造性任务
- 构建数据采集 → 处理 → 输出的完整自动化管线
- 实现跨平台、跨系统的数据流转和业务协同
# 方式一：npm 全局安装 npm install -g mini-claw # 方式二：npx 直接运行（无需安装） npx mini-claw --help # 方式三：项目依赖安装 npm install mini-claw # 方式四：从源码运行 git clone https://github.com/htlin222/mini-claw cd mini-claw npm install npm start
- 访问 GitHub 仓库获取工作流文件
- 在对应平台（Dify / Flowise / Make 等）中找到「导入工作流」功能
- 上传工作流文件
- 按照提示配置必要的环境变量和 API Key
- 运行测试确认流程正常后投入使用
# 命令行使用
mini-claw --help
# 基本用法
mini-claw [options] <input>
# Node.js 代码中使用
const mini_claw = require('mini-claw');
const result = await mini_claw.run(options);
console.log(result);
# mini-claw 配置说明 # 查看配置选项 mini-claw --config-example > config.yml # 常见配置项 # output_dir: ./output # log_level: info # workers: 4 # 环境变量（覆盖配置文件） export MINI_CLAW_CONFIG="/path/to/config.yml"
简介
Features
- Persistent Sessions - Conversations are saved and auto-compacted
- Workspace Navigation - Change directories with
/cd, run shell commands with/shell - Session Management - Archive, switch, and clean up old sessions
- File Attachments - Automatically sends files created by Pi (PDF, images, documents)
- Rate Limiting - Prevents message spam (configurable cooldown)
- Access Control - Optional allowlist for authorized users
- Typing Indicators - Shows activity while AI is processing
Prerequisites
- Node.js 22+
- pnpm
- Pi coding agent installed globally
Installation
```bash
Clone and install
git clone https://github.com/htlin222/mini-claw cd mini-claw pnpm install
Deployment
Quick Start
Configure bot token
cp .env.example .env
Edit .env with your TELEGRAM_BOT_TOKEN
Configuration
```bash
Optional
MINI_CLAW_WORKSPACE=/path/to/workspace # Default: ~/mini-claw-workspace MINI_CLAW_SESSION_DIR=~/.mini-claw/sessions PI_THINKING_LEVEL=low # low | medium | high ALLOWED_USERS=123456,789012 # Comma-separated user IDs
Web search (optional)
BRAVE_API_KEY=your_brave_api_key # For Pi web search skill ```
Troubleshooting
mini-claw 是一个功能强大的交互式工具，旨在为开发者提供流畅的对话与任务执行体验。它通过集成先进的 AI 能力，能够处理复杂的指令并实现高效的任务自动化，是提升开发效率的理想助手。
mini-claw 提供了一系列进阶功能：支持 Persistent Sessions，对话内容会自动保存并进行压缩管理；具备 Workspace Navigation 能力，可通过 /cd 和 /shell 命令直接进行目录切换与 Shell 命令执行；拥有完善的 Session Management 系统，支持存档、切换及清理旧会话；支持 File Attachments，可自动发送由 Pi 生成的文件（如 PDF、图像、文档）；此外还内置了 Rate Limiting 机制，通过可配置的冷却时间防止消息滥用。
在使用 mini-claw 之前，请确保您的开发环境已安装 Node.js 22 或更高版本，并使用 pnpm 作为包管理工具。此外，系统必须全局安装 [Pi coding agent](https://github.com/badlogic/pi-mono)，这是实现核心功能的关键依赖。
您可以通过克隆仓库并使用 pnpm 进行本地安装。首先执行 `git clone https://github.com/htlin222/mini-claw` 进入项目目录，随后运行 `pnpm install` 完成依赖安装。项目也支持通过 Docker 等方式进行部署，具体请参考官方文档的 Deployment 部分。
项目已提供 Quick Start 指南，帮助开发者快速上手。您可以根据引导进行初步测试，确保环境配置正确后，即可开始通过交互式指令与 mini-claw 进行协作。
在启动项目前，您需要进行环境配置。请先将 `.env.example` 文件复制并重命名为 `.env`，然后使用编辑器打开该文件，填入您的 TELEGRAM_BOT_TOKEN。通过这种方式，您可以安全地管理 API 密钥及其他关键运行参数。
如果在运行过程中遇到问题，请查阅 Troubleshooting 章节。该部分汇总了常见的错误场景及解决方案，帮助您快速定位并解决环境或配置方面的问题。
高质量的AI工作流项目，值得关注
- 构建多智能体协作系统的 Agent 开发者
- Agent 任务先做 dry-run 验证工具调用链，再开启自主执行
- API key 直接提交到 git 仓库（请用 .env 并加入 .gitignore）
- 云端托管：可放在 Vercel / Railway / Fly.io 等 PaaS 平台
⚡ 核心功能
- 可视化 Agent 工作流编排，无需编写复杂代码
- 支持多步骤自动化任务链，实现全流程无人值守
- 与外部 API、数据库和第三方服务无缝集成
- 内置错误处理与自动重试机制，保障稳定运行
- 提供可复用的自动化模板，快速在同类场景部署
- 构建多智能体协作系统的 Agent 开发者
- Agent 任务先做 dry-run 验证工具调用链，再开启自主执行
- API key 直接提交到 git 仓库（请用 .env 并加入 .gitignore）
👥 适合人群
🎯 使用场景
- 自动化日常重复性工作，将精力集中于创造性任务
- 构建数据采集 → 处理 → 输出的完整自动化管线
- 实现跨平台、跨系统的数据流转和业务协同
⚖️ 优点与不足
- +MIT 协议，可免费商用
- +大幅减少重复性人工操作
- +可视化流程，清晰直观
- +可扩展性强，支持复杂场景
- −初始配置和调试需投入一定时间
- −强依赖外部服务的稳定性
- −复杂场景需具备一定技术基础
AI Skill Hub 为第三方内容聚合平台，本页面信息基于公开数据整理，不对工具功能和质量作任何法律背书。
建议在沙箱或测试环境中充分验证后，再部署至生产环境，并做好必要的安全评估。
✅ MIT 协议 — 最宽松的开源协议之一，可自由商用、修改、分发，仅需保留版权声明。
🔗 相关工具推荐
❓ 常见问题 FAQ
AI Skill Hub 点评：mini-claw 的核心功能完整，质量优秀。对于自动化工程师和运维人员来说，这是一个值得纳入个人工具库的选择。建议先在非生产环境试用，再逐步推广。
| 原始名称 | mini-claw |
| 原始描述 | 开源AI工作流：Telegram bot for persistent Claude/ChatGPT conversations using Pi agent — zero-c。⭐92 · TypeScript |
| Topics | ai-assistantai-automationchatbotchatgpt-integration |
| GitHub | https://github.com/htlin222/mini-claw |
| License | MIT |
| 语言 | TypeScript |
收录时间：2026-06-20 · 更新时间：2026-06-20 · License：MIT · AI Skill Hub 不对第三方内容的准确性作法律背书。
🤖 交给 Agent 安装 · mini-claw
选择 Agent 类型，复制安装指令后粘贴到对应客户端