​

ACP ajanları

​

Hangi sayfayı istiyorum?

​

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

• Yeni kurulumlar artık paketlenmiş acpx çalışma zamanı plugin’i varsayılan olarak etkin şekilde gelir.
• Paketlenmiş acpx plugin’i kendi plugin yerel sabitlenmiş acpx ikili dosyasını tercih eder.
• Başlangıçta OpenClaw bu ikiliyi yoklar ve gerekirse kendi kendine onarır.
• Hızlı bir hazır olma denetimi istiyorsanız /acp doctor ile başlayın.

• Hedef bir harness bağdaştırıcısı, o harness’i ilk kullandığınızda npx ile isteğe bağlı olarak getirilebilir.
• Bu harness için sağlayıcı kimlik doğrulamasının yine de ana makinede mevcut olması gerekir.
• Ana makinede npm/ağ erişimi yoksa, ilk çalıştırma bağdaştırıcı indirmeleri önbellekler ısıtılana veya bağdaştırıcı başka bir şekilde kurulana kadar başarısız olabilir.

• /acp spawn codex: OpenClaw acpx önyüklemesine hazır olmalıdır, ancak Codex ACP bağdaştırıcısı yine de ilk çalıştırmada getirilmeyi gerektirebilir.
• /acp spawn claude: Claude ACP bağdaştırıcısı için de durum aynıdır; ayrıca o ana makinede Claude tarafı kimlik doğrulaması 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şmada veya başlıkta çalışın (veya o oturum anahtarını açıkça hedefleyin).
3. Çalışma zamanı durumunu denetleyin:
   • /acp status
