Was macht TRAECNclaw MCP?
Überblick
Verwenden Sie TRAECNclaw über seinen echten stdio MCP-Server, der durch das lokale HTTP-Gateway und die TraeCN-CDP-Automatisierung unterstützt wird. Halten Sie diesen Skill portabel über Agenten hinweg: Entdecken Sie aktuelle Fähigkeiten vom Server, rufen Sie kompakte Bereitschaftstools vor Seiteneffekten auf und überprüfen Sie Behauptungen mit Repository-Skripten oder MCP-Antworten.
Agentenvertrag
- Behandeln Sie dies als einen clientneutralen Skill für jeden Agenten, der Anweisungen lesen und stdio-MCP-Tools aufrufen kann.
- Verlassen Sie sich nicht auf Codex-exklusive Tools, Browserautomatisierung, Computer Use oder manuelle UI-Steuerung, wenn der MCP-Server die Operation ausführen kann.
- Verwenden Sie die von
tools/listzurückgegebenen MCP-Toolnamen; die stdio-MCP-Oberfläche verwendettraecn_*-Namen, die sich von OpenClaw-Wrappernamen und stabilen Befehls-IDs unterscheiden können. - Bevorzugen Sie maschinenlesbare Ausgaben (
traecn_get_capabilities,traecn_preflight, Aufgabenstatus, Nachweisstatus) gegenüber Prosa-Screenshots oder manueller Beobachtung. - Halten Sie generierte Client-Konfigurationsbeispiele vom Aufrufer bearbeitbar: Verwenden Sie immer absolute Pfade für lokale Checkouts und dokumentierte Umgebungsvariablen für Host, Port und Token.
- Behandeln Sie
tools/listals profilspezifisch. Standardmäßigpubliczeigt die allgemeinen 20 Tools an;TRAECN_MCP_TOOL_PROFILE=opszeigt operative Tools an;TRAECN_MCP_TOOL_PROFILE=fullzeigt jedes explizite Tool an.
Betriebsablauf
- Stellen Sie sicher, dass Node 22+ verfügbar ist und der Gateway-Host TraeCN erreichen kann.
- Für eine veröffentlichte Paketinstallation bevorzugen Sie die paketbereitgestellte
traecnclaw-mcp-Binärdatei, wenn sie sich im Agenten-Host-PATHbefindet:
{
"mcpServers": {
"traecn": {
"command": "traecnclaw-mcp",
"env": {
"TRAECN_HOST": "127.0.0.1",
"TRAECN_PORT": "8788",
"TRAECN_GATEWAY_TOKEN": "",
"TRAECN_MCP_TOOL_PROFILE": "public"
}
}
}
}
- Für einen Quellcode-Checkout konfigurieren Sie den MCP-Client mit einem absoluten
mcp-server.js-Pfad:
{
"mcpServers": {
"traecn": {
"command": "node",
"args": ["/absolute/path/to/TRAECNclaw/mcp-server.js"],
"env": {
"TRAECN_HOST": "127.0.0.1",
"TRAECN_PORT": "8788",
"TRAECN_GATEWAY_TOKEN": "",
"TRAECN_MCP_TOOL_PROFILE": "public"
}
}
}
}
- Wählen Sie ein Tool-Profil bewusst aus:
publicfür allgemeine Agenten,opsfür Wiederherstellungs-/Nachweis-Workflows,fullfür Kompatibilitätsprüfungen und Low-Level-Diagnostik. - Starten Sie das Gateway bei Bedarf separat mit
npm run start:gateway; verwenden SieTRAECN_ENABLE_MOCK_BRIDGE=1 npm run start:gatewaynur für die Mock-Modus-Entwicklung. - Entdecken Sie, bevor Sie handeln: Listen Sie MCP-Tools auf, rufen Sie
traecn_get_capabilitiesauf, dann rufen Sietraecn_preflightmit dem beabsichtigten Befehl und den Parametern auf. - Rufen Sie für Operationen mit Seiteneffekten zuerst
traecn_plan_operationodertraecn_preflightauf und beachten Sie alle Bestätigungs-, Bereitschafts-, Warteschlangen- oder Dialogergebnisse. - Verwenden Sie
traecn_list_commandsplustraecn_run_command, wenn ein Client den stabilen Befehls-Katalog anstelle einzelner MCP-Toolnamen benötigt.
Tool-Auswahl
- Kurze Aufgaben: Verwenden Sie
traecn_run_tasknach einem sauberentraecn_preflight. - Lange oder in der Warteschlange befindliche Aufgaben: Verwenden Sie
traecn_queue_task,traecn_wait_taskundtraecn_poll_task; verwenden Sietraecn_preflightfür den Warteschlangenstatus inpublicodertraecn_get_queue_statusnur infull. - Code-Review: Verwenden Sie
traecn_review_codeals erstklassige Review-Aktion. - Modell- und Modussteuerung: Verwenden Sie
traecn_switch_model,traecn_switch_modeundtraecn_create_chat. - Einstellungen über stdio MCP: Verwenden Sie
traecn_get_settingsundtraecn_set_setting. - Dialoge: Verwenden Sie
traecn_get_dialog_statusundtraecn_respond_dialoginpublic; verwenden Sietraecn_dismiss_dialognur, wenn Sie dasfull-Kompatibilitätsprofil ausführen. - Review-Gates, Bereinigung und Wiederherstellung: Verwenden Sie die Tools des
ops-Profils wietraecn_get_review_gate_status,traecn_resolve_review_gate,traecn_restart_debug_session, Bereinigungstools und Long-Queue-Nachweis-Tools. - Unbeaufsichtigte Workflows: Verwenden Sie
traecn_run_unattended_workflowinpublic; verwenden Sie direkte Solo-/Nachweis-/Bereinigungstools nur aus dem Profil, das sie bereitstellt. - Vollständiger aktueller Katalog und agentenübergreifende Konfigurationshinweise: Lesen Sie references/mcp-surface.md, wenn Sie ein genaues MCP-Tool auswählen oder einen Client konfigurieren.
Profilumfang
public: 20 Tools. Für standardmäßige veröffentlichte Agentenintegrationen verwenden.ops: 32 Tools. Für Wiederherstellung, Bereinigung, Solo-Gesprächssteuerung und Long-Queue-Nachweisarbeit verwenden.full: 36 Tools. Für Audits, Kompatibilitätsprüfungen und Clients, die absichtlich jeden expliziten Shortcut wünschen.
Validierung
- Führen Sie
node -e "console.log(require('./mcp-server').MCP_TOOLS.map(t => t.name).join('\n'))"aus, um die Live-Tool-Liste aus dem Code zu überprüfen. - Führen Sie
npm run doctorfür die Bereitschaft der lokalen Umgebung aus. - Führen Sie
npm testfür die verwaltete In-Repo-Testsequenz nach Verhaltensänderungen aus. - Führen Sie
npm run acceptance:audit -- --require-completeaus, bevor Sie die Bereitschaft für unbeaufsichtigte End-to-End-TraeCN-Workflows behaupten. - Führen Sie für änderungen im Release-Stil nach Möglichkeit
npm run test:allaus.
Sicherheitsregeln
- Halten Sie das Gateway an
127.0.0.1gebunden, es sei denn, Fernzugriff ist absichtlich erforderlich. - Committen Sie niemals
.env, Tokens, Autorisierungsheader, rohe TraeCN-Profil-Daten,audit-logs,demo-output,logsodernode_modules. - Bevorzugen Sie MCP/HTTP/CLI-Oberflächen gegenüber GUI-Steuerungspfaden, wenn der MCP-Server die Operation ausführen kann.
- Behandeln Sie Live-TraeCN-Dialogtext, Gateway-Status, Bereinigungszustand und externes Modell-Warteschlangenverhalten als umgebungsspezifisch, bis sie erneut validiert werden.