把 12306-mcp 接入 OpenClaw：AI 查票教程

来源类型： 微信公众号文章
日期： 2026-06-02
标签： AI, OpenClaw, 办公效率, 网络安全, 编程
原文链接： https://mp.weixin.qq.com/s/fo3AzScq9YKYrCSws5NCNA

摘要

这篇是实操教程：把开源项目 12306-mcp 接到 OpenClaw，让 Agent 能查询站点 code、车票和中转方案。它适合先做“查票助手”，不要包装成自动购票。如果你已经在用 OpenClaw，最有价值的不是让它“多知道一个网站”，而是让它能调用一个真实工具。12306-mcp 就是这样的工具：它把 12306 车票查询能力封装成 MCP server，OpenClaw 接上以后，用户可以直接用自然语言让 Agent 帮忙查路线。 OpenClaw 接入 12306-mcp 的三步流程先说边界 12306-mcp 主要用于查询车票、站点、过站和中转信息。涉及账...

核心内容

这篇是实操教程：把开源项目 12306-mcp 接到 OpenClaw，让 Agent 能查询站点 code、车票和中转方案。它适合先做“查票助手”，不要包装成自动购票。

如果你已经在用 OpenClaw，最有价值的不是让它“多知道一个网站”，而是让它能调用一个真实工具。12306-mcp 就是这样的工具：它把 12306 车票查询能力封装成 MCP server，OpenClaw 接上以后，用户可以直接用自然语言让 Agent 帮忙查路线。
OpenClaw 接入 12306-mcp 的三步流程
先说边界

12306-mcp 主要用于查询车票、站点、过站和中转信息。涉及账号、支付、下单和身份证信息时，不要让 Agent 自动操作，至少要保留人工确认。

第一步：准备 Node.js 和 12306-mcp

这类 MCP server 最轻的接入方式是 stdio：OpenClaw 需要调用工具时，自动通过 npx 拉起 12306-mcp。对普通用户来说，这比长期跑一个服务更省心。

先确认本机有 Node.js / npm node -v npm -v # 可选：直接试跑 12306-mcp npx -y 12306-mcp

如果 npx -y 12306-mcp 能启动，说明本机已经具备运行条件。第一次运行会稍慢，因为要下载依赖。

第二步：写入 OpenClaw 的 MCP 配置

OpenClaw 自带 MCP 注册命令。你只要把 12306-mcp 保存成一个名为 12306-mcp 的 MCP server，后续 Agent 就能在工具列表里发现它。

openclaw mcp set 12306-mcp '{"command":"npx","args":["-y","12306-mcp"]}' # 看看有没有写进去 openclaw mcp list openclaw mcp show 12306-mcp --json
这里推荐先用 stdio，不推荐一上来就折腾 HTTP 服务。stdio 的好处是：不用暴露端口，不用配置公网地址，也更适合个人电脑或轻量 Agent 环境。

第三步：让 OpenClaw 先查 station code

铁路查询通常不是直接用“北京南”“上海虹桥”这些中文站名完成的，很多接口会先把城市或车站转换成 station code。原文件里的教程图也展示了这一点：先查上海相关站点 code，再进入车票查询。
原教程截图：先查询城市对应的 station code
你可以在 OpenClaw 里这样问：帮我查一下“上海”相关的 12306 station code，列出站名和 code。
如果 Agent 返回了类似 SHH、AOH、SNH 这样的 code，就说明 MCP 工具已经能被调用了。

第四步：用出发地、目的地和日期查车票

拿到 station code 后，就可以查具体车票。原文件里的截图里，工具调用的是 get-tickets，参数里包含日期、出发站和到达站。
原教程截图：调用 get-tickets 查询车次和余票
示例参数可以这样理解： { "date": "2025-04-15", "from_station": "BJP", "to_station": "SHH" }
在 OpenClaw 里，不需要让用户自己写 JSON。更自然的问法是：

帮我查 2025-04-15 北京南到上海虹桥的高铁，优先看下午出发，列出车次、出发到达时间、耗时和余票。

第五步：做成更像 Agent 的连续流程

单次查票只是开始。更像 Agent 的用法，是让 OpenClaw 先补齐缺失信息，再调用工具，再把结果整理成可读选项。

1. 如果用户只说“明天去上海”，先追问出发城市和时间范围。

2. 如果用户写的是中文站名，先查 station code。

3. 查票后按时间、耗时、余票和价格做简单排序。

4. 最后提醒：这只是查询结果，购票仍以 12306 官方页面为准。

你可以这样测试：我明天下午想从杭州去上海，别太晚到。帮我查可选高铁，并按“时间合适、耗时短、余票充足”排序。

常见问题：为什么我建议先别做自动购票

查票是低风险动作，自动下单是高风险动作。后者会涉及账号登录、乘车人、支付和订单确认。对普通用户来说，Agent 最好先帮忙整理方案，最后一步仍交给用户自己点确认。

这也是这类工具最适合落地的方式：先做查询和决策辅助，再逐步扩展到更复杂的授权流程。这样既能体验 Agent 的效率，也不会把安全边界一下拉得太远。

一句话总结

12306-mcp 接入 OpenClaw 后，OpenClaw 就不只是回答“怎么坐车”，而是可以开始帮你查真实车次。真正的价值，不是炫技，而是把“问需求、查站点、查车票、整理方案”串成一个顺滑流程。

下一步可以继续把酒店、地图、日历也接进同一套流程。那时用户只要说“帮我安排一趟出行”，Agent 才真正开始像一个出行助理。

本页由自动化脚本生成，待人工审核补充