跳到主要内容

设置向导

anyy setup 是首次运行的配置向导。它会引导你选择模型 provider、选择 默认模型，并可选地配置 fallback 路由、辅助能力以及消息平台，然后在最终确认后 将所有内容写入磁盘。在交互式向导中，在你确认之前不会写入任何内容，也不会改动你的 shell 配置文件。

非交互式调用会立即生效

“先复核再应用”的行为仅适用于交互式向导。非交互式、由标志驱动的形式 anyy setup channels CHANNEL … 没有最终复核步骤：它会立即写入该 channel 的密钥 文件（即使不加 --write-config），而 --write-config 还会额外更新 config.yaml。

不带任何参数运行即可进入完整引导流程：

anyy setup
anyy setup

Interactive wizard to configure provider, model, messaging, and optional capabilities.

Usage:
  anyy setup [--home PATH]            full wizard
  anyy setup model [--home PATH]      provider/auth/default model
  anyy setup model fallback [--home PATH]
  anyy setup aux [--home PATH]        optional capabilities
  anyy setup aux CAP [--home PATH] [--probe]
  anyy setup channels [--home PATH]   messaging platforms only
  anyy setup channels CHANNEL [--home PATH] [--account-id ID] [--secret NAME=VALUE] [--set NAME=VALUE] [--write-config]
  anyy setup channels weixin login [--home PATH] [--base-url URL] [--secret NAME]
  anyy setup weixin [--home PATH] [--account-id ID] [--secret NAME=VALUE] [--set NAME=VALUE] [--write-config]
  anyy setup weixin login [--home PATH] [--base-url URL] [--secret NAME]

各子命令（model、model fallback、aux、channels）只会重新运行向导的某一个 环节，让你以后无需走完整个流程即可单独重新配置某一项。--home PATH 让向导指向 另一个 home 目录，便于使用临时 profile 或第二个实例。

备注

Anyy 与 provider 无关。你在这里选择的 provider 和模型只是可配置的后端， Anyy 本身始终标识为 Anyy，绝不会标识为其背后的 provider 或模型。

向导需要交互式终端。如果 stdin 不是 TTY（例如在脚本或 CI 中），它会退出并提示你 改用非交互式的 anyy setup channels CHANNEL 形式。

完整交互式设置​

不带子命令运行 anyy setup 会进入完整流程。它以一个 Profile 面板开场， 在提出任何问题之前先准确展示设置将存放的位置：

◆ Anyy Setup

Profile
  Home      /Users/you/.anyy
  Config    /Users/you/.anyy/config.yaml
  Secrets   /Users/you/.anyy/secrets
  Mode      full setup

随后向导会询问要配置到什么程度：

  • Quick setup（默认）—— provider、模型与消息平台。推荐用于首次运行。
  • Full setup —— 在上述基础上，再加上辅助能力与 MCP 服务。

之后向导按以下顺序运行各步骤：

  1. Provider & Model —— 选择 provider、完成认证、选择默认模型（详见下文）。
  2. Model fallback —— 一个可选环节；默认跳过。
  3. Messaging —— 连接零个或多个聊天平台。
  4. Optional capabilities 与 MCP —— 仅 Full setup。
  5. Background service —— 仅当你配置了某个 channel 时才会列入待写入变更： 安装并启动常驻服务，让 Anyy 持续在线以处理消息与计划任务。
  6. Review Changes —— 列出所有待写入变更的摘要，并附最终的 Write these changes? 确认。默认是 yes，因此按 Enter 会写入；回答 no 则不写入任何内容。

成功写入后，向导会打印后续操作提示 （anyy status、anyy config、anyy）。

如果你在任意提示处按 Ctrl-C 或取消，向导会报告 setup canceled; no changes were written 并干净退出。

模型设置​

若只想配置 provider、认证和默认模型，而不涉及消息平台或辅助能力步骤，运行：

anyy setup model
anyy setup model

Configure provider, auth, and default model.

Usage:
  anyy setup model [--home PATH]
  anyy setup model fallback [--home PATH]

这与完整向导中的 Provider & Model 环节相同，因此是日后切换 provider 或更换默认 模型最快的方式。关于模型选择、fallback 以及辅助模型的更深入讨论，参见 配置模型。

Provider 认证​

向导首先展示 Select provider: 菜单。Provider 按厂商分组——例如 OpenAI 会在同一 标题下同时提供 API key 入口和 OAuth 入口——菜单还包含通用的 OpenAI 兼容、Anthropic 兼容以及自定义端点选项，适用于自托管或第三方网关。如果某个 provider 已配置，它会被 标记为 currently active 并预先选中。

选定 provider 后，向导会根据该 provider 支持的方式提示认证——API key、OAuth 登录、 可选 key（对本地端点可跳过），或本地模型服务器的无认证。你输入的 key 会被遮蔽，并写入 secrets/ 目录，绝不会写进 config.yaml。如果文件中已存在凭据，向导会提供复用已有 凭据的选项。

本页仅说明认证在流程中的位置。关于凭据存储、OAuth 登录细节、轮换与清除凭据，参见 凭据与认证。

默认模型​

认证就绪后，向导会加载该 provider 的模型目录并展示 Select model: 列表。 当前生效的模型（如有）会被标记为 current 并预先选中。如果无法获取目录——或该 provider 没有实时目录——向导会回退到 Model id: 提示，并预填一个合理默认值， 让你直接输入模型 id。

你选择的模型将成为新会话的默认模型。日后更改它只需再次运行 anyy setup model。

Fallback 路由​

Fallback 路由让 Anyy 在主模型失败时自动改用另一个 provider/模型重试。在完整 向导中，这是一个可选环节（Set up model fallback routing?），默认跳过。你也可以 直接配置：

