OpenClaw, 이제 사실과 코드베이스 지식을 Learned Skills에서 제외 — 이미 저장된 항목들을 메모리 및 AGENTS.md로 이동하기 (2026)

이번 변경 사항은 10월 8일에 병합되어 2026.10.5 릴리스에 포함된 풀 리퀘스트 #167404에서 도입되었습니다. 문제 정의는 명확합니다: "에이전트가 절차가 아닌 것들, 즉 사용자에 대한 사실(생일)이나 특정 코드베이스에 대한 지식(테스트 명령어, 환경 변수, 명명 규칙 등)을 learned skills로 저장했습니다."

해결책은 무엇을 저장할지 결정하는 프롬프트에 있습니다. 풀 리퀘스트에 따르면, skill_workshop 도구, 백그라운드 검토, 그리고 /learn에서 사용하는 공유 작성 표준은 이제 "스킬은 절차이지, 메모리가 아니다"라는 문구로 시작합니다. 수집 금지 목록에 한 가지 항목이 추가되었습니다: "특정 코드베이스에 대한 지식은 저장소의 문서나 AGENTS.md에 속해야 합니다." 또한 시스템 프롬프트의 항상 활성화되어 있는 Skill Workshop 섹션은 "두 가지 요점을 각각 하나의 절에 담고 있어, 포그라운드 에이전트도 이를 따르도록 합니다."

풀 리퀘스트는 더 이상 자격을 충족하지 않는 항목을 요청했을 때 보게 될 현상도 설명합니다: "코드베이스 세부 정보나 단순한 사실을 /learn하도록 요청받으면, 에이전트는 스킬을 생성하는 대신 그것이 어디에 속해야 하는지 알려줍니다." 개인적인 절차는 영향을 받지 않습니다. 이 규칙은 "모든 코딩 작업이 아닌, 특정 코드베이스의 지식"으로 범위가 제한되므로, 풀 리퀘스트의 예시인 "내 블로그를 게시하는 방법"과 같은 메서드는 여전히 학습됩니다.

OpenClaw는 양쪽 조건에 대해 각각 세 번의 테스트를 거쳤습니다. 이전 프롬프트는 매번 코드베이스 전용 스킬을 저장한 반면, 새 프롬프트는 하나도 저장하지 않았으며 "각 답변은 그것이 저장소의 문서/AGENTS.md에 속한다고 안내"했습니다. 개인적인 절차는 이전과 이후 모두 세 번의 테스트에서 모두 저장되었습니다.

동일한 릴리스에는 풀 리퀘스트 #167639의 두 번째 수정 사항도 포함되어 있습니다. 이전에는 "이름이 63자를 초과하는 learned skills가 Skill Workshop 목록에서 사라지고, 모델 컨텍스트에는 계속 로드되어 있음에도 불구하고 patch/archive/restore가 거부"되었습니다. 수정 이후에는 "이전 릴리스에서 저장한 모든 스킬이 다시 목록에 표시되고 관리할 수 있게 되었습니다." 이는 아래의 정리 작업에 중요합니다. 검토해야 할 일부 스킬이 이제야 목록에 나타날 수 있기 때문입니다.

현재 Skill Workshop 페이지는 세 가지 기준을 제시합니다. 절차는 유지됩니다: "사용자가 반복하는 작업의 메서드로, 에이전트가 매번 다시 계산하지 않도록 합니다." 사실은 다른 곳으로 이동합니다: "사용자나 세상에 대한 사실은 메모리에 속합니다." 그리고 저장소 지식은 저장소로 이동합니다: "컨벤션, 빌드 명령어, 아키텍처와 같은 특정 코드베이스에 대한 지식은 해당 저장소의 문서나 AGENTS.md에 속해야 하며, 그곳에서 일하는 모든 에이전트가 이를 읽으므로 에이전트가 이를 learned skill로 저장하지 않습니다."

