​

ACP agent’ları

​

Hangi sayfayı istiyorum?

​

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

• Yeni kurulumlar artık paketlenmiş acpx çalışma zamanı plugin’i etkin olarak gelir.
• Paketlenmiş acpx plugin’i kendi plugin’e yerel sabitlenmiş acpx ikilisini tercih eder.
• Başlangıçta OpenClaw bu ikiliyi yoklar ve gerekirse kendi kendini onarır.
• Hızlı bir hazırlık kontrolü istiyorsanız /acp doctor ile başlayın.

• Hedef harness bağdaştırıcısı, o harness’i ilk kez kullandığınızda isteğe bağlı olarak npx ile getirilebilir.
• Sağlayıcı kimlik doğrulamasının yine de o host üzerinde mevcut olması gerekir.
• Host üzerinde npm/ağ erişimi yoksa, ilk çalıştırma bağdaştırıcı getirme işlemleri önbellekler önceden ısıtılana veya bağdaştırıcı başka bir yolla kurulana kadar başarısız olabilir.

• /acp spawn codex: OpenClaw acpx bootstrap için hazır olmalıdır, ancak Codex ACP bağdaştırıcısının yine de ilk çalıştırma getirmesine ihtiyacı olabilir.
• /acp spawn claude: Claude ACP bağdaştırıcısı için de aynı durum geçerlidir; ayrıca o host üzerinde Claude tarafı auth gerekir.

​

Hızlı operatör akışı

1. Bir oturum başlatın:
   • /acp spawn codex --bind here
   • /acp spawn codex --mode persistent --thread auto
2. Bağlı konuşma veya thread içinde çalışın (veya o oturum anahtarını açıkça hedefleyin).
3. Çalışma zamanı durumunu kontrol edin:
   • /acp status
4. Gerektiğinde çalışma zamanı seçeneklerini ayarlayın:
   • /acp model <provider/model>
   • /acp permissions <profile>
   • /acp timeout <seconds>
5. Bağlamı değiştirmeden etkin bir oturuma yön verin:
   • /acp steer tighten logging and continue
6. Çalışmayı durdurun:
   • /acp cancel (geçerli dönüşü durdurur), veya
   • /acp close (oturumu kapatır + bağları kaldırır)

​

İnsanlar için hızlı başlangıç

• “Bu Discord kanalını Codex’e bağla.”
• “Burada bir thread içinde kalıcı bir Codex oturumu başlat ve odaklı tut.”
• “Bunu tek seferlik bir Claude Code ACP oturumu olarak çalıştır ve sonucu özetle.”
• “Bu iMessage sohbetini Codex’e bağla ve takip mesajlarını aynı çalışma alanında tut.”
• “Bu görev için bir thread içinde Gemini CLI kullan, sonra takipleri aynı thread içinde tut.”

1. runtime: "acp" seçmek.
2. İstenen harness hedefini çözümlemek (agentId, örneğin codex).
3. Mevcut konuşma bağı isteniyorsa ve etkin kanal bunu destekliyorsa, ACP oturumunu o konuşmaya bağlamak.
4. Aksi halde thread bağı isteniyorsa ve mevcut kanal bunu destekliyorsa, ACP oturumunu o thread’e bağlamak.
5. Odağı kaldırılana/kapatılana/süresi dolana kadar sonraki bağlı mesajları aynı ACP oturumuna yönlendirmek.

​

ACP ile sub-agent’lar karşılaştırması

​

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

1. OpenClaw ACP oturum kontrol düzlemi
2. paketlenmiş acpx çalışma zamanı plugin’i
3. Claude ACP bağdaştırıcısı
4. Claude tarafı çalışma zamanı/oturum mekanizması

• ACP Claude; ACP kontrolleri, oturum devam ettirme, arka plan görevi takibi ve isteğe bağlı konuşma/thread bağına sahip bir harness oturumudur.
• CLI backend’leri ayrı, yalnızca metin tabanlı yerel yedek çalışma zamanlarıdır. Bkz. CLI Backends.

• /acp spawn, bağlanabilir oturumlar, çalışma zamanı kontrolleri veya kalıcı harness çalışması istiyorsanız: ACP kullanın
• ham CLI üzerinden basit yerel metin yedeği istiyorsanız: CLI backend’lerini kullanın

