ACP aracıları

​

Hangi sayfayı istiyorum?

​

Bu kutudan çıktığı gibi çalışır mı?

openclaw plugins install @openclaw/acpx
openclaw config set plugins.entries.acpx.enabled true

​

Desteklenen harness hedefleri

​

Operatör çalışma kılavuzu

​

ACP ve alt araçlar

​

ACP Claude Code’u nasıl çalıştırır

1. OpenClaw ACP oturum denetim düzlemi.
2. Resmi @openclaw/acpx çalışma zamanı Plugin’i.
3. Claude ACP bağdaştırıcısı.
4. Claude tarafındaki çalışma zamanı/oturum mekanizması.

• /acp spawn, bağlanabilir oturumlar, çalışma zamanı denetimleri veya kalıcı harness çalışması mı istiyorsunuz? ACP kullanın.
• Ham CLI üzerinden basit yerel metin yedeği mi istiyorsunuz? CLI backend’lerini kullanın.

​

Bağlı oturumlar

​

Zihinsel model

• Sohbet yüzeyi - insanların konuşmaya devam ettiği yer (Discord kanalı, Telegram konusu, iMessage sohbeti).
• ACP oturumu - OpenClaw’ın yönlendirdiği kalıcı Codex/Claude/Gemini çalışma zamanı durumu.
• Alt iş parçacığı/konu - yalnızca --thread ... tarafından oluşturulan isteğe bağlı ek mesajlaşma yüzeyi.
• Çalışma zamanı çalışma alanı - harness’in çalıştığı dosya sistemi konumu (cwd, repo checkout, backend çalışma alanı). Sohbet yüzeyinden bağımsızdır.

​

Geçerli konuşma bağları

/codex bind                                              # native Codex bind, route future messages here
/codex model gpt-5.4                                     # tune the bound native Codex thread
/codex stop                                              # control the active native Codex turn
/acp spawn codex --bind here                             # explicit ACP fallback for Codex
/acp spawn codex --thread auto                           # may create a child thread/topic and bind there
/acp spawn codex --bind here --cwd /workspace/repo       # same chat binding, Codex runs in /workspace/repo

​

Kalıcı kanal bağlamaları

​

Bağlama modeli

​

Araç başına çalışma zamanı varsayılanları

• agents.list[].runtime.type="acp"
• agents.list[].runtime.acp.agent (harness kimliği, örn. codex veya claude)
• agents.list[].runtime.acp.backend
• agents.list[].runtime.acp.mode
• agents.list[].runtime.acp.cwd

1. bindings[].acp.*
2. agents.list[].runtime.acp.*
3. Genel ACP varsayılanları (örn. acp.backend)

​

Örnek

{
  agents: {
    list: [
      {
        id: "codex",
        runtime: {
          type: "acp",
          acp: {
            agent: "codex",
            backend: "acpx",
            mode: "persistent",
            cwd: "/workspace/openclaw",
          },
        },
      },
      {
        id: "claude",
        runtime: {
          type: "acp",
          acp: { agent: "claude", backend: "acpx", mode: "persistent" },
        },
      },
    ],
  },
  bindings: [
    {
      type: "acp",
      agentId: "codex",
      match: {
        channel: "discord",
        accountId: "default",
        peer: { kind: "channel", id: "222222222222222222" },
      },
      acp: { label: "codex-main" },
    },
    {
      type: "acp",
      agentId: "claude",
      match: {
        channel: "telegram",
        accountId: "default",
        peer: { kind: "group", id: "-1001234567890:topic:42" },
      },
      acp: { cwd: "/workspace/repo-b" },
    },
    {
      type: "route",
      agentId: "main",
      match: { channel: "discord", accountId: "default" },
    },
    {
      type: "route",
      agentId: "main",
      match: { channel: "telegram", accountId: "default" },
    },
  ],
  channels: {
    discord: {
      guilds: {
        "111111111111111111": {
          channels: {
            "222222222222222222": { requireMention: false },
          },
        },
      },
    },
    telegram: {
      groups: {
        "-1001234567890": {
          topics: { "42": { requireMention: false } },
        },
      },
    },
  },
}

​

Davranış

• OpenClaw, yapılandırılmış ACP oturumunun kanala özgü kabulden sonra ve kullanımdan önce mevcut olmasını sağlar.
• Bu kanaldaki, konudaki veya sohbetteki iletiler yapılandırılmış ACP oturumuna yönlendirilir.
• Yapılandırılmış ACP bağlamaları kendi oturum rotasına sahiptir. Kanal yayınına dağıtım, eşleşen bir bağlama için yapılandırılmış ACP oturumunun yerini almaz.
• Bağlı konuşmalarda /new ve /reset, aynı ACP oturum anahtarını yerinde sıfırlar.
• Geçici çalışma zamanı bağlamaları (örneğin ileti dizisi odağı akışları tarafından oluşturulanlar) mevcut oldukları yerlerde uygulanmaya devam eder.
• Açık bir cwd olmadan aracılar arası ACP başlatmalarında OpenClaw, hedef aracı çalışma alanını aracı yapılandırmasından devralır.
• Eksik devralınan çalışma alanı yolları arka ucun varsayılan cwd değerine geri döner; eksik olmayan erişim hataları başlatma hataları olarak gösterilir.

​

ACP oturumlarını başlatma

{
  "task": "Open the repo and summarize failing tests",
  "runtime": "acp",
  "agentId": "codex",
  "thread": true,
  "mode": "session"
}

/acp spawn codex --mode persistent --thread auto
/acp spawn codex --mode oneshot --thread off
/acp spawn codex --bind here
/acp spawn codex --thread here

​

sessions_spawn parametreleri

​

Başlatma bağlama ve ileti dizisi modları

​

Teslim modeli

{
  "task": "Continue where we left off - fix the remaining test failures",
  "runtime": "acp",
  "agentId": "codex",
  "resumeSessionId": "<previous-session-id>"
}

​

Sandbox uyumluluğu

• İstekte bulunan oturum sandbox içindeyse ACP oluşturma işlemleri hem sessions_spawn({ runtime: "acp" }) hem de /acp spawn için engellenir.
• runtime: "acp" ile sessions_spawn, sandbox: "require" desteklemez.

​

Oturum hedefi çözümleme

1. Açık hedef bağımsız değişkeni (veya /acp steer için --session)
   • anahtarı dener
   • ardından UUID biçimli oturum kimliğini
   • ardından etiketi
2. Geçerli iş parçacığı bağlaması (bu konuşma/iş parçacığı bir ACP oturumuna bağlıysa).
3. Geçerli istekte bulunan oturuma geri dönüş.

​

ACP kontrolleri

​

Çalışma zamanı seçenekleri eşlemesi

​

acpx harness, Plugin kurulumu ve izinler

​

Sorun giderme

​

İlgili

• ACP agent’ları - kurulum
• Agent gönderme
• CLI Arka Uçları
• Codex harness
• Codex harness runtime
• Çok agent’lı sandbox araçları
• openclaw acp (köprü modu)
• Alt agent’lar