Agent

如果你已经在使用 Claude Code、Codex 等 AI 编程工具，HiFox Agent 不是另一套模型或编程工具。它把一套稳定的工作方式保存下来，再通过电脑上的 Claude Code、Codex 等运行时（Runtime）执行任务。

例如，你可以创建一个“前端修复 Agent”，配置它负责的范围、开始工作前要检查什么、修改后要运行哪些测试、使用哪个代码库和 Runtime。团队之后只需要把合适的任务指派给它，不必每次重新解释整套工作方式。

理解 Agent，需要先区分四个概念：

任务：这一次要完成什么，包含目标、上下文、评论和验收要求。
Agent：应该如何工作，保存职责、指令、Skill、代码库和运行设置。
Runtime：实际执行工作的 AI 编程工具或执行入口，例如 Claude Code、Codex。
电脑：Runtime 真正运行的机器，提供代码、凭据、工作目录、网络和计算资源。

一次任务的执行链路大致如下：

任务被指派给 Agent
  → HiFox 组合任务上下文和 Agent 配置
  → 派发到 Agent 选择的电脑
  → 电脑上的本地服务启动 Runtime（例如 Claude Code、Codex）
  → Runtime 读取代码、修改文件并运行命令
  → 进展、阻塞和结果写回 HiFox 任务

HiFox Agent 和小队列表

本页重点介绍如何设计、创建和管理 Agent。完整的电脑连接和 Runtime 状态见电脑，完整执行过程见 Agent 如何执行任务。

系统提供的助手

除了你自己创建的 Agent，HiFox 还会提供两类内置助手。它们不是从「创建 Agent」表单建出来的，也不会出现在普通 Agent 列表里。

HiFox 助手：每个人在每个组织里有一个。它出现在侧栏「我的任务」下方，第一次打开时自动创建。没有设置页，名称和指令由系统管理，只支持直接对话。Runtime 在对话输入区选择，不属于任何空间。
飞书任务助手：每个空间一个。从飞书集成页选择 Runtime，再扫码绑定飞书机器人。它只在飞书里工作，不能在站内私聊或 @。飞书集成页是查看、编辑和解绑的入口。它会处理该空间的任务，因此会出现在它创建或评论过的任务活动里。

把鼠标移到普通 Agent 的头像上，悬停卡片里可以选择打开设置。内置助手没有这项入口。

什么时候创建 Agent？

当一类工作具有稳定的职责或工作方式时，适合创建专门的 Agent。例如：

前端 Agent：处理 UI 修复、组件开发和前端测试；
测试 Agent：分析失败用例、补充测试并整理复现步骤；
Review Agent：按团队标准检查代码质量、安全风险和测试覆盖；
文档 Agent：维护产品文档、术语和发布说明；
项目助理 Agent：拆解任务、总结进度并识别阻塞。

不要急着创建一个“什么都能做”的 Agent。职责越明确，团队越容易知道该把什么任务指派给它，它也越容易使用一致的方法完成工作。

如果要求只针对一次工作，直接写进任务；如果是一套会被多个 Agent 复用的流程，更适合整理成 Skill。

内容	应该放在哪里
本次任务的目标、范围和验收标准	任务描述或评论
某个 Agent 长期遵循的职责和工作边界	Agent 指令
多个 Agent 可以复用的流程或规范	Skill
实际使用的工具和默认模型	Runtime、自定义参数，或电脑上的工具配置

Agent 包含哪些配置？

Agent 本身不是电脑，也不是代码仓库。它是一组“如何工作、在哪里工作”的配置，通常包括：

配置	作用
名称和描述	帮助团队判断这个 Agent 适合处理什么工作。
指令	定义职责、工作步骤、边界、检查方式和输出要求。
所属空间和可见性	决定 Agent 可以在哪些任务中被找到和使用。
电脑和 Runtime	决定工作在哪台电脑上、通过哪个工具执行。
Skill	提供可复用的流程、规范和专业知识。
Git 仓库	指定 Agent 处理代码任务时使用的仓库。
环境变量、密钥和启动参数	为 Runtime 和任务命令提供必要配置。
任务运行设置	控制工作目录、最大并发和单任务运行时长。

模型由 Runtime 决定。Agent 跟随所选 Runtime 的默认模型，不承诺也不展示具体模型名。需要更换模型时，可在 Agent 或 Runtime 的自定义参数里指定，例如「指定模型：模型名」；OpenClaw 不会用 --model 选择模型。也可以继续修改 Runtime 或电脑上的工具配置。Agent 页面没有单独的模型下拉选项。

Agent 类型和空间用途

