agency-orchestrator

环境要求

• Node.js 环境（用于 npm 全局安装 CLI）
• 使用 claude-code / gemini-cli / codex-cli 等 provider 时，本机需已安装并登录对应 CLI
• 使用 deepseek / openai 等 API key 类 provider 时，需准备好对应密钥
• Docker 部署需 amd64 或 arm64 架构，并已安装 Docker

安装与启动步骤

1. 1安装 CLI

   全局安装 agency-orchestrator，装好后终端可用 ao 命令。若只用桌面客户端则无需安装，桌面端自带引擎与 Node，双击即用。

   npm install -g agency-orchestrator

   复制

2. 2启动网页 Studio

   本地跑一条 ao web，即可在浏览器里勾选专家、运行工作流、查看产物并实时介入，全中英双语界面。

   ao web

   复制

3. 3运行内置工作流

   用内置的「一人公司全员大会」模板跑第一轮，通过 -i 传入 idea 变量。工作流文件位于仓库 workflows 目录下。

   ao run workflows/一人公司全员大会.yaml -i idea="用AI帮小商家做短视频"

   复制

4. 4让整队人接新活

   用 --team 指定已保存的团队，AO 会把可选角色锁定为该团队成员并重新设计步骤后运行，不漏人也不幻觉出别的角色。

   ao run --team 技术博客组 "写一篇关于 RISC-V 架构的科普"

   复制

5. 5查看团队信息

   team list 列出已保存的团队，team show 查看某个团队的阵容构成。团队以纯 YAML 存在 ~/.ao/teams 下，可与 Studio 共用。

   ao team list
   ao team show 技术博客组

   复制

6. 6Docker 部署

   适合 Docker / NAS 场景，映射 8088 端口并挂载数据卷，密钥在页面「供应商」里配置，存进挂载卷后重启不丢。

   docker run -d -p 8088:8088 -v ao-data:/data ghcr.io/jnmetacode/agency-orchestrator:latest

   复制

关键配置

如何确认成功

Docker 方式打开 http://主机IP:8088 能看到 Studio 页面；本地执行 ao web 后能在浏览器中勾选专家并运行工作流。

常见问题

注意事项

• 选择 --provider claude-code（或 gemini-cli / codex-cli）时必须本机已安装并登录对应 CLI，否则请改用 API key 类 provider。
• 不设 AO_HOME 时运行产物会写到当前目录，建议先固定全局目录以免文件散落。
• Docker 部署的密钥在页面「供应商」中配置，会存进挂载卷，重启不会丢失。
• README 未给出 ao web 的默认端口，本地访问地址以启动后终端提示为准。