OpenClaw 源代码学习笔记

本文总结了ClaudeCode源码的学习笔记，重点分析了其插件系统的架构设计与实现。项目包含命令(Commands)、代理(Agents)、技能(Skills)和钩子(Hooks)四大核心组件，采用渐进式加载、代理协作和事件驱动等设计模式。文章详细介绍了各组件的开发规范、目录结构及交互机制，并通过实战案例展示了多代理并行处理、代码审查等典型应用场景。最后提出了对OpenClaw项目的架构借鉴建议，

Claude Code 抛出 Request Timed Out 不仅可能是网络问题，更大概率是 API 高负载或超大响应导致。本文从默认超时机制出发，拆解三种根因场景，给出 API_TIMEOUT_MS环境变量调优与任务拆分策略，帮助开发者在保证稳定性的同时避免误判网络故障。

本文针对 Hermes Agent 在 32 个消息平台暴露的 `API call failed after {max_retries} retries: {_final_summary}` 用户错误，从 `agent/conversation_loop.py:3553` 出发，定位 `agent/error_classifier.py` 的 22 种 `FailoverReason` 分类未脱敏

本文针对 Hermes Agent Gateway 在 32 个消息平台暴露的 `The request failed: {error_detail[:300]}` 用户兜底错误，从 `_normalize_empty_agent_response` 函数源码追踪到 failed 分支的 6 个上下文关键词列表不全、status_code 维度缺失等根因，并给出 4 个配置优先 / 代码兜底的分层

利用SetUnhandledExceptionFilter实现程序异常时获取DUMP文件来分析程序异常原因，现在很多的软件都是通过这样的方法来收集异常，只不过这里少了一步向服务器传输我们的程序产生的DUMP文件，这种DUMP文件产生后其实会通过网络向指定的服务器传输。这样方便开发都收集程序目前存在的BUG。下面是一控制台程序，直接COPY代码，编译运行，我这里用了两种方法使程序异常崩溃，从而产

;处理ARP包开始.只检测谁在伪装网关.把伪装ARP响应包改成ARP请求包并填写正确的网关MAC地址.        mov ebx,_lpPacket        mov ebx,[ebx+8]        invoke NdisQueryBufferSafe,ebx,addr PacketVa,addr PacketSize,20h        mov edi,Packe

# Bug 报告：自定义 OpenAI 兼容 Provider 返回了有效的 tool_calls 但从不执行工具调用 / Custom OpenAI-compatible provider returns valid tool_calls but OpenClaw never executes tools

# Bug 报告：openai-codex provider broken since 2026.4.5 �� Cloudflare challenge + missing OAuth scope / openai-codex provider broken since 2026.4.5 - Cloudflare challenge + missing OAuth scope

OpenRouter 阶梯定价模型成本统计错误分析 问题描述： OpenClaw Gateway 在处理 OpenRouter 阶梯定价模型（如 qwen/qwen3.6-plus）时，流式返回的 usage.cost.total 与实际账单存在严重偏差。长上下文请求（>128k tokens）中，Gateway 记录的成本仅为实际账单的1/4，导致30天累计误差达71.5%（$75.14）