Ошибка с обнаружением навыков из workspace/extraDirs в OpenClaw 2026.2.x: причины и обходные пути

Как проявляется

После перезапуска шлюза OpenClaw и команды openclaw skills list отображаются только встроенные навыки, а пользовательские из workspace или extraDirs отсутствуют.

Из-за чего возникает

В версиях 2026.2.x и 2026.3.1 OpenClaw не корректно сканирует и регистрирует навыки из каталогов workspace и extraDirs, хотя CLI видит эти файлы. Это баг в механизме загрузки навыков.

Как исправить

1. Проверьте, что каталог с навыками совпадает с активным workspace и extraDirs, которые использует шлюз:

openclaw config get agents.defaults.workspace
openclaw config get skills.load.extraDirs

2. Поместите свои навыки в правильный каталог, например:

mkdir -p ~/.openclaw/workspace/skills/astrid-pm
# скопируйте SKILL.md сюда

3. Перезапустите шлюз:

openclaw gateway restart

4. Обновите OpenClaw до последней версии, где багы с загрузкой исправлены:

npm update -g openclaw
openclaw --version
openclaw gateway restart

5. Если обновление невозможно, используйте временный обход — вручную указывайте агенту читать SKILL.md через AGENTS.md:

When you need the blog-publishing skill, read this file first:
- ~/.openclaw/workspace/skills/blog-publishing/SKILL.md

В чате просите агента прочитать и выполнить инструкции из этого файла.

6. Проверьте, что агент имеет права читать файлы, например:

openclaw config set tools.profile full
openclaw gateway restart

7. После этих действий навыки из workspace должны корректно появиться в списке и работать.

Как не столкнуться снова

Используйте актуальные версии OpenClaw (не ниже 2026.3.13), проверяйте, что workspace и extraDirs настроены правильно и совпадают с каталогами, где лежат навыки.

Источник

Разбор основан на обсуждении в репозитории проекта: issue #10386.

Другие типичные проблемы — в разделе ошибок и решений, а базовая настройка разобрана в первом запуске.