npm package: @sodikinnaa/nvda-fetch-plugin
Description: OpenClaw Plugin for NVDA Stock Fetching
Latest version: 1.1.3

# NVDA Fetch Plugin 🚀

<p align="center">
  <img src="assets/logo.jpg" alt="NVDA Fetch Logo" width="200" />
</p>

Automated stock analysis tool for NVIDIA (NVDA) using Twelve Data API. Built for the OpenClaw ecosystem.

## 📦 Features
- **Instant Slash Command**: Get market reports instantly with `/nvda` (No LLM tokens used!).
- **Auto-Reporting**: Integrated background service for scheduled reports to any channel.
- **AI-Powered Tool**: Agentic tool `nvda_report` for complex AI analysis.
- **Professional CLI**: Dedicated commands for authentication and automation setup.
- **Security First**: Sensitive data masking and standard OpenClaw security compliance.

## 🛠️ CLI & Installation

### 1. Installation (Recommended)
Install the plugin directly from the npm registry:
```bash
openclaw plugins install @sodikinnaa/nvda-fetch-plugin

# IMPORTANT: If you see a warning like "plugins.allow is empty", edit ~/.openclaw/openclaw.json 
# and add "@sodikinnaa/nvda-fetch-plugin" (or "nvda-fetch-plugin" if local) to the plugins.allow array.
# Example:
# "plugins": {
#   "allow": ["@sodikinnaa/nvda-fetch-plugin"],
#   ...
# }

openclaw gateway restart
```

### 2. Verification
Check if the plugin is correctly loaded and see its information:
```bash
# List all plugins
openclaw plugins list

# See detailed info about this plugin
openclaw plugins info nvda-fetch-plugin
```

### 3. Management
Commands to enable, disable, or update the plugin:
```bash
# Update to latest version
openclaw plugins update @sodikinnaa/nvda-fetch-plugin

# Enable/Disable
openclaw plugins enable nvda-fetch-plugin
openclaw plugins disable nvda-fetch-plugin

# Restart Gateway to apply changes
openclaw gateway restart
```

### 4. Development Installation
To install from a local directory or specific GitHub clone:
```bash
# Clone the repository
git clone https://github.com/sodikinnaa/sodikinnaa-openclaw-nvida-fetch

# Install as a link (development mode)
openclaw plugins install -l ./sodikinnaa-openclaw-nvida-fetch
```

## ⚙️ Configuration & Commands

### 1. Authentication
Set your [Twelve Data API Key](https://twelvedata.com/pricing) using the dedicated CLI:
```bash
openclaw nvda-auth <YOUR_TWELVE_DATA_API_KEY>
```

### 2. Auto-Reporting Setup
Enable automatic reports to be sent to a specific channel (e.g., WhatsApp) at regular intervals (default: 1 hour):
```bash
openclaw nvda-auto <CHAT_ID> [CHANNEL]

# Example (WhatsApp):
openclaw nvda-auto "+6288275426716" whatsapp
```

### 3. Instant Chat Command
Type this directly in your chat app (WhatsApp/Telegram/etc.) to get an instant report:
```text
/nvda
```

## 🧩 Developer Reference

- **Source**: `plugins/nvda-fetch-plugin`
- **Tool Name**: `nvda_report` (Available for AI Agents)
- **RPC Method**: `nvda_fetch.status`
- **Folder Structure**:
  - `src/`: Core logic and plugin entry.
  - `skills/`: AI skill definitions.
  - `docs/`: In-depth documentation (Installation, Updates, etc.)
  - `openclaw.plugin.json`: Plugin manifest.

## 🧪 Testing
This plugin uses **Vitest** for unit testing.
```bash
npm install --save-dev vitest
npm test
```

## 🛡️ Safety Notes
- Plugins run in-process with the Gateway. Only install from trusted sources.
- API keys are marked as `sensitive` in `openclaw.plugin.json` for UI masking.
- Uses `child_process.execSync` for internal script execution.

## 🏆 Credits
- **Lead Developer**: [Sodikin](https://github.com/sodikinnaa) 🚀
- **Ecosystem**: Built for [OpenClaw](https://github.com/openclaw/openclaw)
- **Engine**: Powered by **SUL*** Eng****

---
Generated by: **Sodikin** 🚀
Memory Sync: SUL*** Eng**