FAQ и устранение неполадок
Короткие ответы на частые вопросы и типовые поломки.
Часто задаваемые вопросы
С какими LLM-провайдерами работает VibeOS?
С любым OpenAI-совместимым API. Среди поддерживаемых:
- OpenRouter — сотни моделей одним API-ключом (гибкость)
- Nous Portal — подписка Nous Research: 300+ моделей плюс web/image/TTS/browser через один OAuth (удобно новичкам)
- OpenAI — GPT-5.4, GPT-5-codex, GPT-4.1, GPT-4o и др.
- Anthropic — Claude (прямой API, OAuth через
vibeos auth add anthropic, OpenRouter или совместимый прокси) - Google — Gemini (провайдер
gemini, OpenRouter или прокси) - z.ai / ZhipuAI — модели GLM
- Kimi / Moonshot AI — модели Kimi
- MiniMax — global и China endpoints
- Локальные модели — Ollama, vLLM, llama.cpp, SGLang или любой OpenAI-совместимый сервер
Провайдер: vibeos model или ~/.vibeos/.env. Все ключи — в переменных окружения.
Работает ли это на Windows / Android / Termux / …?
См. поддержку платформ — полная матрица.
Я в WSL2. Как лучше управлять обычным Windows Chrome?
Предпочитаю мост MCP /browser connect.
Рекомендуемый шаблон:
- запустите
- внутри WSL2
- продолжайте использовать свой обычный вход Chrome на Windows
- добавьте
chrome-devtools-mcpв качестве сервера MCP черезcmd.exeилиpowershell.exe - позвольте VibeOS использовать полученные MCP инструменты браузера
Это более надежно, чем пытаться заставить VibeOS основной транспорт браузера подключиться непосредственно через WSL2/Windows граница.
См.:
Мои данные отправлены
API вызовы передаются только тому провайдеру LLM, которого вы настроили (например, OpenRouter, ваш локальный экземпляр Ollama). VibeOS не собирает телеметрию, данные об использовании или аналитику. Ваши разговоры, память и навыки хранятся локально в ~/.vibeos/.
Могу ли я использовать его в автономном режиме/с локальными моделями?
Да. Запустите vibeos model, выберите Пользовательская конечная точка и введите URL:
vibeos model
# Select: Custom endpoint (enter URL manually)
# API base URL: http://localhost:11434/v1
# API key: ollama
# Model name: qwen3.5:27b
# Context length: 64000 ← VibeOS minimum; set this to match your server's actual context window
Или настройте его непосредственно в config.yaml:
model:
default: qwen3.5:27b
provider: custom
base_url: http://localhost:11434/v1
VibeOS сохраняет конечную точку, поставщика и базу URL в config.yaml, поэтому он выдерживает перезагрузки. Если на вашем локальном сервере загружена ровно одна модель, /model custom автоматически обнаружит ее. Вы также можете установить provider: custom в config.yaml — это первоклассный провайдер, а не псевдоним для чего-либо еще.
Это работает с Ollama, vLLM, сервер llama.cpp, SGLang, LocalAI и другие. Подробности см. в Руководстве по настройке.
Если вы установили собственный num_ctx в Ollama (например, ollama run --num_ctx 64000), обязательно установите соответствующую длину контекста в VibeOS — Ollama /api/show сообщает максимальный контекст модели, а не эффективный num_ctx, который вы настроено.
::
VibeOS автоматически определяет локальные конечные точки и уменьшает таймауты потоковой передачи (таймаут чтения увеличен со 120 до 1800 с, обнаружение устаревшего потока отключено). Если вы по-прежнему сталкиваетесь с тайм-аутами в очень больших контекстах, установите VIBEOS_STREAM_READ_TIMEOUT=1800 в своем .env. Подробнее см. в Местном LLM руководстве.
Сколько это стоит стоимость?
VibeOS сама по себе является бесплатной и с открытым исходным кодом (MIT). Вы платите только за использование LLM API у выбранного вами провайдера. Локальные модели можно использовать совершенно бесплатно.
Могут ли несколько человек использовать один экземпляр?
Да. Шлюз обмена сообщениями позволяет нескольким пользователям взаимодействовать с одним и тем же экземпляром VibeOS через Telegram, Discord, Slack, WhatsApp или Home Assistant. Доступ контролируется с помощью списков разрешений (конкретные идентификаторы пользователей) и спаривания DM (доступ к заявкам первого пользователя).
В чем разница между памятью и навыками?
- Память хранит факты – сведения, которые агент знает о вас, ваших проектах и предпочтения. Воспоминания извлекаются автоматически в зависимости от их актуальности.
- Навыки хранят процедуры — пошаговые инструкции о том, как что-то делать. Навыки вызываются, когда агент сталкивается с аналогичной задачей.
Оба сохраняются в течение сеансов. Подробнее см. в Память и Навыки.
Могу ли я использовать его в своем Python проект?
Да. Импортируйте класс AIAgent и используйте VibeOS программно:
from run_agent import AIAgent
agent = AIAgent(model="anthropic/claude-opus-4.7")
response = agent.chat("Explain quantum computing briefly")
См. Python Руководство по библиотеке для получения полной версии API
Устранение неполадок
Проблемы при установке
vibeos: command not found после установки
Причина: Ваша оболочка не перезагрузила обновленную PATH.
Решение:
# Reload your shell profile
source ~/.bashrc # bash
source ~/.zshrc # zsh
# Or start a new terminal session
Если все равно не работает, проверьте место установки:
which vibeos
ls ~/.local/bin/vibeos
Установщик добавляет ~/.local/bin к вашему PATH. Если вы используете нестандартную конфигурацию оболочки, добавьте export PATH="$HOME/.local/bin:$PATH" вручную.
Python слишком старая версия
Причина: VibeOS требует Python 3.11 или более поздней версии.
Решение:
python3 --version # Check current version
# Install a newer Python
sudo apt install python3.12 # Ubuntu/Debian
brew install python@3.12 # macOS
Установщик обрабатывает это автоматически — если вы видите эту ошибку во время ручной установки, сначала обновите Python.
Команды терминала говорят node: command not found (или nvm, pyenv, asdf, …)
Причина: VibeOS создает снимок среды для каждого сеанса, запуская bash -l один раз при запуске. Оболочка входа в bash читается как /etc/profile, ~/.bash_profile и ~/.profile, но не использует источник ~/.bashrc — поэтому инструменты, которые там устанавливаются (nvm, asdf, pyenv, cargo, пользовательский экспорт PATH) остаются невидимыми для снимка. Чаще всего это происходит, когда VibeOS работает под systemd или в минимальной оболочке, в которой ничего предварительно не загружено в профиль интерактивной оболочки.
Решение: VibeOS автоматически использует ~/.bashrc по умолчанию. Если этого недостаточно — например. вы являетесь пользователем zsh, чей PATH находится в ~/.zshrc, или вы инициализируете nvm из отдельного файла — перечислите дополнительные файлы для источника в ~/.vibeos/config.yaml:
terminal:
shell_init_files:
- ~/.zshrc # zsh users: pulls zsh-managed PATH into the bash snapshot
- ~/.nvm/nvm.sh # direct nvm init (works regardless of shell)
- /etc/profile.d/cargo.sh # system-wide rc files
# When this list is set, the default ~/.bashrc auto-source is NOT added —
# include it explicitly if you want both:
# - ~/.bashrc
# - ~/.zshrc
Отсутствующие файлы пропускаются автоматически. Поиск происходит в bash, поэтому файлы, использующие только синтаксис zsh, могут вызывать ошибки — если это вас беспокоит, используйте только часть настройки PATH (например, nvm.sh nvm напрямую), а не весь rc-файл.
Чтобы отключить поведение автоматического источника (строгое) только семантика оболочки входа):
terminal:
auto_source_bashrc: false
uv: command not found
Причина: Менеджер пакетов uv не установлен или отсутствует. PATH.
Решение:
curl -LsSf https://astral.sh/uv/install.sh | sh
source ~/.bashrc
Ошибки отказа в разрешении во время установки
Причина: Недостаточно разрешений на запись в каталог установки.
Решение:
# Don't use sudo with the installer — it installs to ~/.local/bin
# If you previously installed with sudo, clean up:
sudo rm /usr/local/bin/vibeos
# Then re-run the standard installer
curl -fsSL https://vibeos.com.ru/downloads/install.sh | bash
Проблемы с поставщиком и моделью
/model показывает только одного провайдера/невозможно переключиться поставщики
Причина: /model (внутри сеанса чата) может переключаться только между провайдерами, которые вы уже настроили. Если вы настроили только OpenRouter, это все, что покажет /model.
Решение: Выйдите из сеанса и используйте vibeos model со своего терминала, чтобы добавить новый провайдеры:
# Exit the VibeOS chat session first (Ctrl+C or /quit)
# Run the full provider setup wizard
vibeos model
# This lets you: add providers, run OAuth, enter API keys, configure endpoints
После добавления нового провайдера через vibeos model начните новый сеанс чата — /model теперь покажет всех настроенных вами провайдеров.
| Хотите... | Используйте |
|---|---|
| Добавить нового провайдера | vibeos model (с терминала) |
| Enter/change API клавиши | vibeos model (с терминала) |
| Переключить модель в середине сессии | /model <name>` (внутри сеанса) |
| Переключиться на другого настроенного провайдера | /model provider:model (внутри сеанса) |
API ключ не работает
Причина: Ключ отсутствует, срок действия истек, установлен неправильно или используется не тот поставщик.
Решение:
# Check your configuration
vibeos config show
# Re-configure your provider
vibeos model
# Or set directly
vibeos config set OPENROUTER_API_KEY sk-or-v1-xxxxxxxxxxxx
Убедитесь, что ключ соответствует поставщику. Ключ OpenAI не будет работать с OpenRouter и наоборот. Проверьте ~/.vibeos/.env на наличие конфликтующих записей.
Модель недоступна/модель не найдена
Причина: Идентификатор модели неверен или недоступен на вашем устройстве. провайдер.
Решение:
# List available models for your provider
vibeos model
# Set a valid model
vibeos config set VIBEOS_MODEL anthropic/claude-opus-4.7
# Or specify per-session
vibeos chat --model openrouter/meta-llama/llama-3.1-70b-instruct
Ограничение скорости (429 ошибок)
Причина: Вы превысили ограничения скорости вашего провайдера.
Решение: Подождите немного и повторите попытку. Для устойчивого использования рассмотрите возможность:
- Обновление плана вашего провайдера
- Переход на другую модель или поставщика
- Использование
vibeos chat --provider<alternative>` для маршрутизации на другой сервер
Длина контекста превышено
Причина: Диалог стал слишком длинным для контекстного окна модели, или VibeOS обнаружил неправильную длину контекста для вашей модели.
Решение:
# Compress the current session
/compress
# Or start a fresh session
vibeos chat
# Use a model with a larger context window
vibeos chat --model openrouter/google/gemini-3-flash-preview
Если это происходит при первом длинном разговоре, VibeOS может иметь неправильную длину контекста для вашей модели. Проверьте, что он обнаружил:
Посмотрите на строку запуска CLI — она показывает длину обнаруженного контекста (например, 📊 Context limit: 128000 tokens). Вы также можете проверить это с помощью /usage во время сеанса.
Чтобы исправить обнаружение контекста, установите его явно:
# In ~/.vibeos/config.yaml
model:
default: your-model-name
context_length: 131072 # your model's actual context window
Или для пользовательских конечных точек добавьте его для каждой модели:
custom_providers:
- name: "My Server"
base_url: "http://localhost:11434/v1"
models:
qwen3.5:27b:
context_length: 64000
См. Определение длины контекста, чтобы узнать, как работает автоматическое обнаружение и все параметры переопределения.
Проблемы с терминалом
Команда заблокирована как опасная
Причина: VibeOS обнаружила потенциально разрушительную команду (например, rm -rf, DROP TABLE). Это функция безопасности.
Решение: При появлении запроса просмотрите команду и введите y, чтобы одобрить ее. Вы также можете:
- Попросить агента использовать более безопасную альтернативу
- Полный список опасных шаблонов см. в Документации по безопасности
Это работает как положено — VibeOS никогда не запускает деструктивные команды молча. В запросе на одобрение показано, что именно будет выполнено.
sudo не работает через шлюз обмена сообщениями
Причина: Шлюз обмена сообщениями работает без интерактивного терминала, поэтому sudo не может запросить пароль.
Решение:
- Избегайте использования
sudoв обмене сообщениями — попросите агента найти альтернативы - Если вам необходимо использовать
sudo, настройте sudo без пароля для определенных команд в/etc/sudoers - Или переключитесь на интерфейс терминала для административных задач:
vibeos chat
Docker серверная часть не подключается
Причина: Демон Docker не запущен или отсутствует у пользователя разрешения.
Решение:
# Check Docker is running
docker info
# Add your user to the docker group
sudo usermod -aG docker $USER
newgrp docker
# Verify
docker run hello-world
Проблемы с обменом сообщениями
Бот не отвечает на messages
Причина: Бот не запущен, не авторизован или вашего пользователя нет в белом списке.
Решение:
# Check if the gateway is running
vibeos gateway status
# Start the gateway
vibeos gateway start
# Check logs for errors
cat ~/.vibeos/logs/gateway.log | tail -50
Сообщения не доставляются
Причина: Проблемы с сетью, срок действия токена бота истек или веб-перехватчик платформы неправильная конфигурация.
Решение:
- Убедитесь, что ваш токен бота действителен с помощью
vibeos gateway setup - Проверьте журналы шлюза:
cat ~/.vibeos/logs/gateway.log | tail -50 - Для платформы на основе веб-перехватчиков (Slack, WhatsApp), убедитесь, что ваш сервер общедоступен
Путаница в белом списке — кто может общаться с ботом?
Причина: Определяет режим авторизации кто получит доступ.
Решение:
| Режим | Как это работает |
|---|---|
| Белый список | Взаимодействовать могут только ID пользователей, указанные в конфигурации |
| Сопряжение с DM | Первый пользователь, отправивший сообщение в DM, претендует на эксклюзивный доступ |
| Открыто | Взаимодействовать может любой желающий (не рекомендуется для рабочей среды) |
Настройте в ~/.vibeos/config.yaml в настройках вашего шлюза. См. документацию по обмену сообщениями](../user-guide/messaging/index.md).
Шлюз не запускается
Причина: Отсутствуют зависимости, конфликты портов или неверная конфигурация. токены.
Решение:
# Install core messaging gateway dependencies
cd ~/.vibeos/vibeos-agent && uv pip install -e ".[messaging]" # Telegram, Discord, Slack, and shared gateway deps
# Check for port conflicts
lsof -i :8080
# Verify configuration
vibeos config show
WSL: Шлюз продолжает отключаться или vibeos gateway start выходит из строя
Причина: WSL Поддержка systemd ненадежна. Во многих установках WSL2 systemd не включен, и даже если он включен, службы могут не пережить WSL перезапуски или Windows простоя.
Решение: Используйте режим переднего плана вместо Сервис systemd:
# Option 1: Direct foreground (simplest)
vibeos gateway run
# Option 2: Persistent via tmux (survives terminal close)
tmux new -s vibeos 'vibeos gateway run'
# Reattach later: tmux attach -t vibeos
# Option 3: Background via nohup
nohup vibeos gateway run > ~/.vibeos/logs/gateway.log 2>&1 &
Если вы все равно хотите попробовать systemd, убедитесь, что он включен:
- Откройте
/etc/wsl.conf(создайте его, если он не существует) - Добавьте:
[boot]
systemd=true - От PowerShell:
wsl --shutdown - Снова откройте терминал WSL
- Проверьте:
systemctl is-system-runningдолжно быть указано "работает" или "деградация"
Для надежного автозапуска используйте Windows Планировщик задач для запуска WSL + шлюз при входе в систему:
- Создайте задачу, которая запускает
wsl -d Ubuntu -- bash -lc 'vibeos gateway run' - Установите срабатывание при входе пользователя в систему
macOS: Node.js / ffmpeg / другие инструменты, не найденные пользователем шлюз
Причина: Службы launchd наследуют минимальный PATH (/usr/bin:/bin:/usr/sbin:/sbin), который не включает Homebrew, nvm, Cargo или другие каталоги инструментов, установленных пользователем. Обычно это нарушает мост WhatsApp (node not found) или транскрипцию голоса (ffmpeg not found).
Решение: Шлюз захватывает вашу оболочку PATH при запуске vibeos gateway install. Если вы установили инструменты после настройки шлюза, повторно запустите установку, чтобы сохранить обновленную PATH:
vibeos gateway install # Re-snapshots your current PATH
vibeos gateway start # Detects the updated plist and reloads
Вы можете проверить, что в списке указан правильный PATH:
/usr/libexec/PlistBuddy -c "Print :EnvironmentVariables:PATH" \
~/Library/LaunchAgents/ai.vibeos.gateway.plist
Проблемы с производительностью
Медленно ответы
Причина: Большая модель, удаленный сервер API или тяжелая системная подсказка со множеством инструментов.
Решение:
- Попробуйте модель faster/smaller:
vibeos chat --model openrouter/meta-llama/llama-3.1-8b-instruct - Уменьшите активные наборы инструментов:
vibeos chat -t "terminal" - Проверьте задержку сети до поставщика
- Для локальных моделей убедитесь, что у вас достаточно GPU VRAM
Высокое использование токена
Причина: Длинные разговоры, подробные системные подсказки или накопление множества вызовов инструментов context.
Решение:
# Compress the conversation to reduce tokens
/compress
# Check session token usage
/usage
Используйте /compress регулярно во время длительных сеансов. Он суммирует историю разговоров и значительно сокращает использование токенов, сохраняя при этом контекст.
Сеанс становится слишком длинным
Причина: Расширенные разговоры накапливают сообщения и выходные данные инструментов, приближаясь к контексту ограничения.
Решение:
# Compress current session (preserves key context)
/compress
# Start a new session with a reference to the old one
vibeos chat
# Resume a specific session later if needed
vibeos chat --continue
MCP Проблемы
MCP сервер не работает Connection
Причина: Двоичный файл сервера не найден, неверный путь к команде или отсутствует среда выполнения.
Решение:
# Ensure MCP dependencies are installed (already included in standard install)
cd ~/.vibeos/vibeos-agent && uv pip install -e ".[mcp]"
# For npm-based servers, ensure Node.js is available
node --version
npx --version
# Test the server manually
npx -y @modelcontextprotocol/server-filesystem /tmp
Проверьте конфигурацию ~/.vibeos/config.yaml MCP:
mcp_servers:
filesystem:
command: "npx"
args: ["-y", "@modelcontextprotocol/server-filesystem", "/home/user/docs"]
Инструменты не отображаются с MCP сервера
Причина: Сервер запущен, но инструмент не обнаружен, инструменты были отфильтрованы конфигурацией, или сервер не поддерживает возможность MCP, которую вы используете.
Решение:
- Проверьте журналы gateway/agent на наличие ошибок соединения MCP
- Убедитесь, что сервер отвечает на
tools/listRPC метод - Проверьте все настройки
tools.include,tools.exclude,tools.resources,tools.promptsилиenabledна этом сервере - Помните что служебные инструменты resource/prompt регистрируются только тогда, когда сеанс действительно поддерживает эти возможности
- Используйте
/reload-mcpпосле изменения config
# Verify MCP servers are configured
vibeos config show | grep -A 12 mcp_servers
# Restart VibeOS or reload MCP after config changes
vibeos chat
См. также:
MCP timeout error
Причина: Сервер MCP отвечает слишком долго или произошел сбой во время выполнения.
Решение:
- Увеличьте время ожидания в вашем MCP конфигурация сервера, если поддерживается
- Проверьте, запущен ли серверный процесс MCP
- Для удаленных серверов HTTP MCP проверьте сеть Connection
Если сервер MCP выйдет из строя во время запроса, VibeOS сообщит об истечении времени ожидания. Проверьте собственные журналы сервера (а не только журналы VibeOS), чтобы определить основную причину.
Профили
Чем профили отличаются от простой настройки VIBEOS_HOME?
Профили представляют собой управляемый уровень поверх VIBEOS_HOME. Вы можете вручную задать VIBEOS_HOME=/some/path перед каждой командой, но профили выполняют всю работу за вас: создают структуру каталогов, генерируют псевдонимы оболочки (vibeos-work), отслеживают активный профиль в ~/.vibeos/active_profile и автоматически синхронизируют обновления навыков между всеми профилями. Они также интегрируются с функцией завершения табуляции, поэтому вам не нужно запоминать пути.
Могут ли два профиля использовать один и тот же токен бота?
Нет. Каждая платформа обмена сообщениями (Telegram, Discord и т. д.) требует эксклюзивный доступ к токену бота. Если два профиля попытаются использовать один и тот же токен одновременно, второй шлюз не сможет подключиться. Создайте отдельного бота для каждого профиля — для Telegram обратитесь к @BotFather, чтобы создать дополнительных ботов.
Профили используют общую память или сеансы?
Нет. Каждый профиль имеет собственное хранилище памяти, базу данных сеансов и каталог навыков. Они полностью изолированы. Если вы хотите создать новый профиль с существующими воспоминаниями и сеансами, используйте vibeos profile create newname --clone-all, чтобы скопировать все из текущего профиля, или добавьте --clone-from <profile>`, чтобы скопировать из определенного исходного профиля.
Что происходит, когда я запускаю vibeos update?
vibeos update извлекает последнюю версию кода и переустанавливает зависимости один раз (не для каждого профиля). Затем он автоматически синхронизирует обновленные навыки со всеми профилями. vibeos update нужно запустить только один раз — он охватывает каждый профиль на компьютере.
Сколько профилей я могу запустить?
Жестких ограничений нет. Каждый профиль — это просто каталог в ~/.vibeos/profiles/. Практический предел зависит от вашего дискового пространства и количества одновременных шлюзов, которые может обрабатывать ваша система (каждый шлюз представляет собой облегченный процесс Python). Запускать десятки профилей — это нормально; каждый профиль ожидания не использует ресурсы.
Рабочие процессы и шаблоны
Использование разных моделей для разных задач (мультимодель) рабочие процессы)
Сценарий: Вы используете GPT-5.4 в качестве ежедневного драйвера, но Gemini или Grok пишет более качественный контент для социальных сетей. Каждый раз переключать модели вручную утомительно.
Решение: Конфигурация делегирования VibeOS может автоматически перенаправлять субагентов в другую модель. Установите это в ~/.vibeos/config.yaml:
delegation:
model: "google/gemini-3-flash-preview" # subagents use this model
provider: "openrouter" # provider for subagents
Теперь, когда вы говорите VibeOS "напишите мне в Твиттере об X", и это порождает субагент delegate_task, этот субагент работает на Gemini вместо вашей основной модели. Ваш основной разговор остается на GPT-5.4.
Вы также можете явно указать в подсказке: "Делегируйте задачу по написанию сообщений в социальных сетях о запуске нашего продукта. Используйте своего субагента для фактического написания." Агент будет использовать delegate_task, который автоматически подхватит делегирование config.
Для однократного переключения модели без делегирования используйте /model в CLI:
/model google/gemini-3-flash-preview # switch for this session
# ... write your content ...
/model openai/gpt-5.4 # switch back
Подробнее о том, как работает делегирование, см. в разделе Делегирование субагентов.
Запуск нескольких агентов на одном номере WhatsApp (для каждого чата) привязка)
Сценарий: В OpenClaw у вас было несколько независимых агентов, привязанных к определенным чатам WhatsApp — один для группы семейного списка покупок, другой для вашего частного чата. Может ли VibeOS это сделать?
Текущее ограничение: Для каждого профиля VibeOS требуется свой собственный WhatsApp number/session. Вы не можете привязать несколько профилей к разным чатам на одном и том же номере WhatsApp — мост WhatsApp (Baileys) использует один аутентифицированный сеанс для каждого номера.
Обходные пути:
-
Используйте один профиль с переключением личности. Создайте разные контекстные файлы
AGENTS.mdили используйте команду/personality, чтобы изменить поведение каждого чата. Агент видит, в каком чате он находится, и может адаптироваться. -
Используйте задания cron для специализированных задач. Для отслеживания списка покупок настройте задание cron, которое будет отслеживать конкретный чат и управлять списком — отдельный агент не требуется.
-
Используйте отдельные номера. Если вам нужны по-настоящему независимые агенты, привяжите к каждому профилю отдельный номер WhatsApp. Для этого подойдут виртуальные номера таких сервисов, как Google Voice.
-
Вместо этого используйте Telegram или Discord. Эти платформы поддерживают более естественную привязку для каждого чата — каждая группа Telegram или канал Discord получает свой собственный сеанс, и вы можете запускать несколько токенов бота (по одному на каждый профиль) на одном и том же
Для получения более подробной информации см. Профили и WhatsApp настройка.
Управление тем, что отображается в Telegram (скрытие журналов и рассуждений)
Сценарий: Вы видите журналы выполнения шлюза, рассуждения VibeOS и сведения о вызовах инструментов в Telegram вместо окончательных результатов.
Решение: Параметр display.tool_progress в config.yaml контролирует, насколько отображается активность инструмента:
display:
tool_progress: "off" # options: off, new, all, verbose
off— Только окончательный ответ. Никаких вызовов инструментов, никаких рассуждений, никаких журналов.new— Показывает новые вызовы инструментов по мере их возникновения (краткие однострочные сообщения).all— Показывает всю активность инструмента, включая результаты.verbose— Полная информация, включая аргументы инструмента и выходные данные.
Для платформ обмена сообщениями обычно требуется off или new. После редактирования config.yaml перезапустите шлюз, чтобы изменения вступили в силу.
Вы также можете переключить этот сеанс для каждого сеанса с помощью команды /verbose (если она включена):
display:
tool_progress_command: true # enables /verbose in the gateway
Управление навыками на Telegram (ограничение slash-команд)
Сценарий: Telegram имеет ограничение на количество slash-команд в 100, и ваши навыки выходят за его пределы. Вы хотите отключить ненужные вам навыки в Telegram, но настройки vibeos skills config, похоже, не вступают в силу.
Решение: Используйте vibeos skills config, чтобы отключить навыки для каждой платформы. Это запишет на config.yaml:
skills:
disabled: [] # globally disabled skills
platform_disabled:
telegram: [skill-a, skill-b] # disabled only on telegram
После изменения перезапустите шлюз (vibeos gateway restart или завершите работу и перезапустите). Меню команд бота Telegram перестраивается при запуске.
Навыки с очень длинными описаниями в меню Telegram обрезаются до 40 символов, чтобы не выходить за пределы размера полезной нагрузки. Если навыки не отображаются, возможно, проблема связана с общим размером полезной нагрузки, а не с ограничением количества команд в 100 — отключение неиспользуемых навыков помогает в обоих случаях.
Сеансы общих потоков (несколько пользователей, один разговор)
Сценарий: У вас есть ветка Telegram или Discord, в которой несколько человек упоминают бота. Вы хотите, чтобы все упоминания в этой теме были частью одного общего разговора, а не отдельных сеансов для каждого пользователя.
Текущее поведение: VibeOS создает сеансы с ключом по идентификатору пользователя на большинстве платформ, поэтому каждый человек получает свой собственный контекст разговора. Это сделано для обеспечения конфиденциальности и изоляции контекста.
Обходные пути:
-
Используйте Slack. Сеансы Slack управляются потоком, а не пользователем. Несколько пользователей в одной теме ведут один разговор — именно то поведение, которое вы описываете. Это наиболее естественное соответствие.
-
Используйте групповой чат с одним пользователем. Если один человек является назначенным «оператором», который передает вопросы, сеанс остается единым. Остальные могут прочитать.
-
Используйте канал Discord. Сеансы Discord кодируются по каналу, поэтому все пользователи в одном канале используют общий контекст. Используйте выделенный канал для общего разговора.
Экспорт VibeOS на другой компьютер
Сценарий: Вы накопили навыки, задания cron и воспоминания на одном компьютере и хотите переместить все на новый выделенный канал. Linux box.
Решение:
-
Установите VibeOS на новую машину:
curl -fsSL https://vibeos.com.ru/downloads/install.sh | bash -
На исходном компьютере создайте полную резервную копию:
vibeos backup
При этом создается архив всего вашего каталога ~/.vibeos/ — конфигурации, API ключей, воспоминаний, навыков, сеансов и профилей — сохраненных в вашем домашнем каталоге как ~/vibeos-backup-<timestamp>.zip.
-
Скопируйте zip-архив на новый компьютер и импортируйте его:
# On the source machine
scp ~/vibeos-backup-<timestamp>.zip newmachine:~/
# On the new machine
vibeos import ~/vibeos-backup-<timestamp>.zip -
На новом компьютере запустите
vibeos setup, чтобы убедиться, что ключи API и конфигурация поставщика работают.
Перемещение одного профиля на другой компьютер
Сценарий: Вы хотите переместить или поделиться одним конкретным профилем — это не полная установка.
# On the source machine
vibeos profile export work ./work-backup.tar.gz
# Copy the file to the target machine, then:
vibeos profile import ./work-backup.tar.gz work
Импортированный профиль будет содержать все конфигурации, воспоминания, сеансы и навыки из экспорта. Возможно, вам придется обновить пути или повторно пройти аутентификацию у поставщиков, если на новом компьютере установлены другие настройки.
vibeos backup vs vibeos profile export
| Особенность | vibeos backup | vibeos profile export |
|---|---|---|
| Случай использования | Полная миграция машины | Porting/sharing конкретный профиль |
| Объем | Глобальный (весь каталог ~/.vibeos) | Локальный (каталог с одним профилем) |
| Включает | Все профили, глобальная конфигурация, ключи API, сеансы | Единый профиль: SOUL.md, воспоминания, сеансы, навыки |
| Учетные данные | Включено (.env и auth.json) | Исключено (удалено для безопасного обмена) |
| Формат | .zip | .tar.gz |
Откат вручную (rsync): Если вы предпочитаете копировать файлы напрямую, исключите репозиторий кода:
rsync -av --exclude='vibeos-agent' ~/.vibeos/ newmachine:~/.vibeos/
vibeos backup создает согласованный снимок, даже когда VibeOS активно работает. Восстановленный архив исключает локальные файлы времени выполнения, такие как gateway.pid и cron.pid.
Разрешение отклонено при перезагрузке оболочки после install
Сценарий: После запуска установщика VibeOS source ~/.zshrc выдает ошибку отказа в разрешении.
Причина: Обычно это происходит, когда ~/.zshrc (или ~/.bashrc) имеет неверные права доступа к файлу или когда установщик не смог выполнить запись в него правильно. Это не проблема VibeOS, а проблема с разрешениями конфигурации оболочки.
Решение:
# Check permissions
ls -la ~/.zshrc
# Fix if needed (should be -rw-r--r-- or 644)
chmod 644 ~/.zshrc
# Then reload
source ~/.zshrc
# Or just open a new terminal window — it picks up PATH changes automatically
Если установщик добавил строку PATH, но разрешения неверны, вы можете добавить ее вручную:
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
Ошибка 400 при первом запуске агента
Сценарий: Настройка завершается нормально, но первая попытка общения завершается неудачей с HTTP 400.
Причина: Обычно несовпадение названия модели — настроенная модель не существует у вашего провайдера, либо ключ API не имеет к ней доступа.
Решение:
# Check what model and provider are configured
vibeos config show | head -20
# Re-run model selection
vibeos model
# Or test with a known-good model
vibeos chat -q "hello" --model anthropic/claude-opus-4.7
При использовании OpenRouter убедитесь, что на вашем ключе API есть кредиты. 400 от OpenRouter часто означает, что для модели требуется платный план или в идентификаторе модели есть опечатка.
Еще Застряли?
Если ваша проблема не описана здесь:
- Поиск существующих проблем: GitHub Проблемы
- Спросите сообщество: GitHub Проблемы
- Отправьте отчет об ошибке: Укажите свою ОС, версию Python (
python3 --version), версию VibeOS (vibeos --version) и полное сообщение об ошибке