원문 캡처 · github.com
원문 캡처 · github.com

phpClaw는 PHP 애플리케이션에 도구 호출, 메모리, 보안 검사 기능을 갖춘 AI 에이전트를 연결하는 오픈소스 런타임이다. 제작자는 프레임워크 의존성이 없는 코어와 7개 LLM 제공자 지원을 내세운다.

설치는 Composer로 진행하며, PHP 8.1~8.4와 ext-curl, ext-json, ext-mbstring 확장이 필요하다. 프레임워크 어댑터는 별도 요구 사항이 있을 수 있다.

sh
composer require phpclaw/phpclaw

에이전트는 셸, HTTP, 파일, 데이터베이스 등의 도구를 등록해 사용하며, ReAct 방식으로 도구를 호출하고 결과를 확인하는 과정을 반복한다. 기본 최대 반복 횟수는 20회다. Anthropic, OpenAI, Groq, Gemini, Mistral, DeepSeek, Ollama를 지원하고, 환경 변수에 설정된 키를 확인해 제공자를 선택한다. 사용자 설정을 통해 OpenAI 호환 사용자 지정 엔드포인트도 쓸 수 있다.

제작자 설명에 따르면 기본 보안 검사에는 프롬프트 인젝션, 개인정보, 코드 인젝션, 파괴적인 SQL 등에 대한 가드가 포함된다. 셸 도구는 허용 목록을 사용하고, 파일 도구는 작업 공간으로 제한된다. phpClaw는 임베딩이나 벡터 저장소를 제공하는 RAG 프레임워크가 아니라, 실제 애플리케이션의 도구와 메모리를 에이전트에 연결하는 데 초점을 둔다.

Laravel, Symfony, Drupal, Magento와 WordPress 등 8개 프레임워크·CMS 어댑터를 제공한다. CMS 어댑터는 Composer 패키지가 아니라 ZIP으로 배포된다. 자세한 설치 방법과 보안 조건은 문서, 보안 안내에서 확인할 수 있다. 코어 저장소와 릴리스는 GitHub 저장소에서 제공된다.