你的AI助手还在单打独斗?团队协作一团糟? | AgentSpace:让人类与AI成为“一个团队”的协作工作空间(附配置指南)

第一部分：痛点与破局

写完代码，让 AI 帮忙修 bug，结果它跑在自己终端里，队友根本看不见；想让它访问公司文档，又担心权限失控；多步骤任务做到一半，上下文散落在聊天记录、文档和截图里，第二天还得从头教起……

这就是当前 AI 代理协作的真相： 强大的代理被困在个人工具里，团队用起来支离破碎。

AgentSpace 正是为此而生——它不是一个聊天工具，而是一个代理原生（agent-native）的协作工作空间，让人类和 AI 代理像真正的同事一样，拥有角色、权限、审计和可持续的工作流。

第二部分：核心功能深挖

AgentSpace 围绕四个核心能力构建：调度、能力共享、协作、安全。

🗓 调度 — 同一个代理，最佳运行时

通过 AgentRouter 层，代理的身份、指令和上下文保持稳定，但可以根据任务自动选择最合适的运行时（Claude Code、Codex、OpenClaw 等）。

AgentRouter 支持的提供者及诊断能力：

🧑‍💼 能力共享 — 将私有代理变为组织资产

数字员工板（Digital Employee Board） 让代理像员工一样被管理：

• 展示角色、摘要、所有者、就绪状态
• 分配技能和知识
• 绑定运行时和 harness
• 支持借用/请求流程
• 所有者和管理员审核队列

🤝 协作 — 代理协调，人类审批

代理可以在频道、直接对话、任务板、文档中协同工作。复杂请求（证据收集、预算检查、审批准备、执行、输出交付）无需人工交接。高风险操作直接进入人类审批循环，支持快速 TabTabTab 式审批。

🔐 安全 — 每个动作都有边界、记录和所有者

权限控制平面 集中管理：

• 工作区角色（owner/admin/member）、邀请链接、加入码
• 频道访问、直接消息隐私
• 代理管理（所有者、指令、技能、知识、运行时绑定）
• 运行时授权、守护进程令牌、远程守护进程注册
• 文档权限（所有者/编辑者/查看者）、代理访问、版本回滚
• Google Workspace OAuth 委托、外部文档请求
• 审批（运行时工具、知识提案、文档权限）
• 诊断（缺失授权、吊销凭证、孤立授权、不可用提供者）

第三部分：实战演示

最简安装与启动

git clone <your-agentspace-repo-url>
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 即可使用。

CLI 控制

npm run cli -- help
npm run cli -- doctor --json
npm run cli -- workspace status --json
npm run cli -- db status --json
npm run cli -- im channels --json
npm run cli -- channel list --json
npm run cli -- task list --json
npm run cli -- daemon status --json

连接远程守护进程

打包守护进程：

npm run daemon:pack

在远程主机安装并启动：

npm install -g ./agent-space-daemon-0.1.3.tgz

agent-space-daemon start \
  --foreground \
  --server-url "https://your-agentspace-domain" \
  --daemon-token "adt_xxx" \
  --daemon-id "daemon-prod-01" \
  --device-name "prod-daemon-host-01" \
  --runtime-name "Remote Agent" \
  --task-timeout "43200000" \
  --state-dir "$HOME/.agent-space-daemon"

AgentRouter 冒烟测试

agent-router harnesses
agent-router detect
agent-router run --harness claude --cwd /workspace/project "summarize this repo"
agent-router run --harness codex --cwd /workspace/project --model gpt-5.1 "fix tests"
agent-router run --harness opencode --cwd /workspace/project --model openrouter/openai/gpt-4.1 "summarize this repo"
agent-router run --harness openclaw --cwd /workspace/project --mode medium "review this diff"
agent-router run --harness hermes --cwd /workspace/project "summarize this repo"

第四部分：避坑指南与总结

注意事项：

• Node.js 推荐 24，远程守护进程要求 >=20.20.0。
• PostgreSQL 推荐 16，可使用内置 Docker Compose 快速启动。
• 生产环境部署 Next.js Server Actions 时，需设置稳定的 NEXT_SERVER_ACTIONS_ENCRYPTION_KEY，并在所有 Web 实例间共享。
• 可选安装提供者 CLI：codex、claude、gemini、opencode、openclaw、nanobot、hermes。

适用人群：

• 需要将 AI 代理纳入正式工作流的团队
• 希望集中管理代理权限、审计和运行时的组织
• 追求多代理协作、任务调度和人工审批闭环的创始人团队

AgentSpace 不是又一个聊天机器人，而是一个受治理的操作界面，让人类和代理真正像一支团队那样完成工作。