백그라운드 검토를 설명하는 자가 학습(self-learning) 페이지는 건너뛰는 항목에 대해 더 구체적으로 설명합니다. 검토 과정에서는 "환경 특정적이거나 일시적인 실패, 도구에 대한 부정적인 주장, 해결되지 않은 실패나 추측, 특정 코드베이스에 대한 지식, 일회성 작업, 개인적 사실, 비밀 정보, 또는 구체적인 명령어, 경로, ID가 없는 일반적인 조언은 수집하지 않습니다." 또한 단일 요청에만 해당하는 세부 정보는 대화에 그대로 유지합니다: "특정 제품, 주문, 메뉴, 날짜, 장소, 예약 등 단 하나의 요청에만 해당하는 세부 정보는 대화에 남아 있습니다."

풀 리퀘스트는 왜 저장소 지식이 주요 대상이었는지 설명합니다: "Skill Workshop은 개인용 claw를 위해 설계되었습니다. 스킬은 에이전트 전체에 적용되는 반면, 저장소는 이미 자체 컨벤션을 관리하는 소유자가 있기 때문입니다."

위의 모든 내용은 앞으로 일어날 일에 대한 것입니다. 풀 리퀘스트는 "프롬프트 및 문서 텍스트만 변경"되었고, "상태를 기록하지 않으며", 결과적으로 "설정이나 저장된 데이터의 변경이 없음"을 명시하고 있습니다. 릴리스 노트나 Skill Workshop 페이지 어디에도 기존의 learned skills를 새로운 규칙에 따라 검토하는 과정에 대한 설명은 없습니다.

따라서 지난달에 저장된 저장소의 테스트 명령어가 포함된 스킬은 오늘날에도 여전히 learned skill로 남아 있습니다. Learned skills의 세 가지 특성 때문에 이는 여전히 영향을 미칩니다.

Learned skills는 항상 해당 에이전트에게 보입니다. Skill Workshop 페이지에 따르면 이들은 "하나의 에이전트에 속하며 항상 에이전트에게 보입니다. agents.defaults.skills 및 agents.entries.<id>.skills 허용 목록(allowlist)을 우회합니다. 숨기려면 아카이브(archive)해야 합니다." 다른 스킬에 사용하는 허용 목록으로는 특정 프로젝트에서 learned skill을 제외할 수 없습니다.

이들은 에이전트를 따라 모든 프로젝트로 이동합니다. 풀 리퀘스트에서 설명하는 문제점은 learned skill로 저장된 코드베이스 지식이 "관련 없는 프로젝트를 포함하여 에이전트의 모든 세션에 로드된다"는 것입니다. 스킬 페이지는 Workshop 스킬을 워크스페이스, 프로젝트 에이전트, 개인 에이전트, 관리형 스킬 아래인 다섯 번째 로딩 우선순위 수준으로 나열하며, 시스템 프롬프트에 들어가는 스킬 카탈로그에는 대상 스킬의 이름, 설명 및 위치가 포함됩니다.

사용되지 않는 스킬 정리 기능이 이들을 반드시 잡아내는 것은 아닙니다. 학습이 활성화된 상태에서 OpenClaw는 "30일 동안 활동이 없는" learned skill을 아카이브합니다. 활동에는 "해당 SKILL.md를 읽은 기록, 포그라운드 skill_workshop view, 그리고 마지막 변경 사항"이 포함됩니다. 에이전트가 설명이 귀하의 작업과 일치하여 계속 열어보는 스킬은 내용이 더 이상 그곳에 속하지 않더라도 활성 상태로 간주됩니다. 또한 정리 작업에는 범위 제한이 있습니다: "정리는 기본 런타임이 내장된 OpenClaw 하네스인 에이전트에 대해서만 실행"되며, "Codex 에이전트의 경우 사용 중인 스킬이 아카이브되는 것을 방지하기 위해 정리가 비활성화된 상태로 유지됩니다."

풀 리퀘스트는 상태를 기록하지 않기 때문에 이번 변경을 "양방향 문(two-way door)"이라고 부르며, 되돌리면 이전 문구로 복구됩니다. 결과적으로 기존 스킬을 분류하는 것은 귀하의 몫입니다.

OpenClaw 문서는 새로운 규칙에 의해 learned skills에서 제외되는 각 콘텐츠 유형에 대해 구체적인 위치를 제시합니다.

