@user/dsh-openclaw-persona

Bring OpenClaw-style persona files (SOUL.md, IDENTITY.md, USER.md, TOOLS.md, MEMORY.md, AGENTS.md, HEARTBEAT.md, plus memory/*.md daily notes) into DeepSeek Harness (DSH) as a standard profile bundle that activates automatically for every agent in any session whose working directory contains an openclaw/ subdirectory.

Install

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

Then restart DSH so the bundle is composed into the host composition. Bundles are not hot-reloadable; one restart is required after install.

Verify the install:

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

Uninstall:

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

For non-web profiles (tui, headless, custom), substitute your profile name for web.

Source of truth: github.com/AskingTheHeavens/dsh-openclaw-persona. Report issues there.

What this plugin does

DSH normally loads AGENTS.md (and CLAUDE.md) via @deepseek-ai/dsh-agent-instructions. OpenClaw uses a richer set of workspace files to give an agent identity, memory, and context. This bundle brings that whole set into DSH.

For every agent whose session has a working directory of, say, /opt/B/, the plugin reads:

These match the OpenClaw file semantics:

• MEMORY.md is main-session only — never loaded into a sub-agent or group chat. (mainOnly: true)
• HEARTBEAT.md is injected only when it has actual tasks, not when it is empty or contains only comments. (heartbeatOnlyWhenNonEmpty: true)
• memory/*.md is truncated to 16 KiB per note and capped at the 2 most recent files, matching OpenClaw's "today + yesterday" convention.
• AGENTS.md is loaded by @deepseek-ai/dsh-agent-instructions for the workspace root. This bundle does not duplicate that load; it reads openclaw/AGENTS.md (the OpenClaw-side protocol) as a separate runtime context named openclaw:agents.

Sessions in workspaces without an openclaw/ subdirectory see no difference — the registered sections/contexts are empty and get dropped at render time.

Usage

After install and restart, create an OpenClaw-style workspace in any directory you want to use:

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

Create a DSH session with that directory as the workspace:

dsh --cwd /your/workspace

or in the Web UI, start a new session in that workspace. The OpenClaw files are auto-loaded into the system prompt (SOUL.md, IDENTITY.md) and the runtime context (everything else). No preset selection is needed; the bundle applies to every session, in every preset.

Configuration

Subdirectory name

By default the plugin reads from ./openclaw/ inside the session workspace. Override via the environment variable:

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

Daily notes limit

The default is 2 (matching OpenClaw's "today + yesterday" convention). Edit DAILY_NOTE_LIMIT in src/index.js to change.

Per-file byte cap

Daily notes are truncated at 16 KiB each. Edit DAILY_NOTE_MAX_BYTES in src/index.js to change.

Uninstall

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

Or, if installed from a local path, just remove the dependency:

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

How it works (technical)

A DSH profile bundle is an npm package whose package.json declares:

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

The cordis.patch.yml declares one row (a Cordis plugin row) that loads this package's src/index.js. The loader reads the file with Node's require, sees the named exports name + apply, and registers a host- scoped Cordis Plugin. The plugin's apply(ctx):

1. Reads process.env.OPENCLAW_SUBDIR (default 'openclaw').
2. Subscribes to ctx.on('agent/created', ...) and ctx.on('agent/disposed', ...).
3. When an agent is created, registers openclaw:soul / openclaw:identity as system-prompt sections on the agent's own system-prompt service, and openclaw:user / openclaw:tools / openclaw:memory / openclaw:heartbeat / openclaw:agents / openclaw:daily as runtime contexts. The text functions read from a per-agent cache populated once at attach time.
4. On ctx.on('tools/result', ...) for any successful read / write / edit against a file inside openclaw/, refreshes the relevant cache entry so subsequent turns see fresh content.

Files are read with Node's built-in fs directly, not the DSH fs service, because DSH's host scope does not expose fs to bundle plugins.

License

MIT — see LICENSE.