安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install patentmax-novelty
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 patentmax-novelty。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

PatentMax Novelty 是一项 Openclaw Skills 工作流，用于评估某项技术方案是否可能已被披露。它会将足够详细的发明描述提交至 PatentMax API，检索专利文献以及论文和公开网页，并返回可比较的文献、相似度分析和范围明确的检索结论。已完成的报告可下载为 DOCX 文件，供审阅和分享。
此技能支持新颖性检索、申请前检查、创造性评估、竞争对手扫描和项目筛选。使用时需要 PatentMax API 密钥，并且在提交付费检索前必须获得用户明确确认。结果仅供技术参考，不保证可获专利，也不是官方认证的检索报告；结论必须考虑检索覆盖范围和未公开申请。

应用场景

在推进专利申请前，检查某项技术方案是否可能已被披露。
将发明披露或专利申请草案与相关现有技术进行比较。
筛查拟议项目或技术方向是否涉及可能已被占据的领域。
按选定地区和检索深度评估新颖性或创造性。
为项目团队生成可下载的 Word 检索报告。
如果用户只需要检索词，则生成双语关键词和 Boolean 检索式；此操作不会提交付费任务。
如果请求仅是查找类似专利、识别单件专利、分析公司或规划技术路线图，请勿使用此工作流；应改用相应的检索或分析功能。

工作原理

判断用户需要新颖性评估还是普通专利检索，并 уточ明目的、深度、地区、相关日期和文献覆盖范围。
收集具体的技术描述，涵盖问题、解决方法和产生的效果。如有需要，提出后续问题；少于 80 个字符的描述会被拒绝。
说明该任务需要付费，概述解决方案和所选参数，并在提交前获得用户确认。create 命令必须包含 --yes。
通过 PatentMax API 提交一个任务。记录其 operation_id；原任务运行期间不要创建重复任务。
使用相同的操作 ID 调用 wait 轮询，并持续转达返回的进度直至完成。任务可能需要数十分钟，每次 wait 调用会在 30 秒内返回。
完成后，脚本会下载 Word 报告并返回 JSON 元数据。概述检索范围、最接近的文献、特征层面的比较、质量提示和报告路径，但不要作出有保证的法律结论。
说明相关限制，例如 18 个月公开期限、数据库和术语方面的缺口，以及需要官方检索报告时应委托具备资质的机构。

配置指南

在 https://api.ip930.com 注册，创建 PatentMax API 密钥，并将其配置为 PATENTMAX_API_KEY。根据服务文档，新用户可能会获得试用额度。
将 $DIR 设为已安装技能目录的绝对路径。技能文档未指定软件包安装命令；请使用该目录中的脚本和参考文件。
在用户的工作目录中运行命令，DOCX 默认保存在此目录；也可以指定 --out-dir。脚本和输入文件请使用绝对路径。如果无法使用 python，请依次尝试 python3、py，或 WorkBuddy 提供的 Python 可执行文件完整路径。
付费提交前，向用户确认技术描述和参数。将命令超时设为 120 秒；各脚本命令会在 30 秒内返回。
export PATENTMAX_API_KEY=""
python "$DIR/scripts/patentmax_novelty.py" options

只有在说明价格并获得用户确认后才提交。

python "$DIR/scripts/patentmax_novelty.py" create
--title ""
--solution ""
--purpose pre_filing
--depth standard
--yes

继续轮询同一任务；不要再次提交。

python "$DIR/scripts/patentmax_novelty.py" wait --operation-id

可选：从文件读取解决方案，或选择输出目录。

