Habilidad de Cartera
Hansen almacena las tenencias de inversión en ~/.openclaw/workspace/data/portfolio.db (SQLite).
Comandos Rápidos
# Ver resumen
python3 ~/.openclaw/workspace/skills/portfolio/scripts/portfolio.py summary
# Tomar una instantánea (registra los valores de hoy)
python3 ~/.openclaw/workspace/skills/portfolio/scripts/portfolio.py snapshot
# Ver instantáneas históricas
python3 ~/.openclaw/workspace/skills/portfolio/scripts/portfolio.py history
# Mostrar tabla completa (todos los 28 campos)
python3 ~/.openclaw/workspace/skills/portfolio/scripts/portfolio.py full
# Mostrar todas las instantáneas
python3 ~/.openclaw/workspace/skills/portfolio/scripts/portfolio.py history
Flujo de Trabajo: Actualizar desde Captura de Pantalla
- El usuario envía una captura de pantalla de la cartera → usa la herramienta
imagepara extraer todas las posiciones - Para cada posición, determina si ya existe (coincide por
nameoname_en)- Existente: ACTUALIZAR con nuevos valores (current_value, unrealized_pnl, unrealized_pct, cash_dividend, total_return, total_return_pct)
- Nuevo: INSERTAR fila completa
- Después de la actualización de la base de datos, ejecutar
portfolio.py snapshotpara registrar la instantánea de hoy - Confirmar la actualización al usuario con un resumen
Flujo de Trabajo: Agregar Nueva Posición
python3 portfolio.py add "基金名称" "英文名" "ticker" "fund" "发行机构" "银行" 风险等级 "CNY" 份额 买入净值 当前净值 买入金额 当前市值 未实现额 未实现% 股息 总回报 总回报% [票息] [knockin] [autocall] [strike] [maturity] [买入日期] "备注"
Esquema (28 campos)
| Campo | Tipo | Notas |
|---|---|---|
| id | INTEGER | PK |
| name | TEXT | Nombre en chino (obligatorio) |
| name_en | TEXT | Nombre en inglés |
| ticker | TEXT | Código del fondo / ticker |
| asset_type | TEXT | fund / stock / structured_deposit / bond / etf |
| issuer | TEXT | Casa de fondos / emisor |
| bank | TEXT | Canal de compra (obligatorio) |
| risk_level | INTEGER | Escala de riesgo 1-5 |
| currency | TEXT | CNY / HKD / USD |
| quantity | REAL | Acciones / unidades |
| purchase_nav | REAL | NAV de compra |
| current_nav | REAL | NAV actual |
| purchase_amount | REAL | Costo total de compra |
| current_value | REAL | Valor de mercado actual (obligatorio) |
| unrealized_pnl | REAL | Pérdidas y ganancias no realizadas |
| unrealized_pct | REAL | % de rendimiento no realizado |
| cash_dividend | REAL | Dividendos en efectivo recibidos |
| total_return | REAL | Rendimiento total (P&L + dividendo) |
| total_return_pct | REAL | % de rendimiento total |
| coupon_rate | REAL | Para depósitos estructurados |
| knockin_level | REAL | Para depósitos estructurados |
| autocall_level | REAL | Para depósitos estructurados |
| strike_level | REAL | Para depósitos estructurados |
| maturity | TEXT | Fecha de vencimiento |
| purchase_date | TEXT | Fecha de compra |
| notes | TEXT | Notas de texto libre |
| created_at | TEXT | Automático |
| updated_at | TEXT | Automático |
También: la tabla snapshots rastrea los valores históricos de la cartera.
Consejos
- Al actualizar, siempre coincidir por
name— no crear duplicados snapshotagrega a la tablasnapshotscon la fecha de hoy automáticamente- Los campos NULL (ticker, purchase_*, maturity, coupon) pueden actualizarse más tarde si el usuario los proporciona