创建 Agent 时可以选择工作类型：

代码开发：适合需要代码库、工作目录和开发工具的任务；
日常办公：适合调研、整理、写作和其他不需要代码环境的工作；
设计创意：目前仍不可用，开放时间以产品界面为准。

首次在空间中创建 Agent 时，HiFox 会根据空间用途给出默认类型：软件开发空间默认选择代码开发，其他空间用途默认选择日常办公。你手动选择过类型后，后续创建流程会记住你的选择。

日常办公模式不会继续校验或提交代码开发相关的代码库、路径等配置；需要处理代码时，请切换回代码开发并提供有效的代码来源或工作目录。Agent 类型不代表额外权限，成员仍需具备对应空间、电脑、Runtime 和资源的访问权限。

创建一个可用的 Agent

一般流程是：

确定 Agent 的稳定职责；
填写便于团队判断用途的名称和描述；
编写 Agent 指令；
选择所属空间和可见性；
选择可用的电脑和 Runtime；
按需绑定 Skill、Git 仓库和运行配置；
使用一个低风险任务验证它能否正常执行和回写结果。

名称和描述写给团队看

名称应该让人一眼知道 Agent 的主要用途。描述则说明适合指派什么工作，以及不适合处理什么。

例如：

负责处理前端 UI 小修复和组件测试补齐。适合范围明确、可以独立验证的前端任务；涉及整体视觉方案或跨端架构调整时需要先由成员确认。

相比“开发 Agent”或“万能 Agent”，这样的描述更容易帮助团队正确选择处理人。

指令写给 Agent 执行

指令会进入 Agent 的任务上下文，适合描述长期稳定的工作方式：

它负责什么、不负责什么；
接到任务后先阅读或检查什么；
什么情况下需要先提问；
修改代码后运行哪些检查；
遇到失败或缺少权限时如何处理；
最终需要汇报哪些内容；
哪些操作不能自行执行。

例如：

你负责处理小型前端修复。开始前先阅读任务描述、最近评论和相关代码；只有不同理解会明显改变实现时才提问。修改范围保持最小，完成后运行最接近的组件测试，并在任务中说明改动内容、验证结果和仍存在的风险。不要隐藏失败的检查。

不要把某个单次任务的具体需求长期写进 Agent 指令，否则后续不相关任务也会携带这些内容。

用低风险任务验证

创建完成后，建议先指派一个只读任务：

请读取项目 README，确认项目使用的主要语言、包管理器和最接近的测试命令。不要修改文件，并注明支持每项结论的文件。

这个任务可以同时验证：

Agent 是否选择了正确的电脑和 Runtime；
Claude Code、Codex 等工具能否真正启动；
Agent 是否获得了预期的任务上下文和指令；
电脑能否访问代码库和工作目录；
Agent 能否把结果写回任务。

确认只读任务成功后，再让 Agent 修改代码或执行更复杂的命令。

电脑、Runtime 和模型

Agent 的执行目标由电脑和 Runtime 共同决定：

电脑提供操作系统、代码、凭据、目录、网络和计算资源；
Runtime 决定实际启动 Claude Code、Codex 或其他执行入口；
Agent 保存对这个 Runtime 的使用方式和任务配置。

电脑在线并不等于 Agent 一定能工作。在线只表示本地服务心跳正常；只有 Agent 所选 Runtime 处于可用状态，任务才具备启动条件。

创建或重新绑定 Agent 时，可以选择离线电脑上的离线 Runtime，方便先完成配置。尚未检测到、检测失败、已卸载或不在可选范围内的 Runtime 仍不可选。本机电脑会排在前面，并带「（本机）」标记。默认优先选在线 Runtime；没有在线项时，会回退到本机离线 Runtime。创建 Agent 不会自动启动电脑。导入或「立即运行」等入口仍只提供在线 Runtime。

选择 Runtime 时，列表里可能看得到某台电脑上的 Runtime，但若该 Runtime 所在电脑不允许用于当前 Agent 所选空间，该项会置灰，不能提交。提示会说明当前空间不可用，并带上空间名称。这和电脑离线不是同一回事：离线是连接状态，空间不可用是这台电脑对当前空间的使用范围。

一台电脑可以服务多个 Agent，但任务能否立即运行还会受到电脑并发、Agent 并发和工作目录占用情况影响。连接、状态和排障方法见电脑。

把任务指派给 Agent

在任务的处理人中选择 Agent 后，它会成为这个任务的执行者。