anyy setup model fallback
anyy setup model fallback

Configure fallback routing for the main model.

Usage:
  anyy setup model fallback [--home PATH]

必须先配置好主模型——fallback 路由需要一个归属对象。编辑器允许你保留、替换 或清除路由链。替换时，你会从已配置的 provider 中（每个都须有默认模型）构建一个 有序的 fallback provider 列表。运行时如何选择 fallback 的机制，参见 配置模型。

辅助能力​

可选的非聊天能力单独配置。在完整向导中，它们位于 Set up optional capabilities? 环节之后（仅 Full setup）；你也可以单独配置：

anyy setup aux
anyy setup aux

Configure optional model capabilities.

Usage:
  anyy setup aux [--home PATH] [--probe]
  anyy setup aux CAP [--home PATH] [--probe]

Capabilities:
  image    image understanding
  video    video understanding
  imagegen image generation
  tts      text-to-speech
  stt      speech-to-text
  search   web search (coming soon)

不带能力名运行 anyy setup aux 会打开一个多选菜单；已配置的能力会被预先选中， 每一行还会显示其当前状态（例如 inherits main: …、configured: … 或 off）。 传入单个能力 id（anyy setup aux tts）可只配置那一项。可选的 --probe 标志 会为支持的能力请求一次校验检查（目前为图像生成与文字转语音）。

各能力分为两种凭据方式：图像与视频理解，以及图像生成会绑定到你已配置的 某个 provider；而文字转语音与语音转文字可以指向各自独立的端点。

图像生成​

配置一个绑定到你某个 provider 的图像生成模型，以及其生成策略。支持 --probe 在配置 后校验该模型。

文字转语音​

针对 OpenAI 兼容的 TTS 端点配置一个文字转语音音色，并提供自动朗读回复的选项。支持 --probe。

语音转文字​

语音转文字（stt）会配置一个音频理解模型，使 Anyy 能转写收到的音频。它使用 各自独立的端点，而非绑定到主 provider。

Browser 与 Computer Use​

Browser 与 computer-use 工具是通过 MCP 服务接入的，而非 aux 能力列表。在完整 向导中，它们会在辅助能力之后的 MCP 环节提供。关于配置模型以及 MCP 服务的表示方式， 参见配置。

消息平台设置​

消息 channel 将 Anyy 接入聊天平台。完整向导包含一个消息环节；若只想配置 channel，运行：

anyy setup channels
anyy setup channels

Configure messaging platforms.

Usage:
  anyy setup channels [--home PATH]
  anyy setup channels CHANNEL [--home PATH] [--account-id ID] [--secret NAME=VALUE] [--set NAME=VALUE] [--write-config]
  anyy setup channels weixin login [--home PATH] [--base-url URL] [--secret NAME]
  anyy setup weixin [--home PATH] [--account-id ID] [--secret NAME=VALUE] [--set NAME=VALUE] [--write-config]
  anyy setup weixin login [--home PATH] [--base-url URL] [--secret NAME]

在不带 channel 参数且处于交互式终端时，向导会展示一个平台多选列表——Telegram、 Discord、Slack、WhatsApp、Facebook、Email、SMS (Twilio)、DingTalk、Feishu / Lark、 Weixin / WeChat、QQ Bot、IRC 与 LINE——计划中的平台会显示但禁用。对你选中的每个 平台，向导会提示：

  • 一个私信策略（配对审批、全部允许、白名单或禁用）。
  • 一个群聊策略（在支持的平台上：被提及时回复、禁用、开放或白名单）。
  • 该平台的配置字段与密钥字段（令牌与 key，输入时遮蔽）。Feishu 会额外提供 连接模式选择（长连接或 webhook）；Weixin 则运行二维码登录而非令牌提示。

传入明确的 channel 名（anyy setup channels CHANNEL …）会以非交互式模式 运行，接受 --account-id、--secret NAME=VALUE 与 --set NAME=VALUE 标志，并通过 --write-config 写入配置。由于交互式向导需要 TTY，脚本中应使用这种形式。

当你配置了任何 channel 时，向导会提供安装并启动后台服务的选项，让 Anyy 持续在线以接收消息。

状态检查​

向导绝不会悄无声息地覆盖你的配置：每次运行都会以 Review Changes 摘要结束，列出 provider、模型、fallback、能力、channel、后台服务操作，以及将写入多少个密钥文件 （每个 0600）。只有在你接受 Write these changes? 之后才会写入文件；默认回答是 yes。

设置完成后，使用向导指向的标准运行时命令验证结果：

anyy status     # runtime + gateway health
anyy config     # review the written configuration
anyy doctor     # deeper checks of providers, storage, capabilities

针对 channel，anyy channels doctor CHANNEL 会检查单个平台的配置。

设置如何存储​

设置会在 Anyy 的 home 目录下（默认 ~/.anyy）写入单个 config.yaml， 并将凭据作为独立文件分开存放在 secrets/ 下（权限 0600）。不会写入你的 shell 配置文件。使用 --home PATH（或 ANYY_HOME 环境变量）可指向不同的 home 目录。 完整的配置模型见配置。

重新运行设置​

设置可以随意重新运行——它会先加载你当前的配置，预先选中已生效的项，并只更改你确认的 内容。请选用范围最小的入口：

目标命令
重新配置所有内容anyy setup
切换 provider 或默认模型anyy setup model
添加或编辑 fallback 路由anyy setup model fallback
配置某个辅助能力anyy setup aux [CAP]
添加或编辑消息 channelanyy setup channels [CHANNEL]

每个子命令都在自己的 Review Changes 确认后独立提交，因此重新配置某一部分绝不会 扰动其余部分。