Parallel specialist lanes

기준일: 2026-07-26
공식 기준: Parallel specialist lanes

Parallel specialist lanes 문서는 OpenClaw 공식 문서(concepts/parallel-specialist-lanes)를 한국어로 정리한 가이드입니다. Run parallel specialist agents without clogging shared model and tool capacity 명령·설정 키·코드 예시는 공식 문서를 그대로 보존하며, 해석과 절차 안내는 한국어로 제공합니다. 최종 동작은 설치된 CLI 버전과 공식 원문을 확인하세요.

핵심 요약

Run parallel specialist agents without clogging shared model and tool capacity

한국어 가이드 범위: concepts/parallel-specialist-lanes 경로의 설정·명령·제약·예시를 학습용으로 재구성합니다.

문서 구성

공식 문서의 주요 섹션은 다음과 같습니다.

• First principles
• Recommended rollout
• Phase 1: lane contracts + background heavy work
• Phase 2: priority and concurrency controls
• Phase 3: coordinator / traffic controller
• Minimal lane contract template
• Lane contract
• Owns
• Does not own
• Chat budget
• Handoff
• Tool posture
• 관련 문서

상세 내용

본문

Parallel specialist lanes let one Gateway route different chats or rooms to different agents while keeping the user experience fast. Treat parallelism as a scarce-resource design problem, not just "more agents".

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

First principles

A specialist lane only improves throughput when it reduces contention for the real bottlenecks:

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

주요 항목:

• Session locks: only one run should mutate a given session at a time.
• Global model capacity: all visible chat runs still share provider limits.
• Tool capacity: shell, browser, network, and repository work can be slower
• Context budget: long transcripts make every future turn slower and less
• Ownership ambiguity: duplicate agents doing the same job waste capacity.

Recommended rollout

이 섹션의 세부 항목은 공식 문서 Recommended rollout를 참고하세요.

Phase 1: lane contracts + background heavy work

Give every lane a written contract in its workspace and system prompt:

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

주요 항목:

• Purpose: the work this lane owns.
• Non-goals: work it should hand off instead of attempting.
• Chat budget: quick answers stay in chat; long tasks acknowledge briefly,
• Handoff rule: when another lane owns the work, say where it should go and
• Tool-risk rule: prefer the smallest tool surface that can do the job.

Phase 2: priority and concurrency controls

Tune queue and model capacity around the business value of each lane:

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

{
  agents: {
    defaults: {
      maxConcurrent: 4,
      subagents: { maxConcurrent: 8, delegationMode: "prefer" },
    },
  },
  messages: {
    queue: {
      mode: "collect",
      debounceMs: 1000,
      cap: 20,
      drop: "summarize",
    },
  },
}

Phase 3: coordinator / traffic controller

Add a small coordinator pattern once multiple lanes are active:

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

주요 항목:

• Track active lane tasks and owners.
• Detect duplicate requests across groups.
• Route handoff summaries between lanes.
• Surface only blockers, completed results, and decisions the human must make.

Minimal lane contract template

### Lane contract

이 섹션의 세부 항목은 공식 문서 [Lane contract](https://docs.openclaw.ai/concepts/parallel-specialist-lanes)를 참고하세요.

### Owns

주요 항목:

- <job this lane is responsible for>

### Does not own

주요 항목:

- <work to hand off>

### Chat budget

the work, then return the result when complete.

> 위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 `--help`를 확인하세요.

주요 항목:

- Answer quick questions directly.
- For multi-step, slow, or tool-heavy work: acknowledge briefly, spawn/background

### Handoff

If another lane owns the request, reply with:

> 위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 `--help`를 확인하세요.

주요 항목:

- target lane
- objective
- relevant context
- exact next action

### Tool posture

Use the smallest tool surface that can complete the task. Avoid broad shell or network work unless this lane explicitly owns it. ```

> 위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 `--help`를 확인하세요.

### 관련 문서

주요 항목:

- Multi-agent routing
- Command queue
- Sub-agents

## 실습 체크리스트

1. 공식 문서와 로컬 버전을 대조합니다: `https://docs.openclaw.ai/concepts/parallel-specialist-lanes`
2. 관련 CLI는 `openclaw --help` 및 하위 명령 `--help`로 옵션을 확인합니다.
3. 설정 변경 시 `openclaw config` / `openclaw doctor`로 유효성을 검사합니다.
4. Gateway·채널·플러그인 변경 후에는 필요 시 Gateway를 재시작합니다.

## 자주 쓰는 명령·설정 예시

```json5
{
  agents: {
    defaults: {
      maxConcurrent: 4,
      subagents: { maxConcurrent: 8, delegationMode: "prefer" },
    },
  },
  messages: {
    queue: {
      mode: "collect",
      debounceMs: 1000,
      cap: 20,
      drop: "summarize",
    },
  },
}

# Lane contract

## Owns

- <job this lane is responsible for>

## Does not own

- <work to hand off>

## Chat budget

- Answer quick questions directly.
- For multi-step, slow, or tool-heavy work: acknowledge briefly, spawn/background
  the work, then return the result when complete.

## Handoff

If another lane owns the request, reply with:

- target lane
- objective
- relevant context
- exact next action

## Tool posture

Use the smallest tool surface that can complete the task. Avoid broad shell or
network work unless this lane explicitly owns it.

관련 링크

• 공식 원문: concepts/parallel-specialist-lanes
• OpenClaw 문서 홈

이 가이드는 공식 문서를 한국어 학습용으로 재구성한 것입니다. 옵션 기본값·플래그 이름은 설치 버전에 따라 달라질 수 있습니다.