如果任务处于 Todo、In Progress 或其他可执行状态，HiFox 会尝试开始运行；
如果任务仍在 Backlog，Agent 会等待，不会立即开始；
如果电脑、Runtime、并发或工作目录暂时不可用，任务会排队；
后续要让 Agent 继续处理时，在任务评论里 @ 该 Agent，或直接进入任务上的对话。普通评论不会自动触发处理人 Agent。

也可以从 Agent 详情选择指派任务。在这里可以搜索该 Agent 所属空间中的已有任务，或直接在同一空间新建任务。这个入口只提供当前成员有权访问、尚未归档的同空间任务；跨空间、已归档或无权访问的任务不会出现在选择中。只有未归档、非小队专属且当前具备执行条件的 Agent 才能用于此入口。

通过任一入口指派时，Agent 会作为执行处理人加入任务，不会移除已有的人员处理人。点击指派任务也不代表任务一定立即开始：任务状态、电脑和 Runtime 可用性、并发以及工作目录仍会决定任务是启动还是排队。

执行过程中，任务会保留 Agent 的进展、阻塞、失败、结果和执行记录。团队不需要到某个人的本地终端里寻找过程和结论。

任务状态和 Agent 工作状态是两套概念。任务可以处于 In Progress，而 Agent 运行可能仍在排队；Agent 也可能已经完成一轮运行，但任务仍需要成员 review 或继续推进。完整状态和触发方式见 Agent 如何执行任务。

代码库和凭据

Agent 可以绑定 Git 仓库：

如果 Agent 绑定了仓库，优先使用 Agent 自己的仓库配置；
如果 Agent 没有绑定仓库，通常使用任务所属空间配置的 Git 仓库；
如果两边都没有配置，Agent 可能能读取任务，但无法进入代码目录完成代码工作。

真正执行 clone、git、gh、构建和测试命令的是 Agent 所在的电脑。电脑上的 Git 凭据、目录权限和必要工具必须可用。

不要把密码、Token、API Key 或私钥写进 Agent 指令、任务描述或评论。完整配置方式见连接代码库。

Skill：复用团队工作方法

Skill 用来保存可以被多个任务或 Agent 复用的流程、规范和专业知识。例如：

代码 review 清单；
发布检查步骤；
文档写作规范；
前端组件测试流程；
故障排查方法。

如果同一套要求会反复出现，把它整理成 Skill 比复制进多个 Agent 指令更容易维护。Agent 可以绑定多个 Skill，但不要添加大量无关内容，否则会增加上下文噪音。

Skill 的创建、导入和维护方式见 Skill。

任务运行设置

任务运行设置控制 Agent 如何使用电脑资源，主要包括：

任务工作目录：选择创建临时目录，或指定电脑上的已有目录；
最大并发运行任务数：Agent 同时可以处理多少个任务；
单任务最大运行时长：避免任务无限运行；
环境变量和启动参数：为 Runtime 或任务命令提供额外配置。

环境变量和自定义参数在 Agent 设置或 Runtime 详情中以表格添加、修改和删除；未配置时用「添加」。环境变量值默认隐藏，需要时再显示。已检测 Runtime 的执行程序、默认附加参数和默认环境变量会提供基础启动配置。Agent 为同一个启动参数或环境变量设置的值优先于 Runtime 默认值。

选择工作目录

模式	适合场景	并行特点
创建临时目录	Git 仓库任务、常规开发和安全并行	每个任务使用独立目录，通常通过 Git worktree 隔离修改。
指定已有目录	超大代码库、已有本地环境或特殊依赖	复用电脑上的目录。Git 工作区可选择隔离 worktree；原地运行时同一目录通常一次一个。

一般建议优先选择 创建临时目录。指定已有目录可以复用电脑上的已有目录；如果路径是 Git 工作区，还可以选择是否为每个任务创建隔离 worktree。完整说明见 Agent 工作目录。

默认并发规则：

指定已有目录：默认并发等于已配置的目录数；
创建临时目录：默认并发是电脑并发的 50%。

可以手动调整并发，但不要盲目调高。更高并发会增加 CPU、内存、磁盘、网络和 Runtime provider 的压力；如果手动值高于指定目录数量，界面也会提示写入冲突风险。

所属空间和可见性

每个 Agent 必须且只属于一个空间，只能用于该空间中的任务。

Agent 有两种可见性：

私有：只有 Agent 所有者可以看到和使用；
共享：所属空间中有访问权限的成员可以看到和使用。

可见性会影响成员能否找到 Agent、把任务指派给它、与它对话，或在任务评论里 @ 它。任务只能选择与自己位于同一空间、且当前成员有权使用的 Agent。

