前言¶

DeepSeek Harness (DSH) 在加載智能體指令時，通常依賴 @deepseek-ai/dsh-agent-instructions 中的 AGENTS.md 或 CLAUDE.md。OpenClaw 採用了一套更豐富的工作區文件結構，通過 SOUL.md、IDENTITY.md、MEMORY.md 等文件爲智能體提供更完整的身份、記憶和上下文。

askingtheheavens/dsh-openclaw-persona 旨在解決這一問題，它將 OpenClaw 的文件體系封裝爲一個標準的 DSH Profile Bundle。只要工作區包含指定的子目錄，該插件就會自動將相關文件注入到 DSH 會話中，無需手動切換預設。

插件簡介¶

• 名稱：askingtheheavens/dsh-openclaw-persona
• 維護者：AskingTheHeavens
• 類別：記憶
• 許可證：MIT
• 核心作用：將 OpenClaw 風格的角色文件（SOUL.md, IDENTITY.md, USER.md, TOOLS.md, MEMORY.md, AGENTS.md, HEARTBEAT.md 及 memory/*.md）加載到 DSH 會話中。

核心功能¶

該插件主要提供以下能力：

1. 自動檢測與加載：檢測工作區中是否存在 openclaw/ 子目錄，存在時自動激活。
2. 文件映射：將特定文件映射爲 DSH 的 system-prompt 章節（如 openclaw:soul）和運行時上下文（如 openclaw:user）。
3. 上下文注入：支持 USER.md、TOOLS.md、MEMORY.md、HEARTBEAT.md 等文件作爲運行時上下文注入。
4. 每日筆記管理：自動讀取 memory/*.md 中的每日筆記，默認限制加載最近 2 條，每條限制 16 KiB。
5. 文件監聽：監聽工作區內的文件讀寫操作，文件變更時自動刷新緩存。
6. 配置靈活性：支持通過環境變量 OPENCLAW_SUBDIR 自定義子目錄名稱。

安裝與啓用¶

Bundle 不可熱重載，安裝後必須重啓 DSH。

1. 安裝插件（以 web profile 爲例）：

    dsh plugin --profile web add github:AskingTheHeavens/dsh-openclaw-persona

2. 驗證安裝：

    dsh plugin --profile web list
    # └── @user/dsh-openclaw-persona@github:AskingTheHeavens/dsh-openclaw-persona

3. 重啓 DSH：使 Bundle 生效。

注意：此插件僅適用於 web profile。若使用 tui、headless 或其他自定義 profile，需將命令中的 web 替換爲對應名稱。

使用方法¶

安裝並重啓後，在任意包含 openclaw/ 子目錄的工作區中啓動會話，插件將自動生效。

1. 創建工作區結構：

   在工作區根目錄下創建 openclaw/ 文件夾，並放入所需文件：

    /your/workspace/
    └── openclaw/
        ├── AGENTS.md
        ├── SOUL.md
        ├── IDENTITY.md
        ├── USER.md
        ├── TOOLS.md
        ├── MEMORY.md
        ├── HEARTBEAT.md
        └── memory/
            └── 2026-08-16.md

2. 啓動會話：

    dsh --cwd /your/workspace

或在 Web UI 中，在對應工作區創建新會話。

3. 加載規則：

   插件會將文件映射爲不同的上下文，具體規則如下：

   • SOUL.md / IDENTITY.md：注入爲 System Prompt 章節（openclaw:soul, openclaw:identity）。
   • USER.md / TOOLS.md：注入爲常駐運行時上下文（openclaw:user, openclaw:tools）。
   • MEMORY.md：注入爲運行時上下文（openclaw:memory），僅加載至主會話，不傳遞給子代理或羣聊。
   • memory/*.md：注入爲運行時上下文（openclaw:daily），默認取最近 2 個文件，按文件名排序。
   • AGENTS.md：注入爲運行時上下文（openclaw:agents），用於 OpenClaw 啓動協議。
   • HEARTBEAT.md：僅在有實際任務時注入（openclaw:heartbeat），空文件或僅註釋時不加載。

配置與限制¶

子目錄自定義¶

默認讀取路徑爲 ./openclaw/。若需修改，可通過環境變量指定：

OPENCLAW_SUBDIR=persona dsh --cwd /your/workspace

此時插件將讀取 /your/workspace/persona/ 下的文件。

限制配置¶

插件內置了對每日筆記的大小和數量限制，以匹配 OpenClaw 的語義：

• 每日筆記數量：默認 2 條（對應今天和昨天）。
• 每條文件大小：默認 16 KiB。如需修改，需編輯插件源碼 src/index.js 中的 DAILY_NOTE_LIMIT 和 DAILY_NOTE_MAX_BYTES 常量。

卸載¶

如需移除該插件：

dsh plugin --profile web remove @user/dsh-openclaw-persona

執行命令後，務必重啓 DSH。

總結¶

askingtheheavens/dsh-openclaw-persona 爲 DSH 提供了與 OpenClaw 工作流無縫對接的方案。它通過自動化的文件映射和上下文注入，讓開發者能夠利用 OpenClaw 的豐富文件結構來定義智能體的身份與記憶，而不必手動維護複雜的 Prompt 配置。

• GitHub 倉庫
• SkillHub 目錄頁