Files
DBAdmin/docs___/OpenClaw_Specification.md
2026-05-27 07:48:02 +00:00

9.5 KiB

Specyfikacja Konfiguracji OpenClaw: System Zarządzania Misjami

Na podstawie analizy dostarczonych plików, przygotowałem specyfikację do ustawienia systemu zarządzania misjami w OpenClaw. System ten opiera się na hierarchicznej strukturze folderów, pliku konfiguracyjnym openclaw.missions.json oraz zestawie szablonów.

1. Konfiguracja Rdzenia Systemu (openclaw.missions.json)

Sercem systemu jest plik konfiguracyjny, który mapuje misje, sekcje i agentów. Należy go umieścić w {ROOT_PATH}/_MCC/openclaw.missions.json.

Zawartość openclaw.missions.json:

{
  "root_path": "{{ROOT_PATH}}",
  "wip_limit": 5,
  "modes": {
    "default": "SIM",
    "flight_requires_checklist": true,
    "flight_requires_program_lead_for_priority": ["P0", "P1"]
  },
  "governance": {
    "program_lead": {
      "name": "PROGRAM LEAD",
      "responsibilities": ["Vision", "Strategy", "Final Decisions"]
    },
    "mission_control": {
      "name": "MISSION CONTROL",
      "alias": "MCC",
      "responsibilities": ["Research", "Delegation", "Execution", "Orchestration"]
    }
  },
  "missions": {
    "APOLLO": {
      "label": "FLIGHT SYSTEMS",
      "sections": {
        "APOLLO-CORE": { "folder": "APOLLO/CORE_TECH", "agents": ["Anvil", "Cipher"] },
        "APOLLO-CODE": { "folder": "APOLLO/FLIGHT_CODE", "agents": ["Pixel", "Sentry"] },
        "APOLLO-VERIFY": { "folder": "APOLLO/VERIFICATION", "agents": ["Inspector"] }
      }
    },
    "HUBBLE": {
      "label": "MISSION STORY",
      "sections": {
        "HUBBLE-CONTENT": { "folder": "HUBBLE/CONTENT", "agents": ["Rex", "Sage", "Echo", "Clip"] },
        "HUBBLE-CREATIVE": { "folder": "HUBBLE/CREATIVE", "agents": ["Nebula", "Nova"] }
      }
    },
    "ARTEMIS": {
      "label": "MISSION OUTCOMES",
      "sections": {
        "ARTEMIS-EXP": { "folder": "ARTEMIS/EXPERIMENTS", "agents": ["Scout", "Herald"] },
        "ARTEMIS-TLM": { "folder": "ARTEMIS/TELEMETRY", "agents": ["Forge", "Pulse"] },
        "ARTEMIS-GROUND": { "folder": "ARTEMIS/GROUND_CREW", "agents": ["Beacon", "Link", "Vibe"] }
      }
    }
  },
  "packet": {
    "name_format": "YYYY-MM-DD__CALLSIGN__slug",
    "required_files": [
      "00_brief.md",
      "10_worklog.md",
      "30_results.md",
      "40_decision.md",
      "90_links.md"
    ],
    "artifact_dir": "20_artifacts"
  }
}

2. Struktura Katalogów

System wymaga następującej struktury katalogów, którą można utworzyć za pomocą poniższych poleceń. ROOT_PATH to główny katalog systemu (np. ~/.openclaw/workspace/missions).

ROOT/
  _MCC/
    00_operating-manual.md
    10_backlog.md
    20_active-missions.md
    30_decisions.md
    40_routing-rules.md
    50_templates/
      task-brief.md
      sim-flight-checklist.md
      post-mission-report.md
      decision-record.md
    openclaw.missions.json
    90_archive-index.md

  APOLLO/
    CORE_TECH/missions/
    FLIGHT_CODE/missions/
    VERIFICATION/missions/
    99_archive/

  HUBBLE/
    CONTENT/missions/
    CREATIVE/missions/
    99_archive/

  ARTEMIS/
    EXPERIMENTS/missions/
    TELEMETRY/missions/
    GROUND_CREW/missions/
    99_archive/

3. Procedura Ustawieniowa (Bootstrap)

Poniższa procedura wykorzystuje klienta openclaw w środowisku Linux/WSL do automatycznego utworzenia całej struktury.