귀하에 대한 사실과 선호도는 메모리로 이동합니다. OpenClaw의 메모리 개요에 따르면 "에이전트의 워크스페이스에 일반 Markdown 파일을 작성하여 기억"합니다. 여기서는 두 가지 파일이 중요합니다. USER.md는 "지시문 형태로 작성된 안정적인 선호도, 커뮤니케이션 스타일, 관계 및 활성 프로젝트 컨텍스트"를 보관합니다. MEMORY.md는 "프로필이 아닌 지속적인 사실 및 결정 사항"을 보관합니다. 두 파일 모두 세션 시작 시 로드됩니다. 일상적인 관찰 내용은 memory/ 아래의 날짜가 지정된 일일 노트에 저장되며, 검색은 가능하지만 "매 턴마다 부트스트랩 프롬프트에 주입되지는 않습니다." 메모리 페이지에서 제안하는 팁은 다음과 같습니다: "에이전트가 무언가를 기억하게 하고 싶다면 그냥 요청하세요." 에이전트가 "적절한 파일에 노트를 작성"할 것입니다.

코드베이스 지식은 저장소로 이동합니다. 이는 저장소 자체의 문서나 해당 저장소에서 작업하는 모든 에이전트가 읽는 파일인 AGENTS.md를 의미합니다. 이 파일은 OpenClaw 에이전트 워크스페이스에 있는 AGENTS.md와는 다른 파일입니다. OpenClaw의 FAQ는 워크스페이스 파일을 AGENTS.md, SOUL.md, IDENTITY.md, USER.md, MEMORY.md 및 일일 노트로 나열하며, "운영 규칙은 AGENTS.md에, 지속적인 사실은 메모리에" 둘 것을 권장합니다. 프로젝트의 빌드 명령어를 워크스페이스 파일에 넣으면 에이전트가 작업하는 모든 곳에 로드되어 이 문제의 원인이 되었던 것과 동일한 현상이 발생합니다. 저장소에 이미 지침 파일이 있는 경우, CLAUDE.md 콘텐츠를 AGENTS.md로 마이그레이션하는 가이드에서 두 가지 일반적인 형식의 연관 관계를 다룹니다.

절차는 learned skills로 유지됩니다. 반복하는 작업 클래스에 대한 메서드가 바로 Workshop이 존재하는 이유입니다. 일반적인 메서드와 특정 저장소의 세부 정보가 혼합된 스킬은 분할할 수 있습니다. 풀 리퀘스트는 이를 "의도된 분할: 일반적인 메서드는 유지되고, 코드베이스 사실은 저장소로 이동함"으로 설명합니다.

업데이트가 오래된 스킬을 정리했다고 가정하는 것. 이번 릴리스는 앞으로 저장될 내용만 변경했습니다. 풀 리퀘스트에 따르면 기존 스킬은 그대로 유지됩니다.

사용하지 않는 스킬이 자동으로 아카이브될 것이라고 가정하는 것. 30일 동안 활동이 없는 스킬만 아카이브되며, 에이전트가 읽는 스킬은 활성 상태로 간주되고, Codex 하네스를 사용하는 에이전트의 경우 정리가 비활성화됩니다.

허용 목록이 프로젝트에서 learned skill을 제외해 줄 것이라고 가정하는 것. Learned skills는 에이전트 및 기본 스킬 허용 목록을 우회합니다. 아카이브하는 것이 문서를 통해 안내된 유일한 숨기기 방법입니다.

에이전트가 더 이상 사실을 저장할 수 없다고 가정하는 것. 변경 사항은 프롬프트에 있습니다. 결정은 여전히 모델이 내리며, Workshop의 쓰기 유효성 검사는 이름, frontmatter, 경로, 크기 및 보안 결과만 확인하며 콘텐츠가 사실인지 여부는 확인하지 않습니다.

모든 것이 이미 목록에 표시되어 있다고 가정하는 것. 2026.10.5 이전에는 이름이 긴 스킬이 모델 컨텍스트에 로드되어 있으면서도 목록에서 누락되었습니다.

1단계: 모든 learned skill을 나열하고 세 가지 더미로 분류하기

먼저 2026.10.5 이상 버전으로 업데이트하여 이름이 긴 스킬이 표시되도록 하십시오. 그런 다음 Control UI에서 Plugins → Skill workshop을 열거나 openclaw skills workshop list를 실행합니다. Control UI는 가장 많이 사용된 learned skills를 먼저 나열하고 2주 동안 유휴 상태인 스킬을 표시합니다. openclaw skills workshop show <name>은 스킬의 내용을 출력합니다.

