Как проявляется
Сразу после перезапуска OpenClaw инструменты exec, read и write работают, но через пару минут любые попытки их использования завершаются ошибкой «Tool not found».
Из-за чего возникает
Причина в том, что базовый профиль инструментов tools.profile: “coding” перекрывается более узкими настройками на уровне провайдера или агента (tools.byProvider, tools.allow/deny), из-за чего после запуска сессии инструменты сначала доступны, а затем теряются.
Как исправить
- Выполните команды для проверки эффективных настроек инструментов:
openclaw config get tools --json
openclaw config get tools.byProvider --json
openclaw config get agents.list --json-
Если в выводе есть провайдерские или агентские переопределения, временно удалите или отключите их, чтобы не сужали профиль инструментов.
-
Перезапустите шлюз OpenClaw и начните новую сессию:
openclaw gateway restart-
Проверьте, что инструменты exec, read, write остаются доступными в течение всей сессии.
-
При необходимости проверьте настройки сессии:
openclaw sandbox explain --session <ключ_сессии> --json
openclaw sessions listи убедитесь, что в политиках песочницы (sandbox) разрешены группы инструментов runtime и fs.
Если проблема сохраняется, соберите вывод вышеуказанных команд для дальнейшей диагностики.
Как не столкнуться снова
Следите, чтобы в конфигурации не было конфликтующих или слишком узких правил доступа к инструментам на уровне провайдера и агента, особенно если используется профиль tools.profile: “coding”.
Источник
Разбор основан на обсуждении в репозитории проекта: issue #39062.
Другие типичные проблемы — в разделе ошибок и решений, а базовая настройка разобрана в первом запуске.