PhyAgentOS配置完全手册Provider、Forge与验证模式的12个关键字段详解【免费下载链接】PhyAgentOS-corePhyAgentOS is a Recursive Self-Improving (RSI) physical agent operating system that enables agents to recursively self-improve through agentic workflows.项目地址: https://gitcode.com/gh_mirrors/ph/PhyAgentOS-corePhyAgentOS 是一个支持递归自我改进RSI的物理智能体操作系统它的核心配置文件只有一个~/.PhyAgentOS/config.json。运行paos onboard会自动创建该文件之后你只需围绕Provider模型接入、Forge机器人执行、验证模式verification三块来配置就能让智能体可靠地驱动仿真器或真实机器人。本手册精选 12 个最常用的字段按填一次就能跑通的顺序讲解每个字段都给出默认值、取值约束和配置位置。完整字段表见官方文档 Forge 配置参考。 配置文件同时支持camelCase和snake_case两种键名写法如requestTimeoutS/request_timeout_spaos onboard生成的是 camelCase 格式。一、Provider 与模型先让智能体开口说话模型配置在agents.defaults下Provider 凭据在providers下。支持 18 种 ProviderOpenRouter、Anthropic、OpenAI、DeepSeek、Ollama、vLLM、Azure OpenAI 等定义见 providers/registry.py。1.agents.defaults.model— 模型选择器类型string默认anthropic/claude-opus-4-5位置schema.py L236写法约定为前缀/模型名如openrouter/openai/gpt-4o-mini前缀用于匹配 Provider不写前缀时系统会按关键词自动匹配已配置 API Key 的 Provider。2.agents.defaults.provider— Provider 显式指定类型string默认auto位置schema.py L237-L239设为auto时按模型前缀和关键词自动匹配填具体名称如openrouter则强制走该 Provider。验证服务和进化服务的模型默认继承此配置减少重复填写。3.providers.名称.apiKey— API 密钥类型string默认空位置schema.py L382每个 Provider 均可选填三个字段apiKey、apiBase自定义端点、extraHeaders自定义请求头例如 AiHubMix 的APP-Code。最小可用示例{ agents: { defaults: { model: openrouter/openai/gpt-4o-mini, provider: openrouter } }, providers: { openrouter: { apiKey: YOUR_API_KEY } } }二、Forge机器人执行链路的超时与轮询Forge 是 PhyAgentOS 统一的机器人执行接口所有 Query / Action / Session 调用都经过它。配置位于顶层forge字段schema.py L289-L295。4.forge.requestTimeoutS— HTTP 请求超时类型number默认10.0必须大于 0单次 HTTP 请求如调用/tools的超时秒数。网络较慢的部署可适当调大。5.forge.pollIntervalS— 异步任务轮询间隔类型number默认0.5范围0.1 ~ 5.0秒Action 和 Session 是异步的提交后返回 invocation IDAgent 按此间隔轮询/invocations对账状态。间隔越小反馈越快但不要低于 0.1 秒以免打满 Gateway。6.forge.executionTimeoutS— 任务执行超时类型number默认300.0必须大于 0Agent 侧的任务时限指导值超过它不代表机器人动作已停止只是提示 Agent 该收尾或重新规划。三、Forge 证据采集验证的摄像头验证不是空口判词forge.evidence定义了任务执行前后自动采集的图像/状态证据schema.py L278-L286。7.forge.evidence.requiredImageSources— 全局图像源类型string 数组默认[]例如填[front]表示默认使用前相机。任务级evidence_policy.required_sources非空时会优先覆盖此全局值两者都空则自动探测运行时就绪的源。8.forge.evidence.captureTimeoutS— 前置快照等待类型number默认5.0秒执行绑定 Action之前等待before 快照到达的最长时间。传感器帧率低时可调大超过时限仍会尽力继续不会阻塞动作提交。9.forge.evidence.postCaptureTimeoutS— 后置快照等待类型number默认5.0秒Gateway 报告终止状态后继续等待更高序号帧的最长时间用于拿到after 快照。与上一个字段配合共同决定证据的完整程度。四、验证服务语义裁判与恢复预算验证配置位于agents.verification控制独立验证子服务的启停、模型与预算schema.py L329-L347。10.agents.verification.serviceEnabled— 验证服务开关类型boolean默认true非off模式的 AgentTask 必须依赖该服务若服务不可用此类任务会被直接拒绝。只想跑通执行链路做冒烟测试时关掉它并只使用mode: off任务即可。11.agents.verification.evidenceRetention— 证据保留策略类型枚举all | failed | none默认none控制验证结束后证据文件图像、状态快照的保留范围failed只留失败任务的证据最常用于长期部署兼顾磁盘空间与事后复盘。12.agents.verification.maxReplansPerEpisode— 最大重规划次数类型integer默认2非负单个 AgentTask 内允许追加的 PlanRevision 上限。只有recovery模式会用到验证不通过时规划器在同一任务上追加一版有界的修正计划而不是盲目重试未知效果的动作。五、四种验证模式怎么选任务契约中的mode决定裁判的严格程度行为矩阵来自 04-forge-configuration-reference.md模式目标/标准必填最终结果失败时行为off否跟随 Gateway 执行状态永不恢复audit是保留执行得出的终态仅记录裁判结论永不恢复enforce是裁判说了算缺证据、结论不明一律判败fail-closed永不恢复recovery是同enforce但replan_required触发恢复规划器追加 PlanRevision新手建议路径先用off打通链路 → 再上audit观察裁判输出 → 稳定后切recovery获得自动纠错能力。六、两份推荐配置直接抄作业冒烟测试最短配置{ forge: { requestTimeoutS: 10, executionTimeoutS: 300 }, agents: { verification: { serviceEnabled: false }, evolution: { enabled: false } } }长期验证部署生产推荐{ agents: { verification: { serviceEnabled: true, evidenceRetention: failed, maxReplansPerEpisode: 2, maxVerifierCallsPerRun: 50, replanTimeoutS: 120 } }, forge: { requestTimeoutS: 10, pollIntervalS: 0.5, executionTimeoutS: 300, evidence: { requiredImageSources: [front] } } }改完配置后用paos status检查本地模型与 Provider 是否生效再用forge_tool_context工具查看实时 ToolSpec、就绪状态和帧配置确认 Gateway 侧一切正常。七、常见配置陷阱清单❌写了顶层runtime字段1.0.0 已移除旧 Runtime 配置会直接报错提示删除。❌在forge里写enabled/baseUrl/apiVersion这些旧执行选择器同样被拒绝——Gateway 地址只能来自显式启动的 Skill 清单配置文件中不出现机器人地址。❌端口冲突servicePort默认8100本机跑多个 PAOS 实例时请改为不同端口。✅环境变量的优先级PAOS_RESOURCE_REGISTRY_URL会覆盖resourceRegistry.url适合在 CI 中注入私有制品库。小结PhyAgentOS 的配置哲学是一个文件、三个关注点Provider 管模型接入、Forge 管执行与证据、verification 管裁判与恢复。按本文顺序把 12 个字段过一遍配合paos onboard生成的初始文件即可从off模式平稳过渡到带自动恢复的recovery模式。更多字段细节可查阅 用户手册 与 开发者手册。【免费下载链接】PhyAgentOS-corePhyAgentOS is a Recursive Self-Improving (RSI) physical agent operating system that enables agents to recursively self-improve through agentic workflows.项目地址: https://gitcode.com/gh_mirrors/ph/PhyAgentOS-core创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 PhyAgentOS配置完全手册：Provider、Forge与验证模式的12个关键字段详解
PhyAgentOS配置完全手册Provider、Forge与验证模式的12个关键字段详解【免费下载链接】PhyAgentOS-corePhyAgentOS is a Recursive Self-Improving (RSI) physical agent operating system that enables agents to recursively self-improve through agentic workflows.项目地址: https://gitcode.com/gh_mirrors/ph/PhyAgentOS-corePhyAgentOS 是一个支持递归自我改进RSI的物理智能体操作系统它的核心配置文件只有一个~/.PhyAgentOS/config.json。运行paos onboard会自动创建该文件之后你只需围绕Provider模型接入、Forge机器人执行、验证模式verification三块来配置就能让智能体可靠地驱动仿真器或真实机器人。本手册精选 12 个最常用的字段按填一次就能跑通的顺序讲解每个字段都给出默认值、取值约束和配置位置。完整字段表见官方文档 Forge 配置参考。 配置文件同时支持camelCase和snake_case两种键名写法如requestTimeoutS/request_timeout_spaos onboard生成的是 camelCase 格式。一、Provider 与模型先让智能体开口说话模型配置在agents.defaults下Provider 凭据在providers下。支持 18 种 ProviderOpenRouter、Anthropic、OpenAI、DeepSeek、Ollama、vLLM、Azure OpenAI 等定义见 providers/registry.py。1.agents.defaults.model— 模型选择器类型string默认anthropic/claude-opus-4-5位置schema.py L236写法约定为前缀/模型名如openrouter/openai/gpt-4o-mini前缀用于匹配 Provider不写前缀时系统会按关键词自动匹配已配置 API Key 的 Provider。2.agents.defaults.provider— Provider 显式指定类型string默认auto位置schema.py L237-L239设为auto时按模型前缀和关键词自动匹配填具体名称如openrouter则强制走该 Provider。验证服务和进化服务的模型默认继承此配置减少重复填写。3.providers.名称.apiKey— API 密钥类型string默认空位置schema.py L382每个 Provider 均可选填三个字段apiKey、apiBase自定义端点、extraHeaders自定义请求头例如 AiHubMix 的APP-Code。最小可用示例{ agents: { defaults: { model: openrouter/openai/gpt-4o-mini, provider: openrouter } }, providers: { openrouter: { apiKey: YOUR_API_KEY } } }二、Forge机器人执行链路的超时与轮询Forge 是 PhyAgentOS 统一的机器人执行接口所有 Query / Action / Session 调用都经过它。配置位于顶层forge字段schema.py L289-L295。4.forge.requestTimeoutS— HTTP 请求超时类型number默认10.0必须大于 0单次 HTTP 请求如调用/tools的超时秒数。网络较慢的部署可适当调大。5.forge.pollIntervalS— 异步任务轮询间隔类型number默认0.5范围0.1 ~ 5.0秒Action 和 Session 是异步的提交后返回 invocation IDAgent 按此间隔轮询/invocations对账状态。间隔越小反馈越快但不要低于 0.1 秒以免打满 Gateway。6.forge.executionTimeoutS— 任务执行超时类型number默认300.0必须大于 0Agent 侧的任务时限指导值超过它不代表机器人动作已停止只是提示 Agent 该收尾或重新规划。三、Forge 证据采集验证的摄像头验证不是空口判词forge.evidence定义了任务执行前后自动采集的图像/状态证据schema.py L278-L286。7.forge.evidence.requiredImageSources— 全局图像源类型string 数组默认[]例如填[front]表示默认使用前相机。任务级evidence_policy.required_sources非空时会优先覆盖此全局值两者都空则自动探测运行时就绪的源。8.forge.evidence.captureTimeoutS— 前置快照等待类型number默认5.0秒执行绑定 Action之前等待before 快照到达的最长时间。传感器帧率低时可调大超过时限仍会尽力继续不会阻塞动作提交。9.forge.evidence.postCaptureTimeoutS— 后置快照等待类型number默认5.0秒Gateway 报告终止状态后继续等待更高序号帧的最长时间用于拿到after 快照。与上一个字段配合共同决定证据的完整程度。四、验证服务语义裁判与恢复预算验证配置位于agents.verification控制独立验证子服务的启停、模型与预算schema.py L329-L347。10.agents.verification.serviceEnabled— 验证服务开关类型boolean默认true非off模式的 AgentTask 必须依赖该服务若服务不可用此类任务会被直接拒绝。只想跑通执行链路做冒烟测试时关掉它并只使用mode: off任务即可。11.agents.verification.evidenceRetention— 证据保留策略类型枚举all | failed | none默认none控制验证结束后证据文件图像、状态快照的保留范围failed只留失败任务的证据最常用于长期部署兼顾磁盘空间与事后复盘。12.agents.verification.maxReplansPerEpisode— 最大重规划次数类型integer默认2非负单个 AgentTask 内允许追加的 PlanRevision 上限。只有recovery模式会用到验证不通过时规划器在同一任务上追加一版有界的修正计划而不是盲目重试未知效果的动作。五、四种验证模式怎么选任务契约中的mode决定裁判的严格程度行为矩阵来自 04-forge-configuration-reference.md模式目标/标准必填最终结果失败时行为off否跟随 Gateway 执行状态永不恢复audit是保留执行得出的终态仅记录裁判结论永不恢复enforce是裁判说了算缺证据、结论不明一律判败fail-closed永不恢复recovery是同enforce但replan_required触发恢复规划器追加 PlanRevision新手建议路径先用off打通链路 → 再上audit观察裁判输出 → 稳定后切recovery获得自动纠错能力。六、两份推荐配置直接抄作业冒烟测试最短配置{ forge: { requestTimeoutS: 10, executionTimeoutS: 300 }, agents: { verification: { serviceEnabled: false }, evolution: { enabled: false } } }长期验证部署生产推荐{ agents: { verification: { serviceEnabled: true, evidenceRetention: failed, maxReplansPerEpisode: 2, maxVerifierCallsPerRun: 50, replanTimeoutS: 120 } }, forge: { requestTimeoutS: 10, pollIntervalS: 0.5, executionTimeoutS: 300, evidence: { requiredImageSources: [front] } } }改完配置后用paos status检查本地模型与 Provider 是否生效再用forge_tool_context工具查看实时 ToolSpec、就绪状态和帧配置确认 Gateway 侧一切正常。七、常见配置陷阱清单❌写了顶层runtime字段1.0.0 已移除旧 Runtime 配置会直接报错提示删除。❌在forge里写enabled/baseUrl/apiVersion这些旧执行选择器同样被拒绝——Gateway 地址只能来自显式启动的 Skill 清单配置文件中不出现机器人地址。❌端口冲突servicePort默认8100本机跑多个 PAOS 实例时请改为不同端口。✅环境变量的优先级PAOS_RESOURCE_REGISTRY_URL会覆盖resourceRegistry.url适合在 CI 中注入私有制品库。小结PhyAgentOS 的配置哲学是一个文件、三个关注点Provider 管模型接入、Forge 管执行与证据、verification 管裁判与恢复。按本文顺序把 12 个字段过一遍配合paos onboard生成的初始文件即可从off模式平稳过渡到带自动恢复的recovery模式。更多字段细节可查阅 用户手册 与 开发者手册。【免费下载链接】PhyAgentOS-corePhyAgentOS is a Recursive Self-Improving (RSI) physical agent operating system that enables agents to recursively self-improve through agentic workflows.项目地址: https://gitcode.com/gh_mirrors/ph/PhyAgentOS-core创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考