OpenClaw를 업데이트하고 가동 확인까지 진행하는 openclaw-update
機械翻訳 / Machine-translated
機械翻訳 / Machine-translated
원문: OpenClawを更新して稼働確認まで進めるopenclaw-update（cccskills）
스킬 페이지: openclaw-update
이 글의 결론
openclaw-update를 도입하면, OpenClaw Gateway 운용자는 업데이트 작업을 에이전트에게 맡길 수 있습니다.
맡길 수 있는 범위는 도입 환경에 맞는 절차로의 업데이트부터, 재시작 후 세션 복구, 가동 버전 확인까지입니다.
이하에서는 업데이트 절차의 분기 방식, 설치 방법, 요청문 예시, 사용 전에 알아두어야 할 주의사항을 순서대로 소개합니다.
기존 Gateway의 업데이트를 요청하면, 에이전트는 대상 특정부터 가동 확인까지를 일련의 흐름으로 진행합니다.
이 서버의 OpenClaw Gateway를 업데이트하고, 가동 확인까지 진행해줘
에이전트가 먼저 조사하는 것은 대상 호스트, 실행 사용자, 프로필 및 상태 저장 위치입니다.
함께 서비스, 가동 중인 릴리스, 업데이트를 담당하는 관리 주체(오너)도 확인합니다.
로컬 리포지토리나 셸의 CLI가 다른 설치에 속해 있을 수 있기 때문입니다.
그 위에서, 도입 환경에 맞는 기존 업데이트 절차를 선택합니다.
백업이나 재시작, 복구는 그 절차에 기재된 대로 진행합니다.
마지막 작업은 목표 버전이나 커밋이 실제로 동작 중인지 확인하는 것입니다.
결과는 1~3줄의 짧은 보고로 반환되며, 필요할 때만 짧은 SHA(커밋을 식별하는 문자열)가 첨부됩니다.
로그의 반복이나 전체 해시는 포함되지 않습니다.
이 스킬의 역할은 환경별 올바른 업데이트 절차로 분기하고, 완료까지 지켜보는 것입니다.
업데이트를 직접 구성하지는 않습니다.
새로운 배포 메커니즘이나 스케줄러를 만들지도 않습니다.
어떤 절차로 업데이트할지는 도입 환경의 종류에 따라 결정됩니다.
| 도입 환경 | 사용하는 업데이트 절차 |
|---|---|
| 정규 main 체크아웃 및 macOS 앱 | openclaw-live-updater 스킬 |
| 운용자가 설정한 Team 서버 | update-team-server 스킬 |
| 컨테이너나 선언적 설치 등, 그 외 관리 환경 | 환경 고유의 스킬이나 운용 절차서와 기존 관리 주체 |
| 표준 패키지, 또는 단일 사용자의 소스 설치 | OpenClaw 업데이트 문서와 update CLI(대상 호스트·프로필의 CLI 사용) |
선택한 절차의 명령어, 잠금, 백업 및 마이그레이션 요건은 그대로 따릅니다.
알림 방침이나 사후 정리도 마찬가지입니다.
별도 관리되는 릴리스나 가동 중인 컨테이너 내부에서 표준 CLI 업데이트를 적용하지는 않습니다.
가동 중인 Gateway가 사용하는 파일의 덮어쓰기도 피합니다.
미커밋 변경이 남아 있는 체크아웃을 덮어쓰지도 않습니다.
업데이트 요청에는 일반적인 재시작과 제한된 시간의 중단이 포함되는 것으로 취급됩니다.
복구 대상 세션은 자동으로 재개되므로, 에이전트나 태스크가 동작 중이라는 이유만으로 재확인을 요구받지 않습니다.
정지에 사용하는 것은 관리 주체가 준비한 점진적 종료(처리 중인 작업을 마친 후 종료하는 방법)입니다.
태스크 취소, 세션 중단, 큐 삭제는 작업 손실의 원인이 됩니다.
따라서 대기 상태를 강제로 만드는 목적으로는 사용하지 않습니다.
복구된 대화를 수동으로 다시 처리하지도 않습니다.
업데이트가 연기되거나, 실패 또는 롤백이 발생해도 스킬은 요청을 놓지 않습니다.
관리 주체에 의한 완료 확인이나, 외부 대응이 필요한 구체적인 장애 요인이 파악될 때까지 추적합니다.
이전 프로세스가 복귀했을 뿐인 경우는 완료로 간주하지 않습니다.
사용자가 일시 정지나 취소를 지시한 경우에는 그에 따릅니다.
계속 진행할 경로가 없으면, 불가능한 약속은 하지 않고 장애 요인을 전달합니다.
확인에 사용하는 것은 관리 주체의 검증 절차입니다.
주로 확인하는 항목은 다음과 같습니다.
빌드 성공이나 인계 수령은 완료의 증거가 되지 않습니다.
모니터링용 래퍼가 성공을 반환해도, 실제 업데이트는 연기되거나 실패로 끝났을 수 있습니다.
따라서 양쪽 결과는 나누어 판독합니다.
설치 방법은 명령어를 한 줄 실행하는 방법과, 에이전트에게 요청하는 방법 두 가지입니다.
명령어로 설치할 경우, Claude Code나 Codex 등 설치할 대상 에이전트를 선택할 수 있습니다.
npx skills add https://github.com/openclaw/openclaw --skill openclaw-update
에이전트에게 요청할 경우에는 다음 내용을 그대로 보내주세요.
次の Agent Skill をインストールしてください。
https://github.com/openclaw/openclaw/tree/main/.agents/skills/openclaw-update
まず SKILL.md と付属ファイルの中身を確認し、不審な処理（外部への送信、認証情報の読み取りなど）がないことを確かめてから、Claude Code なら ~/.claude/skills/openclaw-update/、Codex なら ~/.agents/skills/openclaw-update/ に配置してください。
저장 위치는 사용 범위에 따라 다음과 같이 구분됩니다.
| 에이전트 | 모든 프로젝트에서 사용 | 특정 프로젝트에서만 사용 |
|---|---|---|
| Claude Code | ~/.claude/skills/ | .claude/skills/ |
| Codex | ~/.agents/skills/ | .agents/skills/ |
포함된 파일은 SKILL.md와 agents/openai.yaml 두 가지입니다.
분기 대상 절차는 같은 리포지토리의 다른 스킬이나 OpenClaw 문서에 있습니다.
자신의 환경에 해당하는 스킬(openclaw-live-updater나 update-team-server)이 있다면 함께 설치해 두세요.
요청문은 한국어로 작성해도 됩니다.
업데이트 범위나 확인해 주었으면 하는 사항을 덧붙이면, 보고 내용이 명확해집니다.
로컬 OpenClaw Gateway를, 현재 업데이트 채널을 유지한 채로 최신 버전으로 업데이트해줘
이 경우의 "최신 버전"은 설정된 채널을 유지한다는 의미로 처리됩니다.
에이전트는 관리 주체를 확인하고, 해당 절차로 업데이트합니다.
완료 후 보고는 가동 중인 버전을 전달하는 짧은 내용입니다.
관리 중인 서버의 Gateway를 업데이트하고 싶어.
어떤 업데이트 절차를 사용해야 하는지 먼저 조사해줘
에이전트는 호스트, 실행 사용자, 서비스, 가동 중인 릴리스를 조사하고, 위의 표에서 어떤 절차에 해당하는지 판단합니다.
로컬 CLI가 다른 설치에 속한 경우에는 그 점도 구분하여 처리합니다.
최신 main으로 업데이트하고, 가동 중인 커밋과 정상성을 확인해줘
"최신 main"으로 명시하여 요청하면, 개발 버전 소스로부터 업데이트하는 흐름이 선택됩니다.
표준 CLI에서는 --channel dev에 해당하는 것입니다.
개발 버전의 사전 체크는 빌드 가능한 오래된 커밋을 선택하는 경우가 있습니다.
따라서 업데이트 전에 대상이 제시되고, 업데이트 후에는 실제로 가동 중인 SHA가 보고됩니다.
대상은 기존 Gateway의 정기적인 업데이트뿐입니다.
신규 설치, 릴리스 검증 및 공개, 관계없는 호스트는 취급하지 않습니다.
업데이트할 환경의 관리 절차와 그에 대한 접근 권한이 필요합니다.
업데이트에는 재시작이 수반됩니다.
복구 대상 세션은 자동으로 재개되지만, PTY(의사 터미널)는 유지되지 않습니다.
관리 주체에 의해 제어된 중단 메커니즘이 없는 경우, 에이전트는 그 부족함을 보고하거나 허용된 범위 내에서 수정합니다.
강제 플래그를 생성하거나, 호환성 체크를 우회하지는 않습니다.
미승인 다운그레이드나 플러그인 권한 변경도 자동으로 허용하지 않습니다.
관리 환경 고유의 제약이나 업데이트 잠금에도 따릅니다.
업데이트 절차에 명확한 버그가 발견된 경우에는 허용된 범위 내에서 수정합니다.
수정은 PR 리뷰와 CI를 거쳐 반영되는 흐름입니다.
라이선스는 MIT입니다.
설치 전에 SKILL.md와 첨부 파일을 읽고, 의심스러운 처리가 없는지 확인해 주세요.
openclaw-update가 분기하는 대상 스킬은, 환경에 따라 함께 사용합니다.
openclaw-live-updater는 macOS 위의 OpenClaw를 main 최신 버전으로 업데이트하고, Gateway와 앱의 동작을 확인하는 스킬입니다.
정규 main 체크아웃과 macOS 앱 환경에서는 이 스킬이 업데이트를 담당합니다.
update-team-server는 운용자가 설정한 Team 서버의 업데이트를 담당자에게 인계하고, 검증·복구·완료 확인까지 진행합니다.
Team 서버를 운용 중이라면 함께 설치해 두세요.
진행됩니다.
업데이트 요청에는 일반적인 재시작과 제한된 중단이 포함되며, 복구 대상 세션은 자동으로 재개됩니다.
단, PTY(의사 터미널)는 유지되지 않습니다.
로컬 리포지토리나 CLI가, 업데이트하려는 환경과는 다른 설치에 속해 있을 수 있습니다.
이 스킬은 대상 호스트의 프로필과 관리 주체를 확인한 후, 그 환경의 절차를 선택합니다.
사용할 수 없습니다.
대상은 기존 Gateway의 업데이트이며, 신규 설치나 릴리스 검증·공개는 범위 밖입니다.
연기, 실패, 롤백이 발생해도 완료 확인이나 구체적인 장애 요인이 파악될 때까지 추적합니다.
외부 대응이 필요한 경우에는 그 장애 요인이 짧게 보고됩니다.
openclaw-update는 이미 동작 중인 OpenClaw Gateway를, 그 환경의 관리 절차에 따라 업데이트하는 스킬입니다.
재시작 후 세션 복구와, 목표 버전이 가동 중인지 확인까지를 일련의 흐름으로 진행합니다.
도입 환경이 여러 개 있어 어떤 절차로 업데이트해야 할지 고민하는 운용자에게 적합합니다.
먼저 로컬 Gateway 업데이트를 요청해 보고, 분기와 보고의 흐름을 확인해 보세요.
이 글은 cccskills의 읽을거리 「OpenClawを更新して稼働確認まで進めるopenclaw-update」의 전재입니다.
스킬의 상세 내용과 설치 방법은 cccskills의 openclaw-update 페이지에 있습니다.