Krok 1: Ustawienie zmiennej ROOT_PATH

Zdefiniuj ścieżkę do głównego katalogu systemu. Zalecane jest umieszczenie go w przestrzeni roboczej OpenClaw.

export ROOT_PATH="$HOME/.openclaw/workspace/missions"

Krok 2: Uruchomienie Gateway w osobnym profilu

Dla izolacji konfiguracji, użyj dedykowanego profilu missionctl.

openclaw --profile missionctl gateway start
openclaw --profile missionctl gateway status

Krok 3: Weryfikacja dostępu (Sandbox)

Upewnij się, że agent OpenClaw ma uprawnienia do zapisu w ROOT_PATH.

openclaw --profile missionctl sandbox explain

Krok 4: Ustawienie profilu narzędzi (opcjonalnie)

Aby zapewnić dostęp do operacji na plikach, możesz ustawić profil coding.

openclaw --profile missionctl config set tools.profile '"coding"'

Krok 5: Główna komenda bootstrap

To pojedyncze polecenie instruuje agenta OpenClaw, aby utworzył całą strukturę katalogów, pliki konfiguracyjne i szablony.

openclaw --profile missionctl agent --message "
BOOTSTRAP Mission Management System.

ROOT_PATH=$ROOT_PATH

1) Create directories:
- $ROOT_PATH/_MCC/50_templates
- $ROOT_PATH/APOLLO/CORE_TECH/missions
- $ROOT_PATH/APOLLO/FLIGHT_CODE/missions
- $ROOT_PATH/APOLLO/VERIFICATION/missions
- $ROOT_PATH/APOLLO/99_archive
- $ROOT_PATH/HUBBLE/CONTENT/missions
- $ROOT_PATH/HUBBLE/CREATIVE/missions
- $ROOT_PATH/HUBBLE/99_archive
- $ROOT_PATH/ARTEMIS/EXPERIMENTS/missions
- $ROOT_PATH/ARTEMIS/TELEMETRY/missions
- $ROOT_PATH/ARTEMIS/GROUND_CREW/missions
- $ROOT_PATH/ARTEMIS/99_archive

2) Write MCC files (overwrite if exist):
A) $ROOT_PATH/_MCC/00_operating-manual.md
# Operating Manual — Mission System

## Governance
- PROGRAM LEAD: vision, strategy, final decisions
- MISSION CONTROL (MCC): triage, routing, execution, WIP, closure

## Missions
- APOLLO: Flight Systems (Core Tech, Flight Code, Verification)
- HUBBLE: Mission Story (Mission Content, Creative Studio)
- ARTEMIS: Mission Outcomes (Experiments, Telemetry, Ground Crew)

## Packet standard
Each packet contains:
00_brief.md, 10_worklog.md, 20_artifacts/, 30_results.md, 40_decision.md, 90_links.md

## Modes
SIM (default) vs FLIGHT (requires SIM→FLIGHT checklist)

## Closure
PROCEED | ITERATE | HOLD | SCRUB

B) $ROOT_PATH/_MCC/40_routing-rules.md
# Routing Rules (MCC)

## Call-signs → folders
APOLLO-CORE   → APOLLO/CORE_TECH
APOLLO-CODE   → APOLLO/FLIGHT_CODE
APOLLO-VERIFY → APOLLO/VERIFICATION

HUBBLE-CONTENT  → HUBBLE/CONTENT
HUBBLE-CREATIVE → HUBBLE/CREATIVE

ARTEMIS-EXP    → ARTEMIS/EXPERIMENTS
ARTEMIS-TLM    → ARTEMIS/TELEMETRY
ARTEMIS-GROUND → ARTEMIS/GROUND_CREW

## Default mode
SIM is default. FLIGHT requires checklist + approvals.

C) Empty indices:
- $ROOT_PATH/_MCC/10_backlog.md with '# Backlog (MCC)'
- $ROOT_PATH/_MCC/20_active-missions.md with '# Active Missions (MCC)'
- $ROOT_PATH/_MCC/30_decisions.md with '# Decisions (MCC)'
- $ROOT_PATH/_MCC/90_archive-index.md with '# Archive Index (MCC)'

