Openclaw용 웹 게임 개발

개발자와 AI 에이전트가 Playwright를 사용하여 canvas 기반 웹 게임을 체계적으로 빌드, 테스트 및 개선할 수 있도록 하는 자동화 프레임워크입니다.

tbeard602
v1.0.0
Jun 7, 2026
0
760
0

설치 및 다운로드

1. ClawHub CLI

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

npx clawhub@latest install develop-web-game

2. 수동 설치

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

글로벌
~/.openclaw/skills/
워크스페이스
<project>/skills/

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

3. 프롬프트 설치

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

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

다운로드를 원하시나요?

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

웹 게임 개발란 무엇인가요?

웹 게임 개발 스킬은 대화형 브라우저 게임 빌드를 위한 결정론적 개발 및 테스트 워크플로우를 구축합니다. 게임 설계를 구현, 동작 실행, 일시 중지, 관찰 및 조정의 점진적 주기로 다룸으로써, 이 스킬은 개발 과정 내내 웹 게임이 강력하고 오류 없이 유지되도록 보장합니다. Openclaw Skills 생태계의 일부로서, 이는 테스트 불안정성을 제거하고 깔끔한 게임 루프를 유지하는 데 필요한 구조화된 도구를 에이전트와 개발자에게 제공합니다.

이 스킬의 핵심은 시각적 검증과 프로그래밍 방식의 상태 추적을 긴밀하게 통합하는 것입니다. 개발자는 수동 테스트에 의존하는 대신 사용자 입력 시퀀스를 자동화하고 정확한 런타임 상태를 캡처할 수 있습니다. Openclaw Skills 패러다임을 기반으로 하는 이러한 규율 있는 테스트 요법은 게임의 메커니즘, canvas 레이아웃 및 물리 엔진이 모든 조건에서 정확하게 렌더링되도록 보장합니다.

웹 게임 개발 활용 사례

  • 작고 테스트 가능한 단위로 기능을 빌드하여 HTML 및 JavaScript canvas 게임을 빠르게 프로토타이핑합니다.
  • 이동, 점프, 메뉴 상호작용과 같은 사용자 입력을 자동화하여 수동 검증의 피로를 방지합니다.
  • 자동화된 스크린샷 분석을 사용하여 게임 상태 전환, 렌더링 로직 및 시각적 UI 레이아웃을 검증합니다.
  • 구조화된 진행 상태 로그를 사용하여 여러 AI 에이전트 인스턴스 간의 지속적인 핸드오프를 가능하게 합니다.

웹 게임 개발 작동 원리

  1. 목표 정의: 구현할 단일 기능 또는 메커니즘을 식별합니다.
  2. 후크 통합: 게임 루프 내에 window.render_game_to_text 및 window.advanceTime을 노출하여 결정론적인 상태 액세스 및 시간 단계를 보장합니다.
  3. 진행 상황 추적: 지속적인 progress.md 로그 파일을 유지하여 원본 사용자 프롬프트와 보류 중인 작업을 캡처합니다.
  4. Playwright 클라이언트 실행: 자동화된 클라이언트 스크립트를 참조 작업과 함께 사용하여 게임 플레이를 시뮬레이션합니다.
  5. 시각적 검사: 새로 추가된 기능의 생성된 스크린샷을 열고 시각적으로 검사하여 정확성을 확인합니다.
  6. 상호작용 검증: 완전한 다단계 상호작용 체인을 테스트합니다(예: 적을 쏘아 체력을 줄이고 점수를 업데이트).
  7. 오류 해결: 브라우저 콘솔 로그를 확인하고 반복적인 피드백 루프 내에서 런타임 예외를 해결합니다.

웹 게임 개발 설정 가이드

이 스킬의 경로를 초기화하기 위해 필요한 환경 변수를 구성하세요:

export CODEX_HOME="${CODEX_HOME:-$HOME/.codex}"
export WEB_GAME_CLIENT="$CODEX_HOME/skills/develop-web-game/scripts/web_game_playwright_client.js"
export WEB_GAME_ACTIONS="$CODEX_HOME/skills/develop-web-game/references/action_payloads.json"

Playwright가 전역적으로 설치되었는지 또는 프로젝트 종속성으로 설치되었는지 확인하세요:

# npx 사용 가능 여부 확인, 그렇지 않으면 전역 설치
command -v npx >/dev/null 2>&1 || npm install -g @playwright/mcp@latest

지정된 작업 payload 파일을 사용하여 테스트 클라이언트를 실행하세요:

node "$WEB_GAME_CLIENT" --url http://localhost:5173 --actions-file "$WEB_GAME_ACTIONS" --click-selector "#start-btn" --iterations 3 --pause-ms 250

웹 게임 개발 데이터 스키마 및 분류 체계

텍스트 상태 출력

게임은 활성 상태를 나타내는 간결한 JSON 문자열을 반환하는 전역 렌더링 후크를 노출해야 합니다:

{
  "mode": "playing",
  "player": { "x": 100, "y": 150, "r": 15 },
  "entities": [
    { "x": 200, "y": 220, "r": 10 }
  ],
  "score": 500
}

작업 Payloads

JSON으로 단계 구조를 정의하여 다단계 상호작용을 시뮬레이션합니다:

{
  "steps": [
    { "buttons": ["left_mouse_button"], "frames": 2, "mouse_x": 120, "mouse_y": 80 },
    { "buttons": [], "frames": 6 },
    { "buttons": ["right"], "frames": 8 },
    { "buttons": ["space"], "frames": 4 }
  ]
}

핵심 파일 및 로그

파일 이름 설명
progress.md 원본 프롬프트, TODO 목록, 활성 회귀 및 후속 에이전트를 위한 제안을 추적합니다.
$WEB_GAME_CLIENT Playwright 통합, 가상 시간 진행 및 스크린샷 내보내기를 수행하는 Node 스크립트.
$WEB_GAME_ACTIONS 키보드 및 마우스 이동 schema payload가 포함된 참조 JSON 파일.

웹 게임 개발 고급 기능

  • 가상 시간 단계: window.advanceTime을 활용하는 사용자 정의 결정론적 루프를 구현하여 테스트 중 게임 속도를 호스트 프로세서 성능과 분리합니다.
  • 시각적 스크린샷 캡처: 게임 내 캡처를 시각적 자산으로 자동 생성하여 직접적인 시각적 단언 및 시각적 회귀 검사를 허용합니다.
  • 콘솔 로그 리디렉션: 터미널 실행 내에서 브라우저 콘솔 메시지를 직접 캡처하고 파싱하여 결함을 빠르게 강조합니다.
  • 다중 에이전트 진행 로깅: progress.md 파일과 통합하여 연속적인 에이전트 개발 주기 전반에 걸쳐 컨텍스트와 사용자 프롬프트를 보존합니다.

SKILL.md


로드 중

관련 Openclaw 스킬

METADATA

Github Stars: 0
forks: 0

추천*