LangBot 里同时存在插件、MCP、Skills、沙箱四种扩展机制，容易混淆。本页帮你区分它们的职责和适用场景。
一句话区分
- 沙箱：执行环境，让 Agent 跑命令、读写文件
- Skills：按需激活的指令包，给 Agent 临时增加一段专业工作流
- MCP Server：接入外部工具服务
- 插件：长期运行的扩展进程，可带配置页、事件监听、知识库
对照表
| 能力 | 提供方 | 给 Agent 的形式 | 何时使用 |
|---|
| 沙箱 | Box Runtime | 直接挂上 exec/read/write/edit/glob/grep 六件套 | Agent 要执行代码、读写文件 |
| Skills | Box Runtime skill store | Agent 调 activate 后，指令通过 Tool Result 注入 | 想给 Agent 加一段流程/模板/脚本，按需触发 |
| MCP Server | LangBot MCP Loader（stdio 模式由 Box 托管） | 工具直接进入可用工具列表 | 接入已有的 MCP 服务 |
| 插件 | Plugin Runtime | 由插件系统暴露能力 | 长期能力、需要配置页/事件监听/知识库组件 |
流水线绑定
Skills、MCP Server、插件都属于流水线扩展。在 WebUI 安装/创建后，还要在流水线扩展配置里决定启用范围：
Skills 的绑定决定 Agent 能看到哪些技能（影响 <available_skills> 列表）。具体技能内容只有 Agent 调用 activate 后才会注入。
排障入口
| 现象 | 优先检查 |
|---|
Agent 没有 exec/read/write 工具 | box.enabled、后端是否可用、流水线是否用内置 Agent |
| Skill 列表为空 | Box Runtime 状态、box.local.skills_root、流水线绑定 |
| stdio MCP 启动失败 | Box Runtime 状态、MCP 命令和环境变量、启动超时 |
| Docker 部署沙箱启不来 | langbot_box 是否挂载 docker.sock、Box 根目录路径是否一致 |
| 文件读写失败 | box.local.host_root、box.local.allowed_mount_roots |
| 后端选择不生效 | 确认 BOX__BACKEND 设在 langbot 服务上，不是 langbot_box |
沙箱内置工具和 Skills 当前面向内置 Agent。外部 Runner（Dify、n8n、Langflow、Coze 等）应使用各自平台的工具和执行机制。
