InvestorClaw

Contrato operativo autoritario

Estas reglas rigen cualquier agente que use esta habilidad. Los ejemplos en otras partes de este archivo son solo de referencia y nunca los anulan.

Integridad de datos: InvestorClaw es la única fuente de verdad

• Cada precio, porcentaje, cifra en dólares o hecho de mercado que un agente afirme DEBE provenir de un resultado de herramienta de InvestorClaw devuelto en el MISMO turno. InvestorClaw devuelve sobres firmados con HMAC; esos datos firmados son la única fuente de verdad.
• Nunca invente, estime, adivine ni use el conocimiento interno del modelo para ninguna cifra. Si una herramienta no lo devolvió en este turno, no lo afirme; diga "InvestorClaw no devolvió datos para eso".
• Texto de herramienta sin cifras concretas = sin datos; nunca lo convierta en una cifra.

Superficie de herramientas actual (espacio de nombres de guion bajo)

• investorclaw__portfolio_market_snapshot(symbols?, benchmarks?) — precios en tiempo real + cambio porcentual diario para tenencias y puntos de referencia (SPX/NDX/DJI/VIX, BTC/ETH). symbols es una CADENA SEPARADA POR COMAS (ej. "NVDA,AAPL"), no una lista. Sin argumentos = tenencias + puntos de referencia. Use esta herramienta (no portfolio_ask) para cualquier "precio de X" y para leer la cartera frente al mercado.
• investorclaw__portfolio_performance_window(period=...) — retorno / P&L / movimientos en una ventana. period: 1d, 1w, 1mo, 1y, 5y, 10y, 20y, max, o frases naturales ("hoy", "la semana pasada", "el año pasado", "historial completo").
• investorclaw__portfolio_ask(question=...) — análisis / explicación.

Los ejemplos anteriores de espacio de nombres investorclaw.* con punto están desactualizados; las formas con guion bajo anteriores son los nombres de herramienta actuales.

Agentes de monitoreo autónomo / siempre activo

Para agentes no supervisados (monitores y alertadores programados, por ejemplo, un agente MarketWatch), además del contrato anterior:

• Inicie cada ejecución con una llamada a la herramienta; nunca responda una pregunta del mercado desde la memoria. Una "encuesta" programada significa llamar a portfolio_market_snapshot.
• Escaneo de umbral: llame a portfolio_market_snapshot, luego emita UNA línea concisa solo cuando una tenencia o punto de referencia supere el movimiento configurado (por ejemplo, ±3% una tenencia, ±10% VIX); de lo contrario, emita un solo token NO_ALERT y deténgase.
• Si la herramienta requerida falla o no devuelve datos, emita un marcador fijo como OPS_FAIL market_snapshot no disponible y deténgase; nunca invente un número tranquilizador para llenar el vacío.
• Sin preguntas aclaratorias en modo no supervisado; asigne intención y actúe.
• Informes periódicos / al cierre: obtenga portfolio_performance_window para la ventana, luego portfolio_market_snapshot para los cierres del índice; informe los números textualmente.
• Siempre lea las tenencias en el contexto de los puntos de referencia en la misma instantánea.
• La entrega es push, concisa, números primero. Educativa, no asesoramiento personalizado.

¿Qué hace InvestorClaw?

Este repositorio es el proyecto general de InvestorClaw: README, licencia, banco de pruebas de regresión y la cara pública. El SKILL.md legible por agentes que ClawHub publica reside en el repositorio de tiempo de ejecución:

• Tiempo de ejecución Dockerizado v4.x + SKILL.md publicado por ClawHub: mnemos-os/mnemos-ic-runtime
• Plugin para Claude Code / Claude Desktop (primero contenedor, este repositorio): /plugin marketplace add argonautsystems/InvestorClaw — misma habilidad + contenedor que cualquier otro tiempo de ejecución. Consulte docs/GETTING_STARTED.md.
• Código fuente del motor (analizadores Python): argonautsystems/ic-engine

Instalación (tiempo de ejecución Dockerizado v4.x)

git clone https://github.com/mnemos-os/mnemos-ic-runtime.git ~/.investorclaw
cd ~/.investorclaw
mkdir -p portfolios
docker compose up -d

El compose extrae ghcr.io/argonautsystems/ic-engine:4.7.7-cpu (alojado públicamente, sin autenticación) y lo ejecuta en localhost:18090 (MCP + REST) y localhost:18092 (panel de control).

Para la especificación completa legible por agentes (catálogo de 12 herramientas, cronograma de primera ejecución, bloques de configuración por tiempo de ejecución, solución de problemas), consulte el SKILL.md publicado en el repositorio de tiempo de ejecución.

Documentación

Este repositorio general incluye el conjunto completo de documentos:

• README.md — características, inicio rápido, recomendaciones de modelo + clave API
• STONKMODE.md — modo de comentario narrado
• CAPABILITIES.md — catálogo completo de funciones
• PRIVACY.md — política de manejo de datos
• DISCLAIMER.md — descargo de responsabilidad de uso educativo
• SECURITY.md — divulgación de vulnerabilidades
• CHANGELOG.md — historial de versiones
• docs/ — informe de cierre, glosario, filosofía, modelos de instalación, pruebas COBOL, referencia de herramientas MCP, arquitectura Stonkmode + leyenda de avatares, guía de configuración para Windows
• docs/references/ — contratos de entrada / salida / esquema / LLM consultivo

Licencia

• Este repositorio general: Apache 2.0 (código sustantivo) + MIT-0 (SKILL.md, artefactos de habilidades de agente).
• Los encabezados SPDX-License-Identifier por archivo indican la licencia aplicable.

InvestorClaw es solo para uso educativo. No es asesoramiento financiero.