​

Bağlı oturumlar

​

Mevcut konuşmaya bağlar

• Kanal taşıması, auth, güvenlik ve teslimatın sahibi OpenClaw olmaya devam eder.
• Geçerli konuşma, başlatılan ACP oturum anahtarına sabitlenir.
• Bu konuşmadaki takip mesajları aynı ACP oturumuna yönlendirilir.
• /new ve /reset, aynı bağlı ACP oturumunu yerinde sıfırlar.
• /acp close, oturumu kapatır ve mevcut konuşma bağını kaldırır.

• --bind here, aynı sohbet yüzeyini korur. Discord’da mevcut kanal aynı kanal olarak kalır.
• --bind here, yeni bir çalışma başlatıyorsanız yine de yeni bir ACP oturumu oluşturabilir. Bağ, o oturumu mevcut konuşmaya iliştirir.
• --bind here kendi başına alt Discord thread’i veya Telegram konusu oluşturmaz.
• ACP çalışma zamanı yine de kendi çalışma dizinine (cwd) veya backend tarafından yönetilen disk üstü çalışma alanına sahip olabilir. Bu çalışma zamanı çalışma alanı sohbet yüzeyinden ayrıdır ve yeni bir mesajlaşma thread’i anlamına gelmez.
• Farklı bir ACP agent’ına başlatma yaparsanız ve --cwd vermezseniz, OpenClaw varsayılan olarak isteği yapanın değil hedef agent’ın çalışma alanını devralır.
• Devralınan çalışma alanı yolu eksikse (ENOENT/ENOTDIR), OpenClaw yanlış ağacı sessizce yeniden kullanmak yerine backend varsayılan cwd’sine geri döner.
• Devralınan çalışma alanı varsa ancak erişilemiyorsa (örneğin EACCES), başlatma cwd alanını düşürmek yerine gerçek erişim hatasını döndürür.

• sohbet yüzeyi: insanların konuşmaya devam ettiği yer (Discord channel, Telegram topic, iMessage chat)
• ACP oturumu: OpenClaw’ın yönlendirdiği kalıcı Codex/Claude/Gemini çalışma zamanı durumu
• alt thread/topic: 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ı)

• /acp spawn codex --bind here: bu sohbeti koru, bir Codex ACP oturumu başlat veya bağlan ve gelecekteki mesajları burada ona yönlendir
• /acp spawn codex --thread auto: OpenClaw bir alt thread/topic oluşturabilir ve ACP oturumunu oraya bağlayabilir
• /acp spawn codex --bind here --cwd /workspace/repo: yukarıdakiyle aynı sohbet bağı, ancak Codex /workspace/repo içinde çalışır

• Geçerli konuşma bağlama desteği bildiren sohbet/mesajlaşma kanalları --bind here seçeneğini paylaşılan konuşma bağlama yolu üzerinden kullanabilir.
• Özel thread/topic semantiğine sahip kanallar yine de kanal bazlı kanonikleştirmeyi aynı paylaşılan arayüzün arkasında sağlayabilir.
• --bind here her zaman “geçerli konuşmayı yerinde bağla” anlamına gelir.
• Genel mevcut konuşma bağları paylaşılan OpenClaw bağ deposunu kullanır ve normal gateway yeniden başlatmalarında korunur.

• /acp spawn üzerinde --bind here ile --thread ... birbirini dışlar.
• Discord’da --bind here, mevcut kanal veya thread’i yerinde bağlar. spawnAcpSessions yalnızca OpenClaw’ın --thread auto|here için alt thread oluşturması gerektiğinde gerekir.
• Etkin kanal mevcut konuşma ACP bağlarını açığa çıkarmıyorsa, OpenClaw açık bir desteklenmiyor mesajı döndürür.
• resume ve “new session” soruları kanal soruları değil, ACP oturumu sorularıdır. Geçerli sohbet yüzeyini değiştirmeden çalışma zamanı durumunu yeniden kullanabilir veya değiştirebilirsiniz.

​

Thread’e bağlı oturumlar