python "$DIR/scripts/patentmax_novelty.py" create
--solution-file "/absolute/path/solution.md"
--purpose novelty
--depth deep
--out-dir "/absolute/path/reports"
--yes PatentMax 新颖性检索 数据架构与分类体系
输入和任务选项
字段或选项 用途
title / solution 发明名称和技术描述；描述应说明问题、技术手段和效果。 --solution-file 从绝对文件路径读取较长的发明披露或草案。 --purpose novelty、inventiveness、pre_filing、project_screening 或 competitor_scan。 --depth quick、standard 或 deep。申请决策建议使用 standard 或 deep；quick 适用于初步筛查。 --regions 默认为 global；仅检索中国时使用 CN，也可使用逗号分隔的列表，例如 CN,US,EP,JP。 --patents-only 限定来源类型；如果非专利文献和公开网页也应作为现有技术，通常不要启用。 --idempotency-key 可选；省略时会生成基于请求的密钥，以防同一请求重复收费。 返回的数据和文件
任务响应包含用于轮询的 operation_id。完成响应包含报告元数据、带有已下载 DOCX 路径的 files 数组，以及 searched、closest 和 report_sections 等摘要字段。
searched 描述检索量，包括已分析的专利文献数量以及论文和网页的数量。
closest 列出高度相关的对比文献及其 relevance 分类：X 表示单独就可能影响新颖性或创造性，Y 表示与其他文献结合时相关，A 表示背景资料。使用每份文献的 conclusion 说明特征层面的重合情况。
quality_status 和 quality_hint 用于提示输入或结果质量方面的限制。当状态不是 qualified 时，应转达提示内容。
report_sections 标明 Word 报告中包含的章节。报告默认保存在工作目录，也可保存至通过 --out-dir 设置的目录。
错误响应使用 error 和面向用户的中文 message；应遵循该消息，不要猜测或通过更改输入重试。退出代码用于区分运行中、成功、错误、输入无效和已有重复任务正在运行。

高级特性

检索 PatentMax 专利数据，并可将论文和公开网页纳入现有技术来源。
支持不同的检索目的、三种检索深度和地区覆盖范围，包括全球检索及指定市场检索。 --solution-file 接受较长的发明披露和专利草案。
异步运行：
create
返回操作 ID，
wait
报告进度，
download
可再次获取报告，
cancel
可停止任务。
默认采用基于请求的幂等机制，帮助防止重复提交和收费；恢复已有任务时，应使用其原始操作 ID，而不是另建任务。
导出 DOCX 报告，并返回包含检索数量、最接近文献、相关性、质量和报告章节的结构化 JSON 元数据。
提供仅生成关键词的路径，可生成中文和英文词语、同义词及 Boolean 检索式，而不提交付费检索。
严谨传达结果：比较技术特征，不要仅依赖摘要；不要把多份文献合并视为一份披露；不要承诺新颖性或可专利性。

name: patentmax-novelty description: 专利查新与可专利性判断。当用户问一个技术方案有没有人做过、能不能申请专利、有没有新颖性或创造性、申请前要做查新、立项前要筛查方向是否被占，或要一份可交付的查新报告时使用。常见说法：「帮我查新」「查新检索」「这个能不能申请专利」「有没有人做过」「相似专利对比」，也可以直接给写好的交底书或专利初稿。Use when the user asks whether a technical idea is novel, patentable, or already disclosed in prior art. Requires a PatentMax API key. Also covers prior art search, novelty search, patentability check, or checking a finished invention disclosure. version: "1.1.1"
author: PatentMax
user-invocable: true
argument-hint: "[技术方案描述]"
allowed-tools: Bash, Read, Write

PatentMax 专利查新

给一段技术方案描述，返回对比文件、相似度分析与查新结论，判断这个方案有没有被公开过、还能不能申请。异步生成，可导出 Word 报告直接交付。

数据来自 PatentMax 专利库，可将论文与公开网页一并计入现有技术。

使用问题、企业采购：访问 ip930.com，右下角「联系客服」。

需要 PatentMax 密钥。 在 https://api.ip930.com 注册（新用户送 ¥50 体验额度）、创建密钥，设成环境变量 PATENTMAX_API_KEY。没设时脚本会返回中文提示，原样转告用户即可。

运行环境（必读，所有命令都适用）

部分 WorkBuddy 等环境的命令行不完整，cat、ls、sleep、rm 等可能找不到。为保证任何电脑都能跑通：

脚本路径一律写绝对路径：$DIR/scripts/patentmax_novelty.py（$DIR 是本技能所在目录），不要写 cd ... && ...（前一步失败会让后面整条静默不执行）

python 找不到时依次试 python3、py；还找不到就用 WorkBuddy 自带的：先用 Glob 在 ~/.workbuddy/binaries/python/versions/ 下找到 python.exe，用它的完整路径。下文所有 python 都按这条替换