部分 Agent 可能被设置为小队专属 Agent。这类 Agent 只能在所属小队中被调用，不会出现在普通 Agent 列表、处理人选择器或独立对话入口。详见小队专属 Agent。

Agent 状态和排障

Agent 列表和详情页会展示可用性、当前工作负载和最近运行。常见状态包括：

空闲：当前没有任务在运行；
工作中：正在执行任务；
受阻：运行遇到需要处理的问题；
错误：最近运行出现错误；
离线：电脑或 Runtime 当前不可用。

Agent 状态和单次运行状态不同。即使 Agent 在线，任务也可能因为并发已满或指定目录被占用而排队。

如果 Agent 没有开始，建议按以下顺序检查：

任务是否仍在 Backlog；
Agent 所选电脑是否在线；
所选 Runtime 是否可用；
代码库、凭据和工作目录是否可访问；
电脑或 Agent 并发是否已满；
执行记录中是否有明确错误或等待原因。

与 Agent 对话

除了把任务指派给 Agent，也可以直接与 Agent 对话。

对话适合临时询问、调研、解释和讨论方案；任务适合需要跟踪、指派、执行和验收的工作。如果对话中形成了明确行动项，建议创建任务并把结论带过去。

独立对话、任务中的 Agent 对话和任务评论并不是同一套记录。具体区别和使用方式见与 Agent 对话。

归档和恢复 Agent

不再使用的 Agent 可以归档。归档后：

不能再被指派新任务或在评论中提及；
正在执行的工作会被取消；
历史任务、评论和执行记录仍会保留。

归档前，先确认是否仍有运行或排队任务，以及自动化或小队是否仍依赖它。

需要恢复时，进入 Agent 列表的更多菜单，打开已归档 Agent，找到目标 Agent 后选择恢复。恢复后，它会重新出现在列表中；当空间权限、电脑和 Runtime 条件满足时，可以再次使用。

最佳实践

按稳定职责创建：让一个 Agent 对应一类清晰工作，而不是覆盖所有场景。
描述写用途，指令写方法：描述帮助人选择，指令帮助 Agent 执行。
单次要求放任务：不要让临时需求长期污染 Agent 指令。
复用流程放 Skill：让团队维护一份规范，而不是复制多份 prompt。
先用只读任务验证：确认 Runtime、仓库、权限和结果回写都正常后，再执行写操作。
逐步提高并发：先确认电脑和 Runtime 能稳定处理当前负载。

常见问题

为什么 Agent 页面没有模型选择？

Agent 跟随所选 Runtime 的默认模型。HiFox 当前无法可靠读取 Runtime 实际使用的模型，因此不会在 Agent 上承诺或展示具体模型名，也不提供思考深度选项。需要更换模型时，可在 Agent 或 Runtime 的自定义参数里指定，例如「指定模型：模型名」。OpenClaw 不会用 --model 选择模型。也可以继续修改 Runtime 或电脑上的工具配置。

Agent 没有开始运行怎么办？

先确认任务不在 Backlog，再检查电脑是否在线、Runtime 是否可用、代码库和凭据是否正确，以及并发或工作目录是否已满。执行记录通常会显示具体等待或失败原因。

什么时候应该新建一个 Agent？

当一类工作有稳定职责、固定指令、特定代码库或固定 Skill 时，适合创建专门 Agent。只针对一次任务的要求应直接写在任务中。

Agent 和小队有什么区别？

Agent 是单个 AI 队友，适合职责清楚、可以独立完成的工作；小队由队长 Agent 协调多个 Agent 或成员，适合需要拆解、分工和汇总的复杂任务。详见小队。

为什么某个 Agent 在列表里找不到？

它可能已归档、属于其他空间、当前成员没有使用权限，或者被设置为小队专属 Agent。小队专属 Agent 只能在对应小队中使用。HiFox 助手和飞书任务助手也不会出现在普通 Agent 列表里。

#Agent

#系统提供的助手

#什么时候创建 Agent？

#Agent 包含哪些配置？

#Agent 类型和空间用途

#创建一个可用的 Agent

#名称和描述写给团队看

#指令写给 Agent 执行

#用低风险任务验证

#电脑、Runtime 和模型

#把任务指派给 Agent

#代码库和凭据

#Skill：复用团队工作方法

#任务运行设置

#选择工作目录

#所属空间和可见性

#Agent 状态和排障

#与 Agent 对话

#归档和恢复 Agent

#最佳实践

#常见问题

#为什么 Agent 页面没有模型选择？

#Agent 没有开始运行怎么办？

#什么时候应该新建一个 Agent？

#Agent 和小队有什么区别？

#为什么某个 Agent 在列表里找不到？