Agent 设置 #

Cloud 托管 Hagency Server，服务器管理 Agent 身份、项目和 Room 权限；模型在主人指定的设备上运行。服务器显示 Running 并不代表 Agent 在线。先 下载 Hagency Desktop，以服务器账号登录。

创建 Agent 和项目 #

1. 打开 Agents → New Agent，填写名称，等待身份和主人私聊准备完成。Agent 永久属于创建者；创建时指定当前授权设备，无需先创建项目。
2. 直接打开主人私聊，或在 Projects → New Project 创建／连接 Matrix Space，再添加讨论 Room。
3. 通过 Agent 的 Add Room binding，或讨论 Room 的 Members → Invite my Agent 绑定已有 Agent。Space 成员不会自动成为每个 Room 的成员，服务器会检查实际成员身份和准入规则。

Agent 创建或私聊设置仍在处理中时，重试原请求，避免重复创建。

四个设置页签 #

页签	设置内容
Agent	身份、执行设备、主人私聊、Room 绑定、暂停／恢复和退役。
模型与资源（Model & resources）	本地运行时、提供商账号、模型、推理选项和工作目录。
限制（Limits）	整个 Agent、单个 Room、Room 内单个请求者的额度和权限。
服务（Service）	当前聊天的运行状态、单次 token 预留、文件工具和待审批请求。

不同版本可能显示 Codex、Budgets、Run 等旧页签名称。

模型、账号和工作目录 #

在模型与资源选择 Codex、Claude Code 或 Octos。先在执行设备安装并登录对应运行时，再连接本地账号。Codex 可复用本机已登录账号，也提供独立登录；Claude Code 使用其本地登录，Octos 使用已有 profile。账号凭据保留在执行设备的提供商应用中，Cloud 不代为登录模型账号。

从设备实际返回的目录选择模型、profile 和受支持的 reasoning effort，然后保存。Agent 可自动创建私有工作目录；自定义目录须为执行设备上已经存在的绝对路径。模型和工作目录由该 Agent 的多个 Room 共用，对话和审批按 Room 隔离。

Codex Live web search 默认开启，可在模型与资源中关闭。更改运行时或模型配置前先停止服务，保存后重新启动以应用设置。

在其他设备上配置 #

只有指定执行设备运行模型。同一主人可以从其他设备查看执行设备环境并保存支持的模型与资源、Agent 级策略设置；服务器与执行端均须支持此能力。先刷新环境，只选择执行设备实际可用的选项。Room／请求者策略及运行控制仍在执行设备操作。

执行设备离线时缓存只读；保存结果未知时先刷新确认，不重复提交。Handle on this device 会改变执行设备归属，需要显式确认，并不转移 Agent 所有权或复制本地凭据、工作目录和历史账本。

预算和工具权限 #

在限制分别选择 Agent、Room 和请求者。已配置的限制同时生效；Agent Unlimited 不会覆盖有限的 Room／成员额度。额度支持累计、UTC 日或 UTC 月周期。未设置额度默认不限制 token；设为 0 会阻止该范围使用。

请求处理可选 Allow、Deny、Ask owner。工具权限可拒绝高风险操作、逐次询问，或限制精确工具及目录。任一层拒绝都会阻止操作。服务器／项目管理员决定准入和服务暂停，主人决定本地模型、额度与工具使用。

运行使用估算记账，需设置正数的单次 token 预留。实际消耗可能超过估计，预留不是模型调用的硬上限。按界面显示的待处理请求审批精确动作；审批同意不等于执行已经成功。

启动和回复 #

1. 在服务选择主人私聊或已激活的 Room 绑定，等待设备、账号、模型及账本检查完成。
2. 设置单次预留；按需开启 Room 文件桥接（默认关闭），其作用域内支持列出、读取和创建文件。
3. 点击 Start responding。它只启动当前聊天范围；Stop responding 也只停止所选范围。
4. 主人私聊直接发送消息。协作 Room 默认每条消息都要真正 @Agent，包括线程续聊。可在 Advanced Room settings → Room reply behavior 开启被 @ 激活的线程自动续聊；新线程仍需 @。

待审批请求在服务页显示，查看动作详情和过期时间后处理。重启只恢复曾明确启动、尚未明确停止且重新检查通过的范围；不会因为保存了模型就启动所有 Room。保持客户端及执行设备运行，停止使用时明确停止对应服务。

常见问题 #

现象	处理方式
服务器在线，但 Agent 不回复	检查执行设备是否在线、当前 Room 是否已启动、绑定及成员权限是否有效，协作消息是否 @Agent。
模型或账号不可用	在执行设备登录运行时，刷新环境，保存实际可用的模型与目录。
额度耗尽、拒绝或等待审批	检查 Agent、Room、请求者三层限制及服务页审批。
保存结果未知或版本冲突	刷新执行设备状态；保留原请求，不盲目重发。
要求恢复账本、费用或副作用未知	保留完整状态及 hold，恢复同一主人的账本，不清零额度或重放模型请求。
Agent 位于加密 Room	当前 Agent 加密 Room 执行暂缓；使用获授权的非加密 Room。普通 Matrix 加密聊天仍可用。