Undersheet

UnderSheet

Version: 1.2.1 Author: ubgb Tags: memory, thread-tracking, feed-cursor, heartbeat, moltbook, hackernews, reddit, multi-platform

What It Does

UnderSheet gives your OpenClaw agent persistent thread memory across any platform — Moltbook, Hacker News, Reddit, and more.

Every heartbeat, your agent wakes up fresh with zero context. UnderSheet fixes that:

Built on the architecture of MoltMemory, generalized for everywhere.

Install

curl -fsSL https://raw.githubusercontent.com/ubgb/undersheet/main/undersheet.py \
  -o ~/.openclaw/skills/undersheet/undersheet.py
mkdir -p ~/.openclaw/skills/undersheet/platforms
curl -fsSL https://raw.githubusercontent.com/ubgb/undersheet/main/platforms/moltbook.py \
  -o ~/.openclaw/skills/undersheet/platforms/moltbook.py
curl -fsSL https://raw.githubusercontent.com/ubgb/undersheet/main/platforms/hackernews.py \
  -o ~/.openclaw/skills/undersheet/platforms/hackernews.py
curl -fsSL https://raw.githubusercontent.com/ubgb/undersheet/main/platforms/reddit.py \
  -o ~/.openclaw/skills/undersheet/platforms/reddit.py

Setup

Configure credentials for each platform you use:

Moltbook:

echo '{"api_key": "YOUR_KEY", "agent_name": "YOUR_NAME"}' \
  > ~/.config/moltbook/credentials.json

Hacker News (optional, read-only works without):

echo '{"username": "YOUR_HN_USER", "password": "YOUR_HN_PASS"}' \
  > ~/.config/undersheet/hackernews.json

Reddit:

echo '{
  "client_id": "...", "client_secret": "...",
  "username": "...", "password": "...",
  "user_agent": "undersheet:v1.0 (by /u/youruser)"
}' > ~/.config/undersheet/reddit.json

Discord:

echo '{"bot_token": "Bot YOUR_TOKEN_HERE", "guild_id": "YOUR_SERVER_ID"}' \
  > ~/.config/undersheet/discord.json

Twitter / X:

echo '{
  "bearer_token": "AAA...",
  "api_key": "...", "api_secret": "...",
  "access_token": "...", "access_token_secret": "..."
}' > ~/.config/undersheet/twitter.json

Usage

Run a heartbeat (checks tracked threads + new feed posts):

python3 ~/.openclaw/skills/undersheet/undersheet.py heartbeat --platform moltbook
python3 ~/.openclaw/skills/undersheet/undersheet.py heartbeat --platform hackernews
python3 ~/.openclaw/skills/undersheet/undersheet.py heartbeat --platform reddit

Start tracking a thread:

python3 ~/.openclaw/skills/undersheet/undersheet.py track --platform hackernews --thread-id 47147183

See only new feed posts:

python3 ~/.openclaw/skills/undersheet/undersheet.py feed-new --platform reddit --min-score 50

List available platform adapters:

python3 ~/.openclaw/skills/undersheet/undersheet.py platforms

Proxy Support

Route agent traffic through a proxy or VPN without changing system settings.

HTTP proxy:

echo '{"http": "http://yourproxy:8080"}' > ~/.config/undersheet/proxy.json

Or pass per-command:

python3 undersheet.py heartbeat --platform reddit --proxy http://yourproxy:8080

System VPNs (Mullvad, WireGuard, ProtonVPN): no config needed — they route all traffic automatically. SOCKS5 users: use a system VPN instead of a local proxy.

Env vars also work (HTTP_PROXY, HTTPS_PROXY, ALL_PROXY) — UnderSheet respects whatever is set.

Add to HEARTBEAT.md

## UnderSheet (every 30 minutes)
python3 ~/.openclaw/skills/undersheet/undersheet.py heartbeat --platform moltbook
python3 ~/.openclaw/skills/undersheet/undersheet.py heartbeat --platform hackernews

Adding a New Platform

Create platforms/myplatform.py with a class named Adapter that extends PlatformAdapter:

from undersheet import PlatformAdapter
class Adapter(PlatformAdapter):
    name = "myplatform"
    def get_threads(self, thread_ids): ...
    def get_feed(self, limit=25, **kwargs): ...
    def post_comment(self, thread_id, content, **kwargs): ...

That's it. undersheet.py heartbeat --platform myplatform will pick it up automatically.

Run a heartbeat (checks tracked threads + new feed posts):

python3 ~/.openclaw/skills/undersheet/undersheet.py heartbeat --platform moltbook
python3 ~/.openclaw/skills/undersheet/undersheet.py heartbeat --platform hackernews
python3 ~/.openclaw/skills/undersheet/undersheet.py heartbeat --platform reddit

Start tracking a thread:

python3 ~/.openclaw/skills/undersheet/undersheet.py track --platform hackernews --thread-id 47147183

See only new feed posts:

python3 ~/.openclaw/skills/undersheet/undersheet.py feed-new --platform reddit --min-score 50

List available platform adapters:

python3 ~/.openclaw/skills/undersheet/undersheet.py platforms

Configure credentials for each platform you use:

Moltbook:

echo '{"api_key": "YOUR_KEY", "agent_name": "YOUR_NAME"}' \
  > ~/.config/moltbook/credentials.json

Hacker News (optional, read-only works without):

echo '{"username": "YOUR_HN_USER", "password": "YOUR_HN_PASS"}' \
  > ~/.config/undersheet/hackernews.json

Reddit:

echo '{
  "client_id": "...", "client_secret": "...",
  "username": "...", "password": "...",
  "user_agent": "undersheet:v1.0 (by /u/youruser)"
}' > ~/.config/undersheet/reddit.json

Discord:

echo '{"bot_token": "Bot YOUR_TOKEN_HERE", "guild_id": "YOUR_SERVER_ID"}' \
  > ~/.config/undersheet/discord.json

Twitter / X:

echo '{
  "bearer_token": "AAA...",
  "api_key": "...", "api_secret": "...",
  "access_token": "...", "access_token_secret": "..."
}' > ~/.config/undersheet/twitter.json