OpenGoat

Build AI Autonomous Organizations of OpenClaw Agents.

OpenGoat allows you to build herarchical organizations of AI agents that coordinate work across multiple tools, including Claude Code, Codex, Cursor, GitHub Copilot CLI, Lovable, and more.

---

Installation

# Install OpenClaw and OpenGoat
npm i -g openclaw opengoat

# Setup OpenClaw
openclaw onboard

# Start OpenGoat
opengoat start

That's it. Open http://127.0.0.1:19123 and start messaging Goat, your AI co-founder.

Alternative: Docker

docker build -t opengoat:latest .
docker run --rm -p 19123:19123 -v opengoat-data:/data/opengoat opengoat:latest

Then open http://127.0.0.1:19123.

From Source (without global npm install)

pnpm install
pnpm build
./bin/opengoat --help

Documentation (Mintlify)

cd docs
mintlify dev

Use mintlify broken-links before publishing documentation changes.

When agents execute commands from their OpenGoat workspace, use the workspace shim:

sh ./opengoat agent list
sh ./opengoat agent info goat

CLI Quick Start (Optional)

Runtime: Node >=20.11.

npm i -g openclaw opengoat
openclaw onboard
opengoat init
opengoat project create https://myproject.com
opengoat agent --message "Set up a CTO and two engineers for this project."

Run the production UI server from the CLI:

opengoat start

Restart a running UI server:

opengoat restart

Use an external OpenClaw gateway:

opengoat onboard --external \
  --gateway-url ws://host:18789 \
  --gateway-token <token> \
  --non-interactive

Typical Workflows

Create a project CMO

opengoat project create https://myproject.com

This provisions a project-scoped CMO agent workspace at ~/.opengoat/projects/<project>/cmo, installs the agent-browser skill by default, and bootstraps the CMO with an internal first-run prompt sequence derived from the project URL.

Build the organization

opengoat agent create "CTO" --manager --reports-to goat
opengoat agent create "Engineer" --individual --reports-to cto --skill coding
opengoat agent create "Designer" --individual --reports-to cto
opengoat agent list

Run role-based work

opengoat agent cto --message "Plan the Q2 engineering roadmap and split it into streams."
opengoat agent engineer --message "Implement the auth middleware for this sprint."

Configure the default entry agent

# Persist in config.json
opengoat agent set-default stone

# Or override at runtime
export OPENGOAT_DEFAULT_AGENT=stone

You can also set defaultAgent directly in ~/.opengoat/config.json.

Keep session continuity

opengoat agent goat \
  --session saaslib-planning \
  --message "Create a release checklist for v1.2"

opengoat agent goat \
  --session saaslib-planning \
  --message "Now draft the changelog"

Operate with tasks

opengoat task create --title "Ship auth" --description "Finish middleware + tests" --owner cto --assign engineer
opengoat task list --as engineer
opengoat task status <task-id> doing

Skills

opengoat skill install og-boards --from /path/to/skill
opengoat skill install jira-tools --from /path/to/skill
opengoat skill list --agent goat

Role skill behavior:

• OpenClaw agents use role-specific board skills:
  • managers: og-board-manager
  • individuals: og-board-individual
• Non-OpenClaw agents use one board skill: og-boards

License

MIT