BF openclaw
Полное руководство по установке, настройке, эксплуатации и устранению неполадок OpenClaw — локального шлюза AI-агентов с поддержкой нескольких каналов. Используйте, когда пользователь спрашивает об установке OpenClaw, настройке, управлении каналами (WhatsApp/Telegram/Discord/Slack/iMessage/и т. д.), настройке поставщика моделей, операциях шлюза, маршрутизации нескольких агентов, усилении безопасности, устранении неполадок или любых задачах обслуживания, связанных с локальной установкой OpenClaw. Также используйте при возникновении ошибок от команд `openclaw` CLI или демона шлюза.
машинный переводПоказать оригиналСкрыть оригинал«Comprehensive guide for installing, configuring, operating, and troubl…»
Comprehensive guide for installing, configuring, operating, and troubleshooting OpenClaw — a self-hosted, multi-channel AI agent gateway. Use when the user asks about OpenClaw setup, configuration, channel management (WhatsApp/Telegram/Discord/Slack/iMessage/etc.), model provider setup, Gateway operations, multi-agent routing, security hardening, troubleshooting, or any maintenance task related to their local OpenClaw installation. Also use when encountering errors from `openclaw` CLI commands or the Gateway daemon.
Полное руководство по установке, настройке, эксплуатации и устранению неполадок OpenClaw — локального шлюза AI-агентов с поддержкой нескольких каналов.
Как процесс F 33/100 · Не запустится — Скилл ссылается на файлы, которых нет в архиве: references/channels.md, references/channel_troubleshooting.md, references/tools.md
Чем это грозит
Находки средней серьёзности: скорее всего скилл честный, но прочитайте, что именно насторожило сканер.
Ниже описан худший случай для этой категории. Здесь находка средней серьёзности: guard увидел признак, но не доказательство.
Скилл содержит команды, которые удаляют файлы, переписывают диски или исполняют код, скачанный из сети. Агент может выполнить их без вопроса, если считает, что так требует инструкция.
Замените разрушительные команды на безопасные аналоги с подтверждением, ограничьте область действия конкретной папкой и не тяните код через curl | bash: укажите версию и контрольную сумму.
Ниже описан худший случай для этой категории. Здесь находка средней серьёзности: guard увидел признак, но не доказательство.
Скилл просит больше прав, чем нужно для задачи: широкий доступ к инструментам, секретные переменные окружения, бинарные файлы. Каждое лишнее право расширяет ущерб при ошибке или взломе.
Сузьте allowed-tools и список переменных до минимума, замените бинарники на исходники или скрипты, которые можно прочитать.
Как улучшить
- В тексте есть ссылки на отсутствующие файлы: добавьте файлы или уберите ссылки.
- Свои кейсы (evals/evals.json, 4–6 реальных запросов с ожидаемыми ответами): тогда полная проверка прогонит именно их, а не черновик от модели.
- spec.yaml с триггерными фразами и утверждениями — контракт поведения для CI; `skilltest init` создаст шаблон.
Находки guard · 12
✓ Критических и высоких находок нет
Средние и низкие: 12
-
средняя Опасные команды
cmd-persistencegateway_ops.md:339Механизм закрепления (cron / launchd / планировщик / автозапуск в реестре) (документация security-скилла)launchctl bootstrap gui/$(id -u) ~/Library/LaunchAgents/ai.openclaw.gateway.plist
security-скилл -
средняя Широкие права
meta-agent-memory-dumpheartbeat.mdВ скилле есть файлы памяти агента / рабочего пространства (2) — похоже на дамп с личными данными или токенамиheartbeat.md, memory.md
-
низкая Сокрытие от пользователя
en-hide-from-userexec.md:38Инструкция скрыть действия от пользователя (с отрицанием — текст это запрещает)- **Sandboxing off + `host=sandbox`**: Exec fails closed (does not silently run on gateway). Enable sandboxing or use `host=gateway` with approvals.
с отрицанием -
низкая Опасные команды
cmd-background-processgateway_ops.md:77Запуск фонового / автозапускаемого процесса (документация security-скилла)sudo systemctl enable --now openclaw-gateway.service
security-скилл -
низкая Опасные команды
cmd-pipe-to-shellgateway_ops.md:208Скачивание и запуск удалённого кода с неизвестного хоста (pipe в shell) (документация security-скилла; хост вендора самого скилла)curl -fsSL https://openclaw.ai/install.sh | bash
security-скиллvendor-host -
низкая Утечка данных
read-dotenvgateway_ops.md:298Чтение файла .env (документация security-скилла)cat ~/.openclaw/.env
security-скилл -
низкая Опасные команды
cmd-pipe-to-shellinstall.md:26Скачивание и запуск удалённого кода с неизвестного хоста (pipe в shell) (документация security-скилла; хост вендора самого скилла)curl -fsSL https://openclaw.ai/install.sh | bash
security-скиллvendor-host -
низкая Опасные команды
cmd-pipe-to-shellinstall.md:35Скачивание и запуск удалённого кода с неизвестного хоста (pipe в shell) (документация security-скилла; хост вендора самого скилла)curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard
security-скиллvendor-host -
низкая Опасные команды
cmd-pipe-to-shellinstall.md:151Скачивание и запуск удалённого кода с неизвестного хоста (pipe в shell) (документация security-скилла; хост вендора самого скилла)curl -fsSL https://openclaw.ai/install.sh | bash
security-скиллvendor-host -
низкая Опасные команды
cmd-pipe-to-shellSKILL.md:279Скачивание и запуск удалённого кода с неизвестного хоста (pipe в shell) (документация security-скилла; хост вендора самого скилла)curl -fsSL https://openclaw.ai/install.sh | bash
security-скиллvendor-host
Ещё 2 совпадений отнесены к цитатам в документации скилла по безопасности и не считаются находками.
Просканировано файлов: 53. Улики замаскированы. Пометки в серых чипах объясняют, почему серьёзность понижена.
По спецификации Agent Skills
- предупреждение
missing-refссылка на отсутствующий файл: references/channels.md - предупреждение
missing-refссылка на отсутствующий файл: references/channel_troubleshooting.md - предупреждение
missing-refссылка на отсутствующий файл: references/tools.md - предупреждение
missing-refссылка на отсутствующий файл: references/exec.md - предупреждение
missing-refссылка на отсутствующий файл: references/exec_approvals.md - предупреждение
missing-refссылка на отсутствующий файл: references/browser.md - предупреждение
missing-refссылка на отсутствующий файл: references/web_tools.md - предупреждение
missing-refссылка на отсутствующий файл: references/pdf_tool.md - предупреждение
missing-refссылка на отсутствующий файл: references/elevated.md - предупреждение
missing-refссылка на отсутствующий файл: references/lobster.md - предупреждение
missing-refссылка на отсутствующий файл: references/llm_task.md - предупреждение
missing-refссылка на отсутствующий файл: references/openprose.md - предупреждение
missing-refссылка на отсутствующий файл: references/plugins.md - предупреждение
missing-refссылка на отсутствующий файл: references/skills.md - предупреждение
missing-refссылка на отсутствующий файл: references/providers.md - предупреждение
missing-refссылка на отсутствующий файл: references/multi_agent.md - предупреждение
missing-refссылка на отсутствующий файл: references/nodes.md - предупреждение
missing-refссылка на отсутствующий файл: references/security.md - предупреждение
missing-refссылка на отсутствующий файл: references/secrets.md - предупреждение
missing-refссылка на отсутствующий файл: references/sandboxing.md - предупреждение
missing-refссылка на отсутствующий файл: references/config_reference.md - предупреждение
missing-refссылка на отсутствующий файл: references/gateway_ops.md - предупреждение
missing-refссылка на отсутствующий файл: references/remote_access.md - предупреждение
missing-refссылка на отсутствующий файл: references/sessions.md - предупреждение
missing-refссылка на отсутствующий файл: references/hooks.md - предупреждение
missing-refссылка на отсутствующий файл: references/automation.md - предупреждение
missing-refссылка на отсутствующий файл: references/acp_agents.md - предупреждение
missing-refссылка на отсутствующий файл: references/install.md - предупреждение
missing-refссылка на отсутствующий файл: references/web_ui.md - предупреждение
missing-refссылка на отсутствующий файл: references/slash_commands.md - предупреждение
missing-refссылка на отсутствующий файл: references/platforms.md - предупреждение
missing-refссылка на отсутствующий файл: references/diffs_firecrawl.md - предупреждение
missing-refссылка на отсутствующий файл: references/subagents.md - предупреждение
missing-refссылка на отсутствующий файл: references/memory.md - предупреждение
missing-refссылка на отсутствующий файл: references/architecture.md - предупреждение
missing-refссылка на отсутствующий файл: references/agent_runtime.md - предупреждение
missing-refссылка на отсутствующий файл: references/streaming.md - предупреждение
missing-refссылка на отсутствующий файл: references/queue.md - предупреждение
missing-refссылка на отсутствующий файл: references/model_failover.md - предупреждение
missing-refссылка на отсутствующий файл: references/clawhub.md - предупреждение
missing-refссылка на отсутствующий файл: references/thinking.md - предупреждение
missing-refссылка на отсутствующий файл: references/polls.md - предупреждение
missing-refссылка на отсутствующий файл: references/voice.md - предупреждение
missing-refссылка на отсутствующий файл: references/presence_discovery.md - предупреждение
missing-refссылка на отсутствующий файл: references/gateway_internals.md - предупреждение
missing-refссылка на отсутствующий файл: references/heartbeat.md - предупреждение
missing-refссылка на отсутствующий файл: references/bonjour.md - предупреждение
missing-refссылка на отсутствующий файл: references/pairing.md - предупреждение
missing-refссылка на отсутствующий файл: references/tui.md - предупреждение
missing-refссылка на отсутствующий файл: references/media.md - предупреждение
missing-refссылка на отсутствующий файл: references/channel_routing.md
Процессный рейтинг: все десять параметров 33/100
- 0Инструменты и файлы. Не хватает 51 файла(ов): references/channels.md, references/channel_troubleshooting.md, references/tools.md
- 0Результат и критерий готовности. Не сказано, что считать результатом
- 0Входы и предусловия. Не сказано, что нужно иметь на входе
- 30Повторный запуск. Изменяющих операций: 2, без проверки текущего состояния
- 40Согласованность. Имя во frontmatter (openclaw) не совпадает с папкой (openclaw-guide-maintenance)
- 50Ошибки и развилки. Развилок: 0, есть раздел про ошибки
- 60Шаги. Шагов: 27, расплывчатых формулировок: 6
- 70Когда включается. Сказано, когда применять, но не сказано, когда не стоит
- 70Стоимость исполнения. Тело инструкции 4624 токенов
- 100Отчётность по ходу. Скилл сообщает о ходе работы
- medium Правила безопасности и запреты внутри скилла: их место в системном промпте, здесь они не защищают
Всё перечисленное измерено по тексту скилла, а не оценено моделью: цифры проверяемы. Вес параметра тем больше, чем чаще из-за него процесс встаёт.
Сигналы качества
- +5В description нет примеров фраз, по которым скилл должен срабатывать
- +4Описание не говорит, когда скилл НЕ применять (ложные срабатывания)
- +3Формат ответа не описан: модель каждый раз решает сама
- -2Ссылки на localhost: у другого пользователя не заработает
- +1Лицензия не указана
- +2Инструкции на одном языке
- +3Длина description 521 символов: достаточно сигнала, не съедает бюджет
- +4Структура: 19 заголовков
- +3Пошаговые инструкции: 27 пунктов
- +4Есть примеры (11 блоков кода)
База качества 70; замечания lint вычитаются, сигналы прибавляют до 100. Итог: 70.