Ai Claw Orchestrator

راه‌اندازی Agentic Development Environment در Windows با Claw Orchestrator

این راهنما برای ساخت یک محیط Agentic Development روی Windows است که چند Coding Agent مختلف را توسط Claw Orchestrator مدیریت می‌کند.

هدف اصلی این معماری:

• استفاده همزمان از چند Coding Agent
• مدیریت Sessionهای Agentها
• اجرای چند Agent روی یک پروژه
• استفاده از Agentهای مختلف به عنوان Coder و Reviewer
• ایجاد Multi-Agent Council
• استفاده از LLM-as-a-Judge
• جداسازی تغییرات Agentها با Git Worktree
• انجام Build، Test، Lint و Security Check قبل از داوری LLM
• نگهداری Run History
• استفاده از Dashboard برای مدیریت سیستم

معماری کلی:

Windows
│
├── Git
├── Node.js / npm
│
├── Claude Code
├── OpenAI Codex
├── Cursor Agent
├── OpenCode
├── Google Antigravity
├── Freebuff
│
└── Claw Orchestrator
        │
        ├── Dashboard
        ├── Persistent Sessions
        ├── Multi-Agent
        ├── Skills
        ├── Rules
        ├── Teams
        ├── Council
        ├── Run Ledger
        └── LLM-as-a-Judge

---

پیش‌نیازها

قبل از نصب Agentها بهتر است ابزارهای زیر نصب شده باشند:

ابزار	کاربرد	پیشنهاد
Windows	سیستم‌عامل	Windows 10/11 x64
PowerShell	Terminal و Automation	PowerShell 7
Git	Version Control	آخرین نسخه پایدار
Node.js	JavaScript Runtime	Node.js 22+
npm	Package Manager	همراه Node.js
Python	SDKهای Python	اختیاری

بررسی پیش‌نیازها

$PSVersionTable.PSVersion

node --version
npm --version
git --version

بررسی مسیر executableها:

where.exe node
where.exe npm
where.exe git

---

نصب Coding Agentها

Claude Code

وب‌سایت رسمی:

Claude

نصب با PowerShell

irm https://claude.ai/install.ps1 | iex

نصب با CMD / curl

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

نصب با Winget

winget install Anthropic.ClaudeCode

بررسی نصب

claude --version

اجرا

claude

بررسی سلامت

claude doctor

بررسی PATH

where.exe claude
Get-Command claude

---

OpenAI Codex

صفحه Codex:

OpenAI Codex

نصب

npm install -g @openai/codex

یا:

npm i -g @openai/codex

بررسی

codex --version

اجرا

codex

Login

codex login

بررسی PATH

where.exe codex
Get-Command codex

---

Cursor Agent

وب‌سایت رسمی:

Cursor

نصب CLI

irm 'https://cursor.com/install?win32=true' | iex

بررسی

cursor-agent --version

Cursor ممکن است command کوتاه زیر را نیز ارائه کند:

agent

بررسی PATH

where.exe cursor-agent
where.exe agent

---

Google Antigravity

وب‌سایت رسمی:

Google Antigravity

نصب CLI با PowerShell

irm https://antigravity.google/cli/install.ps1 | iex

نصب با curl

curl -fsSL https://antigravity.google/cli/install.cmd -o install.cmd && install.cmd && del install.cmd

بررسی

agy --version

اجرا

agy

بررسی PATH

where.exe agy
Get-Command agy

---

Google Antigravity SDK

در صورت نیاز به SDK پایتون:

pip install google-antigravity

بررسی:

pip show google-antigravity

نکته: اگر فقط قصد استفاده از Coding Agent و Claw Orchestrator را دارید، معمولاً نیازی به نصب SDK پایتون نیست.

---

OpenCode

وب‌سایت رسمی:

OpenCode

تنظیم npm

npm config set allow-scripts=opencode-ai --location=user

نصب

npm install -g opencode-ai

یا:

npm i -g opencode-ai

بررسی

opencode --version

اجرا

opencode

بررسی PATH

where.exe opencode
Get-Command opencode

---

Freebuff