不要用 cat 读文件、不要用 sleep 等待：读文件用 Read 工具；等待由脚本自己完成
命令在用户的工作目录里运行，生成的 Word 会存到这个目录；也可以用 --out-dir 指定
命令超时设为 120 秒。脚本每条命令最多跑 30 秒就返回，不会卡住
核心原则

技术方案描述的质量直接决定结果。 一句「一种新型电池」查不出任何有用的东西，却照样扣费。方案少于 80 字脚本会拦下来。

这是付费任务，执行前必须报价并取得用户确认。 命令必须显式加 --yes。

用户只想「看看有没有类似的」时不要跑这个。 用检索加相似专利就够了，便宜得多——见「什么时候不该用」。

判断新颖性看权利要求，不看摘要。 摘要读着像不等于落进保护范围，要把技术特征逐条比。

不出保证性结论。 不写「具备新颖性」「可以申请」——见「结论纪律」。

不重新提交。 报告要跑几十分钟，跑得久不代表失败。只要没有报错，就继续 wait。重新提交是这个技能最常见、代价最大的错误：输入写法一变就会新建任务、重复扣费，用户还要从头再等一遍，而原来那份其实还在正常生成。

什么时候用
用户说 用不用
「这个想法能不能申请专利」 ✅ 用
「有没有人做过这个方案」 ✅ 用
「申请前帮我做个查新」 ✅ 用
「立项前看看这个方向被占了没」 ✅ 用 --purpose project_screening
「要一份查新报告交给项目组」 ✅ 用，跑完导出 DOCX
「交底书 / 专利初稿写好了，看看有没有人做过」 ✅ 用，直接 --solution-file 交底书.docx
「先给我几个检索词 / 检索式」 ✅ 不用提交任务，见「只要检索词或检索式」
什么时候不该用
用户说 该用什么
「查一下有没有类似的专利」 普通检索 + 相似专利，两次加起来便宜得多
「XX 公司在做什么技术」 企业情报分析
「我们下一步该往哪布局」 技术路线分析
「CN109761224A 是什么」 普通检索的单篇速览

「有没有类似的」和「能不能申请」是两个问题。 前者用检索，后者才需要查新。判断不准时问用户一句：「你是想先看看有哪些相关专利，还是要一个能不能申请的结论？」

执行前检查
检查项 必须确认
方案内容 解决什么问题、用什么手段、达到什么效果，三者缺一不可
用途 立项筛查、申请前查新、还是正式申请决策——决定 --purpose 和 --depth
目标申请日 判断现有技术以公开日为准，有明确申请计划时要说清楚
地域 只关心国内还是要覆盖多国
文献范围 是否把论文和网页计入现有技术（默认计入，一般不要关）
保密 技术方案会发送到服务端。涉及未申请的核心参数时提醒用户
技术方案怎么写

这是整件事里最重要的一步，详见 references/solution-guide.md。

至少讲清三件事：

解决什么问题 — 现有技术卡在哪、有什么缺陷

用什么手段 — 具体的结构、材料、步骤、参数、控制逻辑。这块最关键，也是最容易写空的地方

达到什么效果 — 最好有量化指标

一份够用的描述长这样：

采集阀门转轴角度、启闭扭矩及前后水位，根据扭矩增量和积雪含水状态判断卡滞，并控制振动装置清理。

具体到了传感量、判据、执行动作。这种描述才查得出东西。

用户给的描述不够细时先问，别急着跑——问两三个问题的成本，远低于跑一次没用的查新。

只要检索词或检索式（不花钱）

用户只想要检索关键词或检索式、自己去别的库查时，不提交查新任务。按「技术对象 / 核心机制 / 区别特征」三块，各给中英文关键词和同义词，再组合成一条布尔检索式（AND / OR，短语用双引号），并标注「未实际检索」。最后问一句要不要正式查新。

提交前确认（一条消息问完，不花钱）

参数定好后，用一条消息列给用户确认，用户回「确认」或改完再加 --yes：

📋 准备查新

