clawdbot api要求请求必须包含anthropic-version（iso 8601格式，如2023-09-01）、x-clawdbot-api-key（bearer base64密钥）、content-type（application/json; charset=utf-8）、user-agent（含product/version (platform)）及x-clawdbot-timeout（1000–30000毫秒）五个关键http头部，缺一或格式错误将触发对应400/401/415响应。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 免费无限量使用 DeepSeek R1 模型☜☜☜
Clawdbot API在请求过程中依赖特定的HTTP头部字段来识别客户端版本、认证身份及控制请求行为。anthropic-version是其中关键的版本标识头，用于指定API兼容的协议规范。以下是针对该头部信息的详细说明：
一、anthropic-version头部的作用与格式
anthropic-version头部用于声明客户端所遵循的Clawdbot API语义版本，服务器据此决定响应的数据结构、字段支持范围及错误处理逻辑。该头部值必须为严格定义的字符串格式，不接受模糊匹配或前缀匹配。
1、anthropic-version的取值必须为形如2023-09-01的ISO 8601日期格式字符串。
2、该值不可省略，缺失时服务器将返回400状态码并附带Missing anthropic-version header错误信息。
3、若提供非法格式（如包含空格、字母、非标准分隔符），服务器返回400且错误提示为Invalid anthropic-version format。
二、x-clawdbot-api-key头部的配置要求
x-clawdbot-api-key用于服务端验证请求来源合法性，是每个请求必须携带的身份凭证。该头部与anthropic-version共同构成基础认证链，缺一不可。
1、API密钥须为Base64编码后的32字节随机字符串，原始密钥由Clawdbot控制台生成并仅显示一次。
2、请求中必须以Bearer
3、若密钥格式不符合Bearer模式，服务器返回401并提示Invalid authorization scheme。
三、content-type头部的强制约束
Clawdbot API仅接受application/json类型的请求体，content-type头部不仅用于标识数据格式，还触发服务器端JSON解析器的启用开关。
1、必须显式设置为application/json; charset=utf-8，charset参数不可省略。
2、若使用application/json但未声明charset，服务器返回400并返回错误信息charset parameter missing。
3、任何其他类型（如text/plain、multipart/form-data）均导致415响应，错误提示为Unsupported Media Type。
四、user-agent头部的合规性校验
user-agent头部用于标识发起请求的客户端环境，Clawdbot API通过该字段识别集成方SDK版本、操作系统及运行时特征，影响限流策略与日志归因。
1、值必须包含至少两个由斜杠分隔的组件，格式为Product/Version (Platform)，例如：Clawdbot-Python-SDK/2.4.1 (Linux; x86_64)。
2、若缺失括号内的平台信息，服务器记录警告日志但不拒绝请求；若完全缺失user-agent，服务器返回400并提示User-Agent header is required。
3、值中禁止出现控制字符、URL编码序列及连续空格，违者触发400响应，错误消息为Invalid User-Agent syntax。
五、x-clawdbot-timeout头部的行为控制
x-clawdbot-timeout头部允许客户端声明最大等待时长（毫秒），服务器依据该值调整后端服务调用超时阈值与连接保持时间。
1、取值范围为1000至30000（即1秒至30秒），超出范围时服务器返回400并提示Timeout value out of range。
2、若头部存在但值为空或非数字字符，服务器返回400且错误信息为Invalid timeout value format。
3、当该头部未设置时，服务器采用默认值10000毫秒，并在响应头中返回x-clawdbot-timeout: 10000。
