# MEMORY.md - 长期记忆

---

## 👤 用户信息

| 项目 | 内容 |
|------|------|
| 姓名 | 比利 (Wei Shen) |
| 称呼 | 比利哥 |
| 语言 | 中文对话 |
| 时区 | Asia/Shanghai (GMT+8) |

---

## 🏗️ 部署架构

| 项目 | 内容 |
|------|------|
| 星曜位置 | Mac Mini M4 |
| 同伴位置 | Ubuntu服务器 (同一局域网) |
| 部署类型 | OpenClaw分布式架构 |

---

## 🖥️ 服务器资产

### 服务器列表

| 服务器 | 内网IP | 外网域名 | FRP SSH端口 | Caddy反向代理 |
|--------|--------|----------|-------------|---------------|
| Mac Mini | 192.168.3.189 | macmini.ishenwei.online | 60026 | - |
| Ubuntu1 | 192.168.3.47 | ubuntu1.ishenwei.online | 60022 | - |
| Ubuntu2 | 192.168.3.45 | ubuntu2.ishenwei.online | 60024 | - |
| NAS | 192.168.3.17 | nas.ishenwei.online | 60023 | - |
| VPS1 | 192.227.222.142 | vps.ishenwei.online | 未配置 | ✅ |
| VPS2 | 104.194.92.188 | kiwi.ishenwei.online | 未配置 | - |

### 域名 -> 服务映射

| 域名 | 服务 | 服务器 |
|------|------|--------|
| n8n.ishenwei.online | n8n | macmini |
| vaultwarden.ishenwei.online | vaultwarden | macmini |
| it-tools.ishenwei.online | it-tools | macmini |
| drawio.ishenwei.online | drawio | macmini |
| grafana.ishenwei.online | grafana | ubuntu1 |
| superset.ishenwei.online | superset | ubuntu1 |
| tk.ishenwei.online | tiktok_pm | ubuntu1 |
| transmission.ishenwei.online | transmission | ubuntu1 |
| dashboard.ishenwei.online | homarr | ubuntu1 |
| tk-dev.ishenwei.online | tiktok_pm (dev) | ubuntu2 |
| nas.ishenwei.online | DSM | NAS |
| navidrome.ishenwei.online | navidrome | NAS |
| calibre.ishenwei.online | calibre-web | NAS |
| jellyfin.ishenwei.online | jellyfin | NAS |
| zipline.ishenwei.online | zipline | NAS |

### VPS1 详情

| 项目 | 内容 |
|------|------|
| IP | 192.227.222.142 |
| FRP端口 | 7000 |
| FRP管理面板 | 127.0.0.1:7400 (admin/admin) |
| Caddy配置 | /etc/caddy/Caddyfile |
| 代理域名 | *.ishenwei.online |

---

## 🐳 Docker 管理

### 配置文件
- **应用列表**: `~/.openclaw/workspace/managed-systems/docker-management/docker-apps.yaml`

### 服务器 Docker 路径

| 服务器 | Docker根目录 |
|--------|--------------|
| macmini | `/Users/weishen/docker/` |
| ubuntu1 | `/home/shenwei/Docker/` (大写D) |
| ubuntu2 | `/home/shenwei/docker/` (小写d) |
| NAS | `/volume1/docker/` |

### Docker 命令路径

| 服务器 | 命令方式 |
|--------|----------|
| macmini | `/usr/local/bin/docker` 或 `/opt/homebrew/bin/docker` |
| ubuntu1 | 直接 `docker` |
| ubuntu2 | 直接 `docker` |
| NAS | `/usr/local/bin/docker` (使用 `docker-compose` 旧版) |

### 管理流程
1. 从 `docker-apps.yaml` 查找应用目录
2. SSH到对应服务器: `ssh <服务器名>`
3. 进入目录执行: `docker compose up -d` / `docker compose down` / `docker compose restart`

> ⚠️ **注意**: 所有服务器已配置无密码直接运行 Docker 命令

---

## 🌐 FRP & 科学上网

### FRP 配置位置

