octop v0.9.24 不支持 web 后台配置 cos 后端,需手动修改 config/default.json 中 storage 段落,填入 cos 的 endpoint、bucket、region、accesskeyid、secretaccesskey 等参数,并重启服务验证。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

Octop v0.9.24 不支持通过 Web 后台直接配置 COS 后端,该能力是从 v1.0.0 版本起正式引入的。v0.9.24 仍需手动修改配置文件并重启服务,无法在 UI 中完成添加、测试与启用操作。
配置 COS 为后端(v0.9.24 手动方式)
你需要编辑 Octop 的核心配置文件(通常是 config/default.json 或环境变量驱动的配置),显式声明一个 S3 兼容后端,并确保服务启动时加载该配置。
腾讯云通用文字识别(高精度版)技能包。用户发送/粘贴图片、提供图片URL或要求识别图片文字时自动调用。支持中文、英文、中英混合、数字及特殊符号的检测与识别,返回文字框位置与内容。适用于文字较多、版式复杂、准召率要求高的场景。
-
确认已创建最小权限子用户
在腾讯云控制台 → 访问管理 → API 密钥管理中,获取SecretId和SecretKey;同时记下:- 存储桶全名(含 APPID,如
my-octop-bucket-1250000000) - 所在地域(如
ap-beijing) - Endpoint(格式为
https://cos.<region>.myqcloud.com</region>,如https://cos.ap-beijing.myqcloud.com)
- 存储桶全名(含 APPID,如
修改配置文件
在config/default.json中补充或更新storage段落:
"storage": {
"backend": "s3",
"s3": {
"endpoint": "https://cos.ap-beijing.myqcloud.com",
"bucket": "my-octop-bucket-1250000000",
"region": "ap-beijing",
"accessKeyId": "你的SecretId",
"secretAccessKey": "你的SecretKey",
"pathPrefix": "octop/"
}
}
- 启用记忆持久化(可选但推荐)
v0.9.24 已初步支持harness-memory,若你启用了记忆模块,需确保其读写路径也指向该 S3 后端。检查memory相关配置是否与storage.s3一致,或通过环境变量覆盖:
export OCTOP_MEMORY_BACKEND=s3 export OCTOP_STORAGE_S3_ENDPOINT=https://cos.ap-beijing.myqcloud.com # 其余 S3 参数同上
- 重启 Octop 服务
配置保存后,必须完全重启进程(非热重载),使新存储后端生效。
验证是否成功
- 上传一个测试文件(如 PDF 或 Markdown),观察日志中是否出现类似
Uploading to s3://my-octop-bucket-1250000000/octop/uploads/...的输出 - 登录 COS 控制台,进入对应 Bucket → 查看
octop/路径下是否有新对象生成 - 若启用记忆,新建工作区后,检查
octop/memory/目录下是否同步生成快照文件(如workspace-xxx.json)
不复杂但容易忽略







