Настройка runtime

Anda по умолчанию хранит состояние в ~/.anda. Основной файл — ~/.anda/config.yaml. Необязательная MCP-конфигурация находится в ~/.anda/mcp.json.

Провайдеры моделей

Активный провайдер должен содержать family, model и api_base. api_key можно указать в файле или передать через переменную окружения.

model:
  active: "deepseek-v4-pro"
  providers:
    - family: anthropic
      model: "deepseek-v4-pro"
      api_base: "https://api.deepseek.com/anthropic"
      api_key: "YOUR_API_KEY"
      labels: ["pro", "brain"]
      disabled: false

Поддерживаемые переменные:

OPENAI_API_KEY
ANTHROPIC_API_KEY
GEMINI_API_KEY
GOOGLE_API_KEY
DEEPSEEK_API_KEY
MINIMAX_API_KEY
MIMO_API_KEY
MOONSHOT_API_KEY
KIMI_API_KEY
BIGMODEL_API_KEY
GLM_API_KEY

Основные настройки

Настройка	Назначение
addr	Локальный gateway, по умолчанию 127.0.0.1:8042.
sandbox	Если true, shell идет через ~/.anda/sandbox.
https_proxy	Proxy для моделей и каналов.
model	Провайдеры для агента и памяти.
transcription	Распознавание голоса и аудио.
tts	Озвучивание ответа.
channels	Telegram, WeChat, Discord, Lark/Feishu.

MCP-серверы

Anda Bot может подключаться к MCP-серверам через stdio-процессы или HTTP endpoints. Поместите переносимую MCP-конфигурацию в ~/.anda/mcp.json, затем перезапустите daemon. Файл принимает mcpServers и servers как root key, чтобы можно было вставлять конфигурации из других MCP-инструментов с минимальными изменениями.

{
  "mcpServers": {
    "filesystem": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "$ANDA_WORKSPACE"]
    },
    "remote": {
      "type": "http",
      "url": "https://mcp.example.com/mcp",
      "headers": {
        "Authorization": "Bearer ${MCP_REMOTE_TOKEN}"
      }
    }
  }
}

Удаленные MCP-инструменты отображаются как инструменты Anda с именами вида mcp_<server_id>_<remote_tool>. Строки конфигурации поддерживают подстановку переменных $VAR и ${VAR}. ANDA_HOME и ANDA_WORKSPACE встроены. Для stdio-серверов command запускается напрямую, без shell; если cwd не указан, используется первый workspace Anda. Если type не указан, Anda выводит stdio из command или http из url.

Агент также может добавить сервер во время работы с помощью add_mcp_server. Используйте persist: false только для текущего daemon или persist: true, чтобы сохранить сервер в ~/.anda/mcp.json для последующих перезапусков. Поля сервера повторяют одну запись mcp.json: type, command, args, env, cwd, url, headers, enabled, include и exclude, плюс служебные поля инструмента id и persist.

Локальные директории

~/.anda/
  config.yaml
  mcp.json
  channels/
  db/
  keys/
  logs/
  bundled-skills/
  sandbox/
  skills/
  skills-manifest.json
  skill-backups/
  skill-trash/
  workspace/

db/ хранит память, беседы, состояние каналов и cron. bundled-skills/ содержит skills, управляемые обновлениями Anda, а skills/ содержит личные skills, созданные, клонированные или измененные пользователем. skills-manifest.json хранит локальное состояние включения, отключения и перезагрузки; skill-backups/ и skill-trash/ хранят резервные копии перед редактированием и удаленные личные skills. workspace/ — рабочая область для shell и файлов.

Приватность

Локальные данные остаются на вашей машине, но провайдеры моделей могут получать prompts, резюме и запросы памяти. Выбирайте провайдеры, endpoints и proxy по требованиям приватности.

подсказка

Используйте anda --home /path/to/.anda, чтобы изолировать проекты, личности или тесты.