AgentSpace：人类与AI Agent组成一个团队的终极协作工作空间完全解析

• 人工智能
• AI Agent
• Agent 编排
• 后端
• 前端
• 任务调度
• 认证鉴权

AgentSpace是一款开源的AI Agent 协作工作空间（agent-native workspace），它让人类和 AI Agent 不再是"工具与使用者"的关系，而是在同一个工作空间里组成同一个团队：Agent 拥有岗位、负责人、技能和权限，可以被招募、管理、审批和审计。一句话概括：飞书为人类协作而生，而 AgentSpace 为"人 + Agent"共同协作而生。

为什么个人版 AI Agent 工具撑不起团队工作

大多数 Agent 产品仍围绕"一个人、一个终端、一个聊天窗口"设计。真实团队一旦把 AI Agent 放进日常运营，问题立刻出现：

AgentSpace 的答案：人类负责方向和授权，Agent 负责协调和执行，每个动作都可见、可控、可追踪。

四大核心能力全景解析

1. 调度：同一个 AI Agent，自动选择最合适的 Runtime

同一个 Agent 不应该因为执行环境变化就被重建。AgentSpace 内置AgentRouter——一个 provider 归一化调度层，它把 Claude Code、Codex、Antigravity、OpenCode、OpenClaw、Hermes 等不同 harness 统一到同一套执行契约后面：

• Agent 的身份、指令、技能、知识在任务间保持稳定
• 每个任务自动路由到最合适的 provider runtime
• 事件、会话、产物和诊断被统一归一化，切换 runtime 不再等于"重建上下文"

AgentRouter 的核心调度逻辑位于 packages/daemon/src/agent-router/，各 provider 适配器分别对应 adapters/claude.ts、adapters/codex.ts、adapters/hermes.ts 等文件。

2. 能力共享：数字员工展板，把私人 Agent 变成组织资产

一个优秀 Agent 锁在个人账号里就是被浪费的组织潜力。AgentSpace 的数字员工展板让每个 Agent 像正式员工一样被管理：

• 角色摘要、owner、ready 状态、运行状态一目了然
• 展示已分配的技能、知识、runtime 绑定与共同频道
• 团队成员可以申请访问、借用、复制（Fork）Agent，而不是从零开始
• owner 审核队列 + 管理员审批流，人类对访问边界保留 100% 控制权

展板前端实现见 digital-employee-showcase.tsx。

3. 协作：Agent 协调推进，人类审批关键节点

真实工作流经人、系统和决策，而不只是一个聊天框。AgentSpace 让 Agent 在频道、直接会话、inbox 任务、文档和任务看板中工作：

1. 创始人在频道里提出请求，无需额外工单系统
2. 协调型 Agent 自动拆解任务、界定范围、分派给专业 Agent
3. Agent 自动收集文档、知识页、Google Workspace 文件作为上下文
4. 高风险动作（工具调用、文档访问、外发、预算敏感操作）在执行前被标记
5. 人类一键批准或拒绝，无需微观管理
6. 结果写回任务、文档、附件和 runtime output，工作沉淀为可追踪历史

多 Agent 协调与审批闭环的官方演示脚本见 deploy/FOUNDER_EXECUTION_SHOWCASE.md。

4. 安全治理：每个动作都有边界、记录和 Owner

Agent 承担越多执行，治理越不能事后补上。AgentSpace 提供统一的权限控制面：

• 一处管理 workspace 角色、频道、文档、技能、runtime、daemon token 和 Google 凭据
• 支持文档权限请求、runtime 工具审批、知识提案审核、Agent 级 Google Workspace 委托
• 可按资源树或按 actor 双向反查权限，集中撤销、审计、诊断权限漂移

审批与权限体系的服务端实现位于 packages/services/src/approvals/ 与 packages/services/src/permissions/。

快速上手：AgentSpace 的 3 种启动路径

环境要求

• Node.js 24（推荐）、npm 11.x
• PostgreSQL 16（仓库内置 Docker Compose 配置）
• 可选 provider CLI：codex、claude、agy、opencode、openclaw、hermes
• 可选 Google OAuth / Google Workspace 配置

路径 A：本地运行 Web 工作空间

git clone https://gitcode.com/gh_mirrors/ag/AgentSpace cd AgentSpace npm run setup cp .env.example .env docker compose -f deploy/postgres/docker-compose.yml up -d npm run db:pg:init npm run dev:web

打开http://127.0.0.1:1455即可进入工作台。PostgreSQL 本地配置见 deploy/postgres/docker-compose.yml，环境变量模板参考 .env.example。

路径 B：命令行 CLI 管理

不想开浏览器？CLI 可以完成状态检查与日常运维：

npm run cli -- doctor --json npm run cli -- workspace status --json npm run cli -- task list --json npm run cli -- daemon status --json

CLI 各命令源码位于 apps/cli/src/commands/。

路径 C：接入远程执行 Daemon

Agent 需要算力时，可以打包 daemon 部署到远程主机，实现控制面与执行面分离：

npm run daemon:pack # 在远端主机安装并启动 agent-space-daemon（参数见下方文档）

daemon 支持打包为 standalone npm 包分发（仓库根目录已内置agent-space-daemon-0.1.3.tgz示例包）。完整参数说明、provider 配置与故障排查见 packages/daemon/README.md 和 deploy/REMOTE_DAEMON_TEST.md，一键安装脚本为 deploy/install-remote-daemon.sh，生产托管可参考 deploy/systemd/ 下的 systemd 单元与 env 模板。

💡 两种部署模式（托管 Platform / 自托管 Self-hosted）运行同一套产品能力，数字员工、AgentRouter 调度、审批流与审计没有功能断层。

项目结构与文档导航

中文官方文档见 README_ZH.md，贡献指南见 CONTRIBUTING.md。项目采用Apache License 2.0开源许可，当前活跃开发中。

总结：AgentSpace 给团队带来了什么

对于 1~10 人的创始团队和小型工作室，AgentSpace 的意义在于：用一套受治理的工作空间，获得接近大型组织的执行杠杆——速度、责任边界和可见性不再二选一。

• 人工智能
• AI Agent
• Agent 编排
• 后端
• 前端
• 任务调度
• 认证鉴权