龙虾机器人代理接口与官方Claude API存在五大系统性差异：一、响应结构多出设备元数据且content嵌套；二、流式响应破坏SSE标准，可能注入日志；三、错误码映射失真，混淆硬件与模型异常；四、认证头经本地密钥环转换，原始凭据不可追溯；五、自动注入硬件上下文至system prompt，导致提示词污染。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您调用龙虾机器人本地代理接口与直接调用官方Claude API，会发现响应结构、字段语义及协议行为存在系统性差异。以下是识别并处理这些差异的关键步骤：
一、响应体格式与字段命名差异
龙虾机器人在转发请求至Claude服务前，会对原始响应进行本地封装，添加设备上下文与动作层元数据，导致JSON结构层级增加且字段不可直译。官方Claude API则严格遵循Anthropic Messages API v2023-12-15规范，返回扁平化content数组。
1、向龙虾机器人API发送请求后，检查响应顶层是否包含"moltbot_id"、"execution_timestamp"、"hardware_context"等非Anthropic原生字段。
2、解析response.body.content时，确认其为嵌套对象而非字符串数组；若出现"【ACTION】"、"【CONFIDENCE】"等分隔符前缀，则表明已启用结构化输出模式。
3、对同一prompt分别调用龙虾机器人endpoint与claude.ai/api/messages，对比二者response.headers中anthropic-version值：前者常缺失或伪造，后者必为messages-2023-12-15。
二、流式响应（stream）行为不一致
官方Claude API的流式响应以text/event-stream格式逐块推送delta内容，每块含event: message_delta与data字段；龙虾机器人代理层可能合并chunk、截断末尾空格或注入调试日志，破坏标准SSE解析流程。
1、启用curl -N参数监听流式响应，观察首条事件是否为event: message_start而非event: ping。
2、捕获连续5个data块，检查每块中delta.text是否为完整token片段；若出现"【ERROR_CODE】TIMEOUT"混入data流，则说明代理层已拦截并重写响应。
3、在龙虾机器人配置文件中定位stream_passthrough_enabled参数，设为true可绕过本地缓冲，但需确保底层HTTP客户端支持chunked transfer encoding。
三、错误码映射与异常分类失真
官方Claude API仅返回标准HTTP状态码（如429、401、400）及JSON内error.type字段（如"overload_error"、"invalid_request_error"）；龙虾机器人会将硬件层异常（如IMU读取超时、舵机堵转）映射为相同HTTP码但篡改error.message，掩盖真实故障源。
1、触发一次超长prompt请求，观察返回HTTP状态码为400时，response.body.error.type是否为"prompt_too_long"（官方）或"hardware_buffer_overflow"（龙虾机器人）。
为Claude Code提供对提醒事项、日历、联系人、笔记、邮件和tmux的本地命令访问权限，以便在macOS上进行工作流感知的个人操作。
2、手动断开龙虾机器人电机供电，发起move_forward指令，确认error.message是否包含"Motor controller offline"等物理层描述，而非标准的"permission_denied"。
3、在龙虾机器人日志目录下检索last_error_report.json，比对其中"anthropic_upstream_status"与"local_hardware_status"两个字段值，判断异常是否源于上游模型或本地执行器。
四、认证头与凭据透传机制差异
官方Claude API要求Authorization: Bearer
1、在龙虾机器人配置中启用debug_auth_logging: true，重启服务后查看auth_debug.log中是否记录"original_api_key_hash"与"proxy_token_issued_at"。
2、使用Wireshark抓包，过滤目标端口，确认出站请求的Authorization头是否为Bearer sk-ant-...（官方格式）或Bearer moltbot-proxy-...（代理格式）。
3、调用龙虾机器人/self_test/auth接口，返回结果中若包含"key_rotation_interval_sec"字段且值小于3600，则表明已启用动态令牌机制，原始密钥未直连Anthropic服务端。
五、消息历史与system prompt注入策略不同
官方Claude API要求system prompt必须显式置于messages数组首位且type为"system"；龙虾机器人默认将固件版本、传感器校准参数、UI截图OCR摘要等预置内容自动拼接进system prompt，且不暴露拼接逻辑，造成提示词污染与长度不可控。
1、构造仅含system字段的最小请求体，发送至龙虾机器人，检查响应中是否返回"system_prompt_length_override"字段，其值是否大于您提交的字符数。
2、在龙虾机器人配置项中查找inject_hardware_context参数，设为false可禁用自动注入，但可能导致move_forward等硬件指令无法解析。
3、调用龙虾机器人/debug/prompt_dump接口，获取实际提交至Claude服务端的完整prompt字符串，搜索"[SECTION:CALIBRATION_DATA]"等标记确认注入区块位置。
