# 2号机记忆 (2号机 / 守护者)

> 记忆更新时间: 2026-02-06 11:00 CST
> 上次整理: 2026-02-05

---

## 身份

- **Name:** 2号机
- **Code Name:** 守护者 (Guardian)
- **Creature:** AI Assistant
- **Vibe:** Sharp, efficient, reliable
- **Emoji:** 🛡️

### 核心职责

- 🛡️ **系统守护者** - 保证 OpenClaw 系统稳定运行
- 🤖 **助手培训者** - 帮助主人学习和掌握机器人的使用方法
- 📝 **记忆 keeper** - 维护跨会话记忆
- 📚 **文档化** - 定期总结归纳，重要内容文档化

---

## 用户

- **Name:** yh6788
- **Platform:** Telegram
- **ID:** 5117446326
- **Timezone:** Asia/Shanghai

### 用户偏好

- **主力模型:** MiniMax
- **备用模型:** DeepSeek
- **本地模型:** Ollama llama3
- **向量模型:** nomic-embed-text:latest
- **代理:** 7890 (192.168.0.66:7890)

### 沟通风格

- 简洁高效，避免废话
- 技术问题直接给方案
- 系统性问题需要深入分析根因
- 重视记忆的连贯性
- ✅ **任务完成后必须主动报告** - 收到任务后，完成时主动汇报结果

### Telegram 特性

- TG 是 Telegram 的简称
- 需要翻墙，网络可能暂时失效
- 断线期间消息会积累，连接后一起收到

---

## 青龙 (1号机)

- **别名:** 青龙 = 1号机
- **SSH:** root@192.168.0.31
- **密码:** 3efvVGY&
- **已知问题:** 内存持久化故障（已手动修复）
- **角色:** 备用节点/监控节点

### 硬件配置

| 项目 | 规格 |
|------|------|
| CPU | Intel Core i5 (4核心/4线程) |
| 内存 | 8GB DDR3 |
| 存储 | 256GB SSD |
| 网络 | 有线连接 |

### 性能优化方向

| 场景 | 推荐配置 | 说明 |
|------|----------|------|
| **轻量服务** | 2-3并发 | Ollama / 监控脚本 |
| **中等负载** | 1-2并发 | 可运行一个 Agent |
| **本地模型** | qwen2.5:3b / llama3:8b | 8GB 内存可流畅运行 |
| **向量化** | nomic-embed-text | 274MB，适合 256G SSD |

### 推荐应用

1. **监控服务** - system-monitor.sh (持续运行)
2. **轻量 Agent** - 独立会话处理简单任务
3. **本地 Ollama** - qwen2.5:3b (2GB) 或 llama3:8b (8GB需注意内存)
4. **备份节点** - 会话文件同步/故障转移

---

## 2号机 (本机)

- **机型:** ThinkPad X230
- **CPU:** Intel Core i7-3520M (3代, 2核心/4线程, 最高 3.6GHz)
- **内存:** 8GB DDR3
- **存储:** 500GB HDD (7200RPM)
- **系统:** Linux 6.17.0-12-generic
- **Node:** v22.22.0
- **运行位置:** /root/.openclaw/workspace

### 性能特点

| 项目 | 表现 | 说明 |
|------|------|------|
| CPU | 中等 | 3代 i7 办公足够，AI 推理较慢 |
| 内存 | 充足 | 8GB 可同时运行 Gateway + Ollama |
| 存储 | 瓶颈 | HDD 相比 SSD 读写慢很多 |
| 适合任务 | 办公/对话 | 不适合大规模向量计算 |

### 优化建议

- 避免大量文件 I/O 操作
- 本地模型用轻量级 (qwen2.5:3b)
- 监控脚本定期清理日志

```json
{
  "providers": {
    "minimax": { "models": { "default": "minimax-minimax" } },
    "deepseek": { "models": { "default": "deepseek-chat" } },
    "ollama": {
      "remote": { "baseUrl": "http://localhost:11434/v1" }
    }
  },
  "memorySearch": {
    "provider": "openai",
    "model": "nomic-embed-text:latest",
    "remote": { "baseUrl": "http://localhost:11434/v1" },
    "cache": { "enabled": true, "maxEntries": 50000 }
  }
}
```

### 代理配置

```bash
# /etc/environment
NO_PROXY="localhost,127.0.0.1,192.168.0.66"
no_proxy="localhost,127.0.0.1,192.168.0.66"
```

### 启动命令

```bash
NO_PROXY="localhost,127.0.0.1,192.168.0.66" openclaw gateway restart
```

---

## 技术经验库

### 问题排查清单

#### 1. Gateway 无法连接 Ollama

**症状:** `fetch failed` 或连接超时

**排查步骤:**
1. 检查 `NO_PROXY` 是否包含 Ollama 地址
2. Gateway 是普通进程，需手动设置环境变量
3. 执行: `NO_PROXY="192.168.0.66" openclaw gateway restart`

#### 2. Embedding 上下文超限

**症状:** `input length exceeds the context length`

**解决方案:**
```bash
sed -i 's/mxbai/nomic/' /root/.openclaw/openclaw.json
```

**模型对比:**
| 模型 | 大小 | 上下文 | 适用 |
|------|------|--------|------|
| mxbai-embed-large | 669MB | 短 (512) | 短文本 |
| nomic-embed-text | 274MB | 长 | 长文档 |

#### 3. Ollama 批量上传 404

**症状:** `batch file upload failed: 404`

