你的第一个 Android 自动化任务。

开始之前

• 一台 Windows 或 Linux 主机（也可以是 64 位树莓派），并有与其架构匹配的 Talos 版本。
• Android 平台工具：运行 Talos 的账户必须能使用 adb，可以放在 PATH 中，或配置为 Tools:AdbPath。
• Android 模拟器，或已开启 USB 调试的手机。设有 PIN、图案或密码锁的手机需要在运行前解锁。
• 一个模型提供商的 API 密钥——Claude（Anthropic）、OpenAI、Google Gemini 或 OpenRouter——或实现 Talos 自定义提供商协议的 HTTP 端点。
• 当安装的版本提示时，需要许可证密钥或试用密钥。已授权的安装需要能够访问许可证服务器。

FFmpeg 为可选组件，用于实时屏幕串流（如果不在 PATH 中，请设置 Tools:FfmpegPath）。不需要 Appium。AI 提供商的用量与 Talos 许可证分开计费。

1. 安装 Talos、设置密码并激活

选择一个可用的安装程序。Windows 版本以托盘应用运行；Linux 的 .deb 软件包会安装一个 systemd 服务。请按照所发布软件包的说明操作，并确认其架构。

打开控制面板，通常位于 http://localhost:7700。首次启动时，请设置至少 8 个字符的面板密码；它用于保护 API、实时更新和屏幕预览。如果提示激活，再粘贴许可证密钥。还没有密钥？申请免费试用许可证，并保存屏幕上显示的密钥。

从旧版本升级？请保留数据目录。0.4.0 首次启动时会一次性升级本地数据库，如果运行历史较长，可能需要更久；任务、设置和已保存的 API 密钥都会保留。

2. 连接 Android 设备

启动模拟器，或在手机上开启 USB 调试并连接到主机，在手机上接受授权提示。然后在终端中检查连接：

adb devices

设备状态必须是 device，而不是 unauthorized 或 offline。在 Talos 中打开“设备”并检查屏幕预览。每次运行前，Talos 会唤醒屏幕并解除没有安全保护的锁屏；如果手机设有 PIN、图案或密码，请自行解锁，否则本次运行会被跳过，不会调用模型。

需要显式 ADB 连接的模拟器，必须先使用其文档中说明的地址进行连接。阅读兼容性说明。

3. 选择 AI 提供商

在“设置”中选择提供商，输入其 API 密钥，选择模型并保存。密钥保存在你的主机上，界面只显示末尾几位字符。代理会把目标、界面观察和相关截图发送给提供商；可选的阶段生成器使用同一提供商，并且只在你请求时运行。

Claude、OpenAI 和 Gemini

选择 Anthropic Claude、OpenAI 或 Google Gemini，从列表中选一个模型，或输入其他模型名称。Talos 按提供商价格估算每次调用的费用；对于列表之外的模型，会采用该提供商最贵的费率，让预算宁早勿晚地生效。

OpenRouter

输入 OpenRouter 密钥，并从实时目录中选择模型。只有支持工具调用的模型才能运行任务，不支持图像输入的模型不会收到截图。OpenRouter 会返回每次调用的实际费用，Talos 会把这笔金额计入预算。

Effort 与按任务选择模型

Effort（低、中、高或极高）在单次调用费用与细致程度之间取舍；较低的 effort 可能需要更多步骤，因此请比较已完成任务的总费用。每个任务都可以覆盖默认的模型和 effort，例如为频繁检查使用更便宜的模型，每次运行也会记录所用的模型和 effort。

自定义 HTTP 端点

选择自定义提供商并输入其 URL。Talos 会发送包含 system、tools、history、observation 以及可选 screenshot_base64 的 POST 请求，并期望返回一个工具决策。“设置”中模型指令字段的文字会追加到 system 末尾。这是 Talos 专用协议，不是可以直接套用到任意聊天 API 的设置。

最简响应格式如下：

{
  "tool": "tap",
  "args": { "element": 8 },
  "reasoning": "Open the visible form",
  "input_tokens": 0,
  "output_tokens": 0
}

元素编号必须对应当前观察。响应也可以不返回单个 tool，而是返回由工具和参数组成的 calls 列表。HTTP 408、429 和 5xx 响应会被视为临时故障。Talos 不计算自定义提供商的费用，请在你的端点处自行监控。

4. 创建一个结果可见的小任务

