phpClaw 拆解：PHP 项目挂一个 AI Agent 要几步，以及为什么 8 个安全守卫比 Agent 本身更值得看

Fri, 30 Oct 2026 00:00:00 +0000

PHP 程序员想给项目加个 AI Agent，通常的路径是这样的：装一个 LLM SDK，拿到一个 HTTP 客户端，然后自己写 tool-calling 循环。

循环写完了，问题才开始——工具结果要不要过滤？提示词注入怎么防？记忆存哪？流式输出和工具调用能不能同时跑？

2026 年 10 月底，Hacker News 上出现一个项目，自称把这些全做完了：phpClaw。

我读了它的 README、Packagist 元数据和 HN 上的讨论。结论是——它解决的不是"PHP 能不能调 LLM"，而是"PHP 项目里那个 Agent 循环，谁来维护"。

这篇把它的机制拆开，重点讲三个东西：工具怎么注册、安全守卫怎么工作、以及它和通用 LLM SDK 的真实边界。

TL;DR

phpClaw 是 MIT 开源的 PHP Agent 运行时，核心零框架依赖，PHP 8.1+ 即可

一个 composer require + 一行 builder + 一次 send()，就是完整 Agent

8 个默认安全守卫才是重点：prompt injection / PII / 代码注入 / Unicode / homoglyph / 角色切换 / 破坏性 SQL / 消息长度

ShellTool 白名单硬编码不可覆盖，HttpTool 校验解析后的 IP（堵 DNS rebinding）

明确不做 RAG：没有 embeddings、没有向量库

PHP 项目里的 Agent 循环，为什么会变成祖传代码？

先看不用任何框架要写什么。一个最小的 tool-calling agent，PHP 里大致长这样：

PHP on softon.top

phpClaw 拆解：PHP 项目挂一个 AI Agent 要几步，以及为什么 8 个安全守卫比 Agent 本身更值得看

PHP 项目里的 Agent 循环，为什么会变成祖传代码？