使用与扩展 OpenAgent
先掌握桌面软件的工作方式，再通过可复用技能、MCP 工具、命令或带作用域的侧栏扩展能力。根据当前要完成的任务选择教程。
软件使用教程
Section titled “软件使用教程” 安装与首次使用 选择安装包，连接模型服务，并完成第一个任务。
对话、文件与恢复 提供有效上下文，检查工具结果，审阅分支与文件修改。
模型、权限与扩展 配置对话与 Flash 模型，理解审批，使用插件或 MCP。
常见问题与排查 排查连接、附件、权限、插件、更新与历史记录问题。
插件开发教程
Section titled “插件开发教程”OpenAgent 安装 Agent Plugins 1.0 格式的包，平台专属能力放在 extensions.openagent 中。
先运行一个 Skill 包，再按需添加组件，最后验证实际安装的候选包并发布。创作需要已安装的 OpenAgent、Git 和 Bun，无须构建桌面源码或访问私有 SDK。除非步骤另有说明，命令都从你的项目根目录执行。
01 · 第一个插件 创建 Skill，校验插件，然后安装本地包。
02 · 插件包约定 理解插件身份、协议兼容性、数据目录和可选组件。
03 · MCP 工具 接入 stdio 服务，选择 Direct 或 Relay 挂载方式。
04 · 配置与授权 声明设置表单、绑定私有参数，并连接 OAuth 服务。
05 · 命令与钩子 编写跨平台入口，正确处理完成、审批与取消。
06 · 侧栏与国际化 选择带作用域的面板或持久会话 UI，跟随宿主语言。
07 · Host Bridge 工作流 参考 Goal、Graph 与 Chat Groups，显式管理状态和分支。
08 · 本地开发与排错 刷新已关联的源码安装，定位失败并验收实际候选包。
09 · 发布与更新 声明兼容性、核验发布字节，验证替换与恢复。
| 想扩展什么 | Plugin Kit 模板 |
|---|---|
| 可复用指令 | minimal 或 skill-pack |
| MCP 服务提供的工具 | mcp-tools |
| 斜杠命令 | slash-commands |
| 带作用域的侧栏 | sidebar-panel |
| 生命周期钩子 | automation-hooks |
| 工具租约或受监管的进程 | mcp-lifecycle 或 daemon |
| 经过校验的外观 token | theme |
| 宿主渲染的集成设置 | integration |
克隆工具链后，可运行 bun tools/openagent-plugin-kit/scripts/new-plugin.mjs --list 查看该源码版本提供的模板。full-kit 组合多个界面与能力；学习时先选择小模板，便于定位每个失败的责任边界。
参考当前的独立插件
Section titled “参考当前的独立插件”插件开发助手 既是公开工具链，也是可安装的开发助手。Chat Groups、Goal、Graph、Cua Driver 和 Message Board 分别独立安装。工作流章节把它们的设计对应到具体开发需求。Multi-Agent V2 属于 Runtime 能力；Goal 和 Graph 通过共享 Host Bridge 实现插件自己的工作流。
什么时候可以发布
Section titled “什么时候可以发布”校验通过只证明包结构正确。还要调用实际安装的工具或命令，检查持久化、失败路径、声明的语言与主题，以及需要认证的真实服务操作。保留测试版本与证据。本地刷新、开发者验收和公开发布是分别进行的步骤，排错章节给出完整流程。
本教程依据当前公开 Plugin Kit 的模板与校验器编写。旧版 Runtime 即使接受插件协议 1，也可能缺少可选的桥接操作，调用前应检测支持情况。逐字段规范以 Plugin Kit 文档 为准。
← 返回 OpenAgent 主页