Public.com Account Manager

Disclaimer: For illustrative and informational purposes only. Not investment advice or recommendations.

We recommend running this skill in as isolated of an instance as possible. If possible, test the integration on a new Public account as well.

This skill allows users to interact with their Public.com brokerage account.

Prerequisites

• Python 3.8+ and pip — Required in your OpenClaw environment.
• Public.com account — Create one at https://public.com/signup
• Public.com API key — Get one at https://public.com/settings/v2/api

The publicdotcom-py SDK is required. It will be auto-installed on first run, or you can install manually:

pip install publicdotcom-py

Configuration

This skill uses two environment variables: PUBLIC_COM_SECRET (required) and PUBLIC_COM_ACCOUNT_ID (optional). Each is resolved in the following order:

1. Secure file — ~/.openclaw/workspace/.secrets/public_com_secret.txt (or public_com_account.txt)
2. Environment variable — PUBLIC_COM_SECRET / PUBLIC_COM_ACCOUNT_ID

Setting a value via openclaw config set writes to the secure file location automatically.

API Secret (Required)

If PUBLIC_COM_SECRET is not set:

• Tell the user: "I need your Public.com API Secret. You can find this in your Public.com developer settings at https://public.com/settings/v2/api."
• Once provided, save it: openclaw config set skills.publicdotcom.PUBLIC_COM_SECRET [VALUE]

Default Account ID (Optional)

If the user wants to set a default account for all requests:

• Save it: openclaw config set skills.publicdotcom.PUBLIC_COM_ACCOUNT_ID [VALUE]
• This eliminates the need to specify --account-id on each command.

Available Commands

Get Accounts

When the user asks to "get my accounts", "list accounts", or "show my Public.com accounts":

1. Execute python3 scripts/get_accounts.py
2. Report the account IDs and types back to the user.

Get Portfolio

When the user asks to "get my portfolio", "show my holdings", or "what's in my account":

1. If PUBLIC_COM_ACCOUNT_ID is set, execute python3 scripts/get_portfolio.py (no arguments needed).
2. If not set and you don't know the user's account ID, first run get_accounts.py to retrieve it.
3. Execute python3 scripts/get_portfolio.py --account-id [ACCOUNT_ID]
4. Report the portfolio summary (equity, buying power, positions) back to the user.

Get Orders

When the user asks to "get my orders", "show my orders", "active orders", or "pending orders":

1. If PUBLIC_COM_ACCOUNT_ID is set, execute python3 scripts/get_orders.py (no arguments needed).
2. If not set and you don't know the user's account ID, first run get_accounts.py to retrieve it.
3. Execute python3 scripts/get_orders.py --account-id [ACCOUNT_ID]
4. Report the active orders with their details (symbol, side, type, status, quantity, prices) back to the user.