Introduction

When developing agents for DeepSeek Harness (hereinafter referred to as DSH), a common hassle is scattered capabilities: chatting requires a provider, while image generation, video generation, and web search each require configuring keys and writing adapters. After ClawRouters converged these capabilities into one OpenAI-compatible API and one key, what dsh-plugin-clawrouters does is put that key and these capabilities into a DSH plugin package—once installed and configured with the key, they can be selected directly in DSH.

Below is an introduction to the positioning, features, installation, and configuration of this plugin.

What is it

dsh-plugin-clawrouters is a DSH plugin maintained by ropon. One-sentence positioning: Provides one-click access to ClawRouters for DeepSeek Harness, covering chat, image generation, video generation, and web search. The license is MIT.

It follows the DSH “everything is a plugin” philosophy: no need to launch a separate application outside of DSH; install a plugin package and configure an API key, and the chat router and three tools become available.

Core Features

The plugin provides four entry points:

  • clawrouters / auto: OpenAI-compatible chat router, supports image input;
  • clawrouters_image_generate: Generate images and persist them as DSH image attachments;
  • clawrouters_video_generate: Submit and poll video tasks, returning a signed result URL;
  • clawrouters_web_search: Return structured titles, summaries, and source URLs, without replacing DSH’s existing generic web_search provider.

Note the last point: The search tool is an added capability and will not modify your existing web_search provider configuration.

Installation and Enabling

Prerequisites: DeepSeek Harness 0.1.0-rc.6 or later, and pnpm must be in your PATH.

Install the v0.1.1 tag version to the Web profile and start:

dsh plugin --profile web add github:ropon/dsh-plugin-clawrouters#v0.1.1
dsh web

The repository includes pre-built lib/ output, so installing from GitHub does not require pnpm allowBuilds, and build scripts will not be executed during installation.

For local development and debugging, you can directly install the currently checked-out version in the plugin repository directory:

dsh plugin --profile web add .
dsh web

Configuring the API Key

First, save the key in the settings page, then select the model in the session. The steps are as follows:

  1. Open DSH Web or Desktop;
  2. Go to Settings → Models → ClawRouters;
  3. Paste your ClawRouters API key and save;
  4. Select clawrouters / auto in the session model selector.

The key is stored via the DSH credential service as CLAWROUTERS_API_KEY and is not written to settings.yaml. The chat router and three tools parse the same credentials on every call, so rotating keys does not require rebuilding the plugin.

You can also provide the key via the launch environment without modifying the settings page:

export CLAWROUTERS_API_KEY='...'
dsh web

Default Configuration and Overrides

The default API base is https://www.clawrouters.com/api/v1. Tool deployment defaults can be overridden in subsequent profile patches. The target ID is id: clawrouters-tools. Overridable items include apiKeyEnv, baseURL, imageModel, videoModel, imageTimeoutMs, videoTimeoutMs, searchTimeoutMs, and videoPollIntervalMs.

The default values provided in the README are as follows:

- id: clawrouters-tools
  config:
    apiKeyEnv: CLAWROUTERS_API_KEY
    baseURL: https://www.clawrouters.com/api/v1
    imageModel: auto
    videoModel: auto
    imageTimeoutMs: 600000
    videoTimeoutMs: 1800000
    searchTimeoutMs: 30000
    videoPollIntervalMs: 5000

When you need to adjust deployment parameters such as timeouts or models, simply add this patch after the plugin.

Result Processing and Capability Boundaries

Verification of returned results has boundaries: Image URLs only accept HTTP(S), require decoding and format validation, and are only persisted after being verified by the DSH attachment policy; video result URLs are also restricted to HTTP(S).

Currently, three categories of capabilities are not supported:

  • embeddings / vector search;
  • text-to-speech / speech-to-text;
  • persistent video (returns a signed URL, not copying video bytes).

If your requirements fall into these three categories, this plugin currently does not cover them.

Applicable Scenarios and Considerations

The target audience is clear: individuals who want to use a single key in DSH to simultaneously get chat (including image input), image generation, video generation, and structured search; and teams who do not want to maintain separate providers and credentials for each type of capability.

There are two points to pay attention to before installation:

  1. The plugin runs with the permissions of the current dsh process. Before installing, you should check the plugin source code and license (this project is MIT) to confirm it is acceptable;
  2. Confirm that your local DSH version is not lower than 0.1.0-rc.6, and that pnpm is available in PATH.

After the above steps—installing the plugin, saving the key, and selecting clawrouters / auto—all four types of capabilities will be available in the session. Development participants can run pnpm install && pnpm check locally following the README flow.

Summary

The value of dsh-plugin-clawrouters lies in convergence: one plugin package, one API key, connecting chat, image generation, video generation, and web search into DSH, and key rotation does not require rebuilding the plugin. Related links:

  • GitHub repository: https://github.com/ropon/dsh-plugin-clawrouters
  • Community plugin directory page: https://www.skillhub.cn/plugins/ropon/dsh-plugin-clawrouters (The directory is a community-maintained site, not the official app store)