核心用法
TeamClaw 是一个多功能 AI Agent 服务子系统，采用 LangGraph 构建对话引擎，通过 OASIS 论坛 实现多专家并行协作。系统包含四大核心模块：对话 Agent（流式/非流式）、OASIS 多专家引擎、APScheduler 定时调度、Bark 移动推送，以及完整的 Web UI 前端。
部署流程：
1. bash selfskill/scripts/run.sh setup 安装依赖
2. configure --init 初始化配置，批量设置 LLM_API_KEY、BASE_URL、MODEL
3. add-user 创建账户（如 system:MyPass123）
4. start 启动四服务（51200 Agent、51201 调度、51202 OASIS、51209 Web UI）
OASIS 四模式运行策略（两组正交开关）：
- 讨论模式（discussion=true）：论坛式观点碰撞，适合决策评审
- 执行模式（discussion=false）：工作流式交付，产出代码/清单/SOP
- 同步/脱离（detach）：前者阻塞等待结果，后者返回 topic_id 后台运行
四类智能体：
| 类型 | 格式 | 特性 |
|------|------|------|
| Direct LLM | `tag#temp#N` | 无状态单次调用，快速 |
| Oasis Session | `tag#oasis#id` | OASIS 管理，跨轮记忆 |
| Regular Agent | `Title#session_id` | 接入现有 bot session |
| External API | `tag#ext#id` | 调用外部 OpenAI 兼容服务（含 OpenClaw） |
OpenClaw 集成：配置 OPENCLAW_API_URL、OPENCLAW_SESSIONS_FILE 后，前端面板可自动拖入 OpenClaw 专家，model 格式为 agent:<agent_name>:<session_name>。
显著优点
- 架构灵活：可完全独立运行，也可作为 OpenClaw 的子系统被编排
- 可视化编排：Web UI 支持拖拽构建多 Agent 工作流，YAML 与画布实时互转
- 模式丰富：4 种运行组合覆盖从快速讨论到长时后台任务的全场景
- 智能体多样：支持无状态 LLM、有状态会话、外部 API 三类引擎，OpenClaw 深度集成
- 非侵入部署：
selfskill/scripts/隔离，不影响原项目 - 实时可观测：SSE 流式输出、独立 OASIS Server API、完整话题追踪
潜在缺点与局限性
- 端口占用多：默认占用 51200-51209 等多个端口，需规划防火墙
- 配置复杂度高：LLM、TTS、OpenClaw、Bark 等多源配置，新手易遗漏
OPENCLAW_SESSIONS_FILE等关键路径 - 依赖外部 LLM：核心功能强绑定外部 API（DeepSeek/OpenAI 等），无离线模型支持说明
- 安全令牌管理：
INTERNAL_TOKEN自动生成但需防泄露，多服务间认证逻辑较复杂 - 中文文档与社区：GitHub 仓库以英文为主，中文用户需依赖文档翻译
适合人群
- OpenClaw 用户：需要扩展多 Agent 协作能力，将 TeamClaw 作为子系统调用
- 自动化工程师：需要构建复杂工作流、定时任务、多专家评审流水线
- 产品经理/研究者：需要可视化方式模拟专家讨论、收集多维度观点
- 进阶 AI 开发者：熟悉 Docker/Shell、能接受 YAML 配置与 API 级调试
常规风险
| 风险类别 | 说明 |
|---------|------|
| **Token 泄露** | `INTERNAL_TOKEN` 与 LLM_API_KEY 若写入日志或代码仓库，可导致未授权调用 |
| **端口暴露** | Web UI（51209）与 OASIS（51202）若直接暴露公网，需配合 Cloudflare Tunnel 或鉴权加固 |
| **成本失控** | OASIS 多专家并行+多轮讨论，Token 消耗随 `max_rounds` 与专家数指数增长 |
| **数据持久化** | 讨论记录、session 存储于本地 SQLite（`data/` 目录），需定期备份 |
| **外部依赖失效** | DeepSeek/OpenAI 服务异常将直接导致系统不可用 |