• OpenClaw bir thread’i hedef ACP oturumuna bağlar.
• Bu thread içindeki takip mesajları bağlı ACP oturumuna yönlendirilir.
• ACP çıktısı aynı thread’e geri teslim edilir.
• Odağı kaldırma/kapatma/arşivleme/boşta kalma zaman aşımı veya azami yaş süresi dolması bağlamayı kaldırır.

• acp.enabled=true
• acp.dispatch.enabled varsayılan olarak açıktır (ACP dispatch’i duraklatmak için false ayarlayın)
• Kanal bağdaştırıcısı ACP thread-spawn bayrağı etkin olmalı (bağdaştırıcıya özgü)
  • Discord: channels.discord.threadBindings.spawnAcpSessions=true
  • Telegram: channels.telegram.threadBindings.spawnAcpSessions=true

​

Thread destekleyen kanallar

• Oturum/thread bağlama yeteneğini açığa çıkaran herhangi bir kanal bağdaştırıcısı.
• Mevcut yerleşik destek:
  • Discord threads/channels
  • Telegram topics (gruplar/süper gruplardaki forum konuları ve DM konuları)
• Plugin kanalları aynı bağlama arayüzü üzerinden destek ekleyebilir.

​

Kanala özgü ayarlar

​

Bağlama modeli

• bindings[].type="acp" kalıcı bir ACP konuşma bağı işaretler.
• bindings[].match hedef konuşmayı tanımlar:
  • Discord kanal veya thread: match.channel="discord" + match.peer.id="<channelOrThreadId>"
  • Telegram forum konusu: match.channel="telegram" + match.peer.id="<chatId>:topic:<topicId>"
  • BlueBubbles DM/grup sohbeti: match.channel="bluebubbles" + match.peer.id="<handle|chat_id:*|chat_guid:*|chat_identifier:*>" Kararlı grup bağları için chat_id:* veya chat_identifier:* tercih edin.
  • iMessage DM/grup sohbeti: match.channel="imessage" + match.peer.id="<handle|chat_id:*|chat_guid:*|chat_identifier:*>" Kararlı grup bağları için chat_id:* tercih edin.
• bindings[].agentId, sahibi olan OpenClaw agent kimliğidir.
• İsteğe bağlı ACP geçersiz kılmaları bindings[].acp altında bulunur:
  • mode (persistent veya oneshot)
  • label
  • cwd
  • backend

​

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

• agents.list[].runtime.type="acp"
• agents.list[].runtime.acp.agent (harness kimliği, örneğin 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ı (örneğin acp.backend)

{
  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 } },
        },
      },
    },
  },
}

• OpenClaw, yapılandırılan ACP oturumunun kullanımdan önce var olduğundan emin olur.
• O kanal veya konudaki mesajlar yapılandırılan ACP oturumuna yönlendirilir.
• Bağlı konuşmalarda /new ve /reset, aynı ACP oturum anahtarını yerinde sıfırlar.
• Geçici çalışma zamanı bağları (örneğin thread-focus akışlarıyla oluşturulanlar) mevcut oldukları yerlerde yine uygulanır.
• Açık bir cwd olmadan agent’lar arası ACP başlatmalarında OpenClaw, agent yapılandırmasından hedef agent çalışma alanını devralır.
• Eksik devralınan çalışma alanı yolları backend varsayılan cwd’sine geri döner; eksik olmayan erişim hataları ise başlatma hatası olarak yüzeye çıkar.

​

ACP oturumlarını başlatma (arayüzler)

​

sessions_spawn içinden

{
  "task": "Depoyu aç ve başarısız testleri özetle",
  "runtime": "acp",
  "agentId": "codex",
  "thread": true,
  "mode": "session"
}

• runtime varsayılan olarak subagent olur; bu yüzden ACP oturumları için runtime: "acp" değerini açıkça ayarlayın.
• agentId verilmezse, yapılandırılmışsa OpenClaw acp.defaultAgent değerini kullanır.
• mode: "session" kalıcı bağlı konuşmayı korumak için thread: true gerektirir.