각 스킬에 대해 질문해 보세요: 이것이 내가 반복하는 작업의 메서드인가? 그런 다음 분류합니다:

• 절차(Procedure): 작업을 수행하는 데 필요한 명령어, 경로 또는 ID가 포함된 단계별 절차입니다. 유지합니다.
• 귀하 또는 세상에 대한 사실(Fact): 선호도, 날짜, 관계, 결정 사항 등입니다. 메모리로 이동합니다.
• 특정 코드베이스에 대한 지식(Knowledge): 컨벤션, 빌드 또는 테스트 명령어, 환경 변수, 아키텍처 등입니다. 해당 저장소로 이동합니다.

일부 스킬은 혼합되어 있을 수 있습니다. 어떤 부분이 어디에 속하는지 기록해 두세요.

2단계: 사실은 메모리로, 코드베이스 지식은 저장소로 이동하기

사실의 경우 가장 간단한 방법은 OpenClaw 문서에 안내된 대로 에이전트에게 기억하도록 요청하는 것입니다. 프로필 유형의 선호도는 USER.md에 속하며, 지속적인 비프로필 사실 및 결정 사항은 MEMORY.md에 속합니다. 이후 파일에 무엇이 기록되었는지 확인하세요.

코드베이스 지식의 경우, 해당 저장소의 AGENTS.md 또는 문서에 추가하고 다른 변경 사항과 마찬가지로 커밋하여 저장소 소유자가 검토할 수 있도록 하십시오. 그곳에서 일하는 다른 에이전트와 사람들도 이를 읽게 됩니다.

혼합된 스킬의 경우, 일반적인 메서드만 남도록 스킬을 편집합니다. skill_workshop 도구는 "정확히 일치하는 고유한 스팬 하나를 대체"하는 patch를 지원하며, 모든 변경 사항은 이전 버전을 먼저 저장하므로 잘못된 편집은 복구할 수 있습니다.

3단계: 이동한 항목을 아카이브하고 새 세션에서 확인하기

콘텐츠가 다른 곳으로 이동했다면, openclaw skills workshop archive <name> --reason "Superseded" 명령어 또는 Archive 버튼을 사용하여 원본을 아카이브하십시오. 아카이브는 버전이 관리되므로 "언제든지 복구"할 수 있습니다. 사유는 에이전트당 최신 500개 항목을 유지하는 변경 피드에 표시됩니다.

그런 다음 새 세션을 시작합니다. "변경된 스킬은 새 세션에 로드됩니다. 실행 중인 세션은 시작할 때의 스킬 스냅샷을 유지합니다." 영향을 받는 프로젝트에서 에이전트에게 작업을 요청하고, 이전 스킬 대신 저장소의 AGENTS.md를 읽는지 확인하십시오. 관련 없는 두 번째 프로젝트에서 이를 반복하여 코드베이스 세부 정보가 더 이상 함께 로드되지 않는지 확인합니다.

OpenClaw는 이제 작업을 수행하는 방법, 귀하에 대한 사실, 특정 코드베이스가 작동하는 방법의 세 가지 지식을 분리합니다. 두 번째 항목은 OpenClaw 외부에서 사용하는 다른 어시스턴트에서도 필요할 수 있는 종류입니다. MemoryLake는 이러한 사실과 결정을 귀하가 관리하는 하나의 목록에 보관하는 메모리 레이어로, 통합 기능을 통해 OpenClaw에서 사용할 수 있을 뿐만 아니라 ChatGPT 및 Claude Code와 같이 연결하는 다른 어시스턴트에서도 사용할 수 있습니다.

귀하는 자신의 언어로 직접 항목을 작성합니다. 귀하의 learned skills, USER.md 또는 MEMORY.md, 저장소의 AGENTS.md 또는 벤더의 저장소에서 아무것도 읽거나 쓰거나 삭제하지 않습니다. 저장소 컨벤션은 여전히 저장소에 속하며, 그곳에서 일하는 모든 사람이 검토할 수 있습니다. 비밀 정보나 조직 내부에서만 유지해야 하는 사항은 제외하십시오.

