OpenClaw支持五类数据:一、结构化数据由SQLite管理,含元信息与FTS5语义检索;二、非结构化数据以Markdown/YAML文件直存;三、向量数据依赖LanceDB插件;四、模型I/O采用JSON5配置;五、技能运行时数据遵循三级加载体系与JSON Schema规范。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

如果您在配置或扩展OpenClaw时需要明确其可处理的数据类型边界,则需依据其存储架构与插件机制进行区分。以下是针对OpenClaw所支持数据类型的分类说明与选型依据:
一、结构化数据:SQLite索引数据库承载核心元信息
OpenClaw将对话记忆、用户配置、权限信息、任务日志、技能元数据等强约束关系的数据统一交由SQLite管理,利用其ACID事务保障一致性,并通过FTS5实现关键词精准检索,借助sqlite-vec扩展完成向量嵌入与语义匹配。
1、确认当前OpenClaw实例是否启用SQLite作为默认索引库,检查~/.openclaw/openclaw.json中database.type字段值是否为sqlite。
2、验证SQLite文件是否存在且可读写,路径默认为~/.openclaw/index.db,该文件包含所有结构化记录表及FTS5虚拟表。
3、执行SQL查询测试语义检索能力:SELECT * FROM memories_fts WHERE memories_fts MATCH '会议纪要';
二、非结构化数据:Markdown/YAML文件系统直存
所有长期记忆、知识库文档、完整对话历史、技能配置文件均以纯文本形式落盘,采用Markdown(.md)或YAML(.yml)格式,实现“文件即状态”的透明化管理,天然适配Git版本控制与人工编辑。
1、进入OpenClaw本地数据目录:cd ~/.openclaw/data。
2、列出典型非结构化资源:ls -l memories/ skills/ knowledge/ configs/,确认各子目录下存在对应后缀的文本文件。
3、使用文本编辑器打开任意.md文件,验证其内容为可读自然语言段落与结构化元数据混合格式。
三、向量数据:LanceDB原生插件支持高维嵌入存储
LanceDB是OpenClaw官方唯一原生实现的第三方Memory Plugin,专为AI长期记忆与语义向量检索设计,适用于企业级场景中对大规模嵌入向量的持久化与近似最近邻(ANN)查询需求。
1、在配置文件中启用LanceDB插件,将memory.plugin设为lancedb,并指定lancedb.uri指向本地路径或远程服务地址。
当用户请求“启用语义缓存”、“缓存LLM响应”、“降低API成本”、“加速AI响应”、“配置LangCache”、“搜索语义缓存”、“存储响应到缓存”,或提及Redis LangCache、语义相似性缓存、LLM响应缓存时使用此技能。提供与Redis LangCache托管服务的集成,用于对提示和响应进行语义缓存。
2、确保已安装lancedb Python包,执行pip install lancedb完成依赖补全。
3、启动OpenClaw后观察日志输出,确认出现"Loaded LanceDB memory plugin"标识行。
四、模型输入/输出数据:JSON5格式配置驱动多模态交互
OpenClaw通过JSON5主配置文件定义模型能力边界、上下文窗口、成本结构及API兼容类型,支持注释、单引号、尾随逗号,允许环境变量注入,使模型调用参数具备高度可维护性与动态适应性。
1、打开主配置文件:nano ~/.openclaw/openclaw.json。
2、定位models.providers节点,确认其中每个模型条目均包含id、name、contextWindow、cost及api字段。
3、验证JSON5语法有效性,添加一条测试注释// test model config并保存,重启网关观察是否正常加载无报错。
五、技能运行时数据:三级加载体系支持动态上下文传递
内置技能(Built-in Skills)、本地技能(Local Skills)、插件技能(Plugin Skills)构成OpenClaw技能生态的三级加载体系,运行过程中可接收JSON格式的请求载荷、返回结构化响应,并支持条件路由(如error_code == 503)触发异常处理分支。
1、检查技能目录结构:ls -R ~/.openclaw/skills/,识别builtin/、local/、plugins/三个层级。
2、查看任一技能的manifest.yml,确认其input_schema与output_schema字段为合法JSON Schema定义。
3、构造curl请求模拟技能调用,目标URL为http://localhost:8000/skill/exec?name=web_search,Body传入标准JSON对象。

