打开“任务”，选择“新建任务”，为它命名并选择一台已连接的设备。一台设备可以有多个任务，它们会依次运行。输入目标并选择单次模式。可以手动添加阶段，也可以让 AI 建议。

可以先使用默认限制，或调整本次运行的迭代次数、时长和估算费用。预算在每次模型响应后检查，因此最后一次调用可能超出阈值。任务的每日预算和“设置”中的全局每日预算会限制多次运行的总支出。

任务可以复制，也可以导出为 .talos-task.json 文件，在另一台手机或另一套安装中导入。文件包含任务定义，包括阶段、限制、模型和工作时间，但不包含设备和运行历史。

控制面板默认使用英语，可以切换为 Deutsch、Español、Français、简体中文或 Polski。本站截图为波兰语界面：“设备”对应 “Urządzenia”，“任务”对应 “Zadania”，“新建任务”对应 “Nowe zadanie”，“设置”对应 “Ustawienia”。

5. 启动任务并查看时间线

新任务创建后处于停止状态。在任务卡片上启动它。打开设备预览可以跟随屏幕变化，也可以用“停止”中断运行。当设备上没有正在进行的运行时，你可以点击预览、输入文字，并使用返回、主屏幕、最近使用的应用或唤醒屏幕按钮手动修正设备状态。

打开运行历史，可以查看观察、模型给出的说明、工具与参数、结果、token 用量、费用以及可用截图；本次运行的日志一键可达。Talos 为每个任务保留最近 10 次运行，每日费用汇总另行保存。在依赖结果之前，请先检查最终界面。

用连续模式重复流程

选择连续模式，并设置 10 到 86,400 秒的间隔。每个周期成功后，Talos 会保存摘要并安排下一周期。这份摘要帮助代理带着上下文继续工作。

工作时间可以把周期限制在选定的日期和时间段内，例如周一至周五 9:00–17:00，以服务器本地时间为准。在时间段之外，任务会等待，不产生运行和费用；已经开始的周期会正常结束。

临时问题——API 过载或无法访问、手机断开、屏幕锁定——最多重试四次，间隔从周期间隔逐步增加到 30 分钟。停止、达到限制、配置错误，或模型报告任务无法完成，都会结束任务。如果每日预算用完，任务则会等到第二天。

限制按周期计算，费用会累加。停止还会取消已安排的下一周期。编辑任务定义前，请先停止任务并等待正在进行的运行结束。记忆是模型生成的摘要，而不是精确的事件记录。查看周期性状态检查示例。

在任务需要关注时收到通知

在“设置 → 通知”中选择渠道：Webhook（JSON POST）、Discord、Telegram、ntfy 或通过 SMTP 发送的电子邮件。然后选择事件：任务因错误停止（包括重试用尽后）、因限制停止、每日预算用完、任务已启用时手机断开，或单次任务完成。

正在进行的重试和你自己执行的停止不会触发通知，同一任务的同一事件最多每 10 分钟发送一次。“发送测试”可以检查已保存的设置。通知内容目前只有波兰语；Webhook 负载中另有与语言无关的事件代码。

如果第一次运行不成功

Talos 中看不到设备

在运行 Talos 的账户下检查 adb devices。授权 USB 调试，并确认数据线或模拟器连接正常。Linux 服务可能以与你的终端不同的账户运行。如果 adb 不在 PATH 中，请设置 Tools:AdbPath。

代理无法进入某个界面

解锁设有 PIN 或图案的手机，检查应用权限并查看时间线。尝试更短、只有一个可见成功标准的目标。

任务因达到限制而停止

在提高限制之前，先查看记录的结果。留意重复出现的界面、不可用的选项或含糊的指令。因每日预算用完而停下的任务会在第二天继续。

预览无法串流

检查 FFmpeg 和实时预览设置。使用普通的设备预览来诊断连接。

忘记了面板密码

使用 Talos__Auth__ResetPassword=true 启动一次 Talos，在浏览器中设置新密码，然后移除该选项。面板中的“使用说明 → 面板密码”提供了 systemd 服务的具体命令。

许可证验证失败

检查你的密钥、激活名额以及与许可证服务器的连接。正在运行的安装在最后一次成功验证后，最多还能工作 72 小时，并且始终可以停止任务。

控制面板中的“诊断”页面会显示版本、adb 和 FFmpeg 状态、设备、数据目录、许可证以及最近的问题。如需帮助，请联系 Talos 开发者，附上“复制报告”中的文字和失败步骤的描述。分享任何内容前，请删除其中的私人屏幕内容和密钥。