安装

使用一行安装命令，两分钟内即可启动并运行 Tutou Agent。

快速安装

一行安装命令（Linux / macOS / WSL2）

基于 git 的安装方式，跟踪 main 分支，可立即获取最新变更：

curl -fsSL https://docs.tutoukeji.com/install.sh | bash

Windows（原生，PowerShell）

原生 Windows 无需 WSL 即可运行 Tutou——CLI、gateway、TUI 和工具均可原生运行。（原生安装与 WSL2 安装可干净共存；唯一仅限 WSL2 的功能见下方功能说明。）遇到 bug 请提交 issue。

打开 PowerShell 并运行：

iex (irm https://docs.tutoukeji.com/install.ps1)

源码安装脚本克隆仓库，再由 PM 准备 Python 3.14、Node.js、npm、ripgrep、FFmpeg 和 Python 依赖。缺少 Git 时，脚本下载经过 SHA-256 验证的 Git for Windows 到工具存储目录。它不替换系统 Git，也不再使用 MinGit 或 tutou\node 的旧布局。安装完成后，打开新终端以读取用户 PATH。

桌面软件包： MSIX/App Installer 是自包含的软件包，与源码脚本不同。它要求 Windows 11 22H2 或更新版本，首次启动无需克隆源码或编译基础运行时。打开 .appinstaller 文件安装并登记更新源。Microsoft Store 版本由商店更新。 Tutou-Setup.exe 则是下载并配置源码的引导安装程序。

macOS 的 DMG 包含应用；将它复制到 Applications 后启动。其自动更新使用包含已签名应用的 ZIP。详情见桌面指南。

Android / Termux

aarch64 Android 设备可通过 Termux 安装预发布的 APT 软件包。软件包包含 Python、Node.js 和 TUI，无需在手机上编译核心依赖。请按照 Termux 指南配置签名仓库，然后运行 pkg install tutou-agent。桌面和服务器的安装脚本不支持 Termux。

功能与安装目录

Windows 的 CLI、TUI、gateway 和桌面应用可原生运行。 Dashboard 终端使用 pywinpty/ConPTY，不再是尚未实现的 POSIX-only 功能。部分可选依赖仍受架构限制，请参阅 Windows 指南。

安装方式	代码	命令入口	默认数据目录
POSIX 源码脚本	`~/.tutou/tutou-agent/`	`~/.local/bin/tutou` 包装器	`~/.tutou/`
Windows 源码脚本	`%LOCALAPPDATA%\tutou\tutou-agent\`	`%LOCALAPPDATA%\tutou\bin\`	`%LOCALAPPDATA%\tutou\`
桌面软件包	应用包内部	包内启动器；Windows 执行别名	平台默认数据目录
Docker	`/opt/tutou/`	镜像入口和 `tutou`	挂载的 `/opt/data/`
Termux APT	`$PREFIX/lib/tutou-agent/`	`$PREFIX/bin/` 符号链接	`~/.tutou/`

TUTOU_HOME 选择数据目录。POSIX 的 --dir 单独选择源码目录。以 root 身份运行不再自动选择 /usr/local/lib 的 FHS 布局。 PM 的工具和 Python 环境代际位于独立目录，详见包管理。不要为了修复应用而删除整个数据目录。

安装后

重新加载 shell 并开始聊天：

source ~/.bashrc   # 或：source ~/.zshrc
tutou             # 开始聊天！

如需稍后重新配置单项设置，使用以下专用命令：

tutou model          # 选择 LLM 提供商和模型
tutou tools          # 配置启用的工具
tutou gateway setup  # 配置消息平台
tutou config set     # 设置单个配置项
tutou setup          # 或运行完整的设置向导一次性配置所有内容

最快路径：Nous Portal

一个订阅涵盖 300+ 个模型以及 Tool Gateway（网络搜索、图像生成、TTS、云端浏览器）。无需逐一管理各工具的密钥：

tutou setup --portal

该命令一次性完成登录、设置 Nous 为提供商并开启 Tool Gateway。

前置条件

POSIX 源码脚本需要 Git、curl、tar 和 SHA-256 工具。源码构建还可能需要编译器和系统库。 Tutou 要求 Python 3.14（>=3.14,<3.15），工具版本由 pm/lock.json 决定。自包含桌面软件包不要求用户自行编译基础依赖。

Nix 用户

如果你使用 Nix（在 NixOS、macOS 或 Linux 上），有专门的配置路径，包含 Nix flake、声明式 NixOS 模块和可选容器模式。请参阅 Nix & NixOS 配置 指南。

手动 / 开发者安装

如果你想克隆仓库并从源码安装——用于贡献代码、从特定分支运行或完全控制虚拟环境——请参阅贡献指南中的开发环境配置章节。

非 Sudo / 系统服务用户安装

以目标服务用户运行源码安装脚本。由管理员预先安装构建所需工具和 Chromium 的系统库。当前脚本不运行 Playwright 的 --with-deps，也不提供按发行版选择的 sudo 回退。

安装后，将 $HOME/.local/bin 加入服务用户的 PATH，并运行 tutou doctor。请使用脚本生成的包装器，不要硬编码 venv/bin/tutou。 Linux 用户服务需要在注销后继续运行时，由管理员为该用户启用 lingering。详见消息 Gateway。

故障排查

问题	解决方案
`tutou: command not found`	重新加载 shell（`source ~/.bashrc`）或检查 PATH
`API key not set`	运行 `tutou model` 配置提供商，或 `tutou config set OPENROUTER_API_KEY your_key`
更新后配置丢失	运行 `tutou config check`，然后运行 `tutou config migrate`

如需更多诊断信息，运行 tutou doctor——它会告诉你确切缺少什么以及如何修复。

安装方式自动检测

Tutou 会自动检测安装方式（git 安装程序、Docker 或 NixOS），tutou update 会打印对应路径的更新命令。无需设置任何环境变量——检测基于安装目录结构（~/.tutou/tutou-agent/ 检出、Docker 镜像标记或 Nix store 路径）。tutou doctor 也会在其环境摘要中显示检测到的安装方式。

快速安装​

一行安装命令（Linux / macOS / WSL2）​

Windows（原生，PowerShell）​

Android / Termux​

功能与安装目录​

安装后​

前置条件​

手动 / 开发者安装​

非 Sudo / 系统服务用户安装​

故障排查​

安装方式自动检测​