WhatsApp

Справочник настроек

Настройки WhatsApp CLI: значения по умолчанию, области действия и переменные окружения.

Используйте эту страницу, если вам нужно точное имя, значение по умолчанию или область действия параметра или имя переменной среды. Здесь перечислены все настройки, которые читает wa, и какое значение имеет приоритет.

Ни одна настройка не может хранить секрет: в файле нет поля для ключей устройства, номера телефона или идентификатора чата.

Какое значение выигрывает

Для каждой настройки устанавливается первая из них:

  1. опция в командной строке (--limit 50, --record, --timeout 30s)
  2. переменная среды (WA_PROFILE, WA_TIMEOUT)
  3. собственная запись профиля в файле конфигурации
  4. defaults в файле конфигурации, общий для каждого профиля.
  5. встроенный по умолчанию

wa <profile> config show печатает все действующие настройки и их происхождение.

Файл

~/.config/whatsapp-cli/config.json. Никакая настройка не выбирает профиль: первое слово (wa work …) или WA_PROFILE называет его. В противном случае команда, использующая аккаунт, останавливается с кодом выхода 2 и выводит список профилей на этом компьютере. Файл, в котором все еще есть default_profile из более старого wa, также останавливает эту команду; wa config unset default_profile удаляет его.

НастройкаПо умолчаниюЧто он делаетИзменить для одного запуска
limit20строк на странице списка--limit
timeout_msнеткак долго может ждать один запрос (в миллисекундах); для всей команды используйте --timeoutнет
colorиз терминалацвет в виде таблицыникто; без настроек NO_COLOR отключает его
sender_colorsfalseцвет для каждого отправителя в таблице сообщенийнет
search_catch_upfalseподготовить вновь сохраненные чаты для локального поиска: их график и, если они установлены, их векторы--catch-up, --no-catch-up
picture_searchfalseпоиск сохраненных изображений по тому, что они показывают, после загрузки моделинет
recordfalseсохранять каждый запуск--record, --no-record
keep_runs_for_days30записанные запуски старше этого удаляются при сохранении следующегонет
permissionsразрешено все, кроме удаления и некоторых других изменений, спроситечто профиль может делать по команденикто; --yes отвечает только на ask и никогда не поднимает deny
sends_per_hour30больше всего отправлений за часнет
requests_per_minuteтемп CLIзапросов в минуту, общий предел для всех процессов профиля; 0 отключает егоWA_REQUESTS_PER_MINUTE
transcribe_withautoкто превращает голос в текст: auto, messenger или local--local или --model
speech_modelнеткоторый использует загруженную речевую модель --local--model
read_other_botsfalseпринимать сообщения, определенные как исходящие от других ботов; только профили ботовнет
update_checktrueежедневная строка «Существует более новая версия»; только под defaultsникто; WA_NO_UPDATE_CHECK, NO_UPDATE_NOTIFIER или CI выключить
skill_hinttrueлиния не чаще одного раза в день для агента, у которого копия навыка отсутствует или устарела; только под defaultsнет
embedding_providerlocalлокальная модель или openai--embedding-provider
embedding_modelпровайдер по умолчаниюмодель эмбеддингов--model
embedding_base_urlпровайдер по умолчаниюадрес API эмбеддингов--base-url
embedding_dimsмодель по умолчаниюцелое число 1–65 536--dims
analysis_provideragentagent, openai или anthropicbuild --analysis-provider
analysis_modelнетмодель анализаbuild --model
analysis_base_urlпровайдер по умолчаниюконечная точка API анализаbuild --base-url
modelsнетвнешние модели по назначениюWA_MODELS_* переменные

Настройки поиска, страны телефона, задачи и группы учетных записей (search_stemmers.*, phone_countries, task_*, account_groups.*) перечислены в разделе wa config set.

При первом создании файл записывается как 0600. В этом нет никакой тайны.

Профиль бота

Номер WhatsApp Business в облачном API Meta (wa <profile> bot …) сохраняет свои настройки под bot в файле: wa <profile> config set --bot <setting> <value>. Это идентификаторы со страницы настройки API панели управления приложениями, а не секреты; токен доступа находится в системной связке ключей (номер WhatsApp Business в качестве бота).

НастройкаПо умолчаниюЧто он делаетИзменить для одного запуска
phone_number_idнетбизнес-номер, о котором говорит каждая команда bot--phone-number-id о командах bot api
waba_idнетаккаунт WhatsApp Business, содержащая шаблоны номеров--waba-id о командах bot api
graph_versionv23.0версию Graph API в каждом запросенет

Переменные среды

ПеременнаяЧто он делает
WA_PROFILEпрофиль, когда первое слово не называет ни одного
WA_PROFILE_LOCKзакрепляет процесс в одном профиле; любому другому отказано
WA_TIMEOUTто же, что --timeout: 500ms, 30s или 2m для всей команды
WA_REQUESTS_PER_MINUTEто же, что requests_per_minute, и побеждает его
WA_CONFIG_DIR, WA_STATE_DIR, WA_CACHE_DIRпереместить три каталога
MESSAGING_STOREпуть к файлу локального хранилища
WIRECAT_STATE_DIRпапка WireCat, совместно используемая каждым CLI: локальное хранилище и речевые модели
WA_READ_ONLY1 делает этот процесс доступным только для чтения: каждое изменение, включая привязку и отвязку устройства, отклоняется
WA_ENGINEпуть к программе движка, которую нужно запустить вместо установленной
WA_ENGINE_LOGфайл, в который движок добавляет свои предупреждения, замаскировав номера телефонов; не установлено, ничего не регистрируется
WA_NO_UPDATE_CHECK1 отключает ежедневную строку «Существует более новая версия»
NO_COLORнет цвета в виде таблицы
WA_EMBEDDING_*, WA_ANALYSIS_*, WA_MODELS_*настройки модели