Install DeepSeekBot

Version scope: stable 1.4.0. Installation identity and bilingual release notes are synchronized; historical screenshots do not show the current UI.

Install the DeepSeekBot plugin in DeepSeek Harness (DSH), enable it and create your first PersonaBot. You install one product package; Core, Client and the qualified IM Provider arrive with it.

Install the stable npm package deepseekbot@1.4.0. Use DSH 0.2.1-rc.2; the same released packages passed installation, Host startup, Bot/DM creation and restart persistence on 0.2.0-rc.2 and 0.2.1-rc.2. Declared admission is >=0.2.0-rc.2 <0.3.0-0, not runtime qualification of every version. The DSH 0.2.0-rc.1 screenshots below are historical UI records; follow the current text. Back up the Profile before upgrading; returning to an older binary may require the pre-upgrade backup.

#1. Open Plugins

Start DSH and open its Web interface. If DSH is not installed yet, follow the official DSH getting-started documentation. Follow API and Bot model setup to configure a provider first; after creating the Bot, choose its models under Model in the DM's Channel sidebar.

Click Plugins (插件) in the left sidebar, then Add plugin (添加插件).

#2. Enter the public package name

Paste this exact value into Package name or address (包名或地址):

deepseekbot@1.4.0

Keep npm official registry (npm 官方源) as the installation source and click Install (安装). Wait for the installation task to finish.

This field imports the package source, not an uploaded file. Screenshots are historical UI references; use the exact package spec above, not the earlier version shown in a screenshot.

#New-release age policy and recovery

Do not replace the exact spec with deepseekbot or deepseekbot@latest. With pnpm 11.7 defaults, both selected 1.2.0 during 1.2.1's 24-hour release-age window, even though DSH's preview displayed 1.2.1. Core 1.2.0 requires DSH 0.2.0-rc.1 exactly; Core 1.2.1 declares >=0.1.7-0. These are different installed packages, not a remaining version ceiling in 1.2.1.

Retry using the exact spec above. For an existing Desktop Profile, fully quit Desktop before running dsh plugin --profile desktop add deepseekbot@1.4.0; restart afterwards and check the actual installed Product/Core versions. Preserve the Profile and its data; do not delete it to retry.

Explicit versions can record exact minimumReleaseAgeExclude entries under pnpm defaults. If strict policy prompts or refuses, obtain approval for only the verified package versions or wait for the policy window; do not globally disable supply-chain protection or use DSH version exemptions. These instructions do not claim native Windows Desktop verification or compatibility with every future DSH release.

#3. Enable the installed plugin

The completed task shows Installed (已安装), the package name and the installed version. Click Enable now (立即启用). If you closed the task, return to Plugins and turn on Enable deepseekbot (启用 deepseekbot).

Once enabled, Bot mode (Bot 模式) appears in the sidebar. In the verified RC1 setup it loaded immediately. If your DSH reports that a restart is required, restart the same DSH Profile and reopen its Web page.

#4. Start with Home onboarding

Open Bot mode, configure a model in Home and send Tob an editable creation request. Follow the journey to create a real Bot and group, with existing management approvals, then learn to drag panel titles, resize panels and reopen them from the control rail. Finish by clicking the Home title to close Home and enter the original Tob DM.

New Bots no longer receive an automatic welcome message. Send your own greeting and check a real reply to verify model usability. DSH still manages credentials; npm installation does not provide them. See API and Bot models and the 1.4.0 introduction.

#5. Connect a messaging app

The initial installation has no connected IM accounts. After a local DM works, use Connections and optional tools to choose a platform, check your version and bind an app. Current source binds in the DM sidebar’s External identities; new conversations can be automatic or ask first, without per-group Profile authorization.

#Git

Bot mode needs Git 2.28 or newer on the computer that runs DSH, because each Bot's memory is a Git repository. When Git is missing or too old, Bot mode says so at the top of the roster and turns off creating and importing Bots until Git works.

The quickest fix is the Install Git button in that notice. It downloads a portable Git (about 65 MB) into the DeepSeek Harness data folder, checks it against a pinned checksum, and starts using it right away. It needs no admin rights and does not change the Git installed on your computer. DeepSeekBot downloads it from media.botharness.ai first and from GitHub if that fails. A usable system Git always takes priority, so installing Git yourself later replaces it on the next DeepSeek Harness start.

To install Git yourself instead:

• macOS: run xcode-select --install in Terminal and follow the prompt, or install Git with Homebrew (brew install git).
• Windows: install Git for Windows with the default options.
• Linux: install the git package with your distribution's package manager, for example sudo apt install git. Ubuntu 20.04 ships Git 2.25; use the git-core PPA for a newer one.

After installing it yourself, restart DeepSeek Harness and click Check again in Bot mode.

The Git row in DeepSeekBot settings shows the Git version in use and whether it is your system Git or the Managed Git.

When you import a Bot from an SSH address such as git@github.com:owner/repo.git and the Host has no SSH key for it, DeepSeekBot retries once with the matching HTTPS address and tells you it switched. The Bot then syncs over HTTPS. Addresses with a custom SSH port are not converted.

#Other installation methods

The official DSH packaging reference also supports CLI installation into a named Profile:

dsh plugin --profile <your-profile> add deepseekbot@1.4.0

Use the Profile you actually start. Enable the plugin in that Profile's Plugins page afterward.

To import the same precompiled archive, download the public npm tarball with npm pack deepseekbot@1.4.0, which saves deepseekbot-<version>.tgz in the current directory. In the Web interface, enter its absolute path on the machine running DSH in Package name or address; a path on a different browser machine is not a Host path. With the CLI you can instead use dsh plugin --profile <your-profile> add ./deepseekbot-<version>.tgz from the download directory.

#If installation does not finish

For source development rather than installation, see the repository README and local development guide.