怎么把豆包和博途连接起来:TIA Portal 三步打通
豆包会写 SCL 代码,但它写不进博途项目,也没法验证写得对不对。补中间那一层,再装一个插件包,三步就通。
「怎么把豆包和博途(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 都能连)。
三件事要先知道:
- 它装在与博途同一台 Windows 上,但那台机器不必是你的电脑——豆包可以连局域网里的它。
- 未授权时只读:能读工程、不能写,也不会擅自动你的工程。要写才需要授权。
- 装完打开
http://localhost:8080/能看到状态页,就算装好了。
桥通了,再看豆包那边——它还需要知道"这座桥怎么用"。这就是插件包。
三步
第一步:装插件包(6 个技能 + 5 个连接)
- Gitee(国内,推荐):tia-forge/doubao-tiaforge · 发行版
- GitHub:tia-forge/doubao-tiaforge · Releases
进去挑带版本号的那个 zip(tiaforge-doubao-plugin-*.zip,当前 1.0.5,41 KB)——别下 "Source code" 那两个,那是仓库源码包,不能当插件包上传。
豆包左侧「插件 · 技能 · 伙伴」→「插件」→ 右上角 + 添加 → 上传插件包 → 选 zip,不用解压。
包里是两样东西:
| 类型 | 内容 | 作用 |
|---|---|---|
| 技能 ×6 | 博途工程直连 / 文档检索 / LadDoc 转 SimaticML / 梯形图渲染 / 云仿真 / 编程教练 | 告诉它什么时候用、按什么顺序做 |
| 连接 ×5 | TiaLink + 文档检索 + 云仿真 + LadDoc + 梯形图渲染 | 给它真正能调的工具 |
技能和连接缺一不可:只有技能,它知道怎么做但没有手;只有连接,它有手但不知道你的流程。

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

6 个技能一次装齐,默认全部开启。
第二步:把包里的 TiaLink 指向你的桥(最容易漏的一步)
包里的地址是占位值,不改永远连不上。 我前后收到的"每次都要重新告诉它地址",十有八九都是漏了这一步。
顺序很重要:先改参数,再打开开关。 反了就会一直显示"运行失败"。
- 左侧「插件 · 技能 · 伙伴」→ 切到「连接器」。如果
tialink的开关已经是开的,先关掉; - 点它右侧
…→「编辑」,把「服务器 URL」改成你自己的网关地址(见下表),点「保存」; - 再打开开关(或改完直接点旁边的「重新启动」);
- 状态正常后,完全退出豆包再打开——连接是启动时建立的。

要改地址就点这个 … → 编辑,不用重装插件包。
| 网关在哪 | 服务器 URL 填什么 |
|---|---|
| 就是这台电脑 | http://127.0.0.1:8080/mcp |
| 另一台 Windows(常见) | http://<那台的局域网IP>:8080/mcp |

其余三项不用动:名称 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 次免费;渲染按次计费(查版本不扣)。
填法(以云仿真为例):
- 连接器页找到
plc-sim→…→「编辑」; - 「服务器 URL」保持
https://tia.hubwiz.com/sim/mcp,不用改; - 「自定义 Headers」→「+ 添加」—— - 名称填
Authorization- 值填Bearer <你的 Key>(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 定时器/计数器的背景块。

实测:问「当前博途项目里有几个程序块?」→ 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 背景关系均由网关原生工具返回,不是模型记忆。