运行时与扩展关系

LangBot 里同时存在插件、MCP、Skills、沙箱四种扩展机制，容易混淆。本页帮你区分它们的职责和适用场景。

一句话区分

能力	提供方	给 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 等）应使用各自平台的工具和执行机制。