OpenClaw는 로컬 모델에 연결할 수 있지만, '채팅 가능'이 '에이전트가 될 수 있다'는 것과 같다고 가정하지 마세요. 작은 요청이 로컬 OpenAI 호환 백엔드에서는 작동하지만 OpenClaw 에이전트가 실패하는 경우, 보통 메시지 형식, 툴 호출, 또는 컨텍스트 길이의 호환성 문제 때문입니다.
먼저 3층 테스트를 해보세요
- 로컬
/v1/chat/completions에 직접 접속해서 백엔드가 사용 가능한지 확인하세요. openclaw infer model run사용하여 모델이 OpenClaw에서 기본 응답을 수행할 수 있는지 테스트하세요.- 에이전트가 작은 파일 읽기나 보안 명령어 실행 같은 간단한 도구를 호출하게 합니다.
공통 호환 가능한 수정안
messages[].content필요 문자열 보고서: 모델에compat.requiresStringContent: true을 추가하세요.- 일반 채팅은 작동하지만 도구 호출은 실패:
compat.supportsTools: false설정하는 것을 고려하고 도구 기반 작업을 맡기지 마세요. - 작은 프롬프트는 크래시, 큰 컨텍스트는 크래시: 이는 모델 또는 서버 측의 제한으로, 컨텍스트를 줄이거나 백엔드를 변경합니다.
로컬 모델은 프라이버시, 오프라인, 저비용 시나리오에 적합하지만, 복잡한 툴체인이 모델에 더 안정적입니다. 로컬 모델을 저위험 작업이나 대체 단계에 두는 것이 권장되며, 핵심 자동화는 여전히 강력한 모델로 커버됩니다.
공식 오픈 소스 주소: https://github.com/openclaw/openclaw.
가장 안전한 방법은 로컬 모델에 대해 별도의 테스트 에이전트를 구축하여 저위험 도구만 허용하는 것입니다. 컨텍스트, 툴 호출, 오류 복구를 안정적으로 처리할 수 있는지 확인한 후, 메인 에이전트의 백업에 넣으세요.