{"skill":{"slug":"mini-agent","displayName":"Mini-Agent","summary":"Mini-Max AI 编程助手 - 基于 MiniMax M2.5 模型的智能代码开发工具，支持文件操作、命令执行、代码编写等功能。适用于 OpenClaw Agent 系统。","description":"---\nname: mini-agent\ndescription: Mini-Max AI 编程助手 - 基于 MiniMax M2.5 模型的智能代码开发工具，支持文件操作、命令执行、代码编写等功能。适用于 OpenClaw Agent 系统。\nmetadata:\n  {\n    \"openclaw\":\n      {\n        \"requires\": { \"bins\": [\"mini-agent\"] },\n        \"install\":\n          [\n            {\n              \"id\": \"node\",\n              \"kind\": \"node\",\n              \"package\": \"mini-agent\",\n              \"bins\": [\"mini-agent\"],\n              \"label\": \"安装 Mini-Agent (uv)\",\n              \"command\": \"uv tool install git+https://github.com/MiniMax-AI/Mini-Agent.git\"\n            },\n          ],\n      },\n  }\n---\n\n# Mini-Agent Skill\n\n## 概述\n\nMini-Agent 是一个基于 MiniMax M2.5 大语言模型的智能助手框架，专为 OpenClaw Agent 系统设计。它能够帮助你完成各种任务，包括文件操作、代码编写、系统管理等。\n\n## 能力\n\n### 1. 文件操作\n- **读取文件**: 读取任意文本文件内容，支持大文件分块读取\n- **写入文件**: 创建新文件或完全覆盖已有文件\n- **编辑文件**: 使用精确字符串替换的方式修改文件内容\n\n### 2. 命令执行\n- **bash 命令**: 执行 Linux/Unix 系统命令\n- **后台进程**: 支持启动和管理长时间运行的进程\n- **进程监控**: 查看后台进程输出、终止进程\n\n### 3. 知识管理\n- **技能查询**: 获取其他 skill 的使用说明和内容\n- **笔记记录**: 记录重要信息供后续参考\n\n## 工作原理\n\n```\n用户请求 → LLM 思考 → 工具调用 → 执行结果 → 循环迭代 → 最终响应\n```\n\n1. **接收请求**: Mini-Agent 接收用户的自然语言指令\n2. **智能分析**: LLM 分析任务需求，制定执行计划\n3. **工具调用**: 根据需要调用合适的工具（read_file, write_file, bash 等）\n4. **结果处理**: 分析工具执行结果，决定下一步操作\n5. **循环迭代**: 重复执行直到任务完成\n\n## 配置说明\n\n### 配置文件位置\n`~/.mini-agent/config/config.yaml`\n\n### 配置项说明\n\n```yaml\napi_key: \"your-api-key\"      # MiniMax API 密钥\napi_base: \"https://api.minimaxi.com\"  # API 端点地址\nmodel: \"MiniMax-M2.5\"        # 使用的模型名称\n```\n\n### 工作目录\n- **当前工作空间**: `/home/pi/.openclaw/agents/xiaoma`\n- **所有相对路径**都以此目录为基准\n\n## 使用方法\n\n### 基本语法\n\n由于 Mini-Agent 通常通过 OpenClaw 系统调用，你可以通过以下方式使用：\n\n1. **通过 Agent 界面**: 在 OpenClaw Dashboard 中选择对应的 Agent\n2. **通过 API**: 发送请求到 Agent 的 API 端点\n\n### 示例命令\n\n#### 文件操作示例\n\n```bash\n# 读取文件\n读取 /home/pi/.openclaw/workspace/dashboard/index.html 文件\n\n# 写入文件\n在当前目录下创建一个新文件 test.md，内容为：# Test\n\n# 编辑文件\n修改 config.yaml 文件，将 model 字段改为 \"MiniMax-M2.6\"\n```\n\n#### 代码开发示例\n\n```bash\n# 帮我写一个 Python 脚本\n写一个 Python 脚本，实现读取 CSV 文件并统计行数\n\n# 修复 Bug\n修复 /home/pi/project/main.py 中的空指针错误\n\n# 代码审查\n查看 /home/pi/project/utils.js 文件，给出代码优化建议\n```\n\n#### 系统操作示例\n\n```bash\n# 执行系统命令\n列出当前目录下所有以 .md 结尾的文件\n\n# 启动服务\n在后台启动一个 HTTP 服务器，端口 8080\n```\n\n## 可用工具\n\n| 工具名称 | 功能描述 |\n|---------|---------|\n| `read_file` | 读取文件内容 |\n| `write_file` | 写入/创建文件 |\n| `edit_file` | 编辑文件（精确替换） |\n| `bash` | 执行 Shell 命令 |\n| `bash_output` | 查看后台进程输出 |\n| `bash_kill` | 终止后台进程 |\n| `get_skill` | 获取其他技能说明 |\n| `record_note` | 记录重要笔记 |\n\n## 日志说明\n\n### 日志位置\n`~/.mini-agent/log/`\n\n### 日志格式\n日志文件采用时间戳命名，如：`agent_run_20260302_023022.log`\n\n每个日志包含：\n- **REQUEST**: LLM 收到的请求（包含 messages 和 tools）\n- **RESPONSE**: LLM 的响应（包含思考过程和工具调用）\n- **TOOL_RESULT**: 工具执行结果\n\n## 最佳实践\n\n### 1. 明确任务描述\n- 提供清晰、具体的任务描述\n- 说明期望的输出格式\n- 指出需要注意的约束条件\n\n### 2. 逐步完成任务\n- 复杂任务拆分为多个简单步骤\n- 每完成一步检查结果\n- 及时修正方向\n\n### 3. 利用上下文\n- 可以在同一会话中连续操作\n- Agent 会记住之前的操作和结果\n- 合理利用可以提高效率\n\n## 常见问题\n\n### Q: Mini-Agent 支持哪些编程语言？\nA: Mini-Agent 基于 LLM，理论上支持所有主流编程语言，包括但不限于 Python、JavaScript、Java、C++、Go、Rust 等。\n\n### Q: 如何处理大文件？\nA: 可以使用 `read_file` 的 `limit` 和 `offset` 参数分块读取大文件。\n\n### Q: 后台进程如何管理？\nA: 使用 `bash` 的 `run_in_background=true` 参数启动后台进程，通过 `bash_output` 查看输出，`bash_kill` 终止进程。\n\n### Q: 如何查看历史操作？\nA: 查看 `~/.mini-agent/log/` 目录下的日志文件。\n\n## 相关链接\n\n- [MiniMax 官网](https://www.minimaxi.com)\n- [OpenClaw 项目](https://github.com/openclaw)\n- 配置文件: `~/.mini-agent/config/config.yaml`\n- 日志目录: `~/.mini-agent/log/`\n","topics":["代码开发","编程","开发"],"tags":{"latest":"1.0.0"},"stats":{"comments":0,"downloads":876,"installsAllTime":33,"installsCurrent":0,"stars":0,"versions":1},"createdAt":1772390878987,"updatedAt":1779077485556},"latestVersion":{"version":"1.0.0","createdAt":1772390878987,"changelog":"Initial release","license":null},"metadata":{"setup":[],"os":null,"systems":null},"owner":{"handle":"l1-m1ng","userId":"s17d97fghp646dan1j2g1w0nc18849e3","displayName":"L1-M1ng","image":"https://avatars.githubusercontent.com/u/54474696?v=4"},"moderation":{"isSuspicious":false,"isMalwareBlocked":false,"verdict":"clean","reasonCodes":["review.llm_review"],"summary":"Review: review.llm_review","engineVersion":"v2.4.24","updatedAt":1780089733163}}