**处理:** 正常现象，OpenClaw 自动降级到非批量模式，无需干预

#### 4. 监控脚本 awk 语法错误

**症状:** `awk: syntax error at or near %`

**修复:**
```bash
# 错误
mem_usage=$(awk "BEGIN {printf \"%.1f\", ($mem_used/$mem_total)*100}")

# 正确
mem_usage=$(echo "scale=1; $mem_used*100/$mem_total" | bc 2>/dev/null || echo "0.0")
```

#### 5. Compaction 卡死 (重点!)

**症状:**
- 系统无响应，会话中断
- Gateway 无法关闭 (`shutdown timed out`)
- 日志显示 `compaction retry` 反复出现

**根因:**
- 大会话文件 (9.6MB+) 导致 compaction 算法超时
- 重试机制没有熔断
- 阻塞整个 Gateway

**解决方案:**
```bash
# 1. 清理卡死的会话
rm /root/.openclaw/agents/main/sessions/[session-id].jsonl

# 2. 重启 Gateway
openclaw gateway restart

# 3. 预防: 调整配置 (可选)
# agents.defaults.compaction.enabled = false
```

**配置修复 (2026-02-06):**
- 改用 localhost Ollama (绕过代理)
- 切换到 nomic-embed-text (更长上下文)

---

## 学习习惯

1. ✅ 定期总结归纳 (每日/每周)
2. ✅ 重要内容写文档 (`/root/doc/`)
3. ✅ 跨会话通过记忆延续 (`MEMORY.md`)
4. ✅ 技术方案成熟可靠后再记录

---

## 关键教训

### 历史问题 (已解决)

| 日期 | 问题 | 教训 |
|------|------|------|
| 2026-02-04 | 内存管理器缺少 embedding 模型 | 需单独配置 provider + embedding |
| 2026-02-05 | memorySearch.paths 配置无效 | OpenClaw 不支持自定义 paths，用 symlink 替代 |
| 2026-02-05 | Gateway 反复重启 | 不要手动添加 agents.memorySearch 配置 |
| 2026-02-06 | Compaction 卡死导致"死机" | 大会话需要分片或禁用 compaction |

### 核心认识

1. **Gateway 是普通进程** - 不继承 systemd 环境变量，需手动设置 NO_PROXY
2. **memorySearch 是独立 plugin** - 不走 agents.defaults 配置
3. **Symlink 解决路径问题** - OpenClaw 不支持 paths，用 `ln -s` 替代
4. **Compaction 不是必须的** - 可以禁用，不会影响对话功能

---

## 技术决策

### 优先级

1. **稳定 > 功能** - 宁可禁用功能，也不让系统崩溃
2. **简单 > 复杂** - 避免复杂的批量操作，单条处理更可靠
3. **监控 > 信任** - 关键操作要有日志和状态检查

### 决策记录

| 决策 | 选择 | 原因 |
|------|------|------|
| 向量模型 | nomic-embed-text | 长上下文适合文档索引 |
| 批量写入 | 禁用 | Ollama 不稳定，单条更可靠 |
| paths 配置 | symlink 替代 | OpenClaw 不支持自定义路径 |
| compaction | 监控为主 | 大文件会卡死，需要手动清理 |

---

## 系统状态

### 最后更新时间

- **日期:** 2026-02-06 11:00 CST
- **整理人:** 2号机 (自动整理)
- **源文件:** memory/2026-02-04.md, memory/2026-02-05.md

### 待办

- [ ] 测试 compaction 禁用后的系统表现
- [x] 建立会话文件大小监控 (超过 5MB 预警) - 2026-02-06
- [ ] 文档化 SSH 隧道配置
- [ ] 完善节点 (nodes) 监控体系

---

## 会话文件监控 (2026-02-06 新增)

### 监控配置

```bash
# 阈值设置
SESSION_WARN_SIZE=8MB      # 发送警告提醒
SESSION_NEW_SESSION_SIZE=5MB  # 建议开新会话
```

### 监控行为

| 条件 | 动作 |
|------|------|
| ≥8MB | Telegram 发送警告 (每增加1MB提醒一次) |
| ≥5MB | 记录日志，建议开新会话 |
| 完成后 | 用户手动开新会话，发送"新对话已就绪" |

### 脚本位置

- `/root/.openclaw/scripts/system-monitor.sh` - 监控主脚本
- `/root/.openclaw/scripts/send-session-alert.sh` - Telegram 提醒脚本
- `/var/log/openclaw-monitor/session-alerts.log` - 会话告警日志

### 日志示例

```
[SESSION WARN] 2026-02-06 12:00:00 会话文件过大: abc123 (8.5MB) - 建议开启新会话
```

### 限制说明

> ⚠️ **自动开新会话** 无法由监控脚本直接实现，因为会话管理是 OpenClaw Gateway 内部逻辑。脚本只能：
> 1. 监控并发送提醒
> 2. 记录日志供排查
> 
> 实际开新会话需要：
> - 用户手动重启 Gateway 或
> - 通过 OpenClaw API 创建新会话

---

## 重要提示

> **关于 compaction:** 每次大对话后可能会产生 9MB+ 的会话文件，这会导致 compaction 算法超时。建议监控会话文件大小，必要时手动清理。

> **关于代理:** NO_PROXY 必须包含所有本地服务地址 (localhost, 127.0.0.1, 192.168.0.66)

> **关于配置:** 不要手动修改 agents.memorySearch，memory plugin 有独立配置

---

*记忆版本: v2.0 (2026-02-06 整理)*