وب‌سایت:

Freebuff

ثبت‌نام

برای ثبت‌نام می‌توانید از Referral Link زیر استفاده کنید:

ثبت‌نام در Freebuff

نصب CLI

npm install -g freebuff

بررسی

freebuff --version

اجرا

freebuff

بررسی PATH

where.exe freebuff
Get-Command freebuff

نکته: اگر Freebuff integration مستقیم نداشته باشد، می‌توان اتصال آن به Orchestrator را از طریق Custom Engine بررسی کرد.

---

نصب Claw Orchestrator

Claw Orchestrator لایه مرکزی Orchestration این معماری است.

نصب =

npm install -g @enderfga/claw-orchestrator

بررسی نسخه =

clawo --version

Help =

clawo --help

نمونه دستورات:

clawo acp
clawo serve

clawo session-start
clawo session-send
clawo session-stop
clawo session-list
clawo session-status
clawo session-grep
clawo session-compact

clawo runs

clawo agents-list
clawo agents-create

clawo skills-list
clawo skills-create

clawo rules-list
clawo rules-create

clawo session-team-list
clawo session-team-send

---

Engineهای Claw Orchestrator

برای مشاهده Engineهای نسخه نصب‌شده:

clawo session-start --help

در نسخه 5.0.0 Engineهای زیر در CLI ارائه می‌شوند:

claude
codex
codex-app
gemini
agy
cursor
opencode
custom

نمونه:

clawo session-start my-agent --engine claude

---

مشکل npm Install Scripts

در نسخه‌های جدید npm ممکن است Install Script بعضی dependencyهای Claw Orchestrator به دلایل امنیتی Block شود.

نمونه:

npm warn install-scripts

openclaw
re2
@google/genai
tree-sitter-bash
protobufjs

در این شرایط ممکن است CLI کار کند ولی Server با خطایی مشابه زیر اجرا نشود:

Error: Cannot find module './build/Release/re2.node'

رفع مشکل RE2

اجازه اجرای Scriptهای موردنیاز:

npm config set allow-scripts=openclaw,re2,@google/genai,tree-sitter-bash,protobufjs --location=user

بررسی:

npm config get allow-scripts

سپس:

cd "$env:APPDATA\npm\node_modules\@enderfga\claw-orchestrator"
npm rebuild re2

در صورت موفقیت:

rebuilt dependencies successfully

سپس Server را مجدداً اجرا کنید:

clawo serve

---

اجرای Standalone Server

برای اجرای Claw Orchestrator:

clawo serve

نمونه خروجی:

[ultraapp] runtime mode: host
[ultraapp] router on http://127.0.0.1:19000/forge/<slug>/

[embedded-server] Listening on http://127.0.0.1:18796
[embedded-server] Token file: C:\Users\USER\.openclaw\server-token

Standalone server running on http://127.0.0.1:18796

Press Ctrl+C to stop

---

Dashboard

پس از اجرای:

clawo serve

Claw Orchestrator آدرس Dashboard دارای Authentication Token را در Terminal نمایش می‌دهد.

ساختار URL:

http://127.0.0.1:18796/dashboard?token=YOUR_TOKEN

هشدار امنیتی:

Token واقعی را:

• داخل Wiki قرار ندهید.
• داخل Git Commit نکنید.
• در Screenshot عمومی منتشر نکنید.
• برای دیگران ارسال نکنید.

Token در فایل محلی زیر نگهداری می‌شود:

C:\Users\USERNAME\.openclaw\server-token

بعد از Authentication، آدرس پایه Dashboard:

http://127.0.0.1:18796/dashboard

---

Forge Router

هنگام اجرای Server ممکن است Router دیگری نیز اجرا شود:

http://127.0.0.1:19000/forge/<slug>/

این Router توسط بخش Forge مورد استفاده قرار می‌گیرد.

---

معماری Standalone

Claude Code ───────┐
Codex ─────────────┤
Cursor Agent ──────┤
OpenCode ──────────┤
Antigravity ───────┤
Custom Engine ─────┤
                   ↓
           Claw Orchestrator
                   │
        ┌──────────┼──────────┐
        ↓          ↓          ↓
     Sessions    Agents     Skills
        │          │          │
        └──────────┼──────────┘
                   ↓
                 Rules
                   │
                   ↓
              Dashboard

