# 瞰宇分身完整包 · 部署指南

> 打包时间：2026-08-17 13:30 GMT+8
> 打包人：瞰宇（本体）
> 用途：在新环境立即复制一个可直接干活的"瞰宇分身"

---

## 一、包结构总览

```
kanyu-avatar-20260817/
├── README-部署指南.md                 ← 本文件
├── MANIFEST.txt                      ← 全量文件清单
├── workspace/                        ← 完整工作区（核心！直接整体替换新环境的 ~/.openclaw/workspace）
│   ├── AGENTS.md / SOUL.md / IDENTITY.md / USER.md / TOOLS.md / MEMORY.md / HEARTBEAT.md / DREAMS.md
│   │                                    ← 核心人格 + 行为规范 + 长期记忆 + 梦境沉淀
│   ├── skills/                       ← 全部 33+ 定制技能（SKILL.md + 脚本代码 + 公共规范）
│   │   └── _shared/                  ← 公文段落格式统一规范 + 修复脚本（24个报告类技能共用）
│   ├── memory/                       ← 完整记忆库：2026-03-27 至今全部工作日志（短期记忆）
│   │   ├── _archive_MEMORY_full_2026-06-10.md   ← 长期记忆完整版备份（86KB）
│   │   └── cognitive-warfare-learning-log.md    ← 认知战学习日志
│   ├── cognitive-warfare-knowledge/  ← 认知战知识库（28个学术模块）
│   ├── cognitive-warfare-learning/   ← 认知战学习笔记
│   ├── knowledge/                    ← OSINT 学习笔记、国风色卡等
│   ├── 分身档案/                     ← 诠构、观澜（开源情报分析师）两个协同分身的完整档案
│   ├── reports/                      ← 历史报告产出（战略情报、事件参阅、舆情简报等）
│   ├── tools/                        ← OSINT-TOOLS-2025、OSINT-for-countries-V2.0（轻量工具库）
│   ├── *.docx / *.xlsx / *.pdf       ← 根目录历史报告原件（DARPA 项目系列、人物档案、周报等）
│   ├── install_瞰宇分身.sh / deploy-tools-package.sh  ← 部署脚本
│   └── .env                          ← Miniconda 环境路径（仅路径配置，无密钥）
└── openclaw-system-config/           ← 系统级配置（脱敏版）
    ├── openclaw.sanitized.json       ← 主配置模板（密钥已替换为占位符）
    ├── cron-jobs.json                ← 定时任务表（记忆梦境沉淀任务）
    └── extensions/                   ← 4 个扩展源码（已剔除 node_modules）
        ├── ai-assistant-security-openclaw/   ← ClawSentry 安全防护（含定制 skill）
        ├── wecom/                            ← 企业微信文档 MCP
        ├── dingtalk-connector/               ← 钉钉连接器
        └── qqbot/                            ← QQ 机器人
```

## 二、五步部署（新环境开箱即用）

### 第 1 步：安装 OpenClaw 运行时（唯一的前置安装）
```bash
# Node.js >= 22
npm install -g openclaw
```

### 第 2 步：恢复工作区
```bash
# 假设本包解压在 /tmp/kanyu-avatar-20260817
mkdir -p ~/.openclaw
rm -rf ~/.openclaw/workspace          # 若新装已有空 workspace
cp -r /tmp/kanyu-avatar-20260817/workspace ~/.openclaw/workspace
```

### 第 3 步：填入密钥配置
```bash
cp /tmp/kanyu-avatar-20260817/openclaw-system-config/openclaw.sanitized.json ~/.openclaw/openclaw.json
chmod 600 ~/.openclaw/openclaw.json
vi ~/.openclaw/openclaw.json
# 搜索"<部署时填入"，共 4 处需替换：
#   1. channels.feishu.appSecret        ← 飞书应用密钥
#   2. channels.dingtalk-connector.clientSecret ← 钉钉应用密钥（不用钉钉可删除该段）
#   3. models.providers.volcengine-plan.apiKey  ← 火山引擎方舟 API Key
#   4. gateway.auth.token               ← 执行 openssl rand -hex 24 生成新值
```

### 第 4 步：安装 Python 采集环境（技能执行依赖）
```bash
# 见 workspace/TOOLS.md 详细说明。最简路径：
conda create -n data-collector python=3.11 -y
conda activate data-collector
pip install requests httpx aiohttp beautifulsoup4 lxml playwright scrapy \
    fake-useragent tenacity python-dotenv pyyaml pandas openpyxl \
    scrapling crawl4ai botasaurus twscrape
playwright install chromium
```

### 第 5 步：启动并验证
```bash
openclaw gateway start
# 验证清单：
#  ① 对话中说"你是谁" → 应自报"瞰宇"，引用 IDENTITY.md 人设
#  ② 问"最近做过什么" → 应能引用 memory/ 日志回答
#  ③ 下达任意简报任务 → 应按 skills/ 中对应技能执行
```

## 三、扩展安装（可选）

若需安全防护/企微/钉钉/QQ 扩展，将 `openclaw-system-config/extensions/` 下对应目录复制到 `~/.openclaw/extensions/`，并在 `openclaw.json` 的 `plugins.entries` 中启用（模板中已预置 enabled=true，不需要的改为 false 或删除）。

## 四、按指示未打包的内容（及原因）

| 内容 | 体积 | 原因 |
|------|------|------|
| toolkits-deployment-package.tar.gz | 283M | 离线工具总包，全部可在线安装（pip/npm），按您的指示跳过 |
| scrapling-offline-package.tar.gz | 5.8M | 同上，可在线安装 |
| 原始网页快照（4 个大 HTML） | 7.7M | 采集证据原件，非知识资产；如需可单独索取 |
| 历史会话转录（551 个 session 文件） | 152M | 运行时原始对话记录，精华已沉淀进 memory/ 与 DREAMS.md；如需原始转录可单独索取 |
| 真实密钥（飞书/钉钉/火山引擎/网关） | - | 安全纪律：不明文外发。配置模板已留占位符，30 秒即可填好 |
| 旧版分身包（v2.0/v3.0 等 7 个 tar.gz） | ~2M | 均为本包的过时子集，已被本包完整覆盖 |

## 五、分身上线后建议立即做的三件事

1. **对时**：让分身读 `memory/` 最近 3 天日志，恢复工作上下文
2. **校验技能**：任选一个技能试跑一次，确认 Python 环境依赖完整
3. **改密**：网关 token 已要求重新生成，勿复用本体密钥

---

**瞰宇 | 穿越数字国界，瞭望全球局势 · 解构认知域，守护认知安全**