怎么把豆包和博途连接起来:TIA Portal 三步打通

豆包会写 SCL 代码,但它写不进博途项目,也没法验证写得对不对。补中间那一层,再装一个插件包,三步就通。

分享
怎么把豆包和博途连接起来:TIA Portal 三步打通

「怎么把豆包和博途(TIA Portal)连接起来?」——没有一条现成的链接直接点。但这件事能做成,而且只要三步。

先说清楚:为什么现在不行

你已经试过的做法是让它写、你粘进博途编译。它写得像样,但两个洞一直没补上:写不进工程,验不了对错。

于是活儿变成这样:

  • 变量表要你贴给它,它才知道地址对不对;
  • 它给的块导进去报错,你回来改提示词再导;
  • 编译错在哪,它不知道,得你念给它听。

省下来的打字时间,又花在来回搬。根因不是模型不够强,是它碰不到你的工程,也拿不到工程的回话。

缺的是一个"能被调用"的入口

豆包的客户端就在你本机——但客户端本身没有碰博途的手段。博途的工程只能通过西门子的 Openness 接口读写,而豆包不会说这套接口。所以缺的不是网络通道,是中间一层把博途的动作翻译成"AI 能调用的工具"的东西。

TiaLink 就是这层(产品页与下载)——但它不是只把 Openness 包一层,真正给出来的是整条链:

环节 靠什么 要不要云服务
读懂老工程 → 项目知识图谱(IO 表、块清单、接口表、调用关系、变量与 UDT 表) TiaLink 不要,只读也能做
生成梯形图(LadDoc → 可导入博途的 SimaticML) LadDoc 云服务 要 Key
单元/整机仿真跑 PASS/FAIL 云仿真 要 Key
在真机工程里编译、下载到 PLCSIM、读回核对 TiaLink 不要(PLCSIM 在本机)

后面两项是另外的云服务,各有各的入口和 Key(跟 TiaLink 是两回事,别买错):LadDoc / 云仿真,每把 100 次免费。(包里还带一个梯形图渲染:把 SimaticML 画成 PNG。那是给人看的——评审、交接、跟同事对逻辑时用,不是必经步骤,所以不在上面这条链里。)所以这套东西装好之后,AI 不只是"能改你的工程",而是先看懂、先生成、先验证,再动真机。

TiaLink 装在与博途同一台机器上;豆包这边的连接器指向它就行(连接器在本地进程里跑,所以 127.0.0.1 或局域网 IP 都能连)。

三件事要先知道:

  1. 它装在与博途同一台 Windows 上,但那台机器不必是你的电脑——豆包可以连局域网里的它。
  2. 未授权时只读:能读工程、不能写,也不会擅自动你的工程。要写才需要授权。
  3. 装完打开 http://localhost:8080/ 能看到状态页,就算装好了。

桥通了,再看豆包那边——它还需要知道"这座桥怎么用"。这就是插件包。

三步

第一步:装插件包(6 个技能 + 5 个连接)

进去挑带版本号的那个 zip(tiaforge-doubao-plugin-*.zip,当前 1.0.5,41 KB)——别下 "Source code" 那两个,那是仓库源码包,不能当插件包上传。

豆包左侧「插件 · 技能 · 伙伴」→「插件」→ 右上角 + 添加 → 上传插件包 → 选 zip,不用解压。

包里是两样东西:

类型 内容 作用
技能 ×6 博途工程直连 / 文档检索 / LadDoc 转 SimaticML / 梯形图渲染 / 云仿真 / 编程教练 告诉它什么时候用、按什么顺序做
连接 ×5 TiaLink + 文档检索 + 云仿真 + LadDoc + 梯形图渲染 给它真正能调的工具

技能和连接缺一不可:只有技能,它知道怎么做但没有手;只有连接,它有手但不知道你的流程。

豆包装上插件包之后:插件页出现 Tiaforge,技能 6 个、连接 5 个

装完的样子:插件页多了一个 Tiaforge,开关打开。

技能页:6 个技能全部就位,中文名一目了然

6 个技能一次装齐,默认全部开启。

包里的地址是占位值,不改永远连不上。 我前后收到的"每次都要重新告诉它地址",十有八九都是漏了这一步。

顺序很重要:先改参数,再打开开关。 反了就会一直显示"运行失败"。

  1. 左侧「插件 · 技能 · 伙伴」→ 切到「连接器」。如果 tialink 的开关已经是开的,先关掉;
  2. 点它右侧 … →「编辑」,把「服务器 URL」改成你自己的网关地址(见下表),点「保存」;
  3. 再打开开关(或改完直接点旁边的「重新启动」);
  4. 状态正常后,完全退出豆包再打开——连接是启动时建立的。
连接器页:tialink 右侧的 … 里有「编辑」和「删除」

要改地址就点这个 … → 编辑,不用重装插件包。

网关在哪 服务器 URL 填什么
就是这台电脑 http://127.0.0.1:8080/mcp
另一台 Windows(常见) http://<那台的局域网IP>:8080/mcp
编辑弹窗:服务器名称 / 传输类型 HTTP / 服务器 URL / 自定义 Headers

其余三项不用动:名称 tialink、传输类型 HTTP、Headers 留空。