3) Write templates:
- $ROOT_PATH/_MCC/50_templates/task-brief.md
- $ROOT_PATH/_MCC/50_templates/sim-flight-checklist.md
- $ROOT_PATH/_MCC/50_templates/post-mission-report.md
- $ROOT_PATH/_MCC/50_templates/decision-record.md

Contents:

(task-brief.md)
# [CALLSIGN] Task Brief — <title>
Routing: [CALLSIGN]
Agent: <AgentName>
Mode: SIM | FLIGHT
Priority: P0 | P1 | P2
## Context
## Goal
## Deliverables
## Constraints
## Acceptance Criteria
## Risks

(sim-flight-checklist.md)
# SIM → FLIGHT Checklist
- Acceptance criteria met
- Artifacts linked in 90_links.md
- Risks reviewed
- Verification done (if needed)
- Telemetry plan ready (if needed)
- MCC GO
- PROGRAM LEAD GO (P0/P1)

(post-mission-report.md)
# Post-Mission Report — <title>
Packet:
Decision:
Summary:
Artifacts:
Measurements:
Learnings:
Next Steps:

(decision-record.md)
# Decision Record — <title>
Decision: PROCEED | ITERATE | HOLD | SCRUB
Date:
Owner:
Rationale:
Trade-offs:
Follow-up:

4) Write mapping config:
$ROOT_PATH/_MCC/openclaw.missions.json
Use this exact JSON, but with root_path = ROOT_PATH:

{
  "root_path": "$ROOT_PATH",
  "wip_limit": 5,
  "modes": { "default": "SIM", "flight_requires_checklist": true, "flight_requires_program_lead_for_priority": ["P0","P1"] },
  "missions": {
    "APOLLO": {
      "label": "FLIGHT SYSTEMS",
      "sections": {
        "APOLLO-CORE": { "folder": "APOLLO/CORE_TECH", "agents": ["Anvil","Cipher"] },
        "APOLLO-CODE": { "folder": "APOLLO/FLIGHT_CODE", "agents": ["Pixel","Sentry"] },
        "APOLLO-VERIFY": { "folder": "APOLLO/VERIFICATION", "agents": ["Inspector"] }
      }
    },
    "HUBBLE": {
      "label": "MISSION STORY",
      "sections": {
        "HUBBLE-CONTENT": { "folder": "HUBBLE/CONTENT", "agents": ["Rex","Sage","Echo","Clip"] },
        "HUBBLE-CREATIVE": { "folder": "HUBBLE/CREATIVE", "agents": ["Nebula","Nova"] }
      }
    },
    "ARTEMIS": {
      "label": "MISSION OUTCOMES",
      "sections": {
        "ARTEMIS-EXP": { "folder": "ARTEMIS/EXPERIMENTS", "agents": ["Scout","Herald"] },
        "ARTEMIS-TLM": { "folder": "ARTEMIS/TELEMETRY", "agents": ["Forge","Pulse"] },
        "ARTEMIS-GROUND": { "folder": "ARTEMIS/GROUND_CREW", "agents": ["Beacon","Link","Vibe"] }
      }
    }
  },
  "packet": {
    "name_format": "YYYY-MM-DD__CALLSIGN__slug",
    "required_files": ["00_brief.md","10_worklog.md","30_results.md","40_decision.md","90_links.md"],
    "artifact_dir": "20_artifacts"
  }
}

5) After completion, print a short summary of what you created and where.
"

4. Weryfikacja i Diagnostyka

Po wykonaniu skryptu bootstrap, możesz zweryfikować poprawność instalacji.

Podgląd logów

openclaw --profile missionctl logs --follow

Pełny status systemu

openclaw --profile missionctl status --deep

5. (Bonus) Utworzenie Pierwszego Pakietu Misji

Aby przetestować działanie systemu, możesz utworzyć pierwszy pakiet misji.

openclaw --profile missionctl agent --message "
Utwórz Mission Packet w $ROOT_PATH dla:
CALLSIGN: ARTEMIS-TLM
Owner: Pulse
Mode: SIM
Slug: system-check

Folder: YYYY-MM-DD__ARTEMIS-TLM__system-check w ARTEMIS/TELEMETry/missions/
W środku: 00_brief.md, 10_worklog.md, 20_artifacts/, 30_results.md, 40_decision.md, 90_links.md
Dopisz wpis do $ROOT_PATH/_MCC/20_active-missions.md ze statusem IN_PROGRESS.
"