• task (zorunlu): ACP oturumuna gönderilen ilk istem.
• runtime (ACP için zorunlu): "acp" olmalıdır.
• agentId (isteğe bağlı): ACP hedef harness kimliği. Ayarlanmışsa acp.defaultAgent değerine geri döner.
• thread (isteğe bağlı, varsayılan false): desteklenen yerlerde thread bağlama akışı ister.
• mode (isteğe bağlı): run (tek seferlik) veya session (kalıcı).
  • varsayılan run değeridir
  • thread: true ise ve kip verilmemişse, OpenClaw çalışma zamanı yoluna göre kalıcı davranışı varsayılan yapabilir
  • mode: "session" için thread: true gerekir
• cwd (isteğe bağlı): istenen çalışma zamanı çalışma dizini (backend/çalışma zamanı ilkesi tarafından doğrulanır). Verilmezse ACP başlatma yapılandırılmışsa hedef agent çalışma alanını devralır; eksik devralınan yollar backend varsayılanlarına geri dönerken gerçek erişim hataları döndürülür.
• label (isteğe bağlı): oturum/banner metninde kullanılan operatör odaklı etiket.
• resumeSessionId (isteğe bağlı): yeni bir oturum oluşturmak yerine mevcut bir ACP oturumunu sürdürür. Agent konuşma geçmişini session/load üzerinden yeniden oynatır. runtime: "acp" gerektirir.
• streamTo (isteğe bağlı): "parent" ilk ACP çalıştırma ilerleme özetlerini sistem olayları olarak istek yapan oturuma akıtır.
  • Mevcut olduğunda, kabul edilen yanıtlar tam relay geçmişi için izleyebileceğiniz oturum kapsamlı JSONL günlüğüne (<sessionId>.acp-stream.jsonl) işaret eden streamLogPath içerebilir.

​

Mevcut bir oturumu sürdürme

{
  "task": "Kaldığımız yerden devam et — kalan test hatalarını düzelt",
  "runtime": "acp",
  "agentId": "codex",
  "resumeSessionId": "<previous-session-id>"
}

• Bir Codex oturumunu dizüstü bilgisayarınızdan telefonunuza devretmek — agent’ınıza kaldığınız yerden devam etmesini söyleyin
• CLI içinde etkileşimli başlattığınız bir kodlama oturumuna artık headless olarak agent’ınız üzerinden devam etmek
• Gateway yeniden başlatması veya boşta kalma zaman aşımı nedeniyle kesilen işi sürdürmek

• resumeSessionId için runtime: "acp" gerekir — sub-agent çalışma zamanı ile kullanılırsa hata döndürür.
• resumeSessionId, yukarı akış ACP konuşma geçmişini geri yükler; thread ve mode, oluşturduğunuz yeni OpenClaw oturumu için yine normal şekilde uygulanır; dolayısıyla mode: "session" için yine thread: true gerekir.
• Hedef agent session/load desteğine sahip olmalıdır (Codex ve Claude Code destekler).
• Oturum kimliği bulunamazsa, başlatma açık bir hata ile başarısız olur — yeni oturuma sessiz geri dönüş yapılmaz.

​

Operatör smoke testi

1. Hedef host üzerinde dağıtılan gateway sürümünü/commit’ini doğrulayın.
2. Dağıtılan kaynağın src/gateway/sessions-patch.ts içinde ACP soy kabulünü içerdiğini doğrulayın (subagent:* or acp:* sessions).
3. Canlı bir agent’a geçici bir ACPX bridge oturumu açın (örneğin jpclawhq üzerindeki razor(main)).
4. O agent’tan şu parametrelerle sessions_spawn çağırmasını isteyin:
   • runtime: "acp"
   • agentId: "codex"
   • mode: "run"
   • görev: Reply with exactly LIVE-ACP-SPAWN-OK
5. Agent’ın şunları bildirdiğini doğrulayın:
   • accepted=yes
   • gerçek bir childSessionKey
   • doğrulayıcı hatası yok
6. Geçici ACPX bridge oturumunu temizleyin.

Use the sessions_spawn tool now with runtime: "acp", agentId: "codex", and mode: "run".
Set the task to: "Reply with exactly LIVE-ACP-SPAWN-OK".
Then report only: accepted=<yes/no>; childSessionKey=<value or none>; error=<exact text or none>.

• Özellikle thread’e bağlı kalıcı ACP oturumlarını test etmiyorsanız bu smoke testi mode: "run" üzerinde tutun.
• Temel kapı için streamTo: "parent" gerektirmeyin. Bu yol istek yapan/oturum yeteneklerine bağlıdır ve ayrı bir entegrasyon kontrolüdür.
• Thread’e bağlı mode: "session" testini gerçek bir Discord thread’i veya Telegram konusu içinden ikinci, daha zengin bir entegrasyon geçişi olarak değerlendirin.

​

Sandbox uyumluluğu

• İstek yapan oturum sandbox içindeyse, ACP başlatmaları hem sessions_spawn({ runtime: "acp" }) hem de /acp spawn için engellenir.
  • Hata: Sandboxed sessions cannot spawn ACP sessions because runtime="acp" runs on the host. Use runtime="subagent" from sandboxed sessions.
• runtime: "acp" ile sessions_spawn, sandbox: "require" desteklemez.
  • Hata: sessions_spawn sandbox="require" is unsupported for runtime="acp" because ACP sessions run outside the sandbox. Use runtime="subagent" or sandbox="inherit".

​

/acp komutundan

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

• --mode persistent|oneshot
• --bind here|off
• --thread auto|here|off
• --cwd <absolute-path>
• --label <name>

​

Oturum hedefi çözümleme

1. Açık hedef argümanı (veya /acp steer için --session)
   • önce anahtarı dener
   • sonra UUID biçimli oturum kimliğini
   • sonra etiketi
2. Geçerli thread bağı (bu konuşma/thread bir ACP oturumuna bağlıysa)
3. Geçerli istek yapan oturumuna geri dönüş

​

Başlatma bağ kipleri

• --bind here, “bu kanal veya sohbeti Codex destekli yap” için en basit operatör yoludur.
• --bind here alt thread oluşturmaz.
• --bind here yalnızca geçerli konuşma bağlama desteği sunan kanallarda kullanılabilir.
• --bind ile --thread aynı /acp spawn çağrısında birleştirilemez.

​

Başlatma thread kipleri

• Thread bağlamayan yüzeylerde varsayılan davranış fiilen off olur.
• Thread’e bağlı başlatma kanal ilkesi desteği gerektirir:
  • Discord: channels.discord.threadBindings.spawnAcpSessions=true
  • Telegram: channels.telegram.threadBindings.spawnAcpSessions=true
• Alt thread oluşturmadan geçerli konuşmayı sabitlemek istediğinizde --bind here kullanın.

​

ACP kontrolleri

• /acp spawn
• /acp cancel
• /acp steer
• /acp close
• /acp status
• /acp set-mode
• /acp set
• /acp cwd
• /acp permissions
• /acp timeout
• /acp model
• /acp reset-options
• /acp sessions
• /acp doctor
• /acp install

​

ACP komut yemek kitabı

​

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

• /acp model <id>, çalışma zamanı yapılandırma anahtarı model ile eşlenir.
• /acp permissions <profile>, çalışma zamanı yapılandırma anahtarı approval_policy ile eşlenir.
• /acp timeout <seconds>, çalışma zamanı yapılandırma anahtarı timeout ile eşlenir.
• /acp cwd <path>, çalışma zamanı cwd geçersiz kılmasını doğrudan günceller.
• /acp set <key> <value>, genel yoldur.
  • Özel durum: key=cwd, cwd geçersiz kılma yolunu kullanır.
• /acp reset-options, hedef oturum için tüm çalışma zamanı geçersiz kılmalarını temizler.

​

acpx harness desteği (mevcut)

• claude
• codex
• copilot
• cursor (Cursor CLI: cursor-agent acp)
• droid
• gemini
• iflow
• kilocode
• kimi
• kiro
• openclaw
• opencode
• pi
• qwen

​

Gerekli yapılandırma

{
  acp: {
    enabled: true,
    // İsteğe bağlı. Varsayılan true'dur; /acp kontrollerini korurken ACP dispatch'i duraklatmak için false ayarlayın.
    dispatch: { enabled: true },
    backend: "acpx",
    defaultAgent: "codex",
    allowedAgents: [
      "claude",
      "codex",
      "copilot",
      "cursor",
      "droid",
      "gemini",
      "iflow",
      "kilocode",
      "kimi",
      "kiro",
      "openclaw",
      "opencode",
      "pi",
      "qwen",
    ],
    maxConcurrentSessions: 8,
    stream: {
      coalesceIdleMs: 300,
      maxChunkChars: 1200,
    },
    runtime: {
      ttlMinutes: 120,
    },
  },
}

{
  session: {
    threadBindings: {
      enabled: true,
      idleHours: 24,
      maxAgeHours: 0,
    },
  },
  channels: {
    discord: {
      threadBindings: {
        enabled: true,
        spawnAcpSessions: true,
      },
    },
  },
}

• Discord: channels.discord.threadBindings.spawnAcpSessions=true

​

acpx backend’i için plugin kurulumu

/acp doctor

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

openclaw plugins install ./path/to/local/acpx-plugin

/acp doctor

​

acpx komut ve sürüm yapılandırması

1. Komut varsayılan olarak ACPX plugin paketi içindeki plugin’e yerel node_modules/.bin/acpx olur.
2. Beklenen sürüm varsayılan olarak extension pin’i olur.
3. Başlangıç, ACP backend’ini hemen hazır-değil olarak kaydeder.
4. Arka plandaki bir ensure işi acpx --version doğrulaması yapar.
5. Plugin’e yerel ikili eksikse veya sürüm uyuşmuyorsa şu komutu çalıştırır: npm install --omit=dev --no-save acpx@<pinned> ve yeniden doğrular.

{
  "plugins": {
    "entries": {
      "acpx": {
        "enabled": true,
        "config": {
          "command": "../acpx/dist/cli.js",
          "expectedVersion": "any"
        }
      }
    }
  }
}

• command, mutlak yol, göreli yol veya komut adı (acpx) kabul eder.
• Göreli yollar OpenClaw çalışma alanı dizininden çözülür.
• expectedVersion: "any" sıkı sürüm eşlemesini devre dışı bırakır.
• command özel bir ikiliyi/yolu gösterdiğinde plugin’e yerel otomatik kurulum devre dışı kalır.
• Backend sağlık kontrolü çalışırken OpenClaw başlangıcı engellemez.

​

Otomatik bağımlılık kurulumu

​

Plugin araçları MCP köprüsü

openclaw config set plugins.entries.acpx.config.pluginToolsMcpBridge true

• ACPX oturum bootstrap’ine openclaw-plugin-tools adlı yerleşik bir MCP sunucusu enjekte eder.
• Yüklü ve etkin OpenClaw plugin’leri tarafından zaten kaydedilmiş plugin araçlarını açığa çıkarır.
• Özelliği açık ve varsayılan olarak kapalı tutar.

• Bu, ACP harness araç yüzeyini genişletir.
• ACP agent’ları yalnızca gateway’de zaten etkin olan plugin araçlarına erişir.
• Bunu, o plugin’lerin OpenClaw içinde yürütülmesine izin vermekle aynı güven sınırı olarak değerlendirin.
• Etkinleştirmeden önce yüklü plugin’leri gözden geçirin.

​

Çalışma zamanı zaman aşımı yapılandırması

openclaw config set plugins.entries.acpx.config.timeoutSeconds 180

​

İzin yapılandırması

​

permissionMode

​

nonInteractivePermissions

​

Yapılandırma

openclaw config set plugins.entries.acpx.config.permissionMode approve-all
openclaw config set plugins.entries.acpx.config.nonInteractivePermissions fail

Önemli: OpenClaw şu anda varsayılan olarak permissionMode=approve-reads ve nonInteractivePermissions=fail kullanır. Etkileşimsiz ACP oturumlarında, izin istemi tetikleyen herhangi bir yazma veya exec işlemi AcpRuntimeError: Permission prompt unavailable in non-interactive mode hatasıyla başarısız olabilir. İzinleri kısıtlamanız gerekiyorsa, oturumlar çökmeden zarif biçimde bozulabilsin diye nonInteractivePermissions değerini deny olarak ayarlayın.

​

Sorun giderme