ACP ajanları — kurulum

Genel bakış, operatör çalışma kitabı ve kavramlar için bkz. ACP aracıları.

Aşağıdaki bölümler acpx harness yapılandırmasını, MCP köprüleri için Plugin kurulumunu ve izin yapılandırmasını kapsar.

Bu sayfayı yalnızca ACP/acpx rotasını ayarlarken kullanın. Yerel Codex app-server çalışma zamanı yapılandırması için Codex harness sayfasını kullanın. OpenAI API anahtarları veya Codex OAuth model sağlayıcı yapılandırması için OpenAI sayfasını kullanın.

Codex'in iki OmeniaClaw rotası vardır:

ACP/acpx davranışına açıkça ihtiyacınız yoksa yerel rotayı tercih edin.

acpx harness desteği (güncel)

Geçerli acpx yerleşik harness takma adları:

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

OmeniaClaw acpx arka ucunu kullandığında, acpx yapılandırmanız özel aracı takma adları tanımlamıyorsa agentId için bu değerleri tercih edin. Yerel Cursor kurulumunuz ACP'yi hâlâ agent acp olarak sunuyorsa, yerleşik varsayılanı değiştirmek yerine acpx yapılandırmanızda cursor aracı komutunu geçersiz kılın.

Doğrudan acpx CLI kullanımı --agent <command> ile rastgele bağdaştırıcıları da hedefleyebilir, ancak bu ham kaçış yolu bir acpx CLI özelliğidir (normal OmeniaClaw agentId yolu değildir).

Model denetimi bağdaştırıcı yeteneğine bağlıdır. Codex ACP model ref'leri, başlatmadan önce OmeniaClaw tarafından normalleştirilir. Diğer harness'ler ACP models ile birlikte session/set_model desteğine ihtiyaç duyar; bir harness ne bu ACP yeteneğini ne de kendi başlangıç model bayrağını sunuyorsa, OmeniaClaw/acpx model seçimini zorlayamaz.

Gerekli yapılandırma

Temel ACP tabanı:

