外部能力接入
前置知识： 阅读本文前建议先了解 资源与凭据 中的资源模型。
Monstrum 的能力扩展不限于内置的 6 种资源类型。通过插件和模板，你可以接入更多外部系统、复用成熟的 Bot 配置方案。
概述
平台提供多种方式扩展 Bot 的外部能力：
| 方式 | 说明 |
|---|---|
| 内置资源 | 平台自带的 6 种资源类型（SSH、MCP、Bot、Web、Web3、Agent），开箱即用 |
| 平台插件 | 官方认可的插件，由管理员安装到平台，提供新的资源类型（如 GitHub、GitLab、Notion） |
| Agent 插件 | 用户自行将插件安装到本地 Agent 上，通过 Agent 桥接工具到平台 |
| 模板 | 导入预配置的 Bot 方案（YAML 文件），快速部署包含 Bot + 工作流 + 资源引用的完整配置 |
内置资源的使用参见 资源与凭据。插件系统（含平台插件和 Agent 插件的区别）参见 插件。Agent 的完整说明参见 本地 Agent 接入。本文重点介绍模板系统和市场。
插件市场
插件市场展示官方插件和社区插件。官方插件在平台云端执行，社区插件安装到本地 Agent 执行。
- 在左侧导航栏点击 市场 → 插件市场
- 浏览可用插件列表，通过来源筛选区分官方和社区
详见 插件。
模板系统
模板是 Bot 配置的可移植蓝图，以 YAML 文件的形式导入导出。一个模板封装了：
- Bot 配置（名称、描述、系统提示词、运行时参数）
- 工作流定义（步骤、连接、变量映射）
- 资源引用（声明需要哪些类型的资源，但不包含实际凭据）
- Bot 记忆（用户手动添加的记忆条目）
模板不包含实际的资源配置和凭据——安装后需要你将已有的资源绑定到新创建的 Bot 上。
导出模板
将已配置好的 Bot 导出为 YAML 模板，方便备份或分享：
导出单个 Bot：
- 进入 Bot 详情页
- 点击 导出 按钮
- 下载 YAML 文件
导出 Bot 组：
- 进入 Bot 组详情
- 点击 导出 按钮
- 下载的 YAML 文件包含组内所有 Bot 的配置
导出的 YAML 包含：
- Bot 配置（不含凭据）
- 资源引用提示（resource_hints）——声明原始绑定的资源类型和名称
- 渠道引用提示（channel_hints）——声明原始配置的渠道类型
- 工作流定义
- 手动记忆条目
导入模板
从 YAML 文件创建 Bot：
- 在模板市场页面点击 导入
- 上传
.yaml或.yml文件 - 平台解析模板内容
安装向导
无论从市场安装还是从文件导入，模板的安装都通过向导完成：
第一步：预览内容
查看模板将创建的 Bot、工作流等组件，确认安装意图。
第二步：绑定资源
模板会列出它需要的资源（resource_hints）。你需要将已有的资源映射到这些引用上：
- 选择已创建的同类型资源
- 或当场创建新资源
第三步：完成配置
- 为 Bot 选择 LLM 提供商和模型
- 可选配置消息渠道
- 确认后 Bot 创建完成
完成配置后 Bot 自动激活。也可以跳过部分配置，稍后在 Bot 详情页中补充。
模板市场
模板市场是发现和分享 Bot 配置方案的入口，同时展示官方模板和社区模板。
- 在左侧导航栏点击 市场 → 模板市场
- 浏览可用模板列表
页面支持：
- 搜索：按关键词搜索模板
- 排序：按安装量 / 收藏数 / 最新发布排序
- 标签筛选：按标签过滤模板
- 来源筛选：官方模板 / 社区模板
点击模板卡片查看详情，包括：
- 包含的 Bot 和工作流组件
- 需要的资源类型
- 安装量和评价
点击 安装 进入安装向导（流程同上）。
官方模板与社区模板
| 官方模板 | 社区模板 | |
|---|---|---|
| 来源 | 平台官方发布 | 社区用户提交 |
| 审核 | 管理员审核 | 社区自治（评分、举报） |
| 安装方式 | 相同（向导式安装） | 相同 |
| 安全性 | 模板是 YAML 配置，不含可执行代码，安全风险低 | 同左 |
提交社区模板
将你的 Bot 配置分享给社区：
- 在 Bot 详情页导出 YAML 模板
- 在模板市场提交到社区区域
- 其他用户可以浏览、评分、安装到自己的工作区
常见用法
快速搭建特定场景
从模板市场安装预配置的 Bot 方案：
- “GitHub Issue 自动处理”模板：包含 Bot + Issue 处理工作流，安装后绑定 GitHub 资源即可使用
- “运维巡检”模板：包含 Bot + 巡检工作流 + 定时调度，安装后绑定 SSH 资源
团队或社区共享 Bot 配置
团队内分享：
- 将 Bot 导出为 YAML 模板，直接发给团队成员
- 成员导入后按向导绑定资源即可
社区分享：
- 将 Bot 导出为 YAML 模板
- 提交到模板市场社区区域
- 其他用户可以在市场中发现并安装
接入自定义工具
如果平台没有你需要的插件，可以通过本地 Agent 接入：
- 在本地安装
monstrum-agent - 将
.mst插件包或自定义工具配置到 Agent 中 - Agent 连接平台后，工具自动注册为资源
- 在 Bot 资源配置中绑定即可使用
详见 本地 Agent 接入。
常见问题
模板安装后 Bot 处于草稿状态
模板安装后，如果未完成 LLM 提供商和资源绑定的配置，Bot 可能处于草稿状态。进入 Bot 详情页完成配置后即可激活。
导入的 YAML 格式不对
确认文件是从 Monstrum 导出的 YAML 模板，包含 api_version: v2 头部。手动编写的 YAML 需要符合模板格式规范。
插件安装后看不到新的资源类型
- 确认插件安装成功（页面有成功提示）
- 刷新资源管理页面
- 详见 插件 中的常见问题