dsh-clawrouter 使用指南
给 DeepSeek Harness 智能体加一个"第二大脑":用更强的模型在危险命令执行前先审一遍,并把 60+ 模型通过钱包签名(x402/USDC)接入到 DSH,无需 API Key。
本文为派生内容(基于 wiki / faq / compatibility_json 自动组装),非 AI 即时创作。
本文由本站基于该插件已收录的字段自动派生(wiki / faq / compatibility_json / readme),非 AI 即时创作。每节末尾标源字段。
快速上手
dsh-clawrouter
— 源: plugin_wiki.wiki_content
安装与验证
dsh plugin --profile web add dsh-clawrouter
复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。
— 源: plugins.install
关键要点
- id: blockrun-review
-
- name: no-prod-deploy
- id: blockrun-llm
- No wallet yet?
npx -y @blockrun/clawroutergenerates one and prints its address. Stop it once you have the address, send it a few USDC on Base, then export the key. - id: blockrun-llm
— 源: plugin_wiki.readme_zh (fallback readme_raw)
常见问题
安装后提示 ✕ missing peer 是失败了吗?
不是失败。package.json 的 peerDependencies 列出的 6 个宿主包(dsh-llm / dsh-tools / dsh-credentials 等)由 Harness 自身在运行时注入;这是所有官方 Bundle 的共同做法。验证方式是 dsh --profile web --dump-config 应看到 blockrun-llm 与 blockrun-review 两行都被合成。
钱包密钥从哪里来?我没有 API Key 啊。
BlockRun 用钱包签名代替 API Key。已有钱包则从 ~/.blockrun/.session 或 ~/.openclaw/blockrun/wallet.key 导出;全新用户运行 npx -y @blockrun/clawrouter 会生成并打印地址,给它充少量 Base 链 USDC 后再 export BASE_CHAIN_WALLET_KEY=...。插件只读取你通过 walletKeyEnv 显式指定的环境变量,从不扫描磁盘。
安装后我默认用的模型变了吗?
没有变化。挂载这条 provider 路由不会改 dsh-base 默认的 deepseek-official;该路由要么由你显式选择,要么被审查闸门(review gate)调用。审查模型默认是 anthropic/claude-opus-5,按次以 USDC 结算。
审查闸门会拦截哪些操作?普通 git commit 会被问吗?
不会。规则刻意收窄,只拦截真正不可逆的操作:递归删除、原始磁盘写入、curl | sh、force push、git reset --hard、chmod 777、sudo、访问 ~/.ssh / ~/.aws / /etc/passwd,以及会"以后被执行"的文件写入(git hook、CI workflow、shell 启动文件、.gitconfig、postinstall 等)。日常读/编辑/构建一律放行;命令行"提到"危险命令(grep -rn "rm -rf" docs/)也不会被误报。
审查模型挂了怎么办?会被静默放行吗?
不会。默认 onReviewerFailure: ask——无法联系时升级为人类审批;需要无人值守自动化的用户可改成 deny,让闸门直接拒绝。deny 才让闸门"闭失败",ask 才让闸门"开失败",两者都不会在网络抖动时让危险命令溜过。
/gate drill 是干嘛的?我装了但没启用闸门也能跑吗?
/gate drill 会把 rm -rf / --no-preserve-root 这种必杀命令送过风险匹配器和真实审查模型,但绝不交给任何工具执行。它用来证明闸门真的在工作——/review 命令即使在闸门关闭时也能注册成功,所以单看 /review 能用无法证明闸门在工作;闸门未启用时 /gate drill 会直接报错。
怎么加自定义审查规则?
在 profile 的 cordis.patch.yml 中给 blockrun-review 的 config.extraRules 追加 {name, pattern, tools?},其中 pattern 是 JS 正则源串,对工具的渲染参数做匹配;tools 为空表示对所有工具生效。规则编译时校验,写错会立刻抛错而不会静默跳过。
这会让我用 DeepSeek 更便宜吗?
不会,本插件不替换 DeepSeek 官方账单。BlockRun 不支持 DeepSeek 的缓存命中折扣,cache 命中的 turn 在官方直连下约 $0.000056,经过本插件在 22K 输入时约 $0.007。建议:主循环继续用 DeepSeek 官方,本插件用于 DeepSeek 做不到的事(更强模型审查、Claude/GPT/Gemini/Grok 调用、x402 微支付)。
— 源: plugin_wiki.faq_json
兼容性
- DSH: >=0.1.0-rc.6
- Node: >=22.19(也接受 >=24)
- Platforms: 跨平台
— 源: plugin_wiki.compatibility_json
踩坑提醒
安装前请审阅上游仓库;本指南基于已收录字段自动派生,可能滞后于最新版本。如发现与官方文档冲突,请以上游为准。
— 来源:通用规则