---

Health Check کامل

برای بررسی محیط، فایل زیر را ایجاد کنید:

AgenticDevOS-Check.ps1

و محتوای زیر را در آن قرار دهید:

$tools = @(
    @{ Name = "Node.js";           Command = "node";         Args = @("--version") }
    @{ Name = "npm";               Command = "npm";          Args = @("--version") }
    @{ Name = "Git";               Command = "git";          Args = @("--version") }

    @{ Name = "Claude Code";       Command = "claude";       Args = @("--version") }
    @{ Name = "Codex";             Command = "codex";        Args = @("--version") }
    @{ Name = "OpenCode";          Command = "opencode";     Args = @("--version") }
    @{ Name = "Cursor Agent";      Command = "cursor-agent"; Args = @("--version") }
    @{ Name = "Antigravity";       Command = "agy";          Args = @("--version") }
    @{ Name = "Freebuff";          Command = "freebuff";     Args = @("--version") }

    @{ Name = "Claw Orchestrator"; Command = "clawo";        Args = @("--version") }
)

$results = @()

function Write-Section {
    param([string]$Title)

    Write-Host ""
    Write-Host "============================================================" -ForegroundColor Cyan
    Write-Host " $Title" -ForegroundColor Cyan
    Write-Host "============================================================" -ForegroundColor Cyan
}

function Add-Result {
    param(
        [string]$Name,
        [string]$Status,
        [string]$Version = "",
        [string]$Path = ""
    )

    $script:results += [PSCustomObject]@{
        Name    = $Name
        Status  = $Status
        Version = $Version
        Path    = $Path
    }
}

Clear-Host

Write-Host ""
Write-Host "============================================================" -ForegroundColor Cyan
Write-Host "             AGENTIC DEV OS HEALTH CHECK" -ForegroundColor Cyan
Write-Host "============================================================" -ForegroundColor Cyan

Write-Section "CLI TOOLS"

foreach ($tool in $tools) {

    $command = Get-Command $tool.Command -ErrorAction SilentlyContinue

    if (-not $command) {

        Write-Host "[MISSING] " -ForegroundColor Red -NoNewline
        Write-Host $tool.Name

        Add-Result -Name $tool.Name -Status "MISSING"

        continue
    }

    try {

        $output = & $tool.Command @($tool.Args) 2>&1

        $version = (
            $output |
            Where-Object { $_ -ne $null } |
            Select-Object -First 1
        ).ToString().Trim()

        Write-Host "[OK]      " -ForegroundColor Green -NoNewline
        Write-Host "$($tool.Name) -> $version"

        Write-Host "          Path: " -ForegroundColor DarkGray -NoNewline
        Write-Host $command.Source -ForegroundColor DarkGray

        Add-Result `
            -Name $tool.Name `
            -Status "OK" `
            -Version $version `
            -Path $command.Source
    }
    catch {

        Write-Host "[WARNING] " -ForegroundColor Yellow -NoNewline
        Write-Host "$($tool.Name) -> command exists but version check failed"

        Add-Result `
            -Name $tool.Name `
            -Status "WARNING" `
            -Path $command.Source
    }

    Write-Host ""
}

Write-Section "PATH CHECK"

$pathEntries = @(
    $env:Path -split ";" |
    ForEach-Object {
        $_.Trim().TrimEnd("\")
    } |
    Where-Object {
        $_
    }
)

$duplicatePaths = @(
    $pathEntries |
    Group-Object |
    Where-Object {
        $_.Count -gt 1
    }
)

if ($duplicatePaths.Count -eq 0) {

    Write-Host "[OK]      No duplicate PATH entries found." -ForegroundColor Green

}
else {

    Write-Host "[WARNING] Duplicate PATH entries found:" -ForegroundColor Yellow

    foreach ($duplicate in $duplicatePaths) {

        Write-Host "          [$($duplicate.Count)x] $($duplicate.Name)" `
            -ForegroundColor Yellow
    }
}

