Habilidade de Carteira
O Hansen armazena as participações de investimento em ~/.openclaw/workspace/data/portfolio.db (SQLite).
Comandos Rápidos
# Ver resumo
python3 ~/.openclaw/workspace/skills/portfolio/scripts/portfolio.py summary
# Tirar um instantâneo (registra os valores de hoje)
python3 ~/.openclaw/workspace/skills/portfolio/scripts/portfolio.py snapshot
# Ver instantâneos históricos
python3 ~/.openclaw/workspace/skills/portfolio/scripts/portfolio.py history
# Mostrar tabela completa (todos os 28 campos)
python3 ~/.openclaw/workspace/skills/portfolio/scripts/portfolio.py full
# Mostrar todos os instantâneos
python3 ~/.openclaw/workspace/skills/portfolio/scripts/portfolio.py history
Fluxo de Trabalho: Atualizar a partir de Captura de Tela
- O usuário envia uma captura de tela da carteira → use a ferramenta
imagepara extrair todas as posições - Para cada posição, determine se ela já existe (corresponda pelo
nameouname_en)- Existente: ATUALIZE com os novos valores (current_value, unrealized_pnl, unrealized_pct, cash_dividend, total_return, total_return_pct)
- Nova: INSIRA a linha completa
- Após a atualização do banco de dados, execute
portfolio.py snapshotpara registrar o instantâneo de hoje - Confirme a atualização ao usuário com um resumo
Fluxo de Trabalho: Adicionar Nova Posição
python3 portfolio.py add "Nome do Fundo" "Nome em Inglês" "ticker" "fundo" "Emissor" "Banco" nível_de_risco "CNY" quantidade nav_compra nav_atual valor_compra valor_mercado pnl_não_realizado %_pnl_não_realizado dividendos retorno_total %_retorno_total [cupom] [knockin] [autocall] [strike] [vencimento] [data_compra] "Observações"
Esquema (28 campos)
| Campo | Tipo | Notas |
|---|---|---|
| id | INTEGER | CP |
| name | TEXT | Nome em chinês (obrigatório) |
| name_en | TEXT | Nome em inglês |
| ticker | TEXT | Código do fundo / ticker |
| asset_type | TEXT | fundo / ação / depósito_estruturado / título / etf |
| issuer | TEXT | Gestora do fundo / emissor |
| banco | TEXT | Canal de compra (obrigatório) |
| risk_level | INTEGER | Escala de risco de 1 a 5 |
| currency | TEXT | CNY / HKD / USD |
| quantity | REAL | Quantidade de cotas / unidades |
| purchase_nav | REAL | NAV de compra |
| current_nav | REAL | NAV atual |
| purchase_amount | REAL | Custo total de compra |
| current_value | REAL | Valor de mercado atual (obrigatório) |
| unrealized_pnl | REAL | Ganho/perda não realizado |
| unrealized_pct | REAL | % de retorno não realizado |
| cash_dividend | REAL | Dividendos em dinheiro recebidos |
| total_return | REAL | Retorno total (ganho/perda + dividendo) |
| total_return_pct | REAL | % de retorno total |
| coupon_rate | REAL | Para depósitos estruturados |
| knockin_level | REAL | Para depósitos estruturados |
| autocall_level | REAL | Para depósitos estruturados |
| strike_level | REAL | Para depósitos estruturados |
| maturity | TEXT | Data de vencimento |
| purchase_date | TEXT | Data de compra |
| notes | TEXT | Notas de texto livre |
| created_at | TEXT | Automático |
| updated_at | TEXT | Automático |
Também: a tabela snapshots rastreia valores históricos da carteira.
Dicas
- Ao atualizar, sempre corresponda pelo
name— não crie duplicatas - O comando
snapshotanexa automaticamente à tabelasnapshotscom a data de hoje - Os campos NULL (ticker, purchase_*, maturity, campos de cupom) podem ser atualizados posteriormente se o usuário os fornecer