SeeSaw Claw

Integrates SeeSaw prediction market APIs into OpenClaw, enabling market listing, balance checking, and position management via CLI.

Publish-ready repository for the seesaw-agent OpenClaw skill.

This repository is designed to support three workflows:

1. Install from ClawHub with clawhub install seesaw-agent
2. Install manually from GitHub by copying skills/seesaw into your OpenClaw workspace
3. Publish updates to ClawHub from this repository

Install From ClawHub

Recommended path:

clawhub install seesaw-agent
pip install -r skills/seesaw/requirements.txt
openclaw skills check

After installing the skill files, configure the required environment variables for seesaw-agent.

Configure seesaw-agent

OpenClaw stores skill configuration in ~/.openclaw/openclaw.json under skills.entries.<skill-name>.

Example:

{
  "skills": {
    "entries": {
      "seesaw-agent": {
        "enabled": true,
        "env": {
          "SEESAW_BASE_URL": "https://app.seesaw.fun/v1",
          "SEESAW_API_KEY": "xxx",
          "SEESAW_API_SECRET": "xxx"
        }
      }
    }
  }
}

If your OpenClaw environment exposes a helper wrapper for SeeSaw, you can use it as a shortcut:

openclaw skill run --api-key "xxx" --api-secret "xxx"

If that helper is not available in your OpenClaw build, update ~/.openclaw/openclaw.json manually as shown above.

Verify The Install

openclaw skills info seesaw-agent
openclaw skills check

Expected result:

• seesaw-agent appears in the skill list
• no missing requirements for SEESAW_BASE_URL, SEESAW_API_KEY, or SEESAW_API_SECRET

Install From GitHub

Use this path when an OpenClaw agent is asked to read the GitHub repository and install the skill step by step.

Step 1: Clone The Repository

git clone https://github.com/SeesawTech/SeeSaw-Claw.git
cd SeeSaw-Claw

Step 2: Copy The Skill Into Your OpenClaw Workspace

Default OpenClaw workspace path:

~/.openclaw/workspace/skills

mkdir -p ~/.openclaw/workspace/skills
cp -R skills/seesaw ~/.openclaw/workspace/skills/

Step 3: Install Python Dependency

pip install -r ~/.openclaw/workspace/skills/seesaw/requirements.txt

Step 4: Configure API Credentials

Add the same skills.entries.seesaw-agent.env block shown above to ~/.openclaw/openclaw.json.

Step 5: Refresh OpenClaw

Start a new OpenClaw session, or re-run the gateway so it reloads workspace skills.

Step 6: Verify

openclaw skills info seesaw-agent
openclaw skills check

Usage

Once installed and configured, the skill lives at:

~/.openclaw/workspace/skills/seesaw

The main CLI entrypoint is:

python skills/seesaw/scripts/seesaw.py --help

Common examples:

python skills/seesaw/scripts/seesaw.py balance
python skills/seesaw/scripts/seesaw.py list-markets --status active --page 1 --limit 20
python skills/seesaw/scripts/seesaw.py positions

Publish To ClawHub

Publish the skill folder in this repository:

clawhub publish ./skills/seesaw --slug seesaw-agent --name "SeeSaw Prediction Market" --version 0.1.0 --tags latest

For bulk updates after local changes:

clawhub sync --all

Agent Notes

If an OpenClaw agent receives a prompt like:

請前往 https://github.com/SeesawTech/SeeSaw-Claw，閱讀 SeeSaw 的 OpenClaw Skill 安裝教學，然後一步一步幫我完成安裝。

it should follow this repository's README.md, prefer the ClawHub flow first, and fall back to the GitHub/manual flow if ClawHub is unavailable.