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 个技能:
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
知识产权技能包(`ip-legal`)— 12 个技能:
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
法律研究技能包(`legal-research-cn`)— 4 个技能:
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
四、安装步骤
步骤 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
“`
三个技能包安装顺序建议:
-
法律研究(基础查询)
-
IP 技能包(如有知产业务)
-
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 阶段流程输出法律备忘录:
-
信息完整性检查
-
研究问题确认(硬性暂停,等用户确认)
-
二手文献检索(Tavily,可选)
-
二手文献分析
-
一手权威资料检索(元典法规/案例)
-
分析与推理
-
验证和风险识别
-
生成法律研究备忘录
输出格式: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]、[模型知识])
九、注意事项
-
来源标签必须标注:所有法条引用须标注 `[元典法规 YYYY-MM-DD]`,未经核验的标注 `[verify – 需对照元典原文]`。
-
不能替代律师判断:AI 检索的是研究材料,不是法律意见。出具法律意见前须经执业律师复核。
-
数据时效:优先引用 `sxx=现行有效` 的条文,失效条文必须明确标注。
-
API 限流:元典 API 有调用频次限制,大量检索时注意控制频率。
-
网络稳定性:`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等协议讨论合规边界
如果您也在学习AI+法律,或者专注 AI 产品治理、数据治理、算法与组织边界这类话题,欢迎一起交流探讨。

夜雨聆风