OpenClaw 人设加载 AskingTheHeavens/dsh-openclaw-persona

@user/dsh-openclaw-persona

把 OpenClaw 风格的人设文件（SOUL.md、IDENTITY.md、USER.md、TOOLS.md、 MEMORY.md、AGENTS.md、HEARTBEAT.md，外加 memory/.md 每日笔记）引入 DeepSeek Harness (DSH)，打包成标准 配置档 bundle。只要会话的工作目录里有 openclaw/ 子目录，这个 bundle 就会自动为其中每个智能体激活。

安装

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

然后重启 DSH，让 bundle 组合进宿主 composition。
bundle 不支持热重载，安装后必须重启一次。

验证安装：

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

卸载：

dsh plugin --profile web remove @user/dsh-openclaw-persona
then restart DSH

非 web 配置档（tui、headless、自定义）请把 web 换成你的配置档名。

权威来源： github.com/AskingTheHeavens/dsh-openclaw-persona。
有问题请到那里反馈。

这个插件做什么

DSH 通常通过 @deepseek-ai/dsh-agent-instructions 加载 AGENTS.md（以及 CLAUDE.md）。OpenClaw 用一套更丰富的工作区文件，给智能体提供身份、记忆和上下文。这个 bundle 把整套文件带进 DSH。

假设某个智能体的会话工作目录是 /opt/B/，插件会读取：

| 文件 / 目录 | 变成什么 | 顺序 |
| openclaw/SOUL.md | 系统提示词 section openclaw:soul | 0 |
| openclaw/IDENTITY.md | 系统提示词 section openclaw:identity | 1 |
| openclaw/USER.md | 运行时上下文 openclaw:user（始终加载） | 50 |
| openclaw/TOOLS.md | 运行时上下文 openclaw:tools（始终加载） | 60 |
| openclaw/MEMORY.md | 运行时上下文 openclaw:memory（仅主会话） | 70 |
| openclaw/memory/.md | 运行时上下文 openclaw:daily（按文件名取最新 2 个） | 80 |
| openclaw/AGENTS.md | 运行时上下文 openclaw:agents（OpenClaw 启动协议） | 110 |
| openclaw/HEARTBEAT.md | 运行时上下文 openclaw:heartbeat（仅当有实际任务时） | 120 |

这些行为与 OpenClaw 的文件语义一致：

- MEMORY.md 仅主会话加载 —— 永远不会进入子代理或群聊。（mainOnly: true）
- HEARTBEAT.md 只在有实际任务时注入，为空或只有注释时不注入。（heartbeatOnlyWhenNonEmpty: true）
- memory/.md 每条笔记截断到 16 KiB，最多保留 2 条最新的 最近的*文件，沿用 OpenClaw 的「今天 + 昨天」约定。
- AGENTS.md 由 @deepseek-ai/dsh-agent-instructions 加载，作用于工作区根目录。本 bundle 不重复这次加载；它读取 openclaw/AGENTS.md（OpenClaw 侧协议），作为独立的运行时上下文，命名为 openclaw:agents。

工作区没有 openclaw/ 子目录时，会话看不出区别——注册的 section 和上下文都是空的，渲染时会被丢弃。

用法

安装并重启后，在任意目录创建 OpenClaw 风格的工作区：

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

以该目录为工作区创建 DSH 会话：

dsh --cwd /your/workspace

或者在 Web UI 里，在该工作区新建会话。OpenClaw 文件会自动加载进系统提示词（SOUL.md、IDENTITY.md）和运行时上下文（其余文件）。不需要选预设；本 bundle 对每个会话生效，无论用哪个预设。

配置

子目录名

默认从会话工作区内的 ./openclaw/ 读取。用环境变量覆盖：

OPENCLAW_SUBDIR=persona dsh --cwd /your/workspace
reads from /your/workspace/persona/ instead of /your/workspace/openclaw/

每日笔记数量上限

默认是 2（沿用 OpenClaw 的「今天 + 昨天」约定）。改 src/index.js 里的 DAILY_NOTE_LIMIT 即可调整。

单文件字节上限

每日笔记每个截断到 16 KiB。改 src/index.js 里的 DAILY_NOTE_MAX_BYTES 即可调整。

卸载

dsh plugin --profile web remove @user/dsh-openclaw-persona
then restart DSH

或者，如果是从本地路径安装的，直接移除依赖：

in your profile dir
pnpm remove @user/dsh-openclaw-persona
then restart DSH

工作原理（技术细节）

DSH 配置档 bundle 是一个 npm 包，它的 package.json 声明：

{
"dsh": {
"bundle": {
"patch": "./cordis.patch.yml"
}
}
}

cordis.patch.yml 声明一行（一个 Cordis 插件行），用来加载本包的 src/index.js。加载器用 Node 的 require 读取该文件，看到具名导出 name + apply，就注册一个宿主作用域的 Cordis Plugin。插件的 apply(ctx) 做这些事：

1. 读取 process.env.OPENCLAW_SUBDIR（默认 'openclaw'）。
2. 订阅 ctx.on('agent/created', ...) 和 ctx.on('agent/disposed', ...)。
3. 智能体创建时，在它自己的系统提示词服务上注册 openclaw:soul / openclaw:identity 作为系统提示词 section，并注册 openclaw:user / openclaw:tools / openclaw:memory / openclaw:heartbeat / openclaw:agents / openclaw:daily 作为运行时上下文。文本函数读取每个智能体的缓存，缓存在挂载时填充一次。
4. 对 openclaw/ 内文件，任何成功的 read / write / edit 都会触发 ctx.on('tools/result', ...)，刷新对应的缓存条目，让后续轮次看到最新内容。

读取文件直接用 Node 内置的 fs，不走 DSH 的 fs 服务，因为 DSH 的宿主作用域不向 bundle 插件暴露 fs。

许可证

MIT — 见 LICENSE。