前言¶

给 DeepSeek Harness（下文简称 DSH）开发智能体时，一个常见的麻烦是能力分散：聊天要接一个 provider，图片生成、视频生成、联网搜索各自要配密钥、写适配。ClawRouters 把这些能力收敛到一个 OpenAI 兼容的 API 和一把密钥之后，而 dsh-plugin-clawrouters 要做的，就是把这把密钥和这组能力装进一个 DSH 插件包——装完、配好 key，就能在 DSH 里直接选用。

下面介绍这个插件的定位、功能、安装与配置方式。

这是什么¶

dsh-plugin-clawrouters 是由 ropon 维护的 DSH 插件，一句话定位：为 DeepSeek Harness 提供一键接入 ClawRouters 的能力，覆盖聊天、图片生成、视频生成与网页搜索。许可证为 MIT。

它走的是 DSH「一切皆插件」的路子：不需要在 DSH 之外另起一个应用，安装一个插件包、配置一把 API key，聊天路由和三个工具就都可用。

核心功能¶

插件提供四个入口：

• clawrouters / auto：OpenAI 兼容聊天路由，支持图片输入；
• clawrouters_image_generate：生成图片，并存为持久化的 DSH 图片附件；
• clawrouters_video_generate：提交并轮询视频任务，返回签名结果 URL；
• clawrouters_web_search：返回结构化的标题、摘要与来源 URL，不替换 DSH 既有的通用 web_search provider。

注意最后一点：搜索工具是新增能力，不会动你已有的 web_search provider 配置。

安装与启用¶

前置要求：DeepSeek Harness 0.1.0-rc.6 或更新版本，且 PATH 上需有 pnpm。

把 v0.1.1 标签版本安装到 Web profile 并启动：

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

仓库提交了构建后的 lib/ 输出，因此从 GitHub 安装不需要 pnpm allowBuilds，也不会在安装时执行构建脚本。

本地开发调试时，可以在插件仓库目录里直接安装当前检出版本：

dsh plugin --profile web add .
dsh web

配置 API key¶

先在设置页保存密钥，再到会话里选择模型，步骤如下：

1. 打开 DSH Web 或 Desktop；
2. 进入 Settings → Models → ClawRouters；
3. 粘贴你的 ClawRouters API key 并保存；
4. 在会话模型选择器中选择 clawrouters / auto。

密钥通过 DSH credential service 以 CLAWROUTERS_API_KEY 存储，不会写入 settings.yaml。聊天路由和三个工具在每次调用时解析同一份凭据，所以轮换密钥不需要重建插件。

也可以不改设置页，直接通过启动环境提供密钥：

export CLAWROUTERS_API_KEY='...'
dsh web

默认配置与覆盖¶

默认 API base 为 https://www.clawrouters.com/api/v1。工具部署默认值可以在后续 profile patch 中覆盖，目标是 id: clawrouters-tools，可覆盖项包括 apiKeyEnv、baseURL、imageModel、videoModel、imageTimeoutMs、videoTimeoutMs、searchTimeoutMs、videoPollIntervalMs。

README 给出的默认值示例如下：

- 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

需要调整超时、模型等部署参数时，把这段 patch 加在插件之后即可。

结果处理与能力边界¶

对返回结果的校验是有边界的：图片 URL 仅接受 HTTP(S)，需解码、格式校验，并经 DSH attachment policy 验证后才持久化；视频结果 URL 同样限制为 HTTP(S)。

目前暂不支持的能力有三类：

• embeddings / 向量搜索；
• 文本转语音 / 语音转文本；
• 持久化视频（返回签名 URL，而非复制视频字节）。

如果需求落在这三类里，这个插件目前覆盖不到。

适用场景与注意¶

适合的对象很明确：想在 DSH 里用一把密钥同时获得聊天（含图片输入）、图片生成、视频生成和结构化搜索的人，以及不想为每类能力单独维护 provider 与凭据的团队。

安装前有两点务必留意：

1、插件以当前 dsh 进程的权限运行，安装前应检查插件源码与许可证（本项目为 MIT），确认可接受再装；
2、确认本地 DSH 版本不低于 0.1.0-rc.6，且 PATH 上有 pnpm。

经过上面的步骤——安装插件、保存密钥、选择 clawrouters / auto——四类能力就都可以在会话中使用了。开发参与者可以按 README 的流程跑 pnpm install && pnpm check 做本地检查。

小结¶

dsh-plugin-clawrouters 的价值在于收敛：一个插件包、一把 API key，把聊天、图片生成、视频生成和网页搜索接进 DSH，且密钥轮换不需要重建插件。相关链接：

• GitHub 仓库：https://github.com/ropon/dsh-plugin-clawrouters
• 社区插件目录页：https://www.skillhub.cn/plugins/ropon/dsh-plugin-clawrouters （该目录为社区独立维护的站点，并非官方应用商店）