Llm Memory Integration

---
name: llm-memory-integration
description: LLM Memory Integration - 公开框架包。通过环境变量链接本地私有配置，实现公私分离。
version: 9.0.1
license: MIT-0
author: xkzs2007
homepage: https://clawhub.ai/skill/llm-memory-integration

metadata:
  openclaw:
    emoji: "🧠"
    requires:
      bins:
        - python3
      envVars:
        optional:
          - CNB_PRIVATE_WORKSPACE
    hooks:
      postinstall: hooks/bootstrap-extra-files.py
---

# LLM Memory Integration

## 概述

本技能是一个**公开框架包**，通过环境变量链接本地私有配置。

**核心设计**：公开框架 + 本地私有配置

| 组件 | 位置 | 内容 |
|------|------|------|
| **公开包** | ClawHub | 框架 + 模板 + 钩子 |
| **私有配置** | 用户本地（CNB_PRIVATE_WORKSPACE） | 自定义规则和实现 |

## 安全特性

- ✅ **无网络访问**：不执行任何网络操作
- ✅ **无远程拉取**：不从远程仓库下载代码
- ✅ **无敏感信息**：不包含任何密钥或私有地址
- ✅ **用户可控**：私有配置完全由用户控制
- ✅ **最小权限**：仅访问用户指定的 `CNB_PRIVATE_WORKSPACE` 目录

## 权限说明

| 权限 | 用途 |
|------|------|
| `python3` | 运行钩子脚本 |
| `CNB_PRIVATE_WORKSPACE`（可选） | 用户指定的私有配置目录 |

**注意**：本技能不访问 `~/.openclaw/memory-tdai` 或任何其他系统路径。

## 使用方法

### 基础使用（无私有配置）

```bash
clawhub install llm-memory-integration
```

### 高级使用（带私有配置）

1. **创建私有配置目录**

```bash
mkdir -p ~/my-private-config
```

2. **设置环境变量**

```bash
# 添加到 ~/.bashrc 或 ~/.zshrc
export CNB_PRIVATE_WORKSPACE="$HOME/my-private-config"
```

3. **放置私有文件**

```
~/my-private-config/
├── AGENTS.md          # 自定义 Agent 规则
├── TOOLS.md           # 自定义工具配置
├── MEMORY.md          # 私有记忆文件
└── config/            # 自定义配置
```

4. **安装技能**

```bash
clawhub install llm-memory-integration
```

## 钩子说明

| 钩子 | 功能 |
|------|------|
| `bootstrap-extra-files.py` | 将 `CNB_PRIVATE_WORKSPACE` 目录链接到工作区 |

钩子只执行本地文件操作（symlink/copy），仅访问用户指定的目录。

## 架构支持

- ✅ x64 (x86_64)
- ✅ ARM64 (aarch64)

---

**版本**: 9.0.1  
**许可**: MIT-0  
**作者**: xkzs2007

## 更新日志

### v9.0.1
- 🔒 **修复权限声明**：移除未使用的 `~/.openclaw/memory-tdai` 路径声明
- 📝 **完善文档**：明确说明仅访问 `CNB_PRIVATE_WORKSPACE`

### v9.0.0
- 🔄 **架构重构**：从"远程拉取"改为"本地链接"
- 🔒 **安全增强**：无网络访问、无敏感信息暴露
- 📁 **公私分离**：公开框架 + 本地私有配置