4. Gerektikçe ç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 günlüğü sıkılaştır ve devam et
6. Çalışmayı durdurun:
   • /acp cancel (mevcut turu 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 başlıkta 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 takipleri aynı çalışma alanında tut.”
• “Bu görev için bir başlıkta Gemini CLI kullan, sonra takipleri aynı başlıkta tut.”

1. runtime: "acp" seçmek.
2. İstenen harness hedefini çözmek (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 başlık bağı isteniyorsa ve mevcut kanal bunu destekliyorsa, ACP oturumunu o başlığa bağlamak.
5. Takip eden bağlı mesajları odağı kaldırılana/kapatılana/süresi dolana kadar aynı ACP oturumuna yönlendirmek.

​

ACP ve alt ajanlar karşılaştırması

​

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

1. OpenClaw ACP oturum denetim 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, doğrudan claude-cli/... yedek çalışma zamanı ile aynı şey değildir.
• ACP Claude; ACP denetimleri, oturum sürdürme, arka plan görevi takibi ve isteğe bağlı konuşma/başlık bağlama içeren bir harness oturumudur.
• claude-cli/... yalnızca metin tabanlı yerel bir CLI arka ucudur. Bkz. CLI Arka Uçları.

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

​

Bağlı oturumlar

​

Mevcut konuşmaya bağlamalar

• OpenClaw, kanal taşımasını, kimlik doğrulamayı, güvenliği ve teslimatı yönetmeye devam eder.
• Geçerli konuşma, başlatılan ACP oturum anahtarına sabitlenir.
• O 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ğ, bu oturumu mevcut konuşmaya ekler.
• --bind here kendi başına alt bir Discord başlığı veya Telegram konusu oluşturmaz.
• ACP çalışma zamanının yine de kendi çalışma dizini (cwd) veya arka uç tarafından yönetilen diskte bir çalışma alanı olabilir. Bu çalışma zamanı alanı sohbet yüzeyinden ayrıdır ve yeni bir mesajlaşma başlığı anlamına gelmez.
• Farklı bir ACP ajanına başlatma yaparsanız ve --cwd vermezseniz, OpenClaw varsayılan olarak isteği gönderenin değil hedef ajanın çalışma alanını devralır.
• Devralınan çalışma alanı yolu yoksa (ENOENT/ENOTDIR), OpenClaw yanlış ağacı sessizce yeniden kullanmak yerine arka uç varsayılan cwd’sine geri döner.
• Devralınan çalışma alanı varsa ancak erişilemiyorsa (örneğin EACCES), başlatma cwd’yi bırakmak yerine gerçek erişim hatasını döndürür.

• 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 başlık/konu: yalnızca --thread ... ile 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, arka uç çalışma alanı)

• /acp spawn codex --bind here: bu sohbeti korur, bir Codex ACP oturumu başlatır veya ona bağlanır ve gelecekteki mesajları buradan oraya yönlendirir
• /acp spawn codex --thread auto: OpenClaw bir alt başlık/konu oluşturabilir ve ACP oturumunu oraya bağlayabilir
• /acp spawn codex --bind here --cwd /workspace/repo: yukarıdaki ile aynı sohbet bağı, ancak Codex /workspace/repo içinde çalışır

• Geçerli konuşma bağlama desteği bildiren sohbet/mesaj kanalları, paylaşılan konuşma bağlama yolu üzerinden --bind here kullanabilir.
• Özel başlık/konu anlambilimi olan kanallar, yine aynı paylaşılan arayüz arkasında kanala özgü kanonikleştirme 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ğlama deposunu kullanır ve normal gateway yeniden başlatmalarında korunur.

• /acp spawn üzerinde --bind here ve --thread ... birbirini dışlar.
• Discord’da --bind here, mevcut kanalı veya başlığı yerinde bağlar. spawnAcpSessions yalnızca OpenClaw’ın --thread auto|here için alt bir başlık oluşturması gerektiğinde gerekir.
• Etkin kanal mevcut konuşma ACP bağlarını sunmuyorsa, OpenClaw açık bir desteklenmiyor mesajı döndürür.
• resume ve “yeni oturum” 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.

​

Başlığa bağlı oturumlar

• OpenClaw bir başlığı hedef ACP oturumuna bağlar.
• O başlıktaki takip mesajları bağlı ACP oturumuna yönlendirilir.
• ACP çıktısı aynı başlığa geri teslim edilir.
• Odak kaldırma/kapatma/arşivleme/boşta kalma zaman aşımı veya maksimum yaş süresi dolması bağı kaldırır.

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

​

Başlık destekleyen kanallar

• Oturum/başlık bağlama yeteneğini açığa çıkaran herhangi bir kanal bağdaştırıcısı.
• Mevcut yerleşik destek:
  • Discord başlıkları/kanalları
  • Telegram konuları (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ğını işaretler.
• bindings[].match hedef konuşmayı tanımlar:
  • Discord kanalı veya başlığı: 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, sahip OpenClaw ajan kimliğidir.
• İsteğe bağlı ACP geçersiz kılmaları bindings[].acp altında yaşar:
  • mode (persistent veya oneshot)
  • label
  • cwd
  • backend

​

Ajan 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ılmış ACP oturumunun kullanımdan önce var olduğundan emin olur.
• O kanaldaki veya konudaki mesajlar yapılandırılmış 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 başlık odak akışları tarafından oluşturulanlar) mevcut oldukları yerde yine uygulanır.
• Açık bir cwd olmadan ajanlar arası ACP başlatmalarında OpenClaw, hedef ajan çalışma alanını ajan yapılandırmasından devralır.
• Eksik devralınmış çalışma alanı yolları arka uç varsayılan cwd’ye geri döner; eksik olmayan erişim hataları ise başlatma hatası olarak gösterilir.

​

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

​

sessions_spawn üzerinden

{
  "task": "Repoyu 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 atlanırsa, yapılandırılmışsa OpenClaw acp.defaultAgent kullanır.
• mode: "session" kalıcı bağlı bir konuşma tutmak 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üşer.
• thread (isteğe bağlı, varsayılan false): desteklenen yerlerde başlık bağlama akışını ister.
• mode (isteğe bağlı): run (tek seferlik) veya session (kalıcı).
  • varsayılan run’dır
  • thread: true ve mode atlanmışsa, OpenClaw çalışma zamanı yoluna göre varsayılan olarak kalıcı davranış seçebilir
  • mode: "session" için thread: true gerekir
• cwd (isteğe bağlı): istenen çalışma zamanı çalışma dizini (arka uç/çalışma zamanı ilkesi tarafından doğrulanır). Atlanırsa, ACP başlatma yapılandırılmışsa hedef ajan çalışma alanını devralır; eksik devralınan yollar arka uç varsayılanlarına geri düşer, gerçek erişim hataları ise 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 ACP oturumunu sürdürür. Ajan konuşma geçmişini session/load ile yeniden oynatır. runtime: "acp" gerektirir.
• streamTo (isteğe bağlı): "parent" ilk ACP çalışma ilerleme özetlerini sistem olayları olarak isteği yapan oturuma geri akıtır.
  • Kullanılabildiğinde, kabul edilen yanıtlarda tam aktarma geçmişi için izleyebileceğiniz oturum kapsamlı bir JSONL günlük dosyasına (<sessionId>.acp-stream.jsonl) işaret eden streamLogPath bulunur.

​

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 — ajanınıza kaldığınız yerden devam etmesini söyleyin
• CLI’de etkileşimli olarak başlattığınız bir kodlama oturumunu artık ajanınız üzerinden başsız olarak sürdürmek
• Gateway yeniden başlatması veya boşta kalma zaman aşımı nedeniyle kesilen çalışmayı devam ettirmek

• resumeSessionId için runtime: "acp" gerekir — alt ajan çalışma zamanı ile kullanılırsa hata döner.
• resumeSessionId, üst akış ACP konuşma geçmişini geri yükler; thread ve mode yine de oluşturmakta olduğunuz yeni OpenClaw oturumuna normal şekilde uygulanır, bu nedenle mode: "session" için hâlâ thread: true gerekir.
• Hedef ajan 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 bir oturuma sessiz geri dönüş yoktur.

​

Operatör smoke testi

1. Hedef ana makinede dağıtılmış gateway sürümünü/commit’ini doğrulayın.
2. Dağıtılmış 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 ajana geçici bir ACPX köprü oturumu açın (örneğin jpclawhq üzerinde razor(main)).
4. O ajandan şu özelliklerle sessions_spawn çağırmasını isteyin:
   • runtime: "acp"
   • agentId: "codex"
   • mode: "run"
   • görev: Reply with exactly LIVE-ACP-SPAWN-OK
5. Ajanın şunları bildirdiğini doğrulayın:
   • accepted=yes
   • gerçek bir childSessionKey
   • doğrulayıcı hatası yok
6. Geçici ACPX köprü 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>.

• Kasıtlı olarak başlığa bağlı kalıcı ACP oturumlarını test etmiyorsanız bu smoke testini mode: "run" üzerinde tutun.
• Temel geçit için streamTo: "parent" gerektirmeyin. Bu yol, istekte bulunan/oturum yeteneklerine bağlıdır ve ayrı bir entegrasyon denetimidir.
• Başlığa bağlı mode: "session" testini gerçek bir Discord başlığından veya Telegram konusundan ikinci, daha zengin bir entegrasyon geçişi olarak ele alın.

​

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" desteği sunmaz.
  • 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 başlık bağı (bu konuşma/başlık bir ACP oturumuna bağlıysa)
3. Geçerli istek yapan oturumuna geri dönüş

​

Başlatma bağlama modları

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

​

Başlatma başlık modları

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

​

ACP denetimleri

• /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şleşir.
• /acp permissions <profile>, çalışma zamanı yapılandırma anahtarı approval_policy ile eşleşir.
• /acp timeout <seconds>, çalışma zamanı yapılandırma anahtarı timeout ile eşleşir.
• /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 denetimlerini korurken ACP dağıtımını 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 arka ucu 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 yerel node_modules/.bin/acpx olur.
2. Beklenen sürüm varsayılan olarak extension sabitlemesine göre belirlenir.
3. Başlangıç, ACP arka ucunu anında hazır değil olarak kaydeder.
4. Arka plandaki bir ensure işi acpx --version doğrulaması yapar.
5. Plugin 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", katı sürüm eşlemesini devre dışı bırakır.
• command özel bir ikili/yola işaret ettiğinde, plugin yerel otomatik kurulum devre dışı kalır.
• Arka uç sağlık denetimi çalışırken OpenClaw başlangıcı engelleyici olmadan devam eder.

​

Otomatik bağımlılık kurulumu

​

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

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

• ACPX oturumu önyüklemesine 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 ajanları yalnızca gateway içinde zaten etkin olan plugin araçlarına erişim kazanır.
• Bunu, aynı 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.

​

İ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 ile başarısız olabilir. İzinleri kısıtlamanız gerekiyorsa, oturumlar çökme yerine zarif biçimde bozulsun diye nonInteractivePermissions değerini deny yapın.

​

Sorun giderme