modbender Mini-Agent Skill
概述
Mini-Agent 是一个基于 MiniMax M2.5 大语言模型的智能助手框架，专为 OpenClaw Agent 系统设计。它能够帮助你完成各种任务，包括文件操作、代码编写、系统管理等。
能力
1. 文件操作
- 读取文件: 读取任意文本文件内容，支持大文件分块读取
- 写入文件: 创建新文件或完全覆盖已有文件
- 编辑文件: 使用精确字符串替换的方式修改文件内容
2. 命令执行
- bash 命令: 执行 Linux/Unix 系统命令
- 后台进程: 支持启动和管理长时间运行的进程
- 进程监控: 查看后台进程输出、终止进程
3. 知识管理
- 技能查询: 获取其他 skill 的使用说明和内容
- 笔记记录: 记录重要信息供后续参考
工作原理
用户请求 → LLM 思考 → 工具调用 → 执行结果 → 循环迭代 → 最终响应
- 接收请求: Mini-Agent 接收用户的自然语言指令
- 智能分析: LLM 分析任务需求，制定执行计划
- 工具调用: 根据需要调用合适的工具（read_file, write_file, bash 等）
- 结果处理: 分析工具执行结果，决定下一步操作
- 循环迭代: 重复执行直到任务完成
配置说明
配置文件位置
~/.mini-agent/config/config.yaml
配置项说明
api_key: "your-api-key" # MiniMax API 密钥
api_base: "https://api.minimaxi.com" # API 端点地址
model: "MiniMax-M2.5" # 使用的模型名称
工作目录
- 当前工作空间:
/home/pi/.openclaw/agents/xiaoma - 所有相对路径都以此目录为基准
使用方法
基本语法
由于 Mini-Agent 通常通过 OpenClaw 系统调用，你可以通过以下方式使用：
- 通过 Agent 界面: 在 OpenClaw Dashboard 中选择对应的 Agent
- 通过 API: 发送请求到 Agent 的 API 端点
示例命令
文件操作示例
# 读取文件
读取 /home/pi/.openclaw/workspace/dashboard/index.html 文件
# 写入文件
在当前目录下创建一个新文件 test.md，内容为：# Test
# 编辑文件
修改 config.yaml 文件，将 model 字段改为 "MiniMax-M2.6"
代码开发示例
# 帮我写一个 Python 脚本
写一个 Python 脚本，实现读取 CSV 文件并统计行数
# 修复 Bug
修复 /home/pi/project/main.py 中的空指针错误
# 代码审查
查看 /home/pi/project/utils.js 文件，给出代码优化建议
系统操作示例
# 执行系统命令
列出当前目录下所有以 .md 结尾的文件
# 启动服务
在后台启动一个 HTTP 服务器，端口 8080
可用工具
| 工具名称 | 功能描述 |
|---|---|
read_file |
读取文件内容 |
write_file |
写入/创建文件 |
edit_file |
编辑文件（精确替换） |
bash |
执行 Shell 命令 |
bash_output |
查看后台进程输出 |
bash_kill |
终止后台进程 |
get_skill |
获取其他技能说明 |
record_note |
记录重要笔记 |
日志说明
日志位置
~/.mini-agent/log/
日志格式
日志文件采用时间戳命名，如：agent_run_20260302_023022.log
每个日志包含：
- REQUEST: LLM 收到的请求（包含 messages 和 tools）
- RESPONSE: LLM 的响应（包含思考过程和工具调用）
- TOOL_RESULT: 工具执行结果
最佳实践
1. 明确任务描述
- 提供清晰、具体的任务描述
- 说明期望的输出格式
- 指出需要注意的约束条件
2. 逐步完成任务
- 复杂任务拆分为多个简单步骤
- 每完成一步检查结果
- 及时修正方向
3. 利用上下文
- 可以在同一会话中连续操作
- Agent 会记住之前的操作和结果
- 合理利用可以提高效率
常见问题
Q: Mini-Agent 支持哪些编程语言？
A: Mini-Agent 基于 LLM，理论上支持所有主流编程语言，包括但不限于 Python、JavaScript、Java、C++、Go、Rust 等。
Q: 如何处理大文件？
A: 可以使用 read_file 的 limit 和 offset 参数分块读取大文件。
Q: 后台进程如何管理？
A: 使用 bash 的 run_in_background=true 参数启动后台进程，通过 bash_output 查看输出，bash_kill 终止进程。
Q: 如何查看历史操作？
A: 查看 ~/.mini-agent/log/ 目录下的日志文件。
相关链接
- MiniMax 官网
- OpenClaw 项目
- 配置文件:
~/.mini-agent/config/config.yaml - 日志目录:
~/.mini-agent/log/