| 服务器 | FRP目录 |
|--------|---------|
| macmini | `/opt/frp/frp_0.65.0_darwin_arm64` |
| ubuntu1 | `/opt/frp/frp_0.65.0_linux_amd64` |
| ubuntu2 | `/opt/frp/frp_0.65.0_linux_amd64` |

- 配置文件: `frpc.toml`

### 科学上网代理端口

| 服务器 | 代理地址 | 状态 |
|--------|----------|------|
| macmini | socks5://127.0.0.1:10808 | ✅ 正常 |
| ubuntu1 | socks5://127.0.0.1:10808 | ✅ 正常 |
| ubuntu2 | socks5://127.0.0.1:10808 | ✅ 正常 |
| NAS | socks5://127.0.0.1:20170 | ❌ 仅本机监听 |

### curl 检测命令

```bash
# 国内直连
curl -s -o /dev/null -w "%{http_code}" https://www.baidu.com

# 国外直连
curl -s -o /dev/null -w "%{http_code}" https://www.google.com

# 通过代理访问
curl -s -o /dev/null -w "%{http_code}" -x socks5://127.0.0.1:10808 https://www.google.com
```

> ⚠️ **NAS 特殊说明**: V2RayA 默认监听 127.0.0.1，不支持外部访问

---

## ⚙️ OpenClaw 管理

### 技能安装目录
- **正确路径**: `~/.openclaw/skills/`
- **错误路径**: `~/.openclaw/workspace/skills/`

### task-summary 技能
- **用途**: 记录任务总结
- **安装位置**: `~/.openclaw/skills/task-summary`

### Ubuntu 安装 (重要)

```bash
# 安装
npm install -g openclaw clawhub

# PATH 配置
export PATH=$HOME/.npm-global/bin:$PATH
echo 'export PATH=$HOME/.npm-global/bin:$PATH' >> ~/.bashrc
```

### Gateway 管理

```bash
# 启动/停止/重启
systemctl --user start openclaw-gateway
systemctl --user stop openclaw-gateway
systemctl --user restart openclaw-gateway

# 开机自启
systemctl --user enable openclaw-gateway
```

### 常用命令

| 命令 | 功能 |
|------|------|
| `openclaw --version` | 查看版本 |
| `openclaw status` | 查看状态 |
| `openclaw agents list` | 列出所有 agent |
| `openclaw agents add <name>` | 创建新 agent |

### 重要原则
1. **不要用 root 运行**
2. **统一使用普通用户** (shenwei)
3. **通过 systemctl 管理 Gateway**

---

## 📚 知识库与笔记

### Obsidian 笔记目录 (2026-03-23) ⭐
- **路径**: `/Users/weishen/Workspace/nexus`
- **说明**: 比利哥的 Obsidian 笔记根目录
- **备注**: 以后"obsidian笔记目录"即指此目录

### 知识库目录
- **路径**: `/Users/weishen/Workspace/nexus/openclaw/knowledgebase`
- **说明**: 比利哥的知识库

### 星曜个人笔记目录
- **路径**: `/Users/weishen/Workspace/nexus/openclaw/xingyao`
- **用途**: 星曜专用工作笔记

---

## 🔄 同步规则 ⭐ 重要

- **MEMORY.md 同步**: 每次更新 workspace 里的 MEMORY.md 后，必须同步复制到笔记目录
- **笔记目录**: `/Users/weishen/Workspace/nexus/openclaw/xingyao/MEMORY.md`

---

## 🧠 记忆习惯 ⭐ 每天必做

1. **每天第一次对话时**: 自动创建当天的记忆文件 `memory/YYYY-MM-DD.md`
2. **记录内容**: 对话中的重要操作、决策、用户要求等
3. **用户要求**: 当用户说"请记住xxxx"时必须记录到记忆文件
4. **永久记住**: 这个设定是每天必须执行的 routine

---

## 🔐 安全策略

- **管理方式**: 所有服务器通过SSH统一管理
- **权限原则**: 不存储sudo密码，所有操作通过SSH完成
- **安全级别**: 遵循最小权限原则
