MIA - Memory-Intelligent Assistant

MIA 是一个智能记忆助手系统，让 OpenClaw 具备"经验学习"能力 —— 不是每次遇到问题都从零开始，而是能记住过去如何解决类似问题，并在未来复用这些经验。

🎯 核心特性

通用结构匹配 —— 不依赖具体实体，识别问题的抽象模式
优胜劣汰 —— 只保留最高效的解决轨迹
无硬编码 —— 所有配置通过环境变量传入

🏗️ 架构组成

MIA 由三个核心模块组成：

模块	功能	路径
Memory	智能记忆存储与检索，支持优胜劣汰	`memory/`
Planner	任务规划与分解，支持参考历史优化	`planner/`
Feedback	执行反馈收集（仅针对全新问题）	`feedback/`

📋 工作流程

用户问题
    ↓
[MIA Memory] 检索相似轨迹（基于通用结构）
    ↓
[MIA Planner] 生成执行计划（参考历史或全新生成）
    ↓
[OpenClaw 执行者] 执行搜索、验证、生成答案
    ↓
[MIA Memory] 存储新轨迹（自动优胜劣汰）
    ↓
[MIA Feedback] 收集反馈（仅针对全新问题）

🚀 安装

cd /path/to/mia
npm install

⚙️ 配置

Planner 配置

环境变量	必需	默认值	说明
`MIA_PLANNER_MODE`	否	`local`	运行模式：`local` 或 `api`
`MIA_PLANNER_URL`	否	-	自定义API端点
`MIA_PLANNER_MODEL`	否	`Qwen3-8B`/`gpt-4`	模型名称
`MIA_PLANNER_API_KEY`	api模式必需	-	API密钥

本地部署示例：

export MIA_PLANNER_MODE=local
export MIA_PLANNER_URL=http://localhost:8000/v1/chat/completions
export MIA_PLANNER_MODEL=Qwen3-8B

OpenAI API 示例：

export MIA_PLANNER_MODE=api
export MIA_PLANNER_API_KEY=sk-xxx
export MIA_PLANNER_MODEL=gpt-4

阿里云 DashScope 示例：

export MIA_PLANNER_MODE=api
export MIA_PLANNER_API_KEY=sk-xxx
export MIA_PLANNER_URL=https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completions
export MIA_PLANNER_MODEL=qwen3-8b

Memory 配置

环境变量	默认值	说明
`MIA_MEMORY_FILE`	`./memory/memory.jsonl`	记忆文件路径
`MIA_SIMILARITY_THRESHOLD`	`0.90`	相似度阈值

Feedback 配置

环境变量	默认值	说明
`MIA_FEEDBACK_FILE`	`./feedback/feedback.jsonl`	反馈文件路径

📖 使用方式

Memory 模块

# 查找最相似的记忆
node memory/mia-memory.mjs search "你的问题"

# 存储新轨迹（自动优胜劣汰）
node memory/mia-memory.mjs store '{"question": "...", "plan": "...", "execution": [...]}'

# 列出记忆
node memory/mia-memory.mjs list [数量]

输出示例：

{
  "found": true,
  "similarity": 0.93,
  "record": { ... }
}

Planner 模块

# 生成 Plan（本地模式）
node planner/mia-planner.mjs "你的问题"

# 参考历史轨迹生成优化 Plan
node planner/mia-planner.mjs "你的问题" --reference "历史Plan文本"

输出示例：

{
  "question": "用户问题",
  "plan": "完整的计划文本",
  "steps": ["步骤1", "步骤2", "步骤3"],
  "reference_used": true,
  "model": "使用的模型",
  "timestamp": "2026-03-15T..."
}

Feedback 模块

# 存储反馈
node feedback/mia-feedback.mjs store "问题" "答案" "good"

# 列出反馈
node feedback/mia-feedback.mjs list [数量]

🔍 相似度计算原理

MIA Memory 提取以下通用结构特征（不依赖具体实体）：

特征	识别模式	说明
TIME_REF	那年、当年、时候、举办	时间参照
DUAL_ENTITY_COMPARE	A和B、A比B、谁更	双实体比较
ATTRIBUTE_CONFIRM	是不是、是否、都是	属性确认
NUMERIC_QUERY	多少、几、多大	数值查询
RELATIONSHIP_QUERY	关系、关联、联系	关系查询
RANKING_QUERY	第一、第二、冠军	排名查询

相似度权重：

结构特征相似度：50%
模板相似度：30%
语义相似度：20%

📊 效率评估

MIA Memory 的优胜劣汰机制基于以下指标：

指标	权重	说明
search_count	40%	搜索次数
step_count	30%	执行步骤数
success	30%	是否成功

新轨迹效率分数 > 旧轨迹 → 替换
新轨迹效率分数 ≤ 旧轨迹 → 丢弃

📝 注意事项

Planner 不执行搜索 —— 只生成 Plan，由调用者执行
Memory 严格优胜劣汰 —— 只保留最高效轨迹
Feedback 智能判断 —— 仅对全新问题收集反馈，避免打扰用户
所有配置通过环境变量 —— 无硬编码，灵活部署

📄 许可证

ISC

mia

Safety Notice

Copy this and send it to your AI assistant to learn