Documentation / API Usage

API Usage

How to install, configure, operate, and troubleshoot PhyAgentOS. From zero to running robots — in 8 progressive sections.

Reading Guide

New user? Start with Getting Started (5-minute MVP). Want to dive deeper? Follow the order below — each section builds on the previous one.

Install, onboard, launch simulation Watchdog + Agent. First closed loop in 5 minutes.

All paos commands and script entry points with full flags and examples.

kilo.json reference: providers, agents, tools, embodiments, channels, gateway.

All 11 Markdown protocol files: format, semantics, who reads/writes, lifecycle.

External plugin installation, built-in driver list, ACTION.md direct debugging.

Multi-robot coordination: topology, configuration, task distribution, debugging.

SESSIONS.md → WatchdogSupervisor → SkillRuntime → Target → Artifacts pipeline.

Common problems by component: install, Watchdog, Agent, Fleet, Runtime. Quick fix tables.

I want to…	Go to
Run the system for the first time	Getting Started
Look up a specific CLI command	CLI Reference
Set up my API key or provider	Configuration → providers
Understand what ENVIRONMENT.md contains	Workspace & Protocols → ENVIRONMENT.md
Install the ReKep real-robot plugin	Plugins & Drivers → ReKep
Set up multi-robot coordination	Fleet Mode
Run a Runtime session smoke test	Runtime Session
Fix Watchdog not starting or acting	Troubleshooting → Watchdog