Leavesfly/TinyClaw

Última atividade de origem registrada: 15 de fevereiro de 2026 às 03:39

Catálogo do SkillsMP atualizado: 5 de novembro de 2026 às 19:57

skills coletadas: 1

Estrelas no GitHub: 38
Forks no GitHub: 11

Instalar com um assistente de IA

Copie este prompt para o assistente de IA que você usa.

Follow https://skillsmp.com/skill-install/prompt.md to install Agent Skills from https://github.com/Leavesfly/TinyClaw.

README do repositório

Arquivo de origem do README: README.md

Ler o README original

Expandir README completo

<div align="center"> # 🦞 TinyClaw **超轻量个人 AI 助手** — 用 Java 编写，支持多模型、多通道、多 Agent 协同、自我进化的一站式 AI Agent 框架 [![Java](https://img.shields.io/badge/Java-17-orange)](https://openjdk.org/) [![Maven](https://img.shields.io/badge/Maven-3.x-blue)](https://maven.apache.org/) [![License](https://img.shields.io/badge/License-MIT-green)](LICENSE) [![Version](https://img.shields.io/badge/Version-0.1.0-brightgreen)]() [English README](./README.en.md) </div> --- ### ✨ 特性一览 - **🤖 多模型支持** — 接入 OpenRouter、OpenAI、Anthropic、智谱 GLM、Gemini、阿里云、Groq、Ollama 等主流 LLM 提供商 - **💬 多通道消息** — 同时连接 Telegram、Discord、WhatsApp、飞书、钉钉、QQ、MaixCam 等平台 - **🤝 多 Agent 协同** — 7 种协同模式（辩论/团队/角色扮演/共识/层级/工作流/动态路由），内置工作流引擎 - **🧬 自我进化** — 3 种 Prompt 自动优化策略（文本梯度/OPRO/自我反思）+ 记忆进化 + 反馈收集 - **🔌 MCP 协议** — 完整的 MCP 客户端，支持 SSE、Stdio、Streamable HTTP 三种传输方式 - **🛠️ 丰富的内置工具** — 文件读写、Shell 执行、网络搜索、网页抓取、定时任务、子代理、Token 统计等 15 个工具 - **🧩 技能插件系统** — 通过 Markdown 定义技能，支持语义搜索匹配、从 GitHub 安装，Agent 可自主创建和改进技能 - **⏰ 定时任务引擎** — 支持 Cron 表达式、固定间隔和单次定时 - **🧠 记忆与上下文** — 长期记忆存储、会话摘要、分段式上下文构建 - **💓 心跳服务** — 定期自主思考，让 Agent 保持"活跃" - **🎤 语音转写** — 集成阿里云 DashScope Paraformer，支持语音消息自动转文字 - **🔒 安全沙箱** — 工作空间限制 + 命令黑名单 + Web 安全中间件，生产级安全防护 - **🌐 Agent 社交网络** — 支持接入 ClawdChat.ai，与其他 Agent 通信协作 - **🖥️ Web 控制台** — 内置 Web UI，17 个 REST API，可视化管理 Agent 状态、会话、模型、技能等 - **🎬 Demo 模式** — 一键演示核心功能 ![TinyClaw Logo](src/main/resources/tinyclaw.png) --- ### 📦 项目架构 ``` src/main/java/io/leavesfly/tinyclaw/ ├── TinyClaw.java # 应用入口，命令注册与分发 ├── TinyClawException.java # 框架统一异常基类 │ ├── bootstrap/ # 运行时装配（组合根） │ └── RuntimeAssembly.java # 集中构建对象图，保证 CronService / SecurityGuard / │ # SubagentManager 等有状态组件全进程仅一份实例 │ ├── agent/ # Agent 核心引擎 │ ├── AgentRuntime.java # 运行时容器 + 消息消费主循环（run/stop、Provider 热重载） │ ├── MessageRouter.java # 消息路由（用户/系统/指令） │ ├── ProviderManager.java # LLM Provider 管理与热重载 │ ├── ProviderComponents.java # Provider 切换时原子替换的组件集合 │ ├── ContextBuilder.java # 分段式上下文构建 │ ├── SessionSummarizer.java # 会话摘要与上下文压缩 │ └── context/ # 上下文分段模块（Identity/Bootstrap/Tools/Skills/Memory） ├── react/ # ReAct 执行循环 │ └── ReActExecutor.java # LLM 调用与工具迭代循环（流式/非流式、迭代上限保护） │ ├── bus/ # 消息总线（发布/订阅，入站/出站队列） ├── channels/ # 消息通道适配器（7 种平台 + 重连/Webhook/Token 管理） ├── cli/ # 命令行接口（12 个命令） ├── config/ # 配置模型与加载（20 个类，含 Loader/Migrator/Doctor） │ ├── collaboration/ # 多 Agent 协同编排（顶层包） │ ├── AgentOrchestrator.java # 协同调度器 │ ├── RoleAgent.java # 角色 Agent，协同发言的基本单元 │ ├── CollaborateTool.java # collaborate 工具入口（7 种协同模式） │ ├── CollaborationTopology.java # 协同关系拓扑快照（归一为 nodes/edges/layers） │ ├── CollaborationTopologyBuilder.java # 拓扑构建：讨论交互图/任务依赖图/层级图 │ ├── strategy/ # 协同策略（Discussion / Tasks / Workflow） │ └── workflow/ # 工作流引擎（6 种节点类型 + 断点续跑 + LLM 动态生成 + DAG 拓扑构建） ├── subagent/ # 子代理（顶层包） │ ├── SubagentManager.java # 子代理生成与任务跟踪 │ ├── SpawnTool.java # spawn 工具入口（同步 / 异步两种模式） │ ├── SubagentsLoader.java # 专职子代理定义加载（workspace > global > builtin） │ └── SubagentDefinition.java # AGENT.md 定义模型 ├── evolution/ # 自我进化引擎（顶层包） │ ├── PromptOptimizer.java # Prompt 自动优化 │ ├── VariantManager.java # Prompt 变体管理 │ ├── FeedbackManager.java # 反馈收集（评分/文字/隐式信号） │ ├── strategy/ # 优化策略（SelfReflection 等） │ └── reflection/ # 工具调用失败反思（记录→检测→挖掘→修复→应用） ├── hooks/ # Hooks 钩子（顶层包，6 种生命周期切点） │ ├── HookDispatcher.java # 事件调度与决策合并 │ ├── HookRegistry.java # 钩子注册表 │ ├── HookConfigLoader.java # ~/.tinyclaw/hooks.json 加载 │ └── CommandHookHandler.java # 命令型钩子执行（fail-open 语义） │ ├── plugins/ # 插件系统（顶层包，兼容 Claude Code / OpenClaw 插件） │ ├── PluginManager.java # 插件装配总线：发现 → 校验 → 注册 → 接入运行时 │ ├── PluginDiscovery.java # 多目录发现（workspace → ~/.tinyclaw → 配置路径） │ ├── ManifestParser.java # 插件清单解析 │ ├── PluginInstaller.java # 插件安装（本地路径 / GitHub / git 链接） │ ├── MarketplaceManager.java # 插件市场（<plugin>@<marketplace> 按名选装） │ ├── McpComponentAdapter.java # MCP 组件 → MCPServersConfig │ ├── HookComponentAdapter.java # hooks 组件 → HookRegistry │ └── AgentComponentAdapter.java # agent 组件 → collaboration AgentRole（命名角色库） │ ├── providers/ # LLM 调用抽象（HTTPProvider + StreamEvent + Failover） ├── mcp/ # MCP 协议集成（3 种传输方式） ├── tools/ # Agent 工具集（13 个内置工具 + ToolRegistry + MCP 桥接； │ # spawn / collaborate 分别位于 subagent/ 与 collaboration/） ├── skills/ # 技能系统（加载/注册/搜索/安装） ├── session/ # 会话管理与持久化（JSONL） ├── memory/ # 长期记忆（MemoryStore + MemoryEvolver + MemoryScope） ├── cron/ # 定时任务引擎（Cron / 固定间隔 / 单次 + 执行记录） ├── heartbeat/ # 心跳服务 ├── security/ # 安全沙箱（SecurityGuard + SecretStore / SecretResolver） ├── voice/ # 语音转写（AliyunTranscriber） ├── web/ # Web 控制台（17 个 REST API Handler + 静态资源 + 安全中间件） ├── logger/ # 结构化日志封装 └── util/ # 工具类（JSON 存储 / 媒体路径 / SSL / 字符串） ``` > **分层约定**：`bootstrap` 是唯一组合根，CLI 与网关都从同一个 `RuntimeAssembly` 取用运行时对象； > `agent` 只负责生命周期与上下文，实际的 LLM 调用与工具迭代下沉到 `react`； > `collaboration`、`subagent`、`evolution`、`hooks`、`plugins` 均为**顶层包**（不再是 `agent` 的子包）， > 各自通过 `CollaborateTool` / `SpawnTool` 等工具入口被主 Agent 调用，与引擎解耦。 --- ### 🚀 快速开始 #### 环境要求 - **Java 17** 或更高版本 - **Maven 3.x** - 至少一个 LLM API Key（推荐 [OpenRouter](https://openrouter.ai/keys) 或 [智谱 GLM](https://open.bigmodel.cn/)） #### 1. 构建项目 ```bash git clone <repo-url> cd TinyClaw mvn clean package -DskipTests ``` 构建完成后，可执行 JAR 位于 `target/tinyclaw-0.1.0.jar`。 #### 2. 初始化配置 ```bash java -jar target/tinyclaw-0.1.0.jar onboard ``` 该命令会： - 在 `~/.tinyclaw/config.json` 创建默认配置文件 - 在 `~/.tinyclaw/workspace/` 创建工作空间目录 - 生成模板文件（`AGENTS.md`、`SOUL.md`、`USER.md`、`IDENTITY.md`） #### 3. 配置 API Key 编辑 `~/.tinyclaw/config.json`，填入你的 API Key： ```json { "providers": { "openrouter": { "apiKey": "sk-or-v1-your-key-here", "apiBase": "https://openrouter.ai/api/v1" }, "zhipu": { "apiKey": "your-zhipu-key-here", "apiBase": "https://open.bigmodel.cn/api/paas/v4" }, "dashscope": { "apiKey": "sk-your-dashscope-key-here", "apiBase": "https://dashscope.aliyuncs.com/compatible-mode/v1" } } } ``` #### 4. 开始对话 ```bash # 单条消息模式 java -jar target/tinyclaw-0.1.0.jar agent -m "你好，介绍一下你自己" # 交互模式 java -jar target/tinyclaw-0.1.0.jar agent ``` --- ### 📖 命令参考 | 命令 | 说明 | 示例 | |------|------|------| | `onboard` | 初始化配置和工作空间 | `tinyclaw onboard` | | `agent` | 与 Agent 直接交互 | `tinyclaw agent -m "Hello"` | | `gateway` | 启动网关服务（连接所有通道） | `tinyclaw gateway` | | `status` | 查看系统状态和配置 | `tinyclaw status` | | `cron` | 管理定时任务 | `tinyclaw cron list` | | `skills` | 管理技能插件 | `tinyclaw skills list` | | `mcp` | 管理 MCP 服务器 | `tinyclaw mcp list` | | `demo` | 运行内置演示流程 | `tinyclaw demo agent-basic` | | `version` | 显示版本信息 | `tinyclaw version` | #### Agent 命令选项 ```bash tinyclaw agent [options] -m, --message <text> 发送单条消息并退出 -s, --session <key> 指定会话键（默认：cli:default） -d, --debug 启用调试模式 ``` #### Cron 命令选项 ```bash tinyclaw cron list # 列出所有定时任务 tinyclaw cron add --name "日报" \ --message "生成今日工作总结" \ --cron "0 18 * * *" # 每天 18:00 执行 tinyclaw cron add --name "心跳" \ --message "检查系统状态" \ --every 3600 # 每小时执行 tinyclaw cron remove <job_id> # 移除任务 tinyclaw cron enable <job_id> # 启用任务 tinyclaw cron disable <job_id> # 禁用任务 ``` #### Skills 命令选项 ```bash tinyclaw skills list # 列出已安装技能 tinyclaw skills list-builtin # 列出内置技能 tinyclaw skills install-builtin # 安装所有内置技能 tinyclaw skills install owner/repo/skill # 从 GitHub 安装 tinyclaw skills show <name> # 查看技能详情 tinyclaw skills remove <name> # 移除技能 ``` --- ### 🔌 支持的 LLM 提供商 | 提供商 | 配置字段 | 说明 | |--------|----------|------| | [OpenRouter](https://openrouter.ai/) | `providers.openrouter` | 聚合多模型网关，推荐首选 | | [OpenAI](https://platform.openai.com/) | `providers.openai` | GPT 系列模型 | | [Anthropic](https://www.anthropic.com/) | `providers.anthropic` | Claude 系列模型 | | [智谱 GLM](https://open.bigmodel.cn/) | `providers.zhipu` | GLM-4 系列，国内推荐 | | [Google Gemini](https://ai.google.dev/) | `providers.gemini` | Gemini 系列模型 | | [Groq](https://groq.com/) | `providers.groq` | 超快推理 | | [Ollama](https://ollama.ai/) | `providers.ollama` | 本地部署开源模型 | | [阿里云 DashScope](https://dashscope.aliyun.com/) | `providers.dashscope` | Qwen 系列模型（通义千问） | 所有提供商均通过统一的 `HTTPProvider` 适配 OpenAI 兼容 API 格式，切换模型只需修改配置。 --- ### 💬 支持的消息通道 | 通道 | 配置字段 | 所需凭证 | |------|----------|----------| | Telegram | `channels.telegram` | Bot Token | | Discord | `channels.discord` | Bot Token | | WhatsApp | `channels.whatsapp` | Bridge URL | | 飞书 | `channels.feishu` | App ID + App Secret | | 钉钉 | `channels.dingtalk` | Client ID + Client Secret | | QQ | `channels.qq` | App ID + App Secret | | MaixCam | `channels.maixcam` | Host + Port | 每个通道都支持 `allowFrom` 白名单配置，确保只有授权用户可以与 Agent 交互。 --- ### 🛠️ 内置工具 Agent 在对话中可以自主调用以下工具： | 工具 | 说明 | 安全特性 | |------|------|----------| | `read_file` | 读取文件内容 | ✓ 工作空间限制 | | `write_file` | 写入文件（创建或覆盖） | ✓ 工作空间限制 | | `append_file` | 追加内容到文件 | ✓ 工作空间限制 | | `edit_file` | 基于 diff 的精确文件编辑 | ✓ 工作空间限制 | | `list_dir` | 列出目录内容 | ✓ 工作空间限制 | | `exec` | 执行 Shell 命令 | ✓ 命令黑名单 + 工作目录限制 | | `web_search` | 网络搜索（Brave Search API） | - | | `web_fetch` | 抓取网页内容 | - | | `message` | 向指定通道发送消息 | - | | `cron` | 创建/管理定时任务 | - | | `spawn` | 生成子代理执行独立任务 | - | | `collaborate` | 启动多 Agent 协同（7 种模式） | - | | `social_network` | 与其他 Agent 通信（ClawdChat.ai） | - | | `skills` | 管理和查询技能插件 | - | | `token_usage` | 查询 Token 用量统计 | - | 此外，通过 MCP 协议接入的外部工具会自动注册到工具系统中，LLM 可直接调用。 --- ### 🤝 多 Agent 协同 TinyClaw 内置了完整的多 Agent 协同编排系统，通过 `collaborate` 工具触发： | 模式 | 说明 | |------|------| | `debate` | 正反方辩论，适合利弊权衡和方案评审 | | `team` | 任务分解为子任务，支持并行/串行执行 | | `roleplay` | 多角色对话模拟、场景演练 | | `consensus` | 多方讨论后投票达成共识 | | `hierarchy` | 层级汇报式决策，逐层汇总 | | `workflow` | 多步骤工作流，支持 LLM 动态生成工作流定义 | | `dynamic` | Router Agent 动态选择下一个发言者 | 工作流引擎支持 6 种节点类型：SINGLE / PARALLEL / SEQUENTIAL / CONDITIONAL / LOOP / AGGREGATE。 --- ### 🧬 自我进化 TinyClaw 内置自我进化引擎，Agent 能持续从交互中学习和改进： - **Prompt 自动优化**：3 种策略（文本梯度 / OPRO / 自我反思），自动改进系统提示 - **记忆进化**：从对话中提取长期记忆，跨会话保留重要信息 - **反馈收集**：支持显式评分、文字反馈和隐式信号 --- ### 🔌 MCP 协议集成 TinyClaw 实现了完整的 MCP（Model Context Protocol）客户端： | 传输方式 | 适用场景 | |----------|----------| | SSE | 远程 HTTP 服务器（Server-Sent Events） | | Stdio | 本地进程通信（标准输入/输出） | | Streamable HTTP | 远程 HTTP 服务器（流式 HTTP） | MCP 服务器的工具会自动注册到工具系统中，LLM 可直接调用。配置示例： ```json { "mcpServers": { "filesystem": { "command": "npx", "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/dir"], "timeout": 30 } } } ``` --- ### 🔒 安全防护 TinyClaw 通过 **SecurityGuard** 提供多层安全防护： - **工作空间沙箱**：所有文件操作限制在 workspace 目录内 - **命令黑名单**：阻止 `rm -rf`、`mkfs`、`sudo` 等危险命令 - **通道白名单**：每个通道配置 `allowFrom`，只有授权用户可交互 - **Web 安全中间件**：认证与 CORS 防护 - **路径规范化**：防止路径遍历攻击 --- ### 🖥️ Web 控制台网关模式下，访问 `http://localhost:18791` 可使用 Web 控制台： - 实时对话（支持 SSE 流式输出） - 会话管理与历史记录 - 协同关系拓扑可视化（讨论交互图 / 工作流 DAG / 任务依赖图 / 层级汇报图，手写 SVG 零依赖，协同执行中实时点亮节点） - 模型切换（运行时热重载） - Provider 管理 - 通道状态监控 - 技能管理 - 定时任务管理 - MCP 服务器管理 - 文件浏览与上传 - Token 用量统计 - 用户反馈收集 --- ### 🧩 技能系统技能是通过 Markdown 文件定义的 Agent 能力扩展： ```markdown --- name: my-skill description: "我的自定义技能" --- # My Skill 当用户要求执行某某任务时，按照以下步骤操作： 1. ... 2. ... ``` - 支持从 workspace / global / builtin 三个目录加载 - 支持从 GitHub 安装社区技能 - 支持基于用户输入的**语义搜索匹配**，只注入相关技能 - Agent 可通过 `skills` 工具自主创建、编辑和管理技能 --- ### 🌐 网关模式 ```bash java -jar target/tinyclaw-0.1.0.jar gateway ``` 启动后，网关会： 1. 加载配置并初始化 LLM 提供商 2. 初始化安全防护（SecurityGuard） 3. 注册所有内置工具 4. 初始化 MCP 服务器连接 5. 启动定时任务服务 6. 启动心跳服务（如已启用） 7. 连接所有已启用的消息通道 8. 启动 Web 控制台 9. 在后台运行 Agent 消息处理循环按 `Ctrl+C` 优雅关闭所有服务。 --- ### 🗂️ 工作空间结构 ``` ~/.tinyclaw/ ├── config.json # 主配置文件 ├── workspace/ │ ├── AGENTS.md # Agent 行为指令 │ ├── SOUL.md # Agent 个性与价值观 │ ├── USER.md # 用户画像与偏好 │ ├── IDENTITY.md # Agent 身份描述 │ ├── memory/ # 长期记忆 │ │ ├── MEMORY.md │ │ └── HEARTBEAT.md │ ├── sessions/ # 会话持久化 │ ├── skills/ # 用户技能 │ ├── cron/ # 定时任务 │ │ └── jobs.json │ ├── evolution/ # 进化数据 │ │ └── prompts/ # Prompt 变体 │ └── collaboration/ # 协同记录 ``` --- ### 🎬 Demo 演示 ```bash # 一键演示模式 tinyclaw demo agent-basic # 本地 CLI 助手 tinyclaw agent # 网关 + 通道机器人 tinyclaw gateway # Web 控制台 open http://localhost:18791 # MCP 服务器管理 tinyclaw mcp list ``` --- ### 🧪 测试 ```bash mvn test # 运行所有测试 mvn test -Dtest=TinyClawTest # 运行指定测试类 ``` --- ### 🛣️ 技术栈 | 组件 | 技术 | |------|------| | 语言 | Java 17 | | 构建 | Maven | | HTTP 客户端 | OkHttp 4.12 | | JSON 处理 | Jackson 2.17 | | 日志 | SLF4J + Logback | | 命令行 | JLine 3.25 | | 定时任务 | cron-utils 9.2 | | 环境变量 | dotenv-java 3.0 | | 测试 | JUnit 5.10 + Mockito 5.10 | --- ### 📄 License [MIT License](https://opensource.org/licenses/MIT) — 自由使用、修改和分发。

Carregando o README do repositório…

Skills neste repositório

Desenvolvedores de software

1 categorias ocupacionais · 100% classificado

skill

ocupação

descrição

atualizado

skill-creator

Desenvolvedores de software

Create or update AgentSkills. Use when designing, structuring, or packaging skills with scripts, references, and assets.

Idioma do texto original: inglês

2026-02-15

Mostrando 1 de 1 skills coletadas.