Headers 什么时候要填?只有你的网关开了令牌鉴权才加一条:名称 Authorization,值 Bearer <令牌>。网关默认没开,留空即可。

已经显示"运行失败"也不要紧:把参数改对,点「重新启动」,再完全退出重开就行。参数不对时它只会停在失败状态,不会自己恢复。

第二步补充:云端四个连接怎么填 Key

四个云端连接各要一把 Key,前缀就能看出是哪个服务。Key 在各自的页面领(不是 TiaLink 产品页,那是网关本体):

服务 Key 前缀 领 Key 的地址
文档检索 tia_live_ tia.hubwiz.com/ai-coding-docs
云仿真 sim_live_ tia.hubwiz.com/sim
LadDoc lad_live_ tia.hubwiz.com/lad
梯形图渲染 render_live_ tia.hubwiz.com/render

每把 100 次免费;渲染按次计费(查版本不扣)。

填法(以云仿真为例):

  1. 连接器页找到 plc-sim → … →「编辑」;
  2. 「服务器 URL」保持 https://tia.hubwiz.com/sim/mcp,不用改;
  3. 「自定义 Headers」→「+ 添加」—— - 名称填 Authorization - 值填 Bearer <你的 Key>(Bearer 后面一个空格,Key 本身不加引号、不加前缀)
  4. 点「保存」→ 再打开开关(或点「重新启动」)→ 完全退出豆包重开。
编辑自定义连接器:服务器 URL + 自定义 Headers 里填 Authorization: Bearer <Key>

Header 名称必须是 Authorization,值必须以 Bearer 开头——只填 Key 不行。

两个常见误会:

  • "运行失败"不代表 Key 错。先看它是不是根本没填 Key(没填一定失败),再看 Key 是不是抄漏了字符;最后才怀疑网关。
  • 换 Key 也要走同一条路:… → 编辑 → 改 Header 的值 → 保存 → 重新启动。改完不重启,状态还是旧的。

第三步:完全退出,重开,问一句话

MCP 连接是启动时建立的。所以:完全退出豆包(托盘也要退)→ 重开 → 新建一个工作任务。

配好之后不用再报地址,直接说人话就会触发:

现在打开的是哪个博途工程?有几台设备?
  • 报出你屏幕上的工程名和设备型号 → 通了;
  • 给你一段代码、或"建议你这样操作" → 没通,它在凭记忆答。

如果每次都得把地址念给它才动,说明连接器没真正生效——回去重做第二步(先改参数、后开开关、再完全退出重开)。

工程名它编不出来。接着问一句「当前工程里有几个程序块」——实测 24 秒答出 8 个(1 OB + 1 FB + 2 FC + 4 DB),还顺手指出 4 个 DB 都是 IEC 定时器/计数器的背景块。

豆包在装上插件包、连上本机 TiaLink 之后,24 秒读出工程里的 8 个程序块

实测:问「当前博途项目里有几个程序块?」→ 24 秒给出 8 个块的类型、块名、编号,还指出 4 个 DB 都是 IEC 定时器/计数器的背景块。

三个坑

① 回环地址只能写在"编辑"里,不能写进包。 把 127.0.0.1 打进插件包,结果是连接器页面显示"5 个"、列表里只有 4 个,没有任何报错。写成局域网地址就正常。

② 自定义连接器跑在本地电脑上。 弹窗写着「仅支持在本地电脑中使用」——因为连接器本身就是本地进程。所以云端任务里找不到工具,不是你配错。

③ 只保存不重启,等于没改。 重开之后老会话也不会补上工具,要新建工作任务。

什么情况别走这条路

  • 那台机器没装博途:桥装不上,后面都没意义。
  • 只想让它帮你写代码:直接复制粘贴更快,不值得为这个装一套东西。
  • 要在云端任务里用:连接器只在本地电脑进程里跑,云端任务碰不到它。

装完之后,能兑现的那句话

不是"AI 能写 PLC 了",而是这条链一次走完:

把这段启保停逻辑写成 FB,编译干净后下载到仿真,再把 Main 里调用了哪些块列出来给我核对。

能验收,才叫接上。


想直接开始装

三步里唯一要付钱的只有那层桥。先只读也能装——未授权时 TiaLink 只读,够你把链路验通、把话学会,再决定要不要写。

你要什么 去哪
装 TiaLink(与博途同机、微信扫码、装完 localhost:8080 看得到状态页) TiaLink 产品页 / 下载
领云端 Key(文档检索 / 云仿真 / LadDoc / 渲染,各 100 次免费) 文档检索 / 云仿真 / LadDoc / 渲染
拿插件包(6 技能 + 5 连接) Gitee 发行版(国内)/ GitHub Releases
看不懂某一步、或报错了 把报错原文贴到 Gitee Issues,我按报错改包

插件包:https://github.com/tia-forge/doubao-tiaforge(独立仓,含插件源码与各版本 zip)

相关阅读:DeepSeek DSH 接博途:插件装完,四句对话配好并验通|Claude Code 接博途:从空工程到跑通仿真的全链路|TiaLink 博途 MCP 网关

来源与版本:插件包 tiaforge-doubao-plugin 1.0.5;网关 TiaLink 1.5.1.0,博途 V17;块数、块类型、DB 背景关系均由网关原生工具返回,不是模型记忆。