add openclaw configs, skills, etc

README.md

@@ -9,4 +9,23 @@ license: apache-2.0
 short_description: AGI Assistant
 ---
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+This Space hosts the OpenClaw trading bot (paper-only). The LLM runs in a separate Space that you already have; this repo only contains the bot-side architecture and configs.
+
+**Architecture**
+- OpenClaw bot Space (this repo) calls an external LLM Space for analysis and signal generation.
+- Paper trading via Alpaca API.
+- Trade logs stored to HF Hub storage (dataset repo).
+
+**LLM Space (external)**
+- Expected to expose a simple HTTP inference endpoint.
+- The bot calls `${LLM_SPACE_URL}` (see `config/openclaw.env.example`) and expects a JSON response with an output string.
+- Update `LLM_SPACE_URL` and response path in `openclaw.json` to match your existing LLM Space.
+
+**Key Files**
+- `openclaw.json` defines providers, routing, tools, memory, and safety.
+- `config/openclaw.env.example` lists all required env vars.
+- `skills/` contains architecture-only SKILL specs.
+- `tools/README.md` defines the tool surface to implement later.
+- `schedules/cron.yml` documents the intended schedule.
+
+If you want me to add minimal tool stubs or a working runner later, say the word and I will wire it up.

config/openclaw.env.example

@@ -0,0 +1,14 @@
+# LLM Space (external)
+LLM_SPACE_URL=https://your-llm-space.hf.space/api/predict
+
+# Alpaca paper trading
+ALPACA_API_KEY=your_key
+ALPACA_API_SECRET=your_secret
+ALPACA_BASE_URL=https://paper-api.alpaca.markets
+
+# HF Storage for trade logs
+HF_TOKEN=hf_xxx
+HF_TRADES_REPO=username/trading-logs
+
+# Market data (optional extra source)
+MARKET_DATA_SOURCE=alpaca

openclaw.json

@@ -0,0 +1,62 @@
+{
+  "agent": {
+    "name": "openclaw-trading-bot",
+    "description": "OpenClaw bot for paper trading with Alpaca and external LLM Space",
+    "timezone": "UTC"
+  },
+  "providers": [
+    {
+      "name": "hf_space_llm",
+      "type": "custom_http",
+      "base_url": "${LLM_SPACE_URL}",
+      "method": "POST",
+      "timeout_ms": 20000,
+      "request_schema": {
+        "inputs": "${prompt}"
+      },
+      "response_path": "data.output_text"
+    }
+  ],
+  "routing": {
+    "market_analysis": "hf_space_llm",
+    "signal_generation": "hf_space_llm",
+    "reporting": "hf_space_llm"
+  },
+  "tools": {
+    "alpaca_paper": {
+      "type": "python",
+      "module": "tools.alpaca_paper",
+      "env": [
+        "ALPACA_API_KEY",
+        "ALPACA_API_SECRET",
+        "ALPACA_BASE_URL"
+      ]
+    },
+    "hf_storage": {
+      "type": "python",
+      "module": "tools.hf_storage",
+      "env": [
+        "HF_TOKEN",
+        "HF_TRADES_REPO"
+      ]
+    },
+    "market_data": {
+      "type": "python",
+      "module": "tools.market_data",
+      "env": [
+        "MARKET_DATA_SOURCE"
+      ]
+    }
+  },
+  "memory": {
+    "type": "sqlite",
+    "path": "/data/openclaw_memory.sqlite",
+    "max_tokens": 1200
+  },
+  "safety": {
+    "paper_only": true,
+    "max_order_qty": 5,
+    "max_position_usd": 5000,
+    "require_signal": true
+  }
+}

schedules/cron.yml

@@ -0,0 +1,7 @@
+schedules:
+  market_data:
+    cron: "*/5 * * * *"
+  signal_trading:
+    cron: "*/5 * * * *"
+  reporting:
+    cron: "0 0 * * *"

skills/execution/SKILL.md

@@ -0,0 +1,28 @@
+name: execution
+version: 0.1
+kind: skill
+summary: Executes paper orders with safety checks and logs trades
+triggers:
+  - event: "signal_ready"
+inputs:
+  - signal
+outputs:
+  - order_id
+  - status
+tools:
+  - alpaca_paper
+  - hf_storage
+steps:
+  - id: preflight
+    run: "risk_checks"
+  - id: place_order
+    tool: alpaca_paper
+    with:
+      action: submit_order
+      signal: "${signal}"
+  - id: log_trade
+    tool: hf_storage
+    with:
+      record: "${order}"
+notes:
+  - "Keep this paper-only; hard-block live trading in tool implementation"

skills/market_data/SKILL.md

@@ -0,0 +1,19 @@
+name: market_data
+version: 0.1
+kind: skill
+summary: Fetches market data snapshots for analysis
+triggers:
+  - cron: "*/5 * * * *"
+inputs:
+  - symbols
+outputs:
+  - snapshot
+tools:
+  - market_data
+steps:
+  - id: fetch_snapshot
+    tool: market_data
+    with:
+      symbols: "${symbols}"
+notes:
+  - "This skill is intentionally minimal; implement tool wiring in tools/market_data.py"

skills/reporting/SKILL.md

@@ -0,0 +1,25 @@
+name: reporting
+version: 0.1
+kind: skill
+summary: Creates daily summaries of signals and trades
+triggers:
+  - cron: "0 0 * * *"
+inputs:
+  - trades
+outputs:
+  - report
+providers:
+  - hf_space_llm
+tools:
+  - hf_storage
+steps:
+  - id: summarize
+    provider: hf_space_llm
+    with:
+      prompt: "Summarize the trading day from this JSON: ${trades}"
+  - id: store_report
+    tool: hf_storage
+    with:
+      record: "${report}"
+notes:
+  - "Replace with PDF/CSV generator when ready"

skills/signal_trading/SKILL.md

@@ -0,0 +1,26 @@
+name: signal_trading
+version: 0.1
+kind: skill
+summary: Generates trade signals via external LLM and queues orders
+triggers:
+  - cron: "*/5 * * * *"
+inputs:
+  - snapshot
+outputs:
+  - signal
+providers:
+  - hf_space_llm
+steps:
+  - id: build_prompt
+    run: "render_prompt"
+    with:
+      template: "${PROMPT_TEMPLATE}"
+      snapshot: "${snapshot}"
+  - id: generate_signal
+    provider: hf_space_llm
+    with:
+      prompt: "${prompt}"
+  - id: normalize_signal
+    run: "normalize_signal"
+notes:
+  - "Add a schema validator to keep outputs strict: buy/sell/hold + qty"

tools/README.md

@@ -0,0 +1,19 @@
+# Tools (Architecture Only)
+
+This directory defines the tool surface expected by `openclaw.json`.
+Implementations are intentionally left as stubs for now.
+
+Expected modules:
+- `tools/alpaca_paper.py`
+  - `submit_order(signal)`
+  - `list_positions()`
+  - Safety: refuse non-paper base URL
+- `tools/hf_storage.py`
+  - `append_trade(record)`
+  - `append_report(record)`
+  - Storage target: HF dataset repo
+- `tools/market_data.py`
+  - `get_snapshot(symbols)`
+  - Optional: Alpaca data or external provider
+
+All tools should accept config via environment variables listed in `openclaw.json`.