• 技术问题：……
• 技术手段：……
• 技术效果：……
• 技术特征：F1 一种××（技术主体）；F2 ……；F3 ……（从方案里摘，不要编）
• 查新目的 / 深度 / 地域：novelty / standard / global
• 关键日：××××-××-××（用户没给就按今天）
• 费用：¥15（以提交后返回的价格为准；任务失败或取消全额退回）
• 用时：通常要几十分钟；完成后 Word 报告自动存到当前目录

用户已经在同一轮对话里确认过的，不要再问第二遍。

命令

# 基本用法
python "$DIR/scripts/patentmax_novelty.py" create \

--title "阀门卡滞诊断与清理装置"
--solution "采集阀门转轴角度与启闭扭矩，根据扭矩增量判断卡滞并控制振动装置清理……"
--purpose pre_filing --depth standard
--yes

# 方案长的时候走文件
python "$DIR/scripts/patentmax_novelty.py" create \

--solution-file "/solution.md" --purpose novelty --yes

# 看可选值
python "$DIR/scripts/patentmax_novelty.py" options

# 接着等：每次最多 30 秒，完成时自动下载 Word
python "$DIR/scripts/patentmax_novelty.py" wait --operation-id

# 重新下载 Word（wait 完成时已自动下载过）
python "$DIR/scripts/patentmax_novelty.py" download --report-id

# 不跑了
python "$DIR/scripts/patentmax_novelty.py" cancel --operation-id

参数怎么选

--purpose 什么场景 novelty 判断是否已被公开，最常用
inventiveness 判断创造性，比新颖性更严
pre_filing 申请前查新，马上要递交
project_screening 立项筛查，看方向有没有被占
competitor_scan 竞品扫描

--depth 取 quick / standard / deep。正式申请决策用 standard 或 deep，立项摸底 quick 够了。

--regions 默认 global，只关心国内填 CN，要覆盖多国用 CN,US,EP,JP。

--patents-only 一般别加——查新的现有技术不限于专利，论文和公开产品资料同样能破坏新颖性。

--idempotency-key 不填会按请求内容自动生成，同样的方案重试不会重复扣费。

等待并报告进度

create 约 15 秒后返回。返回退出码 10 时，先发这一句，再发输出里的进度：

专利查新报告已开始生成，这类报告通常要几十分钟，进度会实时告诉你。

记下输出 JSON 里的 operation_id，后面都用它。不主动向用户展示任务编号，用户问起再给。然后运行：

python "$DIR/scripts/patentmax_novelty.py" wait --operation-id

每条 wait 最多 30 秒就返回。按退出码处理：

退出码 含义 怎么做 10 还在生成 发送输出里的进度，然后立即再运行一次 wait 0 完成了，Word 报告已自动下载 按「读结果」交付 1 出错 按「出错时」处理 2 输入有误，什么都没提交 按 message 补齐后再运行 3 同样的任务已经在跑 用输出里的 operation_id 运行 wait，不要换写法重新提交 进度怎么发（照原文，不改字）

把每条 [进度] …… / [进度 X%] …… 去掉方括号部分，按下表加图标后原文发送：

进度行 发送
[进度] 已开始生成…… 🚀 已开始生成……
[进度] 排队中，已等待…… 🕒 排队中，已等待……
[进度] 生成中，已用时…… 📝 生成中，已用时……
[进度 X%] 某阶段，已用时…… 📝 X% 某阶段，已用时……

例：[进度 35%] 检索竞争对手专利，已用时 6分30秒 → 发送 📝 35% 检索竞争对手专利，已用时 6分30秒。

等待期间只发进度，不附加其它文字；不改写进度文字，不自己估算剩余时间，不编造没出现的百分比
出结果之前不要结束回复。 退出码为 10 时，发完进度立即再运行 wait
等了几十分钟还没完成 → 正常，继续 wait。命令断了、对话重开了，也用同一个 operation_id 运行 wait 接着看，不要重新 create
读结果

退出码 0 时 Word 报告已经下载好，输出 JSON 的 files 里是完整路径。先发：

✅ 100% 专利查新报告已生成，用时
📄 报告：

quality_status 不是 qualified 时，紧接着把 quality_hint 讲给用户。没有 Word 时（有 docx_note）照实说。

再根据 summary 用几句话讲要点，讲结论时遵守下面的「结论纪律」（不下保证性结论，交代检索边界）：

