Configuración del runtime

Anda guarda su estado en ~/.anda por defecto. El archivo principal es ~/.anda/config.yaml, creado en el primer arranque. La configuración MCP opcional vive en ~/.anda/mcp.json.

Proveedores de modelos

El proveedor activo debe incluir family, model y api_base. api_key puede estar en el archivo o venir de una variable de entorno.

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

Variables soportadas:

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

Ajustes principales

Ajuste	Propósito
addr	Dirección del gateway local, por defecto 127.0.0.1:8042.
sandbox	Si es true, shell usa ~/.anda/sandbox.
https_proxy	Proxy para modelos y canales.
model	Proveedores para el agente y la memoria.
transcription	Proveedor para voz y adjuntos de audio.
tts	Proveedor para reproducción de voz.
channels	Configuración de Telegram, WeChat, Discord y Lark/Feishu.

Servidores MCP

Anda Bot puede conectarse a servidores MCP mediante procesos stdio o endpoints HTTP. Pon una configuración MCP portable en ~/.anda/mcp.json y reinicia el daemon. El archivo acepta mcpServers y servers como root key para pegar configuraciones de otras herramientas MCP con pocos cambios.

{
  "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}"
      }
    }
  }
}

Las herramientas MCP remotas aparecen como herramientas de Anda con nombres como mcp_<server_id>_<remote_tool>. Las cadenas de configuración admiten expansión de variables $VAR y ${VAR}. ANDA_HOME y ANDA_WORKSPACE están integradas. Para servidores stdio, command se inicia directamente sin shell; si cwd se omite, se usa el primer workspace de Anda. Si type se omite, Anda infiere stdio desde command o http desde url.

El agente también puede añadir un servidor en tiempo de ejecución con add_mcp_server. Usa persist: false solo para el daemon actual, o persist: true para guardar el servidor en ~/.anda/mcp.json y conservarlo tras reinicios. Sus campos de servidor reflejan una entrada de mcp.json: type, command, args, env, cwd, url, headers, enabled, include y exclude, más los campos propios de la herramienta id y persist.

Directorios locales

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

db/ contiene memoria, conversaciones, estado de canales y cron. keys/ contiene claves locales. bundled-skills/ contiene skills gestionadas por las actualizaciones de Anda, mientras que skills/ contiene skills personales creadas, clonadas o editadas por el usuario. skills-manifest.json guarda el estado local de activación, desactivación y recarga; skill-backups/ y skill-trash/ guardan copias previas a la edición y skills personales eliminadas. workspace/ es el espacio por defecto para shell y archivos.

Privacidad

Los datos locales se guardan en tu máquina, pero los proveedores de modelos pueden recibir prompts, resúmenes y solicitudes de memoria. Elige proveedores, endpoints y proxy según tus necesidades.

tip

Usa anda --home /path/to/.anda para aislar proyectos, identidades o pruebas.