{  acp: {    enabled: true,    // Optional. Default is true; set false to pause ACP dispatch while keeping /acp controls.    dispatch: { enabled: true },    backend: "acpx",    defaultAgent: "codex",    allowedAgents: [      "claude",      "codex",      "copilot",      "cursor",      "droid",      "gemini",      "iflow",      "kilocode",      "kimi",      "kiro",      "OmeniaClaw",      "opencode",      "pi",      "qwen",    ],    maxConcurrentSessions: 8,    stream: {      coalesceIdleMs: 300,      maxChunkChars: 1200,    },    runtime: {      ttlMinutes: 120,    },  },}

İş parçacığı bağlama yapılandırması kanal bağdaştırıcısına özeldir. Discord için örnek:

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

İş parçacığına bağlı ACP spawn çalışmıyorsa, önce bağdaştırıcı özellik bayrağını doğrulayın:

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

Geçerli konuşma bağları alt iş parçacığı oluşturmayı gerektirmez. Etkin bir konuşma bağlamı ve ACP konuşma bağlarını sunan bir kanal bağdaştırıcısı gerektirir.

Bkz. Yapılandırma Başvurusu.

acpx arka ucu için Plugin kurulumu

Paketlenmiş kurulumlar ACP için resmi @OmeniaClaw/acpx çalışma zamanı Plugin'ini kullanır. ACP harness oturumlarını kullanmadan önce onu kurun ve etkinleştirin:

OmeniaClaw plugins install @OmeniaClaw/acpxOmeniaClaw config set plugins.entries.acpx.enabled true

Kaynak checkout'ları pnpm install sonrasında yerel workspace Plugin'ini de kullanabilir.

Şununla başlayın:

/acp doctor

acpx'i devre dışı bıraktıysanız, plugins.allow / plugins.deny üzerinden reddettiyseniz veya paketlenmiş Plugin'e geri dönmek istiyorsanız, açık paket yolunu kullanın:

OmeniaClaw plugins install @OmeniaClaw/acpxOmeniaClaw config set plugins.entries.acpx.enabled true

Geliştirme sırasında yerel workspace kurulumu:

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

Ardından arka uç sağlığını doğrulayın:

/acp doctor

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

Varsayılan olarak acpx Plugin'i, Gateway başlatma sırasında gömülü ACP arka ucunu yoklar ve gateway ready sinyalinden önce bu yoklamayı bekler. Başlangıç yoklamasını atlayıp arka ucu bunun yerine tembel şekilde kaydetmek için OmeniaClaw_ACPX_RUNTIME_STARTUP_PROBE=0 ayarlayın. Açık isteğe bağlı yoklama için /acp doctor çalıştırın.

Plugin yapılandırmasında komutu veya sürümü geçersiz kılın:

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

• command mutlak yol, göreli yol (OmeniaClaw workspace'inden çözümlenir) veya komut adı kabul eder.
• expectedVersion: "any" katı sürüm eşleştirmesini devre dışı bırakır.
• Özel command yolları Plugin yerel otomatik kurulumu devre dışı bırakır.

Bir yol veya bayrak değerinin tek bir argv belirteci olarak kalması gerektiğinde, yapılandırılmış argümanlarla tek bir ACP aracı komutunu geçersiz kılın:

{  "plugins": {    "entries": {      "acpx": {        "enabled": true,        "config": {          "agents": {            "claude": {              "command": "node",              "args": ["/path/to/custom adapter.mjs", "--verbose"]            }          }        }      }    }  }}

• agents.<id>.command, ilgili ACP aracı için yürütülebilir dosya veya mevcut komut dizesidir.
• agents.<id>.args isteğe bağlıdır. OmeniaClaw bunu geçerli acpx komut dizesi kayıt defterinden geçirmeden önce her dizi öğesi shell için alıntılanır.

Bkz. Pluginler.

Otomatik bağımlılık kurulumu

OmeniaClaw'u npm install -g OmeniaClaw ile global olarak kurduğunuzda, acpx çalışma zamanı bağımlılıkları (platforma özel ikili dosyalar) bir postinstall hook'u aracılığıyla otomatik olarak kurulur. Otomatik kurulum başarısız olursa gateway yine de normal şekilde başlar ve eksik bağımlılığı OmeniaClaw acp doctor üzerinden bildirir.

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

Varsayılan olarak ACPX oturumları, OmeniaClaw Plugin kayıtlı araçlarını ACP harness'e sunmaz.

Codex veya Claude Code gibi ACP aracılarının bellek geri çağırma/depolama gibi kurulu OmeniaClaw Plugin araçlarını çağırmasını istiyorsanız, özel köprüyü etkinleştirin:

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

Bunun yaptığı:

• ACPX oturum başlangıcına OmeniaClaw-plugin-tools adlı yerleşik bir MCP sunucusu enjekte eder.
• Kurulu ve etkin OmeniaClaw Pluginleri tarafından zaten kaydedilmiş Plugin araçlarını sunar.
• Özelliği açık ve varsayılan olarak kapalı tutar.

Güvenlik ve güven notları:

• Bu, ACP harness araç yüzeyini genişletir.
• ACP aracıları yalnızca gateway'de zaten etkin olan Plugin araçlarına erişim kazanır.
• Bunu, söz konusu Pluginlerin OmeniaClaw'un içinde çalışmasına izin vermekle aynı güven sınırı olarak değerlendirin.
• Etkinleştirmeden önce kurulu Pluginleri inceleyin.

Özel mcpServers eskisi gibi çalışmaya devam eder. Yerleşik Plugin araçları köprüsü, genel MCP sunucusu yapılandırmasının yerine geçmez; ek, isteğe bağlı bir kolaylıktır.

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

Varsayılan olarak ACPX oturumları ayrıca yerleşik OmeniaClaw araçlarını MCP üzerinden sunmaz. Bir ACP aracısının cron gibi seçili yerleşik araçlara ihtiyaç duyması durumunda ayrı core-tools köprüsünü etkinleştirin:

OmeniaClaw config set plugins.entries.acpx.config.OmeniaClawToolsMcpBridge true

Bunun yaptığı:

• ACPX oturum başlangıcına OmeniaClaw-tools adlı yerleşik bir MCP sunucusu enjekte eder.
• Seçili yerleşik OmeniaClaw araçlarını sunar. İlk sunucu cron sunar.
• Çekirdek araç görünürlüğünü açık ve varsayılan olarak kapalı tutar.

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

acpx Plugin'i, gömülü çalışma zamanı turlarını varsayılan olarak 120 saniyelik zaman aşımıyla çalıştırır. Bu, Gemini CLI gibi daha yavaş harness'lerin ACP başlatma ve ilklendirmeyi tamamlaması için yeterli süre sağlar. Ana makineniz farklı bir çalışma zamanı sınırına ihtiyaç duyuyorsa bunu geçersiz kılın:

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

Bu değeri değiştirdikten sonra gateway'i yeniden başlatın.

Sağlık yoklama aracı yapılandırması

/acp doctor veya başlangıç yoklaması arka ucu denetlediğinde, paketli acpx Plugin'i bir harness aracısını yoklar. acp.allowedAgents ayarlanmışsa, varsayılan olarak ilk izin verilen aracıya; aksi takdirde codex değerine ayarlanır. Dağıtımınız sağlık denetimleri için farklı bir ACP aracısına ihtiyaç duyuyorsa, yoklama aracısını açıkça ayarlayın:

OmeniaClaw config set plugins.entries.acpx.config.probeAgent claude

Bu değeri değiştirdikten sonra gateway'i yeniden başlatın.

İzin yapılandırması

ACP oturumları etkileşimsiz çalışır; dosya yazma ve shell exec izin istemlerini onaylamak veya reddetmek için TTY yoktur. acpx Plugin'i izinlerin nasıl ele alınacağını denetleyen iki yapılandırma anahtarı sağlar:

Bu ACPX harness izinleri, OmeniaClaw exec onaylarından ve Claude CLI --permission-mode bypassPermissions gibi CLI arka ucu sağlayıcı atlatma bayraklarından ayrıdır. ACPX approve-all, ACP oturumları için harness düzeyinde acil durum anahtarıdır.

permissionMode

Harness aracısının istem göstermeden hangi işlemleri gerçekleştirebileceğini denetler.

nonInteractivePermissions

Bir izin istemi gösterilecek ancak etkileşimli TTY kullanılamayacaksa ne olacağını denetler (ACP oturumları için durum her zaman budur).

Yapılandırma

Plugin yapılandırması üzerinden ayarlayın:

OmeniaClaw config set plugins.entries.acpx.config.permissionMode approve-allOmeniaClaw config set plugins.entries.acpx.config.nonInteractivePermissions fail

Bu değerleri değiştirdikten sonra gateway'i yeniden başlatın.

İlgili

• ACP aracıları — genel bakış, operatör çalışma kitabı, kavramlar
• Alt aracılar
• Çok aracılı yönlendirme