OpenClaw에서 도구 수가 갑자기 줄거나 모델에 사용하지 말아야 할 도구가 항상 많이 보이면 'tools.profile'을 우선적으로 확인하고 모델을 먼저 바꾸지 마세요. 공식 문제 해결 문서는 도구 프로필을 '메시징', '코딩', '완전' 등 사용 수준으로 나눕니다. 많은 '도구가 빠진' 문제들은 현재 에이전트가 더 좁은 프로필에 배치되었기 때문에 비롯됩니다.
먼저, 어떤 종류의 이상 현상인지 판단해
메시지를 주고받을 수 있고, 파일을 읽거나 쓸 수 없으며, 명령 실행이 불가능하다면, 대부분 '메시징' 수준에 해당합니다; 코드를 수정할 수는 있지만 브라우저, 데스크톱, 외부 연결 도구가 없다면 '코딩'일 수 있습니다; 도구 목록이 너무 길어서 모델이 항상 잘못된 도구를 선택하게 되거나, 보통 '가득 찼을 때' 모델이 도구를 한꺼번에 추가했기 때문입니다.
정말로 피해야 할 것은 '편의를 위해 모든 것을 열어두는' 것입니다. 도구가 많을수록 모델 선택 비용이 높아지고 오류 호출도 증가합니다. 일상적인 원격 채팅, 상태 확인, 파일 전송을 위해서는 경량 프로필을 사용하는 것이 더 안정적입니다; 프로젝트를 유지보수하고, 테스트를 실행하며, 코드를 수정하고, 코딩 도구를 제공하도록 합니다; 브라우저, 데스크톱, 시스템 명령어가 명확히 필요할 때만 일시적으로 확장됩니다.
권장 검사 순서
먼저 'openclaw status-all'을 실행해 에이전트, 게이트웨이, 도구의 현재 노출 상태를 확인하고, 'openclaw doctor'로 설치 문제를 해결하세요. 다음으로, 설정에 'agents.list[].tools' 같은 설정이 있는지 확인해 보세요. 에이전트에 의해 덮어쓰는 설정이 있습니다: Global 프로필은 맞지만, 특정 에이전트가 개별적으로 좁혀지지 않았다는 뜻은 아닙니다.
특정 그룹에서 도구를 호출할 수 없는 문제만 해결하고 싶다면, 전역 설정을 바꾸지 마세요. 먼저, 해당 그룹에 실제로 바인딩된 채널, 계정, 에이전트, 세션키를 찾아보세요. 잘못된 수준을 교정하면 위험한 도구가 다른 채널로 갑자기 들어올 수 있습니다. 신중한 방법은 먼저 틈을 좁히고, 한 번에 열기보다는 하나씩 풀어가는 것입니다.
