安装 Anda

Anda Bot 可以通过发布版安装，也可以直接从仓库源码运行。发布版适合日常使用；源码运行适合贡献代码、调试或试验新功能。

安装最新发布版

Anda 桌面端

大多数用户建议从 Anda 桌面端开始：它提供聊天窗口、工作台和托盘。请从 latest release 下载：

macOS Apple Silicon：Anda-mac-arm64.dmg
Windows x64：Anda-win-x64.exe
Homebrew：brew install --cask ldclabs/tap/anda-desktop（会同时安装 anda formula）

新的 macOS 命令行和桌面发布包仅提供 Apple Silicon 版本。Intel Mac 用户可从源码构建。

Anda 桌面端会沿用已有的 anda 安装；如果没有，就把内置的 anda 和精选技能安装到安装脚本使用的位置（macOS 为 ~/.local/bin，Windows 为 %LOCALAPPDATA%\Programs\AndaBot）。之后桌面端、终端和 Chrome 扩展共用同一个 runtime 和 daemon。模型连接引导中可以选择是否登录时启动 Anda。桌面端托盘取代了已停用的 Anda Bot 菜单栏启动器，桌面端会将其移除。

尚未配置模型时，会自动打开“连接模型”引导。使用 ChatGPT 登录并确认模型，或从内置 config.yaml 的预置模型中选择一项、填写 API Key。引导会等待所选模型加载完成。选择“稍后设置”后会保留草稿和连接提示，也可以从设置 → 通用 → 连接模型重新打开。已有配置会直接沿用。

仅安装命令行

通过 Homebrew：

brew install ldclabs/tap/anda

macOS 和 Linux 通过安装脚本：

curl -fsSL https://raw.githubusercontent.com/ldclabs/anda-bot/main/scripts/install.sh | sh

如果机器上也装过 Homebrew 版本，请打开新终端后确认 command -v anda 指向 ~/.local/bin/anda 或你的 ANDA_INSTALL_DIR；否则较旧的 Homebrew 二进制可能会遮蔽安装脚本安装的新版本。

Windows 通过 PowerShell：

irm https://raw.githubusercontent.com/ldclabs/anda-bot/main/scripts/install.ps1 | iex

安装脚本会安装 anda 和精选技能，将其加入 PATH，用 anda autostart install 注册 daemon 登录自启并重启 daemon；重新运行安装脚本也会移除已停用的启动器。Windows 上的登录项运行 anda start，会短暂出现一个控制台窗口。PowerShell 安装器可以用 -NoAutostart 或 -NoStart 退出默认行为；shell 安装器可以设置 ANDA_NO_AUTOSTART=1 或 ANDA_NO_START=1。

安装完成后打开一个新的终端，并运行：

anda

准备模型 API key

至少需要一个模型 provider API key。Anda 桌面端用户可以在设置 → Agent 配置中填写；CLI 用户可以先用环境变量启动：

DEEPSEEK_API_KEY=YOUR_API_KEY anda

Windows PowerShell：

$env:DEEPSEEK_API_KEY="YOUR_API_KEY"; anda

也可以把 key 写进 ~/.anda/config.yaml，供后续会话复用。config.yaml 中的 api_key 优先级高于环境变量。

首次启动

第一次运行时，Anda 会创建本地运行目录和 ~/.anda/config.yaml。如果配置还不完整，终端 UI 会列出缺失字段。

打开 ~/.anda/config.yaml。
填好 model provider 的 family、model、api_base，以及 api_key 或环境变量。
保存文件。
在 Anda 桌面端或浏览器侧边栏点击刷新模型，或运行 anda models reload。

最小模型配置示例：

model:
  active: "deepseek-v4-pro"
  providers:
    - family: anthropic
      model: "deepseek-v4-pro"
      api_base: "https://api.deepseek.com/anthropic"
      api_key: "YOUR_API_KEY" # 设置 DEEPSEEK_API_KEY 时可留空
      labels: ["pro", "brain"]
      disabled: false

brain 标签会让记忆大脑优先使用这个 provider。没有 provider 带这个标签时，记忆任务会使用当前 active model。

image、audio、video 标签指定理解对应附件的 provider。当前 active model 也带有 image 标签时，消息中 5 MiB 以内的 PNG、JPEG、GIF 和 WebP 图片会直接随消息发给它，在该消息开启的任务内有效；不能读图的模型不要加这个标签。

从源码运行

如果你想直接从仓库运行：

git clone https://github.com/ldclabs/anda-bot.git
cd anda-bot
cargo run -p anda_bot --

使用独立 home 目录可以隔离身份、项目或测试数据：

anda --home /path/to/.anda

源码运行时等价命令是：

cargo run -p anda_bot -- --home /path/to/.anda

更新

通过安装脚本安装的发布版可以这样更新：

anda update

Homebrew 安装通过 brew upgrade anda 更新。Anda 桌面端托盘或设置中的检查更新会检查 anda 和桌面客户端两个组件。正式发布版的桌面更新内置同一版本的 anda，因此当 anda 由桌面端安装时，它就是完整的更新：只下载一次、确认一次，服务排空任务后由重启的客户端用新的 anda 启动。使用 Homebrew 或在设置中指定的 anda 时，runtime 安装会等待活动任务结束，桌面更新只重启客户端。发现或已下载的新版本也会显示在侧边栏底部的下载更新或重启以完成更新。Windows 正式版在签名之前也这样更新：客户端会按该版本的校验和验证下载内容。未签名的 macOS 版本需要手动安装新的桌面安装包。

可以这样管理后台 daemon：

anda status
anda start
anda stop
anda restart
anda autostart status

安装最新发布版​

Anda 桌面端​

仅安装命令行​

准备模型 API key​

首次启动​

从源码运行​

更新​