Sponsored by Vmake Labs Video Enhancer - Vmake Labs Video Enhancer는 AI를 활용해 동영상 화질을 개선하고, 디테일을 복원하며, 흐림을 줄이고 최대 8K까지 업스케일링합니다.

AI 광고 라이브러리

Openclaw Skills

Codex Agent

Openclaw용 Codex Agent

Codex Agent는 OpenAI Codex CLI를 위한 정교한 프로젝트 관리자 역할을 하며 작업 실행, 모니터링 및 지식 베이스 유지 관리를 자동화합니다.

henryxiaoyang

v1.0.0

Feb 28, 2026

설치

정보

Skill.md

설치 및 다운로드

1. ClawHub CLI

레지스트리에서 스킬을 바로 설치하는 가장 빠른 방법입니다.


                  npx clawhub@latest install codex-agent

2. 수동 설치

스킬 폴더를 다음 위치 중 하나로 복사하세요

글로벌

~/.openclaw/skills/

워크스페이스

<project>/skills/

우선순위: 워크스페이스 > 로컬 > 번들

3. 프롬프트 설치

이 프롬프트를 OpenClaw에 복사하면 자동으로 설치됩니다.


                  Clawhub를 사용해서 codex-agent 설치를 도와줘. Clawhub가 설치되어 있지 않다면 먼저 설치해 줘 (npm i -g clawhub).

다운로드를 원하시나요?

ZIP 아카이브 형태의 원본 스킬 파일을 받으세요.

Codex Agent란 무엇인가요?

Codex Agent는 Openclaw Skills 생태계 내에서 OpenAI Codex CLI 상단에 위치하도록 설계된 전문 프로젝트 관리 시스템입니다. 단순한 명령 전달자가 아니라 요구 사항을 이해하고 실행 전략을 설계하며 AI가 생성한 코드의 품질을 감독하는 자율 프로젝트 관리자로서 기능합니다. 터미널 기반 인터페이스와 비동기 모니터링을 결합하여 개발자의 지속적인 감독 없이도 복잡한 다회차 개발 작업을 처리합니다.

이 스킬은 영구 세션을 위한 tmux와 실시간 알림을 위한 사용자 정의 Python 후크를 통합하여 AI 코딩 워크플로우를 관리하기 위한 강력한 프레임워크를 제공합니다. Codex Agent는 상위 수준의 프로젝트 목표와 하위 수준의 CLI 실행 사이의 간극을 메움으로써 Openclaw Skills 사용자가 자동화된 추론과 감독된 반복을 통해 높은 수준의 코드 품질과 아키텍처 무결성을 유지할 수 있도록 보장합니다.

Codex Agent 활용 사례

OpenAI Codex CLI를 통한 복잡한 다중 파일 코드 생성 작업 관리.
비동기식 깨우기 알림을 통한 장시간 실행 코딩 프로세스의 자동 모니터링.
로컬 지식 베이스를 최신 AI 모델 기능 및 문서와 동기화.
개발 환경에서 AI 기반 구성 변경 및 기능 플래그 업데이트 감독.
git worktrees 및 격리된 tmux 세션을 사용하여 병렬 개발 작업 편성.

Codex Agent 작동 원리

요구 사항 분석: 에이전트는 개발자 상호 작용을 통해 작업 목표, 기술 스택 및 수락 기준을 식별합니다.
전략 계획: 내부 지식 베이스를 참조하여 최적의 모델, 추론 노력 및 실행 모드(exec vs. TUI)를 선택합니다.
프롬프트 엔지니어링: 사전 정의된 패턴을 사용하여 기본 AI 모델에 대한 정확한 지침을 구성합니다.
자율 실행: 에이전트는 백그라운드 또는 대화형 tmux 창을 통해 작업을 실행하며, 설정에 따라 자동 승인 또는 수동 승인 게이트를 적용합니다.
실시간 모니터링: 창 모니터 스크립트가 특정 트리거 또는 승인 요청에 대해 터미널 출력을 추적합니다.
검증 및 보고: 완료 시 에이전트는 초기 요구 사항에 대해 변경 사항을 검증하고 수정 사항에 대한 자세한 요약을 제공합니다.

Codex Agent 설정 가이드

Openclaw Skills 워크플로우에 Codex Agent를 통합하려면 다음 단계를 따르세요.

로컬 머신에 tmux를 설치하고 경로를 통해 codex CLI에 액세스할 수 있는지 확인합니다.
~/.codex/config.toml에 알림 후크를 추가하여 codex 설정을 구성합니다.

notify = ["python3", "<path_to_skill>/hooks/on_complete.py"]

알림 시스템에 필요한 환경 변수를 설정합니다.

export CODEX_AGENT_CHAT_ID="your_unique_id"
export CODEX_AGENT_NAME="main"

에이전트를 통해 테스트 메시지를 실행하여 설정을 확인합니다.

openclaw agent --agent main --message "test"

Codex Agent 데이터 스키마 및 분류 체계

Codex Agent는 Openclaw Skills 내에서 정확성을 보장하기 위해 구조화된 Markdown 파일 세트를 통해 운영 컨텍스트를 구성합니다.

데이터 구성 요소	경로	목적
기능 추적	`knowledge/features.md`	모든 CLI 명령 및 기능 플래그 카탈로그.
구성 스키마	`knowledge/config_schema.md`	오류 방지를 위한 config.toml 필드의 엄격한 정의.
프롬프트 패턴	`knowledge/prompting_patterns.md`	특정 코딩 작업을 위한 최적화된 템플릿 라이브러리.
버전 상태	`state/version.txt`	자동 지식 업데이트를 트리거하기 위해 로컬 CLI 버전을 추적.
실행 로그	`/tmp/codex_exec_output.txt`	백그라운드 프로세스 출력을 위한 임시 저장소.