# Claw Empire v2.0.4 릴리스: 크로스 부서 위임 흐름 안정화 이번 업데이트에서는 Claw Empire의 가장 복잡한 부분 중 하나인 크로스 부서 API 위임 시스템을 대대적으로 개선했습니다. 핵심 문제는 여러 부서 간 Office Pack 할당 과정에서 API 권한이 제대로 전파되지 않는 현상이었는데, 이번 릴리스에서 hydrated office pack 확장 시 API 할당이 모든 레이어에 걸쳐 정확하게 이루어지도록 수정했습니다. 또한 Provider 위임 흐름을 완전히 재구성하여 부서 간 권한 이동이 더욱 안정적이고 예측 가능해졌습니다. 총 34개 파일에서 2,500줄 이상의 변경이 이루어져 기존 기능의 견고성이 상당히 향상되었습니다. 이번 작업에서 흥미로웠던 부분은 CLI 실행 인덴테이션과 포매팅 일관성을 유지하는 과정이었습니다. AI의 도움을 받아 Prettier 드리프트 문제를 자동으로 감지하고 수정하는 스크립트를 만들었는데, 이를 통해 코드 스타일 검토에 소요되는 시간을 크게 줄일 수 있었습니다. 엔드투엔드 테스트도 완전히 안정화되어 앞으로 새로운 기능 추가 시 더욱 빠르게 검증할 수 있는 기반이 마련되었습니다.
# Claw Empire 프로젝트 개발 일지 이번 주에는 Claw Empire의 API 제공자 통합과 배포 인프라 개선에 집중했습니다. 가장 주요한 변화는 **공식 API 프리셋 시스템**을 구현한 것인데, 이를 통해 사용자들이 복잡한 API 설정 없이도 주요 AI 제공자들(Kimi, Bailian 등)을 즉시 활용할 수 있게 되었습니다. Kimi Code CLI 제공자 지원도 추가하여 더욱 다양한 개발 워크플로우를 지원하게 되었고, API 프리셋의 캐시 무효화와 키 검증 로직을 강화하면서 안정성도 한 층 높였습니다. 동시에 인프라 측면에서도 중요한 개선이 이루어졌습니다. Docker 배포 지원을 추가하여 사용자들이 더 쉽게 로컬 환경에서 테스트할 수 있게 했고, 고아 상태의 워킹 에이전트 복구 로직을 구현해 시스템 안정성을 높였습니다. API 할당 모달의 부서 필터링 버그도 수정하여 워크플로우 팩 설정과 관계없이 모든 부서를 올바르게 표시할 수 있게 되었습니다. 총 194개 파일의 변경으로 약 3,100줄의 코드가 추가되고 1,641줄이 정리된 이번 업데이트는, 여러 팀 멤버들의 협업과 업스트림 프로젝트의 우수 사례를 적극 반영한 결과입니다. 특히 프리셋 시스템의 안정성을 검증하고 최적화하는 과정에서 AI 코드 분석 도구들의 도움을 받아 엣지 케이스를 사전에 파악할 수 있었습니다. 앞으로도 사용자 경험과 개발자 편의성을 동시에 개선해 나갈 계획입니다.
# 개발 블로그 엔트리 Claw Empire 프로젝트에서 워킹 에이전트의 stale 상태 복구 문제를 해결했습니다. 실제 운영 환경에서 장시간 실행되는 에이전트들이 주기적으로 응답 불가 상태에 빠지는 문제를 발견했고, 이를 자동으로 감지하여 복구하는 메커니즘을 구현했습니다. 문제의 근본 원인은 네트워크 지연, 타임아웃, 또는 예상치 못한 예외로 인해 에이전트가 좀비 상태(zombie state)에 머물러 있었기 때문이었습니다. 해결 방안은 헬스 체크 로직을 강화하고 stale 에이전트를 자동으로 재시작하는 recovery 메커니즘을 추가하는 것이었습니다. 각 워킹 에이전트의 마지막 활동 시간을 추적하고, 설정된 타임아웃 임계값을 초과하면 에이전트를 정리한 후 새로운 인스턴스로 교체하는 방식으로 동작합니다. AI의 도움을 받아 recovery 로직의 엣지 케이스를 검토하고, 동시성 문제가 없는지 검증하는 과정도 거쳤습니다. 이 개선으로 에이전트의 가용성이 크게 향상되었고, 수동 개입 없이도 시스템이 자체 복구될 수 있게 되었습니다. 간단한 변경처럼 보이지만 장기 실행 시스템의 안정성에 미치는 영향은 상당하며, 분산 시스템 환경에서 graceful degradation을 구현하는 좋은 사례가 되었습니다.
# 개발 블로그 엔트리 이번 업데이트에서는 Claw Empire 프로젝트의 대규모 리브랜딩과 함께 여러 새로운 기능들을 추가했습니다. 가장 주요한 변화는 프로젝트명을 Claw-Empire에서 Claw-Republic으로 전면 변경한 것입니다. 153개 파일에 걸친 이름 변경 작업은 단순한 문자열 교체를 넘어, 전체 코드베이스의 일관성을 맞추는 의미 있는 리팩토링이었습니다. 이 과정에서 자동 우선순위 지정 시스템에 Jedi 역할을 추가하여 작업 할당의 정확도를 높였고, AI의 도움을 받아 복잡한 다중 파일 변경 사항을 효율적으로 검증할 수 있었습니다. 기능 측면에서는 Star Wars Coruscant 테마를 기반으로 한 Jedi Office Pack을 새롭게 구현했습니다. 단순한 비주얼 테마를 넘어 authentic한 Coruscant 색상 팔레트를 적용하여 사용자 경험을 한 단계 업그레이드했습니다. 또한 AGENTS.md 문서에 46개의 PM(Project Management) 스킬 프레임워크 레퍼런스를 추가함으로써 개발자들이 프로젝트 관리 관련 자료에 쉽게 접근할 수 있도록 개선했습니다. 이러한 변경들은 여러 브랜치 병합을 통해 체계적으로 통합되었으며, 각 작업이 명확한 목표를 가지고 단계적으로 진행되었음을 보여줍니다. 이번 업데이트는 기술적 안정성과 사용자 경험 개선이 함께 이루어진 균형잡힌 릴리스라고 할 수 있습니다. 특히 자동화된 우선순위 지정과 포괄적인 참조 자료 구축으로 향후 개발 속도를 높일 수 있는 기반을 마련했다는 점이 의미깊습니다.
# Claw Empire v2.0.3 릴리스: Docker 배포 최적화와 안정성 강화 이번 주에는 Claw Empire의 Docker 인프라를 대대적으로 개선하고 v2.0.3을 릴리스했습니다. 가장 큰 변화는 Docker 보안과 배포 프로세스를 현대화한 것입니다. 기존의 root 권한으로 실행하던 컨테이너를 non-root 사용자로 변경했고, 런타임 상태를 `/app/data` 디렉토리 아래에서 관리하도록 마이그레이션했습니다. 특히 환경 변수에 저장된 민감 정보(OpenAI API 키 등)가 실수로 노출되지 않도록 `.env` 파일을 명시적으로 무시하는 처리를 추가했습니다. 이를 통해 개발자들이 더 안전하게 배포할 수 있는 기반을 마련했습니다. 문서화 작업도 함께 진행했습니다. Claude AI와의 협업을 통해 모든 언어의 README에 빠른 배포 가이드와 Claude 환경 설정 방법을 추가했습니다. 덕분에 새로운 사용자들이 프로젝트를 훨씬 더 쉽게 시작할 수 있게 되었습니다. 기술적으로는 표준 Docker Compose/Dockerfile 네이밍으로 통일하고 openclaw 호스트 마운트를 제거하여 설정의 복잡도를 낮췄습니다. 동시에 코어 기능도 개선했습니다. 39개 파일에서 2,000여 줄을 추가하며 API 모델 검색 기능을 안정화했고, CI/CD 파이프라인의 경로 검증 로직을 저장소명에 무관하게 동작하도록 수정했습니다. 일부 실험적 기능(task work phase visibility)은 사용자 피드백을 반영하여 신중하게 롤백했고, PR 리뷰를 통해 검증된 기능만 선택적으로 포함시켜 v2.0.3의 안정성을 높였습니다.
# Claw Empire 프로젝트 업데이트: API 제공자 모델 검색 기능 추가 이번 업데이트에서는 API 제공자의 모델 목록에 검색 필터 기능을 추가했습니다. 사용자들이 수많은 AI 모델 중에서 필요한 모델을 빠르게 찾을 수 있도록 개선한 것인데, 이는 Claude, Codex, Gemini, OpenCode 등 다양한 AI 모델을 지원하는 Claw Empire의 특성상 매우 필요한 기능이었습니다. 검색 필터를 통해 모델명, 제공자, 성능 지표 등으로 효율적으로 필터링할 수 있게 되어 사용자 경험이 크게 향상될 것으로 기대합니다. 기술적으로는 API 엔드포인트에 쿼리 파라미터 기반의 검색 로직을 구현했으며, PR 피드백을 반영하여 코드를 리팩토링했습니다. Docker 환경 구성도 함께 개선했는데, @opencode-ai/opencode npm 패키지로 통합하여 설치 프로세스를 간소화했고, 빌드 실패 시에도 배포가 중단되지 않도록 베스트 에포트 방식으로 변경했습니다. 이 과정에서 Claude와 OpenCode AI의 지원을 받아 다양한 엣지 케이스를 처리할 수 있었습니다. 아울러 CI/CD 파이프라인의 E2E 테스트 커버리지를 확장하고 API 문서를 강화하여, 개발자들이 더욱 안정적으로 통합할 수 있는 환경을 구축했습니다. 2.0.2 릴리스 노트도 함께 발행했으니, 변경사항을 자세히 확인해보시기 바랍니다.
# 개발 블로그 엔트리 Docker 기반의 배포 인프라를 정비하기 위해 Claw Empire 프로젝트에 OpenClaw 배포 스켈레톤을 추가했습니다. 마이크로서비스 아키텍처로 확장되는 프로젝트의 특성상, 각 서비스를 독립적으로 관리하고 배포할 수 있는 기반이 필수적이었습니다. 이번 작업을 통해 팀원들이 일관된 환경에서 개발하고 테스트할 수 있는 기초를 마련했으며, 본격적인 컨테이너화 작업을 시작할 수 있는 발판을 만들었습니다. 구체적으로는 OpenClaw 서비스에 대한 Dockerfile 및 docker-compose 설정의 기본 틀을 구성했습니다. 아직은 스켈레톤 단계이지만, 향후 의존성 정의, 네트워크 설정, 환경 변수 관리 등을 체계적으로 추가할 수 있도록 설계했습니다. 작은 변경처럼 보일 수 있지만, 이러한 표준화된 배포 구조가 있으면 나중에 CI/CD 파이프라인 구축이나 쿠버네티스 마이그레이션 같은 상위 수준의 작업들이 훨씬 수월해집니다. 앞으로 각 마이크로서비스의 특성에 맞게 이 틀을 채워나갈 예정입니다. 특히 AI 도구의 도움을 받아 다양한 시나리오의 설정 파일들을 자동 생성한 후, 팀의 실제 운영 경험을 바탕으로 최적화하는 방식으로 진행할 계획입니다. 이번 기초 작업이 Claw Empire의 배포 안정성과 팀의 생산성 향상으로 이어질 것으로 기대합니다.
# 개발 블로그 엔트리 Claw Empire 프로젝트에서 작은 것부터 차곡차곡 개선해나가고 있습니다. 이번 업데이트에서는 프로젝트 관리 측면에서 두 가지 주요 문제를 해결했습니다. 첫째, `tasks.md` 파일을 `.gitignore`에 추가하여 로컬 작업 메모가 버전 관리에서 제외되도록 했습니다. 이는 개발자별 개인적인 태스크 리스트가 원격 저장소를 오염시키지 않도록 하는 간단하지만 중요한 정리 작업이었습니다. 더 실질적인 개선은 패키지 매니저 셋업 프로세스에서 이루어졌습니다. 기존에는 프로젝트 초기화 시 corepack 체크가 항상 실행되어, 이미 pnpm이 설치된 개발자들에게 불필요한 스텝을 거치게 만들었습니다. 이번 수정으로 pnpm이 이미 설치되어 있으면 체크를 건너뛰도록 최적화했으니, 팀원들의 개발 환경 셋업이 한층 빨라질 것으로 예상됩니다. 작은 변경이지만 개발자 경험(DX)을 높이는 데 도움이 될 만한 개선입니다.
# Claw Empire v2.0.1 릴리스: 하이드레이션 인식 오피스 팩 병합 기능 추가 이번 업데이트에서는 Claw Empire의 핵심 기능을 한 단계 업그레이드했습니다. 가장 주목할 만한 변화는 **하이드레이션 인식(hydrate-aware) 오피스 팩 병합 기능**의 추가입니다. 기존에는 여러 오피스 팩을 단순 병합하는 방식이었다면, 이제는 수정 데이터의 하이드레이션 상태를 감지하여 더 지능적으로 병합할 수 있게 되었습니다. 이를 통해 중복된 데이터 처리를 줄이고, 병합 과정에서의 데이터 무결성을 보장할 수 있게 했습니다. 개발 과정에서는 코드 품질 유지에도 신경 썼습니다. 28개 파일에 걸쳐 2,089줄의 코드가 추가되고 143줄이 정리되었으며, Prettier를 통한 일관된 코드 포매팅 적용과 CI/E2E 테스트 안정화를 함께 진행했습니다. 특히 v2.0.1 문서까지 동시에 업데이트하여 사용자들이 새로운 기능을 바로 활용할 수 있도록 준비했습니다. 이번 릴리스는 단순한 버그 수정을 넘어 시스템의 안정성과 기능성을 동시에 향상시킨 의미 있는 버전입니다. CI/E2E 파이프라인의 안정화로 앞으로의 배포 프로세스도 더욱 견고해질 것으로 기대됩니다.
# Claw Empire 2.0.0 릴리스: AI 협업 워크플로우 안정화 Claw Empire 프로젝트에서 2.0.0 버전을 릴리스했습니다. 이번 업데이트는 91개 파일에 걸쳐 2,000줄 이상의 코드 변경을 포함하며, 핵심적으로는 **AI 에이전트 기반의 크로스팀 협업 워크플로우를 안정화**하는 데 집중했습니다. Remotion 기반의 비디오 렌더링 파이프라인에서 발생하던 여러 엣지 케이스를 해결했고, 특히 `sibling worktree paths`를 AI 위임 프롬프트에 주입하여 부서 간 협업이 더 원활하게 이루어지도록 개선했습니다. 또한 완료된 서브태스크 브랜치를 최종 렌더링 전에 병합하고, 외부 프로젝트 워크트리에 `.claude/skills` 심링크를 자동 설정하는 기능을 추가했습니다. 기술적으로 가장 흥미로운 부분은 **비디오 최종 렌더링 루프의 안정성 개선**입니다. 이전에는 Remotion 게이트의 거짓 양성이 reasoning 로그에서 발생하거나, 렌더링 완료 플로우가 불안정했습니다. 이번 업데이트에서는 검토 홀드 시 렌더링 루프를 즉시 중단하고, `VIDEO_FINAL_RENDER` 위임 전에 모든 서브태스크 브랜치를 병합하는 순서를 강제하여 이러한 문제들을 근본적으로 해결했습니다. Windows 환경에서의 pnpm 쉘 실행 문제도 함께 수정했으며, OpenAPI 계약 동기화 시 프로젝트별 Prettier 설정을 일관되게 적용하도록 개선했습니다. 이번 릴리스는 AI와의 협업이 단순한 코드 생성을 넘어 **멀티팀 프로젝트 오케스트레이션**으로 확장되는 과정을 보여줍니다. yoloMode 설정 뒤의 프로젝트 디시전 게이트 바이패스 기능과 같은 안전장치도 마련했으므로, 개발자들은 자신의 리스크 수준에 맞춰 자동화 수준을 조절할 수 있습니다.
# 개발 블로그 엔트리 Claw Empire 프로젝트에서 비디오 렌더링 파이프라인과 워크플로우 오케스트레이션을 대폭 개선했습니다. 이번 작업의 핵심은 복잡한 멀티-에이전트 워크플로우에서 발생하던 데드락과 레이스 컨디션을 해결하는 것이었습니다. 특히 `VIDEO_FINAL_RENDER` 서브태스크의 위임 순서를 재설계하여, 다른 모든 서브태스크가 완료될 때까지 지연시키는 방식으로 경쟁 상태를 근본적으로 제거했습니다. 또한 Remotion 기반의 동영상 전처리 자동화 기능을 새로 도입해 비디오 품질 프롬프팅을 개선하고, 오피스 팩 시드 부팅 및 DB 백업 체계를 강화했습니다. 워크플로우 격리(isolated worktree execution)와 팩 스코프 분리를 통해 부서/에이전트 간 스코프 일관성을 한층 더 개선했습니다. 이전에는 위임 중 발생하는 상태 동기화 문제로 인해 office-pack 재수화 과정에서 불필요한 지연이 발생했지만, 이제는 hydrated된 팩을 DB 기반으로 유지하면서 스킵 로직을 추가해 성능을 크게 향상시켰습니다. 80개 파일에 걸쳐 4500여 줄의 코드를 추가하고 800여 줄을 정리하는 과정에서, AI 협업을 통해 비디오 퀄리티 가이드라인을 자동으로 생성하고 컨텍스트 표현을 풍부하게 만들 수 있었습니다. 이번 개선으로 보고서 출력(HTML+PPTX) 정책을 강화했을 뿐만 아니라, 결정 리뷰 프로세스에서 중복 렌더 서브태스크 생성을 방지하고 위임 드레인 경합 상태를 제거했습니다. 특히 origin-team-first 순차 위임 정책을 적용함으로써 전체 워크플로우의 예측 가능성과 안정성이 눈에 띄게 향상되었습니다. 앞으로는 이 기반 위에서 더욱 복잡한 멀티-스테이지 렌더링 시나리오를 안정적으로 처리할 수 있을 것으로 기대합니다.