字段 怎么讲
searched 检索规模：找到多少篇专利、逐篇分析了多少篇、论文和网页各多少条
closest 最接近的几篇（按评分排）。relevance 是 X / Y / A：X 单篇就可能影响新颖性或创造性，Y 要和其他文献结合，A 只是背景。逐篇讲清撞在哪一点（conclusion）
report_sections Word 报告里有哪几章，用户想细看时告诉他去哪章找

交付消息里再加「给你的下一步」（还是同一条消息，不调用工具）：

用一道选择题帮用户想清楚怎么补强：「你的方案在〈撞上的那个特征〉上更接近哪种？A 常规做法 → 容易被〈最接近的那篇〉命中；B ……；C 最有区分力，但需要实验数据支撑。」选项必须来自用户的方案和报告内容，不要编
一句提醒：「正式递交申请前，不要公开发表、参展或销售，否则会破坏新颖性。」
「新颖性」「创造性」第一次出现时加白话括注：新颖性（之前有没有人公开过一模一样的方案）、创造性（和已有方案比，改进是不是显而易见）

最后一句固定是：

在 https://api.ip930.com 控制台可以查看所有任务和余额。

不要打开 Word 把正文贴进对话，也不要读「完整结果」JSON 全文：用户直接打开 Word 看。贴进来既拖长对话，又白白消耗积分
以上是本轮最后的输出，发完就停：之后不再调用工具、不补表格、不写总结和建议，等用户回复。在这之后再调工具，收尾信息会被埋掉，用户看不到

用户追问细节时，再按下面几条组织回答：

最接近的对比文件是哪几篇。 按相似度排，重点看前三篇。

每篇在哪一点上撞上了。 逐条比技术特征——是解决同一个问题？用了同样的手段？还是效果相近？看权利要求，不看摘要。

是不是同一篇文献公开了全部必要特征。 这是新颖性的判断标准——多篇结果不能拼成单篇覆盖。多篇组合起来才覆盖的，那是创造性的问题，不是新颖性。

结论怎么下。 说清楚是「未检索到破坏新颖性的对比文件」还是「存在高度相似的在先专利」，别用模糊表述让用户自己猜。

质量提示要说。 quality_status 不是 qualified 时，说明哪块数据不足、结论要打几分折扣。

出错时

脚本出错时输出 {"error": true, "message": "……"}，message 是写给用户看的中文说明，里面已经写明了下一步怎么办。

原样转述 message，不猜原因、不补充建议、不自己换写法重试
退出码 2（输入有误：少必填项、文件读不了、方案太短）：什么都没提交、没扣费，按 message 补齐后再运行
任务失败或取消时，预扣的费用会全额退回，告诉用户这一点
结论纪律

禁止输出「具备新颖性」「可以申请」「全球无人做过」这类保证性结论。

使用这个表述：

截至 [日期]，在 [数据库、地域、文献类型] 及所列检索范围内，未发现一篇在关键日期前公开并披露全部必要技术特征的文献。本结果不排除未公开申请、数据库缺口、非专利公开或术语差异造成的漏检。

三条必须交代：

18 个月公开窗口 — 专利从申请到公开约一年半，这期间的申请谁也检索不到，这是查新最大的固有局限 检索范围有边界 — 只能证明「范围内找到了什么」，不能证明「不存在」
正式场合需专业机构 — 查新报告可以生成，但正式的科技查新报告需要有资质的机构出具并盖章，本结果是技术参考

最后一条尤其要讲明白——别让用户拿这份文档去当官方查新报告用。

相关能力

同一把密钥、同一个余额：

普通检索 — 关键词与字段式检索、单篇速览、相似专利、引证分析、15 维统计、企业画像
企业情报分析 — 竞争格局与对手动作
技术路线分析 — 下一步往哪走、专利怎么布

典型顺序：检索摸底 → 查新确认方案 → 申请。方向都还没定的话，先做情报分析和路线分析。

参考
references/solution-guide.md — 技术方案怎么写，含三个颗粒度对照
references/workflow.md — 完整工作流：先摸底再查新、参数选择、结果解读
references/faq.md — 排查：参数报错、任务卡住、结果太泛、质量分档含义

PatentMax Patent Search

PatentMax Competitive Intelligence