1단계: API 키 생성

로그인하고 대시보드에서 키를 생성합니다. 이 키는 MemoryLake 워크스페이스에 속하며 OpenClaw 설정과는 별개입니다.

2단계: 첫 번째 메모리 업로드

위의 분류 작업에서 learned skills에서 추출한 사실들(선호도, 고정된 결정 사항, 사람 및 프로젝트에 대한 세부 정보)부터 시작하십시오. 항목당 하나의 사실을 날짜와 함께 기록하면 오래된 정보를 쉽게 찾아 제거할 수 있습니다.

3단계: AI 및 에이전트 연결

OpenClaw 및 사용하는 다른 어시스턴트를 연결합니다. Learned skills는 절차를 유지하고, 저장소는 컨벤션을 유지하며, 귀하가 작성한 사실은 작업하는 모든 곳에서 사용할 수 있게 됩니다.

첫 번째 차이점은 각 프로젝트가 자체 규칙을 갖게 된다는 것입니다. 저장소의 AGENTS.md에 있는 코드베이스 지식은 에이전트를 따라 다른 모든 곳으로 이동하는 대신, 해당 코드베이스가 있는 곳에서만 로드됩니다.

두 번째는 사실을 수정하기가 더 쉬워진다는 점입니다. 스킬에 저장된 선호도는 변경될 때 어떤 스킬에 들어있는지 알아야 하므로 찾기 어렵습니다. USER.md, MEMORY.md 또는 귀하가 관리하는 목록에서는 단 한 번의 편집으로 변경할 수 있습니다.

세 번째는 신뢰하기 쉬운 더 작은 크기의 learned-skill 목록을 유지할 수 있다는 점입니다. OpenClaw의 백그라운드 검토는 "learned skills를 반복 가능한 절차의 소규모 집합으로 유지"하는 것을 목표로 합니다. 절차가 아닌 것을 제거하면 기존 목록이 이 목표에 부합하게 됩니다. 다른 도구에서 스킬과 규칙의 경계가 어떻게 설정되는지에 대해서는 Cursor 스킬과 규칙 비교에서 다룹니다.

분류하기 전에 업데이트하십시오. 이름이 긴 스킬은 2026.10.5부터만 목록에 표시됩니다.

저장소 지식은 저장소에 두십시오. 워크스페이스의 AGENTS.md가 아닌 저장소의 AGENTS.md나 문서를 사용하십시오.

혼합된 스킬은 삭제하는 대신 분할하십시오. 일반적인 메서드는 유지하십시오.

이유를 기재하여 아카이브하십시오. 그러면 변경 피드에 무엇이 어디로 이동했는지 설명이 남습니다.

관련 없는 프로젝트에서 확인하십시오. 잘못 배치된 코드베이스 스킬이 나타나는 곳이 바로 그곳입니다.

자가 학습이 다음에 무엇을 저장하는지 주시하십시오. Learned 행이 나타나면 검토하십시오. 다른 벤더들도 메모리에서 제외되는 항목에 대해 유사한 목록을 게시합니다. Grok Build의 메모리 제외 사항 분석에서 그중 하나를 다룹니다.

OpenClaw 2026.10.5는 Skill Workshop이 저장하는 대상을 변경했습니다. 절차는 유지되고, 사실은 메모리로 이동하며, 특정 코드베이스에 대한 지식은 해당 저장소의 문서나 AGENTS.md로 이동합니다. 이미 저장된 내용은 변경되지 않았습니다. Learned skills는 허용 목록에 관계없이 에이전트에게 계속 표시되고, 해당 에이전트가 작업하는 모든 프로젝트에 로드되며, 읽히는 한 사용되지 않는 스킬 정리 대상에서 제외됩니다.

각 learned skill을 분류하고, 사실은 메모리로, 코드베이스 노트는 저장소로 이동한 후 원본을 아카이브하고, 관련 없는 프로젝트의 새 세션에서 확인하십시오. OpenClaw 메모리 심층 분석에서 나머지 메모리 시스템을 다루며, OpenClaw 에이전트를 위한 최적의 메모리 설정 모음에서 다양한 옵션을 비교합니다.