Docker一键部署PhyAgentOS：最快1分钟上线你的具身Agent的完整指南

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-core

PhyAgentOS是一个支持递归自改进（RSI）的具身 Agent 操作系统：Agent 负责规划高层工具调用，Forge 网关执行物理动作，证据采集器捕获执行前后的图像证据，任务级验证器判断目标是否真正达成。本文带你用 Docker 完成 PhyAgentOS 的一键部署，无需手动配置 Python 或 Node.js 环境，最快 1 分钟即可让具身 Agent 跑起来 🚀

为什么选择 Docker 部署 PhyAgentOS？

很多新手听到"具身 Agent"会想到复杂的 Python 依赖、机器人仿真环境，其实启动它的通用 Agent 只需要一个 Docker：

镜像基础为ghcr.io/astral-sh/uv:python3.12-bookworm-slim，体积仅约几百 MB，CPU 环境即可运行。构建逻辑定义在 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.json（macOS/Linux 可执行vi ~/.PhyAgentOS/config.json），在providers段填入你的 LLM 密钥，例如：

{ "providers": { "openrouter": { "apiKey": "YOUR_API_KEY" } } }

然后启动交互式对话：

./scripts/install.sh chat

到这里，你的具身 Agent 已经上线，可以直接和 Agent 对话了 🎉

install.sh 完整命令清单

长驻网关模式：让 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。

常见部署问题速查（排错清单）

⚠️ 注意：标准镜像为 CPU 版，不包含 Dora CLI、托管 Forge Skill Runtime 及 GPU/CUDA 依赖，适合通用 Agent 与消息总线场景；如需机器人仿真等 GPU 能力，需另行构建定制镜像（详见 Docker 部署指南）。

核心文件导航

• 一键安装脚本：scripts/install.sh
• 镜像构建定义：Dockerfile
• Compose 编排配置：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