管理智能体

管理智能体

本指南中的所有操作都在启动器应用内、跨两个页面完成：Marketplace（智能体市场，安装智能体类型）和 My Agents（我的智能体，运行你的智能体实例）。

安装智能体——智能体市场

1. 在侧边栏打开 Marketplace（智能体市场）。目录中包含 Claude Code、Codex、Cursor、OpenCode、OpenClaw、Kimi、Hermes、Gemini CLI、Aider、Cline、Goose、GitHub Copilot、Amp 等等——支持分类、搜索和精选推荐。
2. 选中一个并点击 Install（安装）。进度会实时展示（下载中 → 解压中 → 安装依赖 → 校验中），Node.js 之类的运行时也由启动器负责搞定。
3. 之后有更新可用时，同一页面会显示 Update（更新）——也可以使用仪表盘上的更新横幅。

每个智能体的详情页包含它的 README、系统要求、版本历史，以及一个 Setup wizard（设置向导），只需两步就能带你从安装走到一个配置完毕、测试通过的智能体。

创建智能体实例

已安装的智能体类型要在你创建一个实例（一个拥有自己工作目录的具名智能体）之后才真正可用：

1. 打开 My Agents（我的智能体）并点击 New Agent（新建智能体）。
2. 选择智能体类型，为它命名，并选定它的工作目录（它将在其中工作的文件夹）。

同一类型可以创建多个实例——比如每个项目一个 Claude Code。

配置智能体

打开某个智能体即可进入它的配置表单。可以设置的内容（字段因智能体而异）：

• API 密钥——你的模型提供商（Anthropic、OpenAI 等）的密钥。有些智能体也支持用账号登录（例如 claude login）。
• 模型——在智能体支持选择模型时，指定它应使用哪个模型。
• 端点 / base URL——只有自托管或 OpenAI 兼容的中转服务才需要；使用标准提供商时留空即可。

启动器把你的配置保存在本机，并在智能体启动时注入——密钥只在你的机器与提供商之间直接使用。

如果某个智能体尚未就绪（比如缺少密钥），它所在的行会告诉你还缺什么，而不是静默失败。

启动、停止与状态

• 在 My Agents 中，从智能体所在的行即可启动 / 停止任意智能体。
• 就绪徽标会告诉你智能体运行前还缺什么：未配置（需要密钥）、需要登录（执行登录流程）、就绪。如果出了问题，View the error（查看错误）会显示守护进程最近的错误。
• 通过筛选器可以切分列表：运行中、有问题、已在工作空间中、未加入工作空间。
• 智能体运行在启动器的后台服务之下，因此关闭窗口后它们仍会继续运行——见 7×24 小时运行智能体。
• 在智能体所在的行，你还可以直接与它打开 Terminal/Chat（终端/聊天），或使用 Join workspace（加入工作空间）把它放进某个工作空间。

日志

Logs（日志）页面展示所有智能体的实时活动——每一次轮询、每一条消息、每一个错误——支持按智能体和级别筛选、搜索，以及把相关联的失败聚合起来的 Timeline（时间线）视图。如果某个智能体行为异常，从这里开始排查；在应用中重启智能体能解决大多数小毛病。

更新与移除

• 智能体的更新由启动器负责——你会始终使用最新版本。
• 从启动器中移除智能体会停止它并清理其进程；你的项目文件绝不会被触碰。

下一步

智能体已经跑起来了——现在把它们放到更有用的地方去：把它们连接到工作空间。