从旧版本切换到这次正式版时,数据库会随服务首次启动向前迁移。回退需要迁移前的备份,单独换回旧程序无法撤销迁移。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

稳定版的升级边界
OpenBot v1.1.0 是稳定通道的正式发布,官方发布说明沿用此前候选版的内容。从 v1.0.x 升级时,数据库和接口要按 v1.1.0 的要求评估。已经跟进候选版的环境,其实际数据库状态取决于先前已经执行的迁移。
第一次启动就是数据库的切换点
新服务启动时自动运行 PostgreSQL 迁移,部分旧表的数据移至新表,旧表会保留但停止写入。旧表还在并不能提供完整的回退状态。正式升级的回滚依据是升级前的数据库备份,切回旧容器或程序版本不能撤销数据库迁移。

应用账号和连接池的权限条件
升级后的查询分别使用 openbot_app 和 openbot_system。两个角色不能登录、不能有超级用户权限,也不能绕过行级安全。迁移会把角色授予 OpenBot 的登录账号。如果该账号没有创建角色的权限且管理员也没事先建立所需角色,迁移会停止,显示要执行的 SQL,并且不会改动数据库。
服务在启动和运行期间都会检查实际的查询角色。外置 PostgreSQL 连接池需要透传启动参数 role。官方说明中,Compose 和 openbot-bundle 已包含这项设置。
哪些旧请求会返回 404
旧客户端中已退役的路径会返回 404。新版 REST 的路径写在 api/openapi.yaml 中,WebSocket 通道由 api/asyncapi.yaml 定义。组织资源放在 /api/v2/organizations/{organizationId}/ 下,逐路径放行的网关需要覆盖 /api/v2/ 并允许 WebSocket 升级请求。
仍有路径留在新版前缀之外,例如登录、SSO 与 SCIM 所用的 /api/auth、事件 Webhook 的 /api/events,以及 /health。旧的 /api/channels/events 已退役,不能因为名字近似将它当作保留的 Webhook。











