Mac 小白版 · 逐步安装

先安装 Agent-OS，再进系统里配置 DeepSeek

这份教程只让你一次复制一个命令。不要把多个步骤一起粘贴到终端里，按顺序做完即可。

从第 1 步开始查看安装脚本仓库

先看懂流程

第一段：安装 用公开安装脚本自动准备 Node.js、Bun、Agent-OS CLI 和终端 PATH。

第二段：打开 重新打开终端，运行 agent-os，进入 Agent-OS 的 CLI 页面。

第三段：配置模型 进入系统后输入 /model，在页面里配置 DeepSeek API Key。

重点：安装脚本不会询问 DeepSeek API Key。DeepSeek 是进入 Agent-OS 后，在 /model 里配置。

安装步骤

打开终端

打开 Mac 自带的「终端」App，也可以用 iTerm2。看到类似 % 或 $ 的输入光标即可。

下载安装脚本

复制下面这一条命令，粘贴到终端，然后按回车。

curl -fsSL https://raw.githubusercontent.com/VIONWILLIAMS/agent-os-install/main/install-macos-cli.sh -o install-agent-os-mac.sh

运行安装脚本

等上一步结束后，再复制下面这一条命令，粘贴到终端并按回车。

bash install-agent-os-mac.sh

安装过程中可能会下载 Node.js、Bun 和 Agent-OS。中途不要关闭终端。

重启终端

安装完成后，关闭当前终端窗口，再重新打开一个新的终端窗口。这一步是为了让 PATH 生效。

验证 Agent-OS 版本

复制下面这一条命令，粘贴到新终端里，然后按回车。

agent-os --version

成功时应该看到 1.0.0-alpha.17 (Agent-OS) 或更新版本。

进入 Agent-OS 并配置 DeepSeek

打开 Agent-OS

复制下面这一条命令，粘贴到终端并按回车。

agent-os

如果第一次打开时出现主题选择、安全确认，按页面提示选完即可。

进入模型配置

如果已经进入 Agent-OS 的 CLI 页面，复制下面这一条，在 Agent-OS 里输入，然后按回车。

/model

如果页面已经自动显示「Paste your AI key to get started」，说明已经进入模型配置，可以直接粘贴 DeepSeek API Key。

选择或添加 DeepSeek

在 /model 页面里选择 DeepSeek，或选择添加新 Provider，然后粘贴你的 DeepSeek API Key。

这一步在哪里做？

在 Agent-OS 界面里做，不是在安装脚本里做。安装脚本只负责把 CLI 装好。

验证是否能正常使用

发一句测试消息

在 Agent-OS 里复制下面这一句，然后按回车。

回复 pong

如果 Agent-OS 能正常回答，说明安装和 DeepSeek 配置都完成了。

查看帮助

想看 Agent-OS 有哪些命令，可以复制下面这一条。

agent-os --help

使用短命令

安装脚本也会创建短命令 aos。想验证短命令，可以复制下面这一条。

aos --help

以后升级

以后想升级 Agent-OS，只复制下面这一条命令。不要使用 @latest，当前安装线使用 @alpha。

npm install -g @vionwilliams/agent-os@alpha

升级完成后，再单独复制版本检查命令：

agent-os --version

常见问题

输入 `agent-os` 提示 command not found

先关闭终端，重新打开一个新窗口再试。如果不想重启终端，可以按自己的 shell 复制其中一条。

source ~/.zshrc

source ~/.bash_profile

npm 报 EACCES 或 root-owned cache

重新下载并运行最新版安装脚本。下面两条命令要分开复制，先复制第一条，结束后再复制第二条。

curl -fsSL https://raw.githubusercontent.com/VIONWILLIAMS/agent-os-install/main/install-macos-cli.sh -o install-agent-os-mac.sh