SoClaw Integrasi Menang Balik

SoClaw ialah sistem pemulihan autonomi Flash: senarai kerja dalaman ahli bernilai tinggi yang berisiko, satu set alat MCP yang dikawal dan kemahiran membuat keputusan. Anda mengendalikannya dengan menjalankan ejen OpenClaw — masa jalan ejen sumber terbuka yang anda hoskan sendiri — yang memuatkan kemahiran SoClaw dan mengendalikan gelung melalui kunci ejen berskop dan dihadkan.

Panduan ini adalah untuk pengendali/penyepadu tersebut. Untuk gambaran keseluruhan perniagaan, lihat halaman produk SoClaw. Alatan pemulihan dibina pada pelayan MCP yang ditadbir sama yang didokumenkan dalam panduan integrasi MCP.

Alat menang balik (set alat winback)

Tiga alat tulis ialah rate-only — dikawal oleh suis jeda segera dan had kadar tulis, tanpa had nilai setiap panggilan kerana ia tidak membawa nilai muka. Rujuk setiap alat sebagai Flash:<tool_name>.

Tuas wang — berlabuh pada tugas

Ini adalah piawaian Flash alat tulis. Ejen menang balik MESTI lulus task_id tugasan yang dituntut — tanpanya, penulisan kemenangan balik ditolak dengan WINBACK_TASK_REQUIRED. Yang task_id menjadikan penulisan idempoten dan mengikat lengan penangguhan yang dikuatkuasakan oleh pelayan. Satu tindakan wang bagi setiap tugasan.

Gunakan sendiri masa jalan OpenClaw + kemahiran SoClaw

Flash menyampaikan sistem yang menang-kembali (senarai kerja, alat MCP, penguatkuasaan keselamatan) dan kemahiran SoClaw (doktrin keputusan + buku panduan). Anda membawa masa jalan: hos sendiri ejen OpenClaw, halakannya pada pelayan Flash MCP dengan kunci ejen anda dan muatkan kemahiran tersebut. Pengehosan kendiri memberi anda kawalan operasi — konfigurasi, pantau, pin versi dan bunuh kunci — tetapi ia tidak melonggarkan model keselamatan: pihak MCP melayan ejen sebagai luaran tanpa mengira.

Daftar Flash sebagai pelayan HTTP MCP (kunci pelayan mestilah betul-betul flash):

export FLASH_WINBACK_KEY="fl_live_your_agent_key_here"

# in the OpenClaw runtime's MCP config
{
  "mcpServers": {
    "flash": {
      "type": "http",
      "url": "https://flash.socialhub.ai/api/mcp",
      "headers": { "Authorization": "Bearer ${FLASH_WINBACK_KEY}" }
    }
  }
}

Muat turun kemahiran SoClaw (SKILL.md + doktrin · tuas · aliran kerja · rujukan), masukkan ke dalam direktori kemahiran masa jalan OpenClaw anda dan jalankan gelung:

SoClaw juga berfungsi dengan senarai kerja keputusan melangkaui kemenangan balik — kelulusan (semakan pesanan saluran) dan penipuan (rujukan isi rumah yang sama) — melalui gelung pajakan yang sama (claim_agent_task → get_agent_task → complete_agent_task). Kesannya melalui penulisan idempoten sedia ada Flash; setiap keputusan juga boleh dimajukan kepada manusia.

Semakan kendiri:

• Ejen sepatutnya hanya melihat set alat menang balik + alat tuas yang dibenarkan oleh skop kunci anda — tiada yang lain.
• claim_winback_task pertama mengembalikan tugasan dengan pajakan, atau NO_TASKS_AVAILABLE / WINBACK_DISABLED — kedua-duanya adalah keadaan berhenti biasa, bukan kegagalan.
• Panggilan kupon/mata tanpa task_id mesti kembali WINBACK_TASK_REQUIRED — sahkan gelung anda sentiasa menambat tuas kepada tugas yang dituntut.

Pengendalian ralat & kod

Dua saluran. Ralat protokol (JSON-RPC: kaedah buruk / alat tidak diketahui) biasanya bermaksud nama alat yang salah — semak awalan dan ejaan Flash:. Hasil isError: true ialah sempadan keras yang boleh anda baca — sampaikannya sekali dan ambil langkah seterusnya. Jangan sekali-kali cuba memintasnya semula.

Satu lagi: meta.hasData: false daripada alat metrik ialah kejayaan, bukan ralat — ia bermaksud "tiada data untuk tetingkap itu", tidak pernah 0.

Peningkatan kedudukan — cara senarai kerja disusun

Keutamaan senarai kerja ialah nilai-berisiko × peningkatan apabila model peningkatan sesuai untuk pasukan, dan nilai-berisiko-tulen sebaliknya. Tukar adalah automatik, diputuskan setiap imbasan — tiada apa yang perlu dikonfigurasikan.

Model ini ialah dua model peningkatan logistik, yang dipasang setiap pasukan pada setiap imbasan daripada data penangguhan rawak program sendiri — baris atribusi matang sahaja, dengan definisi penukaran yang sama merentasi kedua-dua cabang:

uplift(x) = P(convert | treated, x) − P(convert | holdout, x)

Kesesuaian adalah deterministik — tiada kerawakan persampelan — jadi data yang sama sentiasa menghasilkan kedudukan yang sama.

Gerbang sampel — semua mesti lulus sebelum model itu dipercayai

• ≥ 200 baris matang dirawat
• ≥ 50 baris holdout yang telah matang
• ≥ 20 penukaran
• Kedua-dua kesesuaian logistik bertemu

Di bawah get mana-mana, model dibuang untuk imbasan tersebut (null) dan kedudukan kembali kepada nilai tulen berisiko — perubahan tingkah laku sifar, bukan tekaan yang direndahkan. Anggaran peningkatan negatif (kesilapan yang diukur) meletakkan keutamaan tugas pada 0 — tugas kekal kelihatan dalam senarai kerja, dengan nombor yang menyatakan sebabnya.