Shopify Integration Install Walkthrough

This guide takes you from a fresh Shopify store to your first synced order. Most merchants finish in under ten minutes.

Prerequisites

You need three things: a Shopify store where you are the owner (or have app install permission), a computer or small server where ERPClaw will run (a laptop, a Mac mini, a cheap Linux VPS; anything that stays online when you want to sync), and basic terminal access on that machine. If “open a terminal and paste a command” is not foreign to you, you are ready.

1. Install ERPClaw on your machine

ERPClaw runs on your own hardware. That is the whole point. Install it with a single command:

clawhub install erpclaw

If you do not have clawhub yet, follow the short install guide at docs.openclaw.ai/install. It takes about two minutes.

Verify the install completed:

python3 ~/.openclaw/workspace/skills/erpclaw/scripts/db_query.py --action status

You should see a JSON status block with a non-zero tables count and an ok status.

2. Install the Shopify app

Open the Shopify App Store listing for ERPClaw Accounting & ERP and click Add app. Shopify shows you an OAuth consent screen listing the permissions the app requests:

• read_orders so ERPClaw can pull your orders
• read_products so SKUs can map to your inventory
• read_customers so customer records can sync
• read_shopify_payments_accounts so payouts and disputes reconcile to your bank

All scopes are read-only. The app cannot change anything in your store.

Approve the install. Shopify redirects you to the ERPClaw admin UI embedded in your Shopify admin.

3. Get your pairing code

The first screen shows a six-character pairing code (for example, ABC-X9Z) and a short instruction block.

The code is valid for ten minutes. If you miss that window, refresh the page to generate a new one. Each code can only be used once.

4. Pair from the terminal

Copy the code. On the machine where ERPClaw is running, run:

erpclaw shopify-connect --pairing-code ABC-X9Z

Replace ABC-X9Z with your actual code. ERPClaw contacts our Cloudflare Worker at shopify.erpclaw.ai, redeems the code, pulls down the OAuth token, and stores it locally. You will see a success message naming your shop domain.

From this moment, your ERPClaw talks to Shopify directly. Our servers are not in the data path.

5. Run the first sync

Kick off a full initial sync:

erpclaw shopify-start-full-sync

ERPClaw pulls products, customers, orders, refunds, and payouts in order. A small store finishes in under a minute. A store with tens of thousands of orders can take a few minutes. The sync runs in the background; you can close the terminal.

6. Use the dashboard

Go back to the Shopify admin tab. The status card shows the last 24 hours of activity:

• Orders synced. How many Shopify orders ERPClaw has pulled.
• GL entries posted. How many journal entries ERPClaw wrote to its double-entry general ledger.
• Errors. Problems during sync or posting. Zero is the healthy state.
• Last sync. When ERPClaw last reported in. Fresh is good; stale means your instance may be offline.

7. The three buttons

Open ERPClaw: deep-links to your local ERPClaw web UI so you can browse the synced data.

Sync now: queues an on-demand sync. ERPClaw picks it up on its next check-in (usually within seconds) and runs a fresh pull.

Disconnect: revokes the OAuth token, clears the pairing state, and stops the push daemon. Your local ERPClaw data stays intact; only the Shopify link is severed.

8. Where your data lives

Your orders, customers, products, and general ledger live in a SQLite database at ~/.openclaw/erpclaw/data.sqlite on your own machine. Back it up like you would any other file. AvanSaber never sees this data. Our Cloudflare Worker only holds your shop domain, a short-lived pairing code, and a small status blob with sync counters.

Next steps

• Read the architecture page to understand what runs where.
• If something looks off, check Troubleshooting.
• Source code at github.com/avansaber/erpclaw-addons.