快速开始

这份指南从一台尚未安装 Anyy 的 macOS 或 Linux 电脑开始，带你完成模型配置、第一次 Dashboard 对话，并亲自确认会话在 Dashboard 重启后仍然存在。

这份指南适合谁

如果你符合下面这些情况，可以从这里开始：

准备在自己的 macOS 或 Linux 设备上使用 Anyy；
日常更愿意使用 Dashboard，同时希望知道背后对应的终端命令；
已有服务商 API Key、受支持的订阅账号，或本机 Ollama、LM Studio 服务；
希望先跑通一条可靠的对话链路，再逐步增加消息渠道、自动任务、Skills 和外部工具。

最快路径

你的目标	先做什么	接着做什么
使用完整的可视化界面	安装 Anyy	运行 `anyy setup`，再运行 `anyy dashboard`
在终端里持续对话	安装并完成模型配置	运行 `anyy`
从脚本发送一次请求	启动常驻 Gateway	运行 `anyy chat "..."`
接入 Telegram 等消息平台	先验证本地对话正常	运行 `anyy setup channel`

先证明最小链路可用

第一次使用只配置一个服务商，并完成一轮普通对话。模型回退、消息渠道、Cron、MCP 和 Browser 都可以稍后增加。这样一旦失败，原因通常只会落在安装、凭据、模型或 Gateway 其中一层。

1. 安装 Anyy

macOS 与 Linux

使用 Anyy 的原生安装脚本：

curl -fsSL https://anyy.ai/install.sh | sh

安装结束后，先确认当前 Shell 能找到 Anyy：

anyy --version

安装脚本会下载对应平台的原生发行包，对照 CHECKSUMS.sha256 校验文件，再把版本激活到 Anyy Home；在不覆盖现有同名命令的前提下，它还会创建命令入口。

安装脚本支持的平台

当前原生发行安装支持 macOS、Linux，以及 amd64/x86_64、arm64/aarch64 架构。安装本身不会擅自启动 Gateway，也不会提前创建 Profile 数据；后续配置或实际运行时才会按需完成这些动作。

如果终端提示找不到 anyy，先用安装结果中 Binary: 后面的完整路径执行 --version。然后按照安装器打印的 PATH 提示添加目录并重新打开终端。普通非 root 安装会尽量把命令入口放到 $HOME/.local/bin。

2. 选择服务商

启动交互式配置：

anyy setup

第一次配置按下面的选择即可：

在模式选择中使用 Quick setup。
选择模型服务商和认证方式。
从在线目录中选模型；如果该服务商需要手动填写，则输入准确的模型 ID。
遇到 Set up model fallback routing? 时先选择 No。
遇到消息平台配置时选择 Skip。
在最后一页检查服务商、模型、Endpoint 和凭据文件数量，然后确认 Write these changes?。

常见账号与向导选项的对应关系如下：

你已有的账号或环境	在向导中选择
OpenAI API Key	OpenAI → OpenAI API key
ChatGPT 订阅	OpenAI → ChatGPT subscription (Codex)
Anthropic API Key	Anthropic → Anthropic API
Claude Code 订阅	Anthropic → Claude Code subscription
本机 Ollama 或 LM Studio	Ollama 或 LM Studio；先启动本地模型服务
其他兼容接口	OpenAI-compatible 或 Anthropic-compatible，再填写对应 Endpoint

向导还会列出当前版本已经可以使用的其他服务商。不要依赖一份长期不变的静态名单：本机向导里的可选目录才与已安装版本一致。

配置成功后会看到 setup complete。随后运行：

anyy config

它会显示当前 Profile、Home、配置文件、数据库、服务商、模型、Endpoint，以及凭据引用是否有效；不会输出凭据原文。

配置和凭据保存在哪里

每个 Profile 都有独立的数据目录：

服务商和模型配置写入 <PROFILE_HOME>/config.yaml；
由 Anyy 管理的凭据单独保存在 <PROFILE_HOME>/secrets/，文件权限为 0600；
会话与运行状态保存在 <PROFILE_HOME>/state.db。

普通非 root 安装的默认 <PROFILE_HOME> 通常是 $HOME/.anyy，root 安装则是 /root/.anyy。如果使用了 ANYY_HOME 或命名 Profile，以 anyy config 实际显示的路径为准。

最后确认前不会落盘

Setup 会先暂存本轮选择，再给出完整的变更摘要。只要还没有确认 Write these changes?，取消操作就不会写入这批暂存配置。

3. 完成第一次对话

第一次对话推荐从 Dashboard 开始。对话、会话、模型、工具、审批、记忆、角色、Profile、渠道、Skills、MCP 和 Cron 都能从同一个界面进入。

在交互式终端运行：

anyy dashboard

如果当前没有可连接的常驻 Gateway，终端会显示 Gateway required，并询问：

Start Anyy Gateway now? [Y/n]:

直接按 Enter 接受默认选项。Anyy 会在需要时安装并启动后台服务，等待 Gateway 就绪，然后继续打开 Dashboard。之后即使退出 Dashboard 进程，这个常驻 Gateway 仍可继续运行。

默认情况下，终端会打印一个 This machine 地址，以及能够监听时的 Local network 地址，端口为 8767。在交互式终端中，Anyy 会自动打开 This machine 地址。只想打印地址而不打开浏览器时使用：

anyy dashboard --no-open

如果只允许一个明确的本机回环监听，而不希望自动监听可用局域网地址，可以运行：

anyy dashboard --listen 127.0.0.1:8767

不要分享 Dashboard 地址

终端打印的地址带有临时访问令牌。不要把它们放进对话、日志、Issue 或截图。需要关闭 Dashboard 监听时，在启动它的终端按 Ctrl+C。

发送第一条消息

打开 Dashboard 后：

进入 对话（Chat）。
点击 新建会话（New session）。
发送下面这句话：

请用一句话说明你是 Anyy，再列出三件你能帮我完成的事情。

当回答正常出现，并且新会话出现在会话栏中，基础配置就已经跑通。

这会调用真实模型

本步骤会消耗服务商额度，也可能产生费用。不要在提示词中粘贴 API Key、访问令牌或其他秘密信息。

4. 确认会话可恢复

第一次回答成功还不够，再验证一次持久化链路：

在同一会话继续追问一句。
回到运行 Dashboard 的终端，按 Ctrl+C。
再次执行 anyy dashboard。
进入对话，从会话列表打开刚才的会话。
确认前两轮内容都在，然后再发送一次追问。

这个过程同时验证了会话写入、Dashboard 重连，以及通过常驻 Gateway 继续执行这三件事。

如果改用终端界面，运行 anyy 后输入 /sessions，即可从最近会话中选择。已知会话 ID 时也可以直接打开：

anyy --resume SESSION_ID

5. 试用关键功能

Dashboard 中的常用入口

现在可以用侧边导航核对刚才的配置：

概览：查看运行状态与当前 Profile。
模型：查看服务商连接、认证状态、可用模型和当前模型。
对话：分别管理普通会话与后台会话。
审批：处理等待决定的操作，并查看历史决定。
角色与记忆：管理身份和需要长期保留的个人上下文。
工具、Skills、MCP、渠道和定时任务：在基础对话稳定后继续扩展能力。

在对话输入框中，Shift+Enter 用于换行；模型正在回答时可点击停止。输入 / 可以打开当前可用的命令菜单。

终端界面

运行下面的命令打开 TUI：

anyy

常用斜杠命令包括：

/help       查看命令与快捷键
/new        新建会话
/sessions   打开最近会话
/status     查看当前对话状态
/model      查看或切换当前模型
/provider   查看服务商与认证状态
/usage      查看服务商用量与上下文
/skills     插入可用的 Skill 命令

Enter 发送，Shift+Enter 或 Alt+Enter 换行，Ctrl+C 中断当前执行或清空草稿，Ctrl+D 退出。

单次命令

常驻 Gateway 已运行时，可以不打开完整界面，直接发送一个请求：

anyy chat "请用五行概括 Anyy 可以做什么。"

脚本需要结构化结果时增加 --json。非交互式对话默认拒绝需要审批的状态变更；--yes 会批准它所支持的待处理审批，因此只有在你已审查任务并信任其影响时才使用。

6. 按需增加下一层能力

接下来只开启当前真正需要的一项：

能力	从这里开始	会增加什么
消息平台	`anyy setup channel`	连接受支持的平台，并配置对应访问策略
模型回退	`anyy setup model fallback`	增加有顺序的备用服务商与模型链
Web、图片、视频或语音后端	`anyy tools`	配置可选的能力服务
Browser	`anyy browser connect`	经明确确认后连接隔离的本地浏览器
Skills	`anyy skills list`	先查看已安装 Skills，再决定是否继续添加
MCP	`anyy mcp --help`	添加、认证、探测、启用并调用 MCP 服务和工具
定时任务	`anyy cron --help`	创建和管理采用审批或 yolo 执行模式的周期任务

Dashboard 与 Gateway 的生命周期不同

Dashboard 是按需启动的 Web 界面，Gateway 才是常驻运行时。按 Ctrl+C 关闭 Dashboard 只会结束 Web 监听，不会停止已经作为后台服务安装的 Gateway。

常见故障

现象	常见原因	处理方法
终端提示 `anyy: command not found`	命令入口目录不在 `PATH`	按安装器输出的准确提示修改 PATH，重开终端，再运行 `anyy --version`
在 API Key 输入处直接回车后 Setup 结束	第一次配置 API Key 时，空输入表示取消	重新运行 `anyy setup model` 并填写有效 Key，或改选订阅、本地服务商
找不到 Ollama 或 LM Studio 模型	本地服务没有启动，或 Endpoint 不正确	先启动本地模型服务，再执行 `anyy setup model`
Dashboard 显示 Gateway required	没有可连接的常驻 Gateway	接受自动启动提示，或先执行 `anyy gateway start`，再运行 Dashboard
`127.0.0.1:8767` 已被占用	另一个 Dashboard 或其他进程正在监听	运行 `anyy dashboard --status`；用 `anyy dashboard --stop` 结束旧实例，或改用 `--listen 127.0.0.1:8768`
Dashboard 能打开，但无法发送对话	服务商、模型、认证或 Gateway 状态异常	依次运行 `anyy config`、`anyy status`、`anyy doctor`；必要时重做 `anyy setup model`
`anyy chat` 无法连接	单次对话命令不会自行启动常驻 Gateway	先运行 `anyy gateway start`
重开后找不到刚才的会话	当前选中了不同的 Profile 或 Home	对照 Dashboard 与 `anyy config` 显示的 Profile、Home

恢复工具箱

按下面的顺序检查。先缩小范围，再修改配置：

确认当前运行时、Profile 和路径：
```
anyy status
anyy config
```
执行内置诊断：
```
anyy doctor
```
确认当前没有正在执行的任务后，再重启异常的 Gateway：
```
anyy gateway restart
```
如果问题只在服务商认证或模型选择，单独修复这一层：
```
anyy setup model
```
如果是 Dashboard 监听问题，查看并停止旧进程，再启动新实例：
```
anyy dashboard --status
anyy dashboard --stop
anyy dashboard
```
使用多个 Profile 时，确认当前激活项：
```
anyy profile list
```

命令速查

命令	用途
`anyy`	打开交互式终端界面
`anyy dashboard`	启动 Dashboard，并打开 This machine 地址
`anyy dashboard --no-open`	启动 Dashboard，但不自动打开浏览器
`anyy chat "PROMPT"`	通过常驻 Gateway 发送单次请求
`anyy --resume SESSION_ID`	在 TUI 中打开已有会话
`anyy status`	查看运行时与 Gateway 状态
`anyy doctor`	执行配置和运行时诊断
`anyy config`	查看解析后的路径、服务商、模型与凭据状态
`anyy gateway start`	安装并启动常驻 Gateway 服务
`anyy gateway restart`	重启常驻 Gateway 服务
`anyy setup model`	配置服务商、认证、模型与可选回退路由
`anyy setup channel`	配置消息平台
`anyy update --check`	检查是否存在新的原生发行版本

下一步

从 Dashboard了解可视化控制界面。
在配置模型中增加或切换服务商。
通过 TUI 手册掌握终端命令和快捷键。
按消息平台说明连接聊天渠道。
在功能总览中了解 Anyy 的其他能力。
需要精确参数时查阅 CLI 命令参考。

这份指南适合谁​

最快路径​

1. 安装 Anyy​

macOS 与 Linux​

2. 选择服务商​

配置和凭据保存在哪里​

3. 完成第一次对话​

发送第一条消息​

4. 确认会话可恢复​

5. 试用关键功能​

Dashboard 中的常用入口​

终端界面​

单次命令​

6. 按需增加下一层能力​

常见故障​

恢复工具箱​

命令速查​

下一步​