乐于分享
好东西不私藏

OpenClaw + Claude for Legal的中国心:从0到1搭建私人法律研究助手(附踩坑记录)

OpenClaw + Claude for Legal的中国心:从0到1搭建私人法律研究助手(附踩坑记录)

一、为什么开始

法律人的日常:查法条、查案例、查企业信息

以前,打开北大法宝、裁判文书网、天眼查,切三个窗口。

现在,元典开放平台的法律 API(法规/案例/企业) + OpenClaw 的 AI 助手 = 一个熟悉中国法的私人AI助理。

我想直接问 AI:「《个人信息保护法》第 24 条怎么规定的?」然后它直接把原文给我。法律数据库需要实时、准确、可溯源,所以我选择了元典开放平台的法律 API。

我的 OpenClaw 位于腾讯云服务器上,已经作为成长教练、编程伙伴、救火队员,稳定陪伴我了 3 个月。

当看到律川 Planet 的这篇文章《把 Anthropic 的 Claude for Legal 搬进中国法务的工位》(原文链接https://mp.weixin.qq.com/s/PIeBSG1RAofrIsEICVNfZg)时,我决定也试一试。

能让米宝成为更强更专业的私人助手,why not?

本篇文章记录完整的安装过程,包括踩坑和解决。

二、环境准备

1. 已安装 OpenClaw

假设你已经有 OpenClaw(昵称:米宝同学)运行(本文基于 OpenClaw 2026.3.11 版本)。

2. 获取元典 API Key

去 [元典开放平台](https://open.chineselaw.com/) 注册账号,获取 API Key:

sk_xxxxxxxxxxxxx

(我的测试 Key,你需要换成自己的)

3. 下载技能包

在这里下载工具包https://yuanli.ailaw.cn/toolkits/  (https://yuanli.ailaw.cn/toolkits/),可以选“中国法律实务智能体技能套装”工具包。

我下载了四个:

agent-for-legal-cn.zip

legal-skillpack-ai-governance-legal.zip

claude-for-legal.zip

legal-skillpack-legal-research-cn.zip

4. 将工具包发给 OpenClaw

我用的是飞书,直接在飞书对话框里直接把文件都发给了OpenClaw米宝同学,然后剩下的就是米宝同学自己干活、自己总结、自己完工。

重点重点:踩坑的地方是在安装legal-research相关的技能时(详见下文踩坑 1:MCP Server 启动超时),由于MCP配置的问题,导致我和米宝一度失联。

以下内容来自米宝同学复盘

三、技能包

本文涉及三个技能包,共 24 个技能:

AI 治理技能包(`ai-governance-legal`)— 8 个技能:

技能
功能
ai-governance-cold-start-interview
初始化访谈(所有技能前提)
ai-governance-use-case-triage
AI 用例合规分类(审批/有条件/不审批)
ai-governance-aia-generation
生成 AI 系统合规评估报告
ai-governance-vendor-ai-review
审查供应商 AI 协议条款
ai-governance-reg-gap-analysis
法规差距分析
ai-governance-policy-monitor
政策漂移监测
ai-governance-policy-starter
生成 AI 使用政策草稿
ai-governance-inventory
AI 系统合规清单管理
ai-governance-customize
单点调整合规配置

知识产权技能包(`ip-legal`)— 12 个技能:

技能
功能
ip-cold-start-interview
知识产权冷启动访谈
ip-clause-review
审查合同知识产权条款
ip-clearance
商标/专利注册前初筛
ip-cease-desist
知识产权侵权告知函
ip-fto-triage
专利侵权风险初步排查
ip-infringement-triage
侵权线索风险分级
ip-invention-intake
发明披露初筛
ip-matter-workspace
法律事项工作区管理
ip-oss-review
开源许可证合规审查
ip-portfolio
知识产权组合管理

法律研究技能包(`legal-research-cn`)— 4 个技能:

技能
功能
prc-legal-research-law-search
法条精确检索
prc-legal-research-case-search
裁判文书检索
prc-legal-research-company-search
企业信息查询
prc-legal-research-deep-research
综合法律研究(8 阶段备忘录)

四、安装步骤

步骤 1:安装元典 MCP Server

MCP(Model Context Protocol)是连接 AI 和外部工具的协议。元典提供了官方 MCP Server:

“`bash

npm install -g yuandian-mcp-server

“`

验证安装:

“`bash

which yuandian-mcp-server

输出结果如下: /root/.nvm/versions/node/v22.22.1/bin/yuandian-mcp-server

“`

步骤 2:配置 API Key

把 Key 写到环境变量文件:

“`bash

~/.openclaw/.env

YUANDIAN_API_KEY=sk_uU23OSDYQ0OR7OBGnpzfx4spTxj9JjxV

“`

重启 Gateway 加载新配置:

“`bash

openclaw gateway restart

“`

步骤 3:安装技能包

技能包位置:`/tmp/legal-agent/legal-skillpack-legal-research-cn/`

执行安装:

“`bash

cd /tmp/legal-agent/legal-skillpack-legal-research-cn/

python3 install.py

“`

安装器会自动检测 OpenClaw 环境,把 4 个技能复制到 `~/.openclaw/skills/`:

“`

INSTALL prc-legal-research-case-search

INSTALL prc-legal-research-company-search

INSTALL prc-legal-research-deep-research

INSTALL prc-legal-research-law-search

Summary: installed=4 updated=0 skipped=0

“`

步骤 4:安装 AI 治理技能包(可选)

AI 治理技能包用于 AI 合规评估、用例分类、政策生成。

“`bash

cd /tmp/ai-governance-legal-skillpack/

python3 install.py

“`

安装后生成 `~/.openclaw/profile/ai-governance-legal/profile.md` 业务档案。

步骤 5:安装知识产权技能包(可选)

IP 技能包用于商标、专利、著作权、开源合规等实务。

“`bash

cd /tmp/ip-legal-skillpack/

python3 install.py

“`

三个技能包安装顺序建议:

  1. 法律研究(基础查询)

  2. IP 技能包(如有知产业务)

  3. AI 治理(如有 AI 合规业务)

所有技能包安装后,`~/.openclaw/skills/` 目录下共 24 个技能。

五、关键问题与排查

踩坑 1:MCP Server 启动超时

现象:启动 yuandian-mcp-server 时报错 `ConnectTimeoutError: timeout 10000ms`。

原因:MCP Server 内部连接的是 `apiplatform.legalmind.cn`,这个域名偶尔超时。但 curl 测试用的 `open.chineselaw.com` 是正常的。

解决

  • 增加超时等待(30-60 秒)

  • 多次重试,最终可以启动成功

  • 启动后会显示:`35 dynamic API tools loaded`

踩坑 2:OpenClaw 不识别 MCP 工具

现象:MCP Server 启动成功,但 OpenClaw 的工具列表里没有元典工具。

原因:OpenClaw 2026.3.11 版本没有标准 `mcpServers` 配置字段。它使用 `mcporter`(memory/QMD 的 MCP runtime),和标准 MCP 客户端(Claude Desktop、Cursor)配置方式不同。

解决:不升级 OpenClaw(升级可能导致不稳定),改为将技能文件中的 MCP 调用改为 `exec curl` 直接调用 API

修改每个技能的 `SKILL.md`:

原来(MCP 方式):

“`

调用 yuandian_rh_ft_search 工具…

“`

改为(curl 方式):

“`bash

curl -s -X POST -H “Content-Type: application/json” \

-H “X-API-Key: ${YUANDIAN_API_KEY}” \

-d ‘{“keyword”:”关键词”,”top_k”:10}’ \

https://open.chineselaw.com/open/rh_ft_search

“`

踩坑 3:curl 认证方式错误

现象:`curl -H “Authorization: Bearer …”` 返回 500 错误。

正确方式:元典 API 使用 `X-API-Key` 头,不是 `Authorization: Bearer`。

“`bash

❌ 错误

curl -H “Authorization: Bearer sk-…”

✅ 正确

curl -H “X-API-Key: sk-…”

“`

API endpoint 也要注意:用 `/open/` 路径,不是 `/api/v1/`。

六、验证测试

测试 1:法条关键词检索

“`bash

curl -s -X POST \

-H “Content-Type: application/json” \

-H “X-API-Key: ${YUANDIAN_API_KEY}” \

-d ‘{“keyword”:”自动化决策”,”fgmc”:”个人信息保护法”,”top_k”:3}’ \

https://open.chineselaw.com/open/rh_ft_search

“`

返回(格式化后):

“`json

{

“code”: 200,

“data”: [

{

“fgmc”: “中华人民共和国个人信息保护法”,

“ft_num”: “第二十四条”,

“llm_content”: “个人信息处理者利用个人信息进行自动化决策,应当保证决策的透明度和结果公平、公正…”,

“sxx”: “现行有效”

}

]

}

“`

✅ 成功,返回了《个保法》第 24 条原文。

测试 2:法条详情查询

“`bash

curl -s -X POST \

-H “Content-Type: application/json” \

-H “X-API-Key: ${YUANDIAN_API_KEY}” \

-d ‘{“fgmc”:”中华人民共和国个人信息保护法”,”ftnum”:”第二条”}’ \

https://open.chineselaw.com/open/rh_ft_detail

“`

返回

“`

📖 《中华人民共和国个人信息保护法》第二条

自然人的个人信息受法律保护,任何组织、个人不得侵害

自然人的个人信息权益。

⏱ 时效状态: 现行有效

📊 效力级别: 法律

📅 施行日期: 2021-11-01

“`

测试 3:语义检索

“`bash

curl -s -X POST \

-H “Content-Type: application/json” \

-H “X-API-Key: ${YUANDIAN_API_KEY}” \

-d ‘{“query”:”个人信息处理者义务”,”sxx”:[“现行有效”],”return_num”:3}’ \

https://open.chineselaw.com/open/law_vector_search

“`

语义检索适合口语化提问,不用精确法条名称,AI 会自动匹配相关条文。

七、使用场景

场景 1:快速查法条

你问 AI:「个人信息保护法关于自动化决策的规定」

AI 直接调用 `rh_ft_search`,返回第 24 条、第 55 条、第 73 条,附带原文和时效状态。

场景 2:查案例

输入案号或关键词,AI 调用 `rh_ptal_search`(普通案例)或 `rh_qwal_search`(指导性案例),返回裁判文书列表。

场景 3:查企业

输入企业名称,AI 调用 `rh_company_info`,返回工商登记、涉诉信息、风险信号。

场景 4:综合法律研究

使用 `prc-legal-research-deep-research` 技能,按 8 阶段流程输出法律备忘录:

  1. 信息完整性检查

  2. 研究问题确认(硬性暂停,等用户确认)

  3. 二手文献检索(Tavily,可选)

  4. 二手文献分析

  5. 一手权威资料检索(元典法规/案例)

  6. 分析与推理

  7. 验证和风险识别

  8. 生成法律研究备忘录

输出格式:Markdown 法律备忘录,含法规清单、案例清单、风险分析、实务建议。

八、技能文件位置

安装后,技能文件在:

“`

~/.openclaw/skills/

├── ai-governance-aia-generation/

├── ai-governance-cold-start-interview/

├── ai-governance-customize/

├── ai-governance-inventory/

├── ai-governance-policy-monitor/

├── ai-governance-policy-starter/

├── ai-governance-reg-gap-analysis/

├── ai-governance-use-case-triage/

├── ai-governance-vendor-ai-review/

├── ip-cease-desist/

├── ip-clause-review/

├── ip-clearance/

├── ip-cold-start-interview/

├── ip-customize/

├── ip-fto-triage/

├── ip-infringement-triage/

├── ip-invention-intake/

├── ip-matter-workspace/

├── ip-oss-review/

├── ip-portfolio/

├── ip-takedown/

├── prc-legal-research-law-search/

├── prc-legal-research-case-search/

├── prc-legal-research-company-search/

└── prc-legal-research-deep-research/

└── SKILL.md          # 综合研究技能说明

“`

每个 `SKILL.md` 包含:

  • 触发条件(什么时候用这个技能)

  • 输入参数格式

  • 输出格式要求

  • 来源标签规范([元典法规]、[verify]、[模型知识])

九、注意事项

  1. 来源标签必须标注:所有法条引用须标注 `[元典法规 YYYY-MM-DD]`,未经核验的标注 `[verify – 需对照元典原文]`。

  1. 不能替代律师判断:AI 检索的是研究材料,不是法律意见。出具法律意见前须经执业律师复核。

  1. 数据时效:优先引用 `sxx=现行有效` 的条文,失效条文必须明确标注。

  1. API 限流:元典 API 有调用频次限制,大量检索时注意控制频率。

  1. 网络稳定性:`apiplatform.legalmind.cn` 偶尔超时,curl 直接调用 `open.chineselaw.com` 更稳定。

十、资源链接

  • 元典开放平台:https://open.chineselaw.com/

  • 元典 API 文档:https://apiplatform.legalmind.cn/

  • 支持邮箱:yuandianzonghe@thunisoft.com

  • OpenClaw 文档:https://docs.openclaw.ai

本文记录完整的安装和踩坑过程,供参考。如有问题,欢迎在评论区讨论。

免责声明:本技术指南仅涉及工具安装和配置方法,不构成法律意见。元典数据来源于北京华宇元典信息服务有限公司,使用 API 须遵守其服务条款。

✎ 推荐阅读 

当AI产品成为“监工” — 从钉钉ONE看算法、隐私与效率的冲突

【AI合规】AI训练可以直接使用开源数据吗?从MIT、GPL、CC等协议讨论合规边界

美国联邦人工智能监管走到关键路口:《Great American AI Act》讨论草案发布(附逐节摘要)

未来生命研究所:《欧盟人工智能法》简报第103期

以“小快灵”立法规范人工智能拟人化互动服务

如果您也在学习AI+法律,或者专注 AI 产品治理、数据治理、算法与组织边界这类话题,欢迎一起交流探讨。

扫码添加