OpenClaw 플러그인을 성공적으로 설치한다고 해서 반드시 새로운 도구가 등장한다는 의미는 아닙니다. 먼저, 플러그인 매니페스트가 실제로 무엇을 명시하는지 살펴보겠습니다: 어떤 플러그인은 스킬만 제공하고, 어떤 플러그인은 프롬프트나 테마만 제공하며, 어떤 플러그인은 확장 프로그램과 도구를 등록합니다. 플러그인 문제 해결 시 '설치 성공'을 '도구 로딩'으로 잘못 생각하는 것이 가장 흔한 실수입니다.
먼저, 플러그인이 어떤 기능을 제공하는지 명확히 하세요
글쓰기 실력이 있다면, 버튼 기반 도구는 추가하지 않고 에이전트의 작업 방식에만 영향을 줄 수 있습니다; 브라우저, 파일, 메시지, 외부 API 확장 프로그램 등이라면 해당 기능이 도구 목록에서 확인할 수 있을 것입니다. manifest에는 선언 기능이 없어서 몇 번을 재시작해도 갑자기 나타나지 않습니다.
그 다음 런타임 중에 연결되는지 확인하세요
플러그인은 확장 프로그램을 선언하지만, 현재 에이전트의 런타임, tools.profile, 권한 정책이 로딩을 허용하는지 확인해야 합니다. 예를 들어, 어떤 도구는 시스템 명령어를 필요로 하지만, 현재 프로필은 메시징만 지원합니다; 또는 플러그인 디렉터리 권한이 비정상적이어서 보안 검사로 건너뛸 수도 있습니다; 또는 플러그인 의존성이 완전히 설치되지 않아 매니페스트가 읽히지 않고 실제 확장 프로그램이 시작되지 않을 수도 있습니다.
다음 순서로 확인하는 것이 권장됩니다: 플러그인 디렉터리가 존재하는지 확인하고, 매니페스트를 읽고, OpenClaw 상태와 로그를 확인한 후 현재 에이전트의 도구 프로필을 확인하세요. 재설치는 즉시 삭제하지 마세요. 특히 ClawHub나 서드파티 소스에서 설치된 플러그인은 재설치가 실제 권한과 의존성 문제를 가릴 수 있습니다.
팀 환경이라면 플러그인이 출시되기 전에 어떤 파일을 읽는지, 인터넷 연결 가능 여부, 키 필요 여부, 고위험 명령어를 등록하는지 확인해야 합니다. 도구가 시스템 계층에 가까울수록 모든 진입점에 직접 적용하기보다는 단일 에이전트에서 더 많이 테스트해야 합니다.