Write-Section "NPM CONFIGURATION"

try {

    $allowScripts = npm config get allow-scripts 2>$null

    Write-Host "allow-scripts:"
    Write-Host "  $allowScripts"

    $requiredScripts = @(
        "openclaw",
        "re2",
        "@google/genai",
        "tree-sitter-bash",
        "protobufjs"
    )

    $configuredScripts = @(
        $allowScripts -split "," |
        ForEach-Object {
            $_.Trim()
        }
    )

    foreach ($package in $requiredScripts) {

        if ($configuredScripts -contains $package) {

            Write-Host "[OK]      " -ForegroundColor Green -NoNewline
            Write-Host "$package install scripts allowed"

        }
        else {

            Write-Host "[WARNING] " -ForegroundColor Yellow -NoNewline
            Write-Host "$package is not in npm allow-scripts"
        }
    }

}
catch {

    Write-Host "[WARNING] Could not read npm configuration." `
        -ForegroundColor Yellow
}

Write-Section "CLAW ORCHESTRATOR"

$clawoCommand = Get-Command clawo -ErrorAction SilentlyContinue

if (-not $clawoCommand) {

    Write-Host "[MISSING] Claw Orchestrator is not installed." `
        -ForegroundColor Red

}
else {

    Write-Host "[OK]      Claw Orchestrator CLI found." `
        -ForegroundColor Green

    try {

        $npmRoot = (npm root -g).Trim()

        $clawoRoot = Join-Path `
            $npmRoot `
            "@enderfga\claw-orchestrator"

        Write-Host ""
        Write-Host "Package:"
        Write-Host "  $clawoRoot"

        if (Test-Path $clawoRoot) {

            Write-Host "[OK]      Claw Orchestrator package directory found." `
                -ForegroundColor Green
        }

        $re2File = Join-Path `
            $clawoRoot `
            "node_modules\re2\build\Release\re2.node"

        Write-Host ""
        Write-Host "RE2 Native Module:"

        if (Test-Path $re2File) {

            Write-Host "[OK]      re2.node found." `
                -ForegroundColor Green

            Write-Host "          $re2File" `
                -ForegroundColor DarkGray

        }
        else {

            Write-Host "[ERROR]   re2.node NOT FOUND." `
                -ForegroundColor Red

            Write-Host ""
            Write-Host "Fix:"
            Write-Host 'npm config set allow-scripts=openclaw,re2,@google/genai,tree-sitter-bash,protobufjs --location=user'
            Write-Host "cd `"$clawoRoot`""
            Write-Host "npm rebuild re2"
        }

    }
    catch {

        Write-Host "[WARNING] Could not inspect Claw Orchestrator package." `
            -ForegroundColor Yellow
    }
}

Write-Section "CLAW SERVER"

$serverPort = 18796
$serverRunning = $false

try {

    $connection = Get-NetTCPConnection `
        -LocalPort $serverPort `
        -State Listen `
        -ErrorAction SilentlyContinue

    if ($connection) {

        $serverRunning = $true

        Write-Host "[OK]      " -ForegroundColor Green -NoNewline
        Write-Host "Claw server is listening on port $serverPort"

        Write-Host ""
        Write-Host "Server:"
        Write-Host "  http://127.0.0.1:$serverPort"

    }
    else {

        Write-Host "[INFO]    Claw server is not currently running." `
            -ForegroundColor Cyan

        Write-Host ""
        Write-Host "Start with:"
        Write-Host "  clawo serve"
    }

}
catch {

    Write-Host "[WARNING] Could not check server port." `
        -ForegroundColor Yellow
}

$tokenFile = Join-Path `
    $HOME `
    ".openclaw\server-token"

if (Test-Path $tokenFile) {

    Write-Host ""
    Write-Host "[OK]      Server token file exists." `
        -ForegroundColor Green

    Write-Host "          $tokenFile" `
        -ForegroundColor DarkGray
}

if ($serverRunning) {

    Write-Host ""
    Write-Host "Dashboard base URL:"
    Write-Host "  http://127.0.0.1:$serverPort/dashboard"

    Write-Host ""
    Write-Host "NOTE: Authentication token is intentionally not displayed." `
        -ForegroundColor DarkGray
}

Write-Section "SUMMARY"

$installed = @(
    $results |
    Where-Object {
        $_.Status -eq "OK"
    }
).Count

$warnings = @(
    $results |
    Where-Object {
        $_.Status -eq "WARNING"
    }
).Count

$missing = @(
    $results |
    Where-Object {
        $_.Status -eq "MISSING"
    }
).Count

Write-Host "CLI Tools OK : $installed"
Write-Host "Warnings     : $warnings"
Write-Host "Missing      : $missing"
Write-Host "Total        : $($tools.Count)"

Write-Host ""

if (($missing -eq 0) -and ($warnings -eq 0)) {

    Write-Host "[READY] Agentic Development environment is ready." `
        -ForegroundColor Green

}
elseif ($missing -eq 0) {

    Write-Host "[READY WITH WARNINGS] All CLI tools are installed." `
        -ForegroundColor Yellow

}
else {

    Write-Host "[NOT READY] Some required tools are missing." `
        -ForegroundColor Red
}

Write-Host ""

if ($serverRunning) {

    Write-Host "Claw Server : RUNNING" `
        -ForegroundColor Green

}
else {

    Write-Host "Claw Server : STOPPED" `
        -ForegroundColor Cyan
}

Write-Host ""

---

اجرای Health Check

.\AgenticDevOS-Check.ps1

اگر Execution Policy مانع اجرا شد:

Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass

سپس:

.\AgenticDevOS-Check.ps1

---

موارد بررسی‌شده توسط Health Check

بررسی	توضیح
Node.js	نسخه و PATH
npm	نسخه و PATH
Git	نسخه و PATH
Claude Code	نسخه و PATH
Codex	نسخه و PATH
OpenCode	نسخه و PATH
Cursor Agent	نسخه و PATH
Antigravity	نسخه و PATH
Freebuff	نسخه و PATH
Claw Orchestrator	نسخه و PATH
Duplicate PATH	پیدا کردن مسیرهای تکراری
npm allow-scripts	بررسی مجوز Native Install Scripts
RE2	بررسی وجود re2.node
Claw Server	بررسی Port 18796
Server Token	بررسی وجود Token File بدون نمایش Token
Dashboard	نمایش URL پایه Dashboard

---

مدیریت Sessionها

مشاهده Sessionها

clawo session-list

ساخت Session با Claude

clawo session-start claude-main `
    --engine claude `
    --cwd "D:\Source\MyProject"

Codex

clawo session-start codex-main `
    --engine codex `
    --cwd "D:\Source\MyProject"

Cursor

clawo session-start cursor-main `
    --engine cursor `
    --cwd "D:\Source\MyProject"

OpenCode

clawo session-start opencode-main `
    --engine opencode `
    --cwd "D:\Source\MyProject"

Antigravity

clawo session-start agy-main `
    --engine agy `
    --cwd "D:\Source\MyProject"

---

ارسال Task

مثال:

clawo session-send claude-main "Analyze this repository. Do not modify files. Explain the architecture and potential problems."

---

وضعیت Session

clawo session-status claude-main

---

جستجو در History

clawo session-grep claude-main "error"

---

Compact کردن Session

clawo session-compact claude-main

---

توقف Session

clawo session-stop claude-main

---

Run Ledger

clawo runs

Run Ledger تاریخچه اجراهای Agentها را نگهداری می‌کند.

---

Agents

clawo agents-list

برای ساخت Agent:

clawo agents-create --help

---

Skills

clawo skills-list

برای ساخت Skill:

clawo skills-create --help

---

Rules

clawo rules-list

برای ساخت Rule:

clawo rules-create --help

---

Agent Teams

مشاهده اعضای Team:

clawo session-team-list SESSION_NAME

ارسال پیام:

clawo session-team-send SESSION_NAME TEAMMATE "Review this implementation."

---

Git Worktree و Isolation

برای اجرای همزمان چند Agent بهتر است هر Agent در Worktree مستقل کار کند.

Repository
│
├── main
│
├── worktree-claude
│
├── worktree-codex
│
├── worktree-cursor
│
├── worktree-antigravity
│
└── worktree-review

Claw Orchestrator نیز Option مربوط به Worktree دارد:

clawo session-start --help

Option:

-w, --worktree [name]

---

LLM-as-a-Judge

یکی از اهداف اصلی این معماری استفاده از Agentهای مختلف برای تولید چند Solution و سپس ارزیابی آن‌ها است.

                       TASK
                         │
                         ↓
                 Claw Orchestrator
                         │
        ┌────────────────┼────────────────┐
        ↓                ↓                ↓
  Claude Code          Codex         Antigravity
        │                │                │
        ↓                ↓                ↓
   Solution A       Solution B       Solution C
        │                │                │
        └────────────────┼────────────────┘
                         ↓
                  Automated Checks
                         │
          ┌──────────────┼──────────────┐
          ↓              ↓              ↓
        Build           Tests          Lint
          │              │              │
          └──────────────┼──────────────┘
                         ↓
                  Security Check
                         ↓
                     Benchmark
                         ↓
                  Multi-Agent Review
                         ↓
                    LLM Judge
                         ↓
                  Score / Consensus
                         ↓
                    Best Result

---

ترتیب پیشنهادی ارزیابی

LLM نباید تنها معیار انتخاب بهترین Implementation باشد.

ترتیب پیشنهادی:

Candidate
   │
   ↓
Build
   │
   ↓
Unit Tests
   │
   ↓
Integration Tests
   │
   ↓
Lint
   │
   ↓
Type Check
   │
   ↓
Security Check
   │
   ↓
Benchmark
   │
   ↓
LLM Review
   │
   ↓
Final Score

---

نقش Agentها

Role	Agent پیشنهادی	وظیفه
Planner	Claude / Codex	تحلیل Task
Primary Coder	Claude / Codex	Implementation اصلی
Alternative Coder	Cursor / OpenCode / Antigravity	Implementation جایگزین
Reviewer	Agent متفاوت از Coder	Code Review
Security Reviewer	Claude / Codex	بررسی Security
Judge	مدل متفاوت از تولیدکننده	امتیازدهی

بهتر است مدلی که Solution را تولید کرده است تنها Judge همان Solution نباشد.

---

Multi-Agent Council

                    Problem
                       │
                       ↓
                Orchestrator
                       │
          ┌────────────┼────────────┐
          ↓            ↓            ↓
       Claude        Codex       Agent C
          │            │            │
          ↓            ↓            ↓
       Plan A         Plan B       Plan C
          │            │            │
          └────────────┼────────────┘
                       ↓
                  Cross Review
                       ↓
                     Vote
                       ↓
                  Consensus
                       ↓
                 Final Decision

کاربردها:

• Architecture Design
• Code Review
• Refactoring
• Debugging
• Security Review
• Performance Optimization
• مقایسه Implementationها
• Pull Request Review
• انتخاب Framework
• انتخاب Design Pattern

---

Troubleshooting

Command Not Found

اگر:

The term 'xxxx' is not recognized

بررسی کنید:

Get-Command xxxx
where.exe xxxx

---

بررسی PATH

$env:Path -split ';'

---

پیدا کردن PATHهای تکراری

$env:Path -split ';' |
    ForEach-Object { $_.Trim().TrimEnd('\') } |
    Group-Object |
    Where-Object Count -gt 1 |
    Select-Object Count, Name

---

بروزرسانی

Codex

npm install -g @openai/codex@latest
codex --version

OpenCode

npm install -g opencode-ai@latest
opencode --version

Freebuff

npm install -g freebuff@latest
freebuff --version

Claw Orchestrator

npm install -g @enderfga/claw-orchestrator@latest
clawo --version

---

نصب سریع روی سیستم جدید

Claude Code

irm https://claude.ai/install.ps1 | iex

Cursor Agent

irm 'https://cursor.com/install?win32=true' | iex

Antigravity

irm https://antigravity.google/cli/install.ps1 | iex

OpenCode

npm config set allow-scripts=opencode-ai --location=user
npm i -g opencode-ai

Codex

npm i -g @openai/codex

Freebuff

npm i -g freebuff

Claw Orchestrator

npm i -g @enderfga/claw-orchestrator

مجوز Install Scriptهای Claw Orchestrator

npm config set allow-scripts=openclaw,re2,@google/genai,tree-sitter-bash,protobufjs --location=user

در صورت نیاز:

cd "$env:APPDATA\npm\node_modules\@enderfga\claw-orchestrator"
npm rebuild re2

---

بررسی نهایی

node --version
npm --version
git --version

claude --version
codex --version
opencode --version
cursor-agent --version
agy --version
freebuff --version

clawo --version

سپس Health Check:

.\AgenticDevOS-Check.ps1

و در نهایت Server:

clawo serve

---

معماری نهایی Agentic Development OS

┌─────────────────────────────────────────────────┐
│              Windows Development OS             │
│                                                 │
│                 Developer / User                │
│                        │                        │
│                        ↓                        │
│                Claw Orchestrator                │
│                        │                        │
│                 Web Dashboard                   │
│                        │                        │
│                Planner / Router                 │
│                        │                        │
│     ┌──────────────────┼──────────────────┐     │
│     │                  │                  │     │
│     ↓                  ↓                  ↓     │
│ Claude Code          Codex          Cursor Agent│
│     │                  │                  │     │
│     ├────────────── OpenCode ─────────────┤     │
│     │                  │                  │     │
│     ├─────────── Antigravity ─────────────┤     │
│     │                  │                  │     │
│     └──────────── Custom Engines ─────────┘     │
│                        │                        │
│                        ↓                        │
│                Git Worktree Isolation           │
│                        │                        │
│                        ↓                        │
│               Automated Validation              │
│                        │                        │
│          Build / Test / Lint / Security         │
│                        │                        │
│                        ↓                        │
│                Multi-Agent Review               │
│                        │                        │
│                        ↓                        │
│                  LLM-as-a-Judge                 │
│                        │                        │
│                        ↓                        │
│                    Best Result                  │
└─────────────────────────────────────────────────┘

---

خلاصه دستورات مهم

کار	دستور
Version	clawo --version
Help	clawo --help
Server	clawo serve
Dashboard	http://127.0.0.1:18796/dashboard
Sessions	clawo session-list
ساخت Session	clawo session-start
ارسال Task	clawo session-send
وضعیت Session	clawo session-status
توقف Session	clawo session-stop
History	clawo runs
Agents	clawo agents-list
Skills	clawo skills-list
Rules	clawo rules-list

---

نتیجه‌گیری

هدف این معماری ساخت یک Agentic Development Environment با کمترین تعداد لایه‌های اضافی و بیشترین استفاده از Coding Agentهای موجود است.

Coding Agentهای مورد استفاده:

• Claude Code
• OpenAI Codex
• Cursor Agent
• OpenCode
• Google Antigravity
• Freebuff / Custom Agents

لایه مرکزی:

Claw Orchestrator

جریان کاری نهایی:

Task
 ↓
Claw Orchestrator
 ↓
Planner / Router
 ↓
Multiple Coding Agents
 ↓
Git Worktree Isolation
 ↓
Build + Tests + Lint + Security
 ↓
Multi-Agent Review
 ↓
LLM-as-a-Judge
 ↓
Best Result

این معماری در آینده می‌تواند با موارد زیر توسعه داده شود:

• MCP
• Local LLM
• CI/CD
• Security Agents
• Automated Code Review
• Pull Request Review
• Custom Agents
• Custom Skills
• Custom Rules
• Multi-Agent Council
• Benchmarking
• Automated Testing
• Model Routing
• Agent Teams
• Forge

نکته مهم: Coding Agentها و Claw Orchestrator با سرعت زیادی توسعه پیدا می‌کنند. قبل از Upgrade، خروجی --help نسخه نصب‌شده و مستندات رسمی پروژه بررسی شود.