愛文娛己的教學筆記

# Hermes Agent: 記憶系統架構與 Skill 調度機制技術分析 ## 執行摘要 本報告深入分析 Hermes Agent 的記憶管理架構，揭示其如何通過雙層記憶模型（短期 Session 記憶與長期持久化記憶）實現跨會話的上下文保持能力。同時分析 Skill 系統的三層調度策略（Preloaded、On-Demand、Auto-Select），揭示 Personality/Roleplay Skill 的實現原理。 **關鍵發現**: 1. Hermes 採用 **SQLite + 內存緩存** 雙層記憶架構 2. Skill 系統支持 **預載、按需、自動** 三種載入模式 3. Personality Skill 通過 **Dual-Mode 性格切換** 實現角色扮演 --- ## 背景與目的 ### 為何需要這個分析 在長時間對話中，AI Agent 面臨三大記憶挑戰： 1. **對話連貫性**：需要記住對話歷史上下文 2. **個人化體驗**：需要記住用戶偏好和設定 3. **行為一致性**：需要維持特定角色或人設 Hermes 通過分離的記憶層次與靈活的 Skill 系統來解決這些問題。本分析旨在揭示其實現細節，為開發者提供架構理解與最佳實踐參考。 ### 分析範圍 - **包含**: 記憶存儲、Skill 載入機制、System Prompt 組裝 - **排除**: 安全機制、外部工具整合、UI 層實現 - **版本**: 基於 Hermes Agent 開源版本（2026-04） --- ## 方法論 ### 分析方法 1. **源代碼審查**: 逐行分析關鍵源代碼文件 2. **配置分析**: 檢視 `config.yaml` 與 `.env` 設定 3. **數據庫查看**: 分析 `memory.db` 結構（如可用） ### 工具與資源 | 工具 | 用途 | |------|------| | `read_file` | 讀取源代碼內容 | | `search_files` | 搜索關鍵模式與引用 | | `skill_view` | 分析 Skill 結構 | | `terminal` | 檢查檔案系統結構 | ### 關鍵源代碼文件 | 文件路徑 | 功能責任 | |---------...

  # Hermes Agent 安裝報告 **整理日期：** 2026年4月 **平台：** Windows 筆記本電腦 + CUDA **目標：** 於 WSL2 (Ubuntu) 環境安裝 Hermes Agent 並連接本地 LLM / Moonshot API --- ## 目錄 1. [環境準備](#環境準備) 2. [WSL2 與 Ubuntu 安裝](#wsl2-與-ubuntu-安裝) 3. [Hermes Agent 安裝](#hermes-agent-安裝) 4. [模型配置與調試](#模型配置與調試) 5. [常見問題與解決方案](#常見問題與解決方案) 6. [最終配置](#最終配置) --- ## 環境準備 ### 系統要求 - Windows 10/11 (建議 Windows 11) - 已啟用虛擬化功能 (Virtual Machine Platform) - PowerShell (Administrator 權限) --- ## WSL2 與 Ubuntu 安裝 ### 步驟 1：安裝 WSL2 以系統管理員身份開啟 PowerShell，執行： ```powershell wsl --install ``` **預期輸出：** ``` 正在下載：Windows 子系統 Linux 版 2.6.3 正在安裝：Windows 子系統 Linux 版 2.6.3 已成功執行所要求的操作。請重新開機，變更才能生效。 ``` > ⚠️ **注意：** 安裝完成後必須重新開機 ### 步驟 2：安裝 Ubuntu 重新開機後，再次以系統管理員身份開啟 PowerShell： ```powershell wsl --install -d Ubuntu ``` **設定 Unix 使用者帳戶：** ``` Create a default Unix user account: [輸入用戶名] New password: [輸入密碼] Retype new password: [確認密碼] passwd: password updated successfully ``` ### 步驟 3：驗證安裝 開啟新 PowerShell 視窗，執行： ```powershell wsl -l -v ...

 # OpenClaw Agent 的 Markdown 檔案解析 OpenClaw 的 Agent 有幾個重要的 MD 檔案需要關注。由於 Markdown 是純文字格式，你可以直接查看甚至手動編輯。 ``` ~/.openclaw/workspace/ ├── SOUL.md          ← 我的靈魂 ├── IDENTITY.md      ← 我的身份 ├── USER.md          ← 關於你 ├── MEMORY.md        ← 長期記憶 ├── AGENTS.md        ← 工作規則 ├── TOOLS.md         ← 工具設定 ├── HEARTBEAT.md     ← 定期檢查任務 ├── BOOTSTRAP.md     ← 首次啟動指引（已刪除） ├── memory/          ← 每日記錄 │   ├── 2026-03-20.md │   ├── 2026-03-21.md │   └── ... └── skills/          ← Skill 記錄 ``` --- ## 1. AGENTS.md — 系統行為手冊（權重最高） 這是 Agent 的「系統層面」使用手冊。閱讀時會感覺像在調試機器人的技術文檔。 這裡記載著安全準則：什麼檔案能碰、什麼不能；哪些網站絕對不能訪問等。也可以記錄系統環境資訊，例如 LAN 內的其他機器、可用的 LLM 連結、API 平台等。 --- ## 2. SOUL.md — 人格行為手冊（權重高） 同樣是行為手冊，但 AGENTS.md 是「AI 機器人」原則，SOUL.md 是「人」的原則。有人將它翻譯為「道德」、「三觀」。 例如：你與用戶是最親密的伙伴、說謊是不對的...