After writing "The Claude Code You Don't Know," I realized my understanding of the underlying agent foundations wasn't deep enough. Given our team's growing experience deploying agents in production, we desperately needed a systematic overview. So, I revisited the literature, open-source implementations, and my own code to compile this article.

撰写“The Claude Code You Don't Know”之后，我意识到自己对底层 agent 基础的理解还不够深入。鉴于我们团队在生产环境中部署 agents 的经验日益增多，我们迫切需要一个系统性的概述。因此，我重温了文献、开源实现和我自己的代码，编译了这篇文章。

This piece focuses on the architectural components that most heavily impact engineering outcomes: control flow, context engineering, tool design, memory, multi-agent organization, evaluation, tracing, and security. Finally, we'll look at the OpenClaw implementation to see how these design principles connect in practice.

本文重点关注对工程成果影响最大的架构组件：control flow、context engineering、tool design、memory、多代理组织、evaluation、tracing 和 security。最后，我们将查看 OpenClaw 实现，以了解这些设计原则在实践中的连接方式。

Along the way, I revised a few of my previous assumptions. Using a more expensive model doesn't always yield the massive improvements you'd expect. Instead, the quality of your harness and validation tests has a far greater impact on success rates. When debugging agent behavior, your first stop should be checking tool definitions, as most tool selection errors stem from inaccurate descriptions. Furthermore, flaws in the evaluation system itself are often harder to spot than bugs in the agent. If you constantly tweak agent code without addressing the underlying evaluation, you won't see obvious results. By the end of this article, you should have some answers to these issues.

在此过程中，我修正了一些先前的假设。使用更昂贵的模型并不总是带来你预期的巨大改进。相反，你的测试框架和验证测试的质量对成功率的影响要大得多。在调试 agent 行为时，你的首要任务应该是检查工具定义，因为大多数工具选择错误源于不准确的描述。此外，评估系统本身的缺陷往往比 agent 中的 bug 更难发现。如果你不断调整 agent 代码而不解决底层评估问题，你不会看到明显的结果。到本文结束时，你应该对这些问题有一些答案。

1. The Basic Operations of an Agent Loop

1. Agent Loop 的基本操作

Abstracting the core implementation logic of the Agent Loop reveals that it's essentially under 20 lines of code:

将 Agent Loop 的核心实...