English | 中文

OpenClaw capabilities, rebuilt as composable dsh plugins.

ClawDSH is a local personal-assistant product built on the DeepSeek Harness (dsh) plugin runtime. It preserves the native Harness application for advanced use while adding an opinionated product profile, memory, skills, automation, privacy-limited activity records, and an optional OpenClaw communication plane.

ClawDSH is an independent community project. It is built on DeepSeek Harness and interoperates with OpenClaw, but it is not endorsed by or affiliated with either project. This release is 0.1.0-rc.1: use the next npm tag, expect release-candidate changes, and do not treat it as a stable compatibility promise.

The ClawDSH repository tracks DeepSeek Harness as the upstream Git remote. The Harness context and reuse map explains the reused dsh capability seams; the roadmap and parity matrix describe ClawDSH-owned work.

The Channel catalog is evidence, not a support claim. Telegram, Feishu, Discord, and other catalog entries are not declared installable, certified, enabled, or ready merely because they appear in the UI. ClawDSH ships no direct platform adapter.

• Node.js 22.19.x or >=24.0.0 with npm.
• A local machine on which you trust same-user agent tools. No model or platform key is needed to open the UI.

npx --yes @clawdsh/cli@next

The command installs or upgrades the managed clawdsh profile under $DSH_HOME (default ~/.dsh), then starts the foreground Web Host. Open the printed URL, normally http://127.0.0.1:3080/clawdsh/. Press Ctrl-C to stop it; the launcher forwards terminal signals and waits for dsh to close.

The first run creates only installer-owned profile, preset, dependency, and management files. It does not require or create an OpenClaw runtime, platform login, model key, Memory fact, Automation rule, or external Channel listener. See the complete CLI reference for global installation, custom host/port values, upgrades, migration, backups, and failure behavior.

ClawDSH separates model, embedding, and platform credentials so one UI or file never becomes an all-secrets store.

The local managed credential document is ordinary YAML:

DEEPSEEK_API_KEY: "<your-deepseek-key>"
ARK_API_KEY: "<your-ark-key>"

Credential precedence is inherited launch environment → $DSH_HOME/.credentials.yaml → the invoking directory's .env → $DSH_HOME/.env. The UI never returns secret values through Settings RPC, and ClawDSH never copies OpenClaw platform credentials into dsh credentials, logs, sessions, Activity, or its management marker.

$DSH_HOME/.credentials.yaml is stored with owner-only permissions. Mode 0600 protects against other operating-system users; it cannot stop a shell or filesystem tool running under the same UID from deliberately reading the file. Run ClawDSH only on a trusted host, keep secrets out of settings.yaml, profile patches, issue reports, and screenshots, and secure any backup that contains the credential document.

The Settings page displays each field's owner and effect timing. live changes affect the mounted runtime, new-session changes require a new conversation, next-call changes are resolved for the next operation, and restart changes take effect after restarting ClawDSH. Soul is new-session scoped; Automation settings apply live; Memory and Skills provider changes require restart; managed credential-file changes are visible on the next call. The generated configuration catalog is the exhaustive field reference; README examples intentionally cover only common entries.

For a complete operator backup, stop ClawDSH and snapshot the entire $DSH_HOME plus ~/.clawdbot/skills or the configured external managedDir. Installer-created source-migration and preset backups cover only the named profile/preset assets; they are not substitutes for a user-data backup. Restore a full snapshot only while ClawDSH is stopped, preserve owner-only permissions, and run npx --yes @clawdsh/cli@next doctor before starting.

npx --yes @clawdsh/cli@next
npx --yes @clawdsh/cli@next doctor
npx --yes @clawdsh/cli@next migrate source
npx --yes @clawdsh/cli@next migrate source --apply
npx --yes @clawdsh/cli@next migrate source --apply --backup-modified
npx --yes @clawdsh/cli@next channel install
npx --yes @clawdsh/cli@next channel doctor

Running the next entry again installs the current release candidate and performs an idempotent managed upgrade. doctor checks only the installer-owned profile, bundle, and presets; channel doctor checks the separately managed OpenClaw runtime. Neither command reads credential stores.

clawdsh migrate source is read-only and reports whether an older source-linked installation is a recognized clean or modified layout. --apply backs up a recognized clean layout and migrates it; modified source-owned patch, preset, or extra profile entries require --apply --backup-modified. Unknown, incomplete, mixed-checkout, non-symlink, or different-package layouts always fail closed. Migration publishes .clawdsh.json last and rolls back on failure without reading or moving Settings, credentials, Memory, Sessions, Skills, Activity, or OpenClaw state.

A fresh checkout uses an isolated source-development home, never the public ~/.dsh home:

git clone https://github.com/Fatemoisted/ClawDSH.git
cd ClawDSH
pnpm install
pnpm run build
pnpm --dir packages/openclaw/preset-openclaw/product-shell install --frozen-lockfile
pnpm --dir packages/openclaw/preset-openclaw/product-shell run build
tools/run-clawdsh-dev.sh

CLAWDSH_DEV_HOME defaults to ~/.clawdsh-dev; the source wrapper refreshes the development links and then exports that path as DSH_HOME. Its private development bundle carries product composition, while the profile cordis.patch.yml is created empty and preserved byte-for-byte on later refreshes. See the assembly guide for advanced Gateway provisioning and source lifecycle details.

• Support and bug reports: GitHub Issues.
• Contributions: CONTRIBUTING.md. ClawDSH-owned changes follow the repository's upstream-read-only policy.
• License: MIT, retaining DeepSeek Harness notices and adding ClawDSH contributors.
• Brand: the original Tidal Claw assets and guide use a whale as the primary form and a coral claw as a secondary detail; they do not reproduce either upstream logo.

English | 中文

DeepSeek Harness (dsh) is an open-source agent harness developed by DeepSeek AI.

It uses an architecture where everything is a plugin, and is powered by Cordis, whose design is described in A Programming Paradigm for Spatiotemporal Composability.

DeepSeek Harness is currently in developer preview and is iterating rapidly. THERE WILL BE COMPATIBILITY-BREAKING CHANGES.

Install Node.js, then run:

npx @deepseek-ai/dsh web

The command starts the Web UI, served at http://127.0.0.1:3080 by default. See Web UI guide.

To run from a repository checkout:

git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness
pnpm install
pnpm run build
pnpm dsh web

• Feel free to submit feedback or bug reports through GitHub Discussions.
• Add the dsh-plugin topic to your plugin repository for discoverability.
• Join DeepSeek Harness Discord community.

See CONTRIBUTING.md.

Start with the development guide and architecture documentation.

For agents, follow AGENTS.md.

MIT

Third-party dependencies and their licenses are disclosed in THIRD_PARTY_NOTICES.md.