openclawai仅支持特定标准化格式：模型含gguf、hf transformers、awq、modelfile.zip；配置支持json5、auth-profiles.json、.env、python技能脚本；数据用markdown、jsonl、yaml、txt/jinja2；插件需js/puppeteer、toml、ssml、pdf/txt/md。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在使用OpenClawAI过程中尝试加载本地数据或模型文件，但系统提示格式不识别或解析失败，则可能是由于所选文件未落入OpenClawAI当前支持的标准化数据格式范围内。以下是OpenClawAI官方确认兼容的各类文件格式及其具体使用场景说明：
一、模型权重与推理格式
OpenClawAI原生支持多种主流模型封装格式，每种格式对应不同推理后端与部署模式，需严格匹配路径声明与配置参数。
1、GGUF格式：文件扩展名必须为.gguf，文件头须含magic bytes“GGUF”，适用于llama.cpp后端直连或Ollama中转；
2、Hugging Face Transformers标准格式：须包含config.json、pytorch_model.bin（或model.safetensors）、tokenizer.json（或tokenizer.model）三类核心文件，用于vLLM或Transformers+bitsandbytes混合加载；
3、AWQ量化格式：依赖AutoAWQ后端，要求目录内存在config.json、pytorch_model.bin、quant_config.json三个必需文件；
4、Modelfile结构化包：以纯文本Modelfile为入口，配合GGUF模型文件打包为.modelfile.zip压缩包，用于LMStudio兼容部署。
二、配置与元数据格式
OpenClawAI对配置文件采用分层兼容策略，不同版本对语法宽松度与字段嵌套深度有明确区分，错误格式将导致服务启动失败。
1、配置主文件支持JSON5格式（允许注释、尾逗号、单引号字符串），扩展名应为.json5并需通过--config显式指定；
2、认证配置强制使用auth-profiles.json独立文件，内容须为标准JSON对象，不可含注释；
3、环境变量配置依赖.env文件，每行格式为KEY=VALUE，禁止空格环绕等号，且不支持#开头的行内注释；
4、技能脚本配置支持Python 3.10+兼容的.py文件，需实现predict()或run()函数接口，并置于./skills/custom/路径下。
三、用户数据与记忆存储格式
OpenClawAI将用户交互上下文与长期记忆持久化为结构化文本文件，所有文件均基于可读性与版本控制优化设计，不使用二进制序列化。
1、会话记录采用Markdown格式（.md），每个会话保存为独立文件，文件名含ISO 8601时间戳；
2、记忆快照存于workspace/memory/子目录，以JSONL格式（.jsonl）逐行存储事件片段，每行一个合法JSON对象；
3、智能体工作区配置使用YAML格式（.yaml），仅接受UTF-8编码，禁止制表符缩进，必须使用空格（建议2空格）；
4、自定义模板文件（如system prompt、chat template）限定为纯文本（.txt）或Jinja2语法文本（.j2），不可含BOM头。
四、技能与插件资源格式
OpenClawAI通过插槽机制加载外部功能模块，各类资源文件须满足特定命名规范与内容结构，否则无法注册为可用技能。
1、浏览器自动化脚本需为Puppeteer-compatible JavaScript（.js），导出默认函数且含valid: true校验字段；
2、图像生成提示词模板使用TOML格式（.toml），顶层必须含[template]表头，字段名区分大小写；
3、语音合成配置文件为SSML XML片段（.ssml），须符合W3C SSML 1.1规范，根元素为
4、本地知识库索引支持PDF、TXT、MD三类原始文档，上传后由内置RAG引擎自动解析为向量块，不接受DOCX、EPUB等非平面格式。
