> ## Documentation Index
> Fetch the complete documentation index at: https://edgefinder.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# EdgeFinder OpenClaw Plugin: Sports Analysis Skills

> Install the EdgeFinder OpenClaw plugin to give your OpenClaw agent native access to NFL, NBA, and MLB analysis, odds, schedules, and portfolio data.

The EdgeFinder OpenClaw plugin bundles the `edgefinder-cli` skill directly into your OpenClaw agent. Once installed, your agent can run sports analysis, pull Polymarket odds, check standings, and look up your portfolio — all without leaving a conversation.

## Prerequisites

* An active OpenClaw gateway running locally
* An EdgeFinder subscription ([Starter, Pro, or Ultimate](https://edgefinder.io))
* Your EdgeFinder API key from [chat.edgefinder.io/settings/integrations](https://chat.edgefinder.io/settings/integrations)

## Install the plugin

<Steps>
  <Step title="Run the install command">
    Install the plugin from npm:

    ```bash theme={null}
    openclaw plugins install @edgefinder/openclaw-plugin
    ```

    If you're testing a local copy instead, pass the absolute path to the plugin directory:

    ```bash theme={null}
    openclaw plugins install /absolute/path/to/openclaw-plugin
    ```
  </Step>

  <Step title="Restart the OpenClaw gateway">
    The plugin won't load until the gateway restarts. Stop and start the gateway process after installation completes.
  </Step>

  <Step title="Authenticate with EdgeFinder">
    The plugin needs your EdgeFinder API key to run analysis. Choose one of the following methods:

    **Option 1 — Environment variable (recommended):**

    Set `EDGEFINDER_API_KEY` in your shell profile so it's available whenever OpenClaw runs:

    ```bash theme={null}
    export EDGEFINDER_API_KEY=ef_live_...
    ```

    **Option 2 — Plugin config:**

    Set the key directly in OpenClaw's config store:

    ```bash theme={null}
    openclaw config set plugins.entries.edgefinder-cli.config.EDGEFINDER_API_KEY ef_live_...
    ```

    **Option 3 — Interactive login:**

    Open the OpenClaw REPL and use the skill's login command:

    ```bash theme={null}
    openclaw
    ```

    Then follow the EdgeFinder login prompt to authenticate with a magic link.
  </Step>

  <Step title="Start a new conversation">
    Skills load at conversation start. Open a fresh conversation with your OpenClaw agent for the `edgefinder-cli` skill to take effect.
  </Step>
</Steps>

<Warning>
  Never paste your API key into a conversation with your agent. Set it via environment variable or plugin config so it stays out of conversation history.
</Warning>

## What the plugin provides

The plugin installs the `edgefinder-cli` skill, which gives your OpenClaw agent access to EdgeFinder's full analysis suite:

| Capability      | What you can ask                                                   |
| --------------- | ------------------------------------------------------------------ |
| AI analysis     | "Who should I bet on tonight?" or "Lakers vs Celtics prediction"   |
| Schedules       | Today's NFL or NBA games and scores                                |
| Standings       | Current league standings for NFL or NBA                            |
| Polymarket odds | Live betting odds for upcoming games                               |
| Portfolio       | Your Polymarket positions, trade history, and AI position analysis |

NFL is the default league. Ask your agent to switch to NBA or MLB explicitly when needed.

<Tip>
  The plugin's wrapper script uses your locally installed `edgefinder` binary if available, and falls back to `npx -y @edgefinder/cli` automatically — so you don't need to install the CLI separately for the plugin to work.
</Tip>

<Note>
  CLI access requires an active paid EdgeFinder subscription. If authentication is missing or expired, prompt your agent to run the EdgeFinder login command and follow the magic-link flow.
</Note>