TeamClaw Setup
Guide users to the smallest working TeamClaw installation first, then expand.
Default workflow
- 1. Prefer the guided installer first:
CODEBLOCK0
- 2. Use manual plugin install only when the user wants direct control:
CODEBLOCK1
If the user explicitly wants the ClawHub package path, use:
CODEBLOCK2
- 3. Recommend
controller + localRoles for the first successful run unless the user explicitly needs distributed or on-demand workers immediately.
- 4. Read
references/install-modes.md before generating config. Pick the smallest matching topology and reuse the provided snippets.
- 5. Read
references/validation-checklist.md before finishing. Always give the user:
- one health-check command
- one UI URL
- one tiny smoke-test requirement
- one or two likely failure checks for the chosen topology
Installation guidance
- - Start with a single machine and
localRoles. - Keep TeamClaw
taskTimeoutMs large for real model runs. - Keep OpenClaw
agents.defaults.timeoutSeconds at least as large as the TeamClaw task window in seconds. - For
docker or kubernetes, require a reachable workerProvisioningControllerUrl. - For
docker, mention the published runtime image:
CODEBLOCK3
What to produce
When helping a user, produce:
- 1. the exact install command
- the minimal config snippet for the chosen topology
- the startup command
- the validation commands and first smoke-test task
Do not push users into distributed, Docker, or Kubernetes first unless they asked for it or already have the surrounding infrastructure ready.
技能名称: teamclaw-setup
详细描述:
TeamClaw 安装指南
首先引导用户完成最小的可用 TeamClaw 安装，然后逐步扩展。
默认工作流程
- 1. 优先使用引导式安装程序：
bash
npx -y @teamclaws/teamclaw install
- 2. 仅当用户希望直接控制时，才使用手动插件安装：
bash
openclaw plugins install @teamclaws/teamclaw
如果用户明确需要使用 ClawHub 包路径，请使用：
bash
openclaw plugins install clawhub:@teamclaws/teamclaw
- 3. 推荐首次成功运行时使用 controller + localRoles，除非用户明确需要立即使用分布式或按需工作节点。
- 4. 在生成配置前，请阅读 references/install-modes.md。选择最小的匹配拓扑结构，并复用提供的代码片段。
- 5. 在完成前，请阅读 references/validation-checklist.md。始终向用户提供：
- 一条健康检查命令
- 一个 UI 地址
- 一个简单的冒烟测试要求
- 针对所选拓扑结构的一到两个可能的故障检查
安装指导
- - 从单台机器和 localRoles 开始。
- 对于实际模型运行，将 TeamClaw 的 taskTimeoutMs 设置得较大。
- 将 OpenClaw 的 agents.defaults.timeoutSeconds 至少设置为与 TeamClaw 任务窗口（以秒为单位）相同的值。
- 对于 docker 或 kubernetes，需要提供一个可访问的 workerProvisioningControllerUrl。
- 对于 docker，请提及已发布的运行时镜像：
text
ghcr.io/topcheer/teamclaw-openclaw:latest
需要提供的内容
在帮助用户时，请提供：
- 1. 确切的安装命令
- 所选拓扑结构的最小配置代码片段
- 启动命令
- 验证命令和首次冒烟测试任务
除非用户主动要求或已具备相关基础设施，否则不要首先引导用户使用分布式、Docker 或 Kubernetes。
