前言¶

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 目录页