cornerstone-autonomous-agent 1.0.2 → 1.0.3

package/README.md

@@ -23,7 +23,7 @@ git clone https://github.com/FinTechTonic/autonomous-agent.git && cd autonomous-
 npm install
 ```
 
-**OpenClaw / Moltbot:** See [adapters/openclaw/SKILL.md](adapters/openclaw/SKILL.md) or use your platform’s skill install (e.g. ClawHub). Then point `MCP_SERVER_URL` at your MCP server.
+**OpenClaw / MoltBook / Moltbot:** Load the skill from `skills/autonomous-agent/` or [adapters/openclaw/SKILL.md](adapters/openclaw/SKILL.md). See [MoltBook / OpenClaw](#moltbook--openclaw) below. Then point `MCP_SERVER_URL` at your MCP server.
 
 ## Quick Start
 
@@ -114,6 +114,9 @@ autonomous/
 │   ├── setup.js          # EVM wallet generation
 │   ├── setup-aptos.js    # Aptos wallet generation
 │   └── show-agent-addresses.js
+├── skills/               # MoltBook/OpenClaw (AgentSkills layout)
+│   └── autonomous-agent/
+│       └── SKILL.md
 ├── adapters/             # OpenClaw, OpenAI, Anthropic, local
 ├── .env.example
 └── package.json
@@ -138,11 +141,42 @@ autonomous/
 ## Capability + adapters
 
 - **Capability:** Core (`src/`) — MCP client, x402 flow, local tools. No OpenAI/Claw/Anthropic logic in code.
-- **Adapters:** `adapters/` — how each platform uses the capability:
-  - [adapters/openclaw/SKILL.md](adapters/openclaw/SKILL.md) — OpenClaw / Moltbot
-  - [adapters/openai/openapi.yaml](adapters/openai/openapi.yaml) — Custom GPTs / Assistants
-  - [adapters/anthropic/tools.json](adapters/anthropic/tools.json) — Claude tools
-  - [adapters/local/README.md](adapters/local/README.md) — LM Studio, AutoGen, CrewAI
+- **Adapters:** How each platform uses the capability:
+  - **MoltBook / OpenClaw / Moltbot:** `skills/autonomous-agent/SKILL.md` (AgentSkills-compatible; [see below](#moltbook--openclaw)) or [adapters/openclaw/SKILL.md](adapters/openclaw/SKILL.md)
+  - **OpenAI:** [adapters/openai/openapi.yaml](adapters/openai/openapi.yaml) — Custom GPTs / Assistants
+  - **Claude / Anthropic:** [adapters/anthropic/tools.json](adapters/anthropic/tools.json) — Claude tools
+  - **Local / OSS:** [adapters/local/README.md](adapters/local/README.md) — LM Studio, AutoGen, CrewAI
+
+## MoltBook / OpenClaw
+
+This repo is optimized for **easy skill loading** in MoltBook and OpenClaw (Claude, Anthropic, OpenAI, and other providers work via the same agent; the skill tells the assistant how to run it).
+
+- **Skill layout:** The skill lives in `skills/autonomous-agent/SKILL.md` (AgentSkills-compatible, single-line frontmatter, `metadata.openclaw` gating). OpenClaw/MoltBook loads skills from `skills/` subfolders.
+- **Load options:**
+  1. **extraDirs:** Add this repo path to `~/.openclaw/openclaw.json` under `skills.load.extraDirs`. OpenClaw will scan `skills/` and load `autonomous-agent`.
+  2. **Workspace:** Clone the repo and use it as your OpenClaw workspace; workspace skills are loaded from `<workspace>/skills`.
+  3. **Managed skills:** Copy `skills/autonomous-agent` to `~/.openclaw/skills/` for all agents on the machine.
+  4. **ClawHub:** When published, install with `clawhub install autonomous-agent` (installs into `./skills` by default).
+- **Config:** In `skills.entries["autonomous-agent"]` you can set `enabled`, `env`, or `apiKey` (maps to `primaryEnv`). Ensure `MCP_SERVER_URL`, x402 facilitator URLs, and LLM/env are set for the agent run.
+- **Run:** From the **repository root** (parent of `skills/`), run `node src/run-agent.js "your message"`.
+
+Example `~/.openclaw/openclaw.json` to load this repo’s skills:
+
+```json
+{
+  "skills": {
+    "load": {
+      "extraDirs": ["/path/to/autonomous-agent"]
+    },
+    "entries": {
+      "autonomous-agent": {
+        "enabled": true,
+        "env": { "MCP_SERVER_URL": "https://borrower.replit.app" }
+      }
+    }
+  }
+}
+```
 
 ## Deployment order
 

package/adapters/openclaw/SKILL.md

@@ -1,7 +1,7 @@
 ---
-name: creditnexus-x402-agent
+name: autonomous-agent
 description: CreditNexus x402 agent. Use when the user wants stock predictions, backtests, or to open a bank account. Payment-protected MCP tools (run_prediction, run_backtest, open_bank_account) with x402 flow (Aptos + Base). Agent handles 402 → pay → retry autonomously.
-metadata: {"clawdbot":{"emoji":"📈","homepage":"https://github.com/FinTechTonic/autonomous-agent","requires":{"bins":["node","npm"]}}}
+metadata: {"openclaw":{"emoji":"📈","homepage":"https://github.com/FinTechTonic/autonomous-agent","requires":{"bins":["node","npm"]},"primaryEnv":"MCP_SERVER_URL","skillKey":"autonomous-agent"},"clawdbot":{"emoji":"📈","homepage":"https://github.com/FinTechTonic/autonomous-agent","requires":{"bins":["node","npm"]}}}
 ---
 
 # CreditNexus x402 Agent Skill
@@ -10,15 +10,15 @@ Autonomous agent that calls x402-protected MCP tools: stock prediction, backtest
 
 ## Installation
 
-Clone or copy the repo (or use the `autonomous` folder as skill root):
+Clone or copy the repo. When loaded from OpenClaw/MoltBook, the skill folder is `{baseDir}`; run commands from the **repo root** (parent of `adapters/openclaw` or of `skills/autonomous-agent`).
 
 ```bash
-# From repository
+# From repository root
 git clone https://github.com/FinTechTonic/autonomous-agent.git && cd autonomous-agent
 npm install
 ```
 
-Set `MCP_SERVER_URL` to your x402 MCP server (e.g. `https://borrower.replit.app` or `http://localhost:4023`). Copy `.env.example` to `.env` and set:
+Set `MCP_SERVER_URL` to `https://borrower.replit.app`. Copy `.env.example` to `.env` and set:
 
 - `MCP_SERVER_URL` – MCP server base URL
 - `X402_FACILITATOR_URL` – x402 facilitator (verify/settle)
@@ -27,6 +27,8 @@ Set `MCP_SERVER_URL` to your x402 MCP server (e.g. `https://borrower.replit.app`
 
 ## Run the agent
 
+From the **repository root** (where `package.json` and `src/` live):
+
 ```bash
 node src/run-agent.js "Run a 30-day prediction for AAPL"
 # Or interactive

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cornerstone-autonomous-agent",
-  "version": "1.0.2",
+  "version": "1.0.3",
   "description": "CornerStone Agentic Score: autonomous agent that uses an x402-enabled MCP server to predict tickers, backtest trading strategies, and open bank accounts. Handles 402 Payment Required (pay via Aptos/Ethereum facilitator and retry). LangChain.js ReAct agent with Hugging Face inference (OpenAI-compatible endpoint).",
   "type": "module",
   "main": "src/run-agent.js",
@@ -10,6 +10,7 @@
   "files": [
     "src",
     "adapters",
+    "skills",
     ".env.example",
     "README.md",
     "SKILL-clawdhub.md",

package/skills/README.md

@@ -0,0 +1,9 @@
+# Skills (MoltBook / OpenClaw)
+
+This folder follows the **AgentSkills** layout expected by MoltBook and OpenClaw. Each subfolder is one skill with a `SKILL.md` (YAML frontmatter + instructions).
+
+| Skill | Description |
+|-------|-------------|
+| [autonomous-agent](autonomous-agent/SKILL.md) | x402 MCP agent: stock prediction, backtest, open bank account (Aptos + Base). |
+
+**Loading:** Add this repo path to `skills.load.extraDirs` in `~/.openclaw/openclaw.json` (MoltBook/OpenClaw will load `autonomous-agent` from `skills/autonomous-agent/`), or copy `autonomous-agent` into `~/.openclaw/skills/`, or use the repo as your OpenClaw workspace. See the main [README](../README.md#moltbook--openclaw).

package/skills/autonomous-agent/SKILL.md

@@ -0,0 +1,50 @@
+---
+name: autonomous-agent
+description: CreditNexus x402 agent. Use when the user wants stock predictions, backtests, or to open a bank account. Payment-protected MCP tools (run_prediction, run_backtest, open_bank_account) with x402 flow (Aptos + Base). Agent handles 402 → pay → retry autonomously.
+metadata: {"openclaw":{"emoji":"📈","homepage":"https://github.com/FinTechTonic/autonomous-agent","requires":{"bins":["node","npm"]},"primaryEnv":"MCP_SERVER_URL","skillKey":"autonomous-agent"},"clawdbot":{"emoji":"📈","homepage":"https://github.com/FinTechTonic/autonomous-agent","requires":{"bins":["node","npm"]}}}
+---
+
+# CreditNexus x402 Agent Skill
+
+Autonomous agent that calls x402-protected MCP tools: stock prediction, backtest, open bank account. Handles payment flow (402 → pay → retry) with Aptos (prediction/backtest) and Base (banking).
+
+## Installation
+
+When this skill is loaded from the **autonomous-agent** repo, the repo root is the parent of the skill folder `{baseDir}`. Clone and install from the repo root:
+
+```bash
+# From repository root (parent of {baseDir} when using this repo)
+git clone https://github.com/FinTechTonic/autonomous-agent.git && cd autonomous-agent
+npm install
+```
+
+Set `MCP_SERVER_URL` to `https://borrower.replit.app`. Copy `.env.example` to `.env` and set:
+
+- `MCP_SERVER_URL` – MCP server base URL
+- `X402_FACILITATOR_URL` – x402 facilitator (verify/settle)
+- `LLM_BASE_URL`, `HUGGINGFACE_API_KEY` or `HF_TOKEN`, `LLM_MODEL` – for inference
+- `APTOS_WALLET_PATH`, `EVM_WALLET_PATH` (or `EVM_PRIVATE_KEY`) – for payments
+
+## Run the agent
+
+From the **repository root** (where `package.json` and `src/` live):
+
+```bash
+node src/run-agent.js "Run a 30-day prediction for AAPL"
+# Or interactive
+node src/run-agent.js
+```
+
+**x402 flow:** Agent calls tool → server returns 402 with payment requirements → agent pays via facilitator (verify → settle) → retries with PAYMENT-SIGNATURE → receives result.
+
+## Tools
+
+| Tool | Description | Cost |
+|------|-------------|------|
+| `run_prediction` | Stock prediction (symbol, horizon) | ~6¢ (Aptos) |
+| `run_backtest` | Backtest trading strategy | ~6¢ (Aptos) |
+| `open_bank_account` | CornerStone bank link / open bank account | ~$3.65 (Base) |
+| `get_agent_reputation_score` / `get_borrower_score` | CornerStone scores | ~1¢ |
+| `get_agent_reputation_score_by_email` / `get_borrower_score_by_email` | CornerStone scores by email (extra fee) | base + extra |
+
+Whitelist your agent at https://borrower.replit.app/flow.html so the server allows your wallet.