OpenClaw 문제 해결: 최소한의 초기화 방법

불안정한 설정을 위한 OpenClaw 재설정 절차

OpenClaw 설정이 불안정해질 때—스킬이 토큰을 소모하거나, 에이전트가 잘못된 완료를 보고하거나, 업데이트로 연결이 끊어질 때—최소 구성으로 완전히 재설정하면 근본 원인을 파악할 수 있습니다. 이 접근 방식은 복잡성을 제거하여 문제를 분리합니다.

5단계 재설정 과정

단계 1: 모든 스킬 제거 (60초)

모든 스킬을 백업으로 이동하여 무한 루프, 토큰 소모, 컨텍스트 주입, 설정 덮어쓰기, 악성 코드와 같은 일반적인 불안정성 원인을 제거하세요:

mkdir ~/.openclaw/skills-backup
mv ~/.openclaw/agents/*/skills/* ~/.openclaw/skills-backup/

이렇게 하면 핵심 에이전트 기능을 테스트하는 동안 나중에 복원할 수 있도록 스킬이 보존됩니다.

단계 2: Claude Sonnet으로 전환 (30초)

모델 관련 문제를 제거하기 위해 AI 모델 구성을 변경하세요:

{
  "ai": {
    "model": "claude-sonnet-4-5-20250929"
  }
}

Sonnet은 저렴하고 신뢰할 수 있으며 도구 호출과 일관성이 있어 권장됩니다. Sonnet으로는 작동하지만 Opus, GPT-5.4 또는 로컬 모델로는 작동하지 않는다면 모델이 문제였습니다.

단계 3: 세션 정리 (15초)

손상되었을 수 있는 대화 기록을 제거하세요:

rm -rf ~/.openclaw/agents/*/sessions/*

이 작업은 SOUL.md, 메모리, USER.md 또는 영구 구성에는 영향을 주지 않습니다—업데이트 또는 모델 전환 후 손상될 수 있는 세션 데이터만 제거됩니다.

단계 4: SOUL.md 단순화 (60초)

현재 SOUL.md를 확인하고 필요한 경우 최소 버전으로 교체하세요:

cat ~/.openclaw/agents/*/SOUL.md

이 5줄 버전으로 교체하세요:

be direct. no filler. match my tone.
if I ask a question, answer it first.
never say "absolutely", "great question", or "I'd be happy to."
if you don't know something, say so.
if a task will cost significant tokens, tell me before doing it.

다음 주 동안 귀찮은 점을 바탕으로 점차적으로 더 많은 지시사항을 추가하세요.

단계 5: 재시작 및 테스트 (30초)

OpenClaw를 재시작하고 기본 메시지를 보내세요:

openclaw stop
openclaw start

"오늘은 무슨 요일이야?" 또는 URL과 함께 "이 기사를 요약해줘"와 같은 간단한 질문으로 테스트하세요. 이상한 동작 없이 올바르게 응답하면 핵심 기능이 작동하는 것입니다. 문제는 제거한 부분에서 발생한 것입니다. 구성 요소를 하나씩 다시 추가하고, 각 추가 후에 테스트하세요.

이 방법이 효과적인 이유

대부분의 OpenClaw 설정은 스킬, 에이전트, 크론 작업, 모델 전환, 설정 조정이 누적되어 한 구성 요소가 붕괴를 일으킬 때까지 진행됩니다. 모든 것이 동시에 추가되었기 때문에 문제가 되는 부분을 식별하는 것이 불가능해집니다. 최소 구성으로 줄이고 점진적으로 재구축하면 안정적인 설정을 만들 수 있습니다.

이 재설정을 구현한 후, 한 사용자는 한 개의 에이전트, Sonnet, 그리고 네 가지 스킬(웹 검색, 일일 브리핑, 메모 작성기, 이메일 분류를 위한 맞춤형 Python 스크립트)로 구성된 안정적인 설정을 보고했습니다. 이 설정은 월 10달러 미만의 비용으로 4주 이상 문제 없이 운영되었습니다.