Docker一键部署PhyAgentOS最快1分钟上线你的具身Agent的完整指南【免费下载链接】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的具身 Agent 操作系统Agent 负责规划高层工具调用Forge 网关执行物理动作证据采集器捕获执行前后的图像证据任务级验证器判断目标是否真正达成。本文带你用 Docker 完成 PhyAgentOS 的一键部署无需手动配置 Python 或 Node.js 环境最快 1 分钟即可让具身 Agent 跑起来 为什么选择 Docker 部署 PhyAgentOS很多新手听到具身 Agent会想到复杂的 Python 依赖、机器人仿真环境其实启动它的通用 Agent 只需要一个 Docker优势说明 零环境配置镜像内置 Python 3.12uv 管理 Node.js 20依赖由锁文件严格锁定⏱️ 分钟级上线一条install.sh脚本完成构建镜像 初始化配置 数据不随镜像丢失配置、工作区、会话历史全部持久化在宿主机~/.PhyAgentOS 长驻服务网关模式可 7×24 小时在线自动重启镜像基础为ghcr.io/astral-sh/uv:python3.12-bookworm-slim体积仅约几百 MBCPU 环境即可运行。构建逻辑定义在 Dockerfile 中它甚至会在构建时执行paos --version冒烟检查确保镜像可用后才产出。前置条件只需一个 Docker 环境开始之前只需确认两件事docker --version # Docker 20.10 docker info # 确认 Docker daemon 正常运行可选若使用 docker-compose.yml 编排常驻服务还需要 Docker Compose v2。最快 1 分钟上手三步一键部署流程以下命令均在仓库根目录执行。第 1 步克隆 PhyAgentOS 仓库git clone https://gitcode.com/gh_mirrors/ph/PhyAgentOS-core cd PhyAgentOS-core第 2 步一键构建镜像 初始化配置项目提供了一键安装脚本 scripts/install.sh一条命令同时完成构建镜像和写入默认配置两件事./scripts/install.sh脚本内部依次执行docker build与onboard成功后会在宿主机生成~/.PhyAgentOS/config.json。首次构建需要下载依赖耗时取决于网速之后重复执行会走 Docker 缓存几乎是秒级完成 ⚡第 3 步填入 API Key进入交互式 CLI用任意编辑器打开~/.PhyAgentOS/config.jsonmacOS/Linux 可执行vi ~/.PhyAgentOS/config.json在providers段填入你的 LLM 密钥例如{ providers: { openrouter: { apiKey: YOUR_API_KEY } } }然后启动交互式对话./scripts/install.sh chat到这里你的具身 Agent 已经上线可以直接和 Agent 对话了 install.sh 完整命令清单命令作用./scripts/install.sh构建镜像 初始化配置默认一键安装./scripts/install.sh build仅构建镜像./scripts/install.sh onboard仅写入默认配置./scripts/install.sh chat启动交互式 CLI./scripts/install.sh gateway启动长驻网关消息总线./scripts/install.sh status查看本地模型 / 工作区状态./scripts/install.sh logs/stop跟踪网关日志 / 停止网关容器长驻网关模式让 Agent 7×24 小时在线如果希望 Agent 常驻运行、对接 Telegram / 钉钉等消息频道并支持定时任务使用网关模式。仓库自带的 docker-compose.yml 已预配置好网关服务含资源限制与自动重启策略# 后台启动网关常驻 自动重启 docker compose up -d phyagentos-gateway # 实时查看日志 docker compose logs -f phyagentos-gateway # 进入交互式 CLI独立 profile docker compose run --rm phyagentos-cli 一个常见疑问网关为什么不需要-p端口映射因为paos gateway是消息总线服务Agent 频道 Cron Heartbeat Forge 编排只主动外连连接 LLM 提供商、各消息频道不监听任何入站端口所以容器无需暴露端口天然更安全。数据持久化卸载镜像不丢数据PhyAgentOS 的所有配置、工作区与会话历史都保存在宿主机的~/.PhyAgentOS通过卷挂载映射到容器内的/root/.PhyAgentOS宿主机 ~/.PhyAgentOS ⟷ 容器 /root/.PhyAgentOS这意味着删除镜像或容器不会丢失任何数据重新运行脚本即可完整恢复可通过环境变量PAOS_DATA_DIR自定义数据目录例如PAOS_DATA_DIR/data/paos ./scripts/install.sh gateway。常见部署问题速查排错清单现象解决方案docker: command not found未安装 Docker参考官方文档安装Cannot connect to the Docker daemon启动 Docker Desktop 或sudo systemctl start docker构建 OOM / 过慢增大 Docker 内存分配首次构建需下载依赖后续走缓存paos agent报No API key configured编辑~/.PhyAgentOS/config.json填入apiKey网关启动后立即退出多为缺 API Key./scripts/install.sh logs查看日志确认网关容器无法启动docker rm -f phyagentos-gateway后重试⚠️ 注意标准镜像为 CPU 版不包含 Dora CLI、托管 Forge Skill Runtime 及 GPU/CUDA 依赖适合通用 Agent 与消息总线场景如需机器人仿真等 GPU 能力需另行构建定制镜像详见 Docker 部署指南。核心文件导航一键安装脚本scripts/install.sh镜像构建定义DockerfileCompose 编排配置docker-compose.yml完整 Docker 部署指南docs/user_manual/DOCKER.md英文版Agent 核心源码PhyAgentOS/agent/WhatsApp 消息桥bridge/按照以上流程从克隆仓库到和 Agent 对话最快只需 1 分钟。祝你的具身 Agent 部署顺利【免费下载链接】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），仅供参考