Tools
Sil Openclaw
By Openclaw plugin for sil shopping
Install
npm install
pnpmREADME
```
โโโโโโโโโโโโโโ
โโโโโโโโโโโโโโ
โโโโโโโโโโโโโโ
โโโโโโโโโโโโโโ
โโโโโโโโโโโโโโโโโโโ
โโโโโโโโโโโโโโโโโโโ
commerce, handled by your agent
```
**The shopping layer your agent runs for you.**
*You say what you want. Your agent searches the catalog, compares, and hands you a ready-to-buy link.*
*No store. No tabs. No forms.*
[](https://github.com/Context4GPTs/sil-openclaw/blob/main/LICENSE)
[](https://www.npmjs.com/package/sil-openclaw)
[](https://clawhub.com)
[](https://github.com/Context4GPTs/sil-openclaw)
[](https://github.com/Context4GPTs/sil-openclaw/commits/main)
**[Website](https://4gpts.com)** ยท **[Changelog](https://github.com/Context4GPTs/sil-openclaw/blob/main/CHANGELOG.md)** ยท **[Security](https://github.com/Context4GPTs/sil-openclaw/blob/main/SECURITY.md)** ยท **[Follow on X](https://x.com/4gpts)**
---
## Install
`sil-openclaw` is the [OpenClaw](https://openclaw.ai) plugin for **sil**. One install and your agent can shop the sil catalog on your behalf.
```bash
# ClawHub (recommended)
openclaw plugins install clawhub:@4gpts/sil
# npm
openclaw plugins install sil-openclaw
# Local checkout (dev / e2e)
openclaw plugins install /path/to/sil-openclaw
```
### First run
Two lines and you're shopping:
```text
1. Tell your agent: "register me on sil" (one browser sign-in, done)
2. Tell your agent: "find me a mechanical keyboard under $100"
```
The agent loads the bundled skill on first commerce intent and takes it from there โ searching, comparing, pulling up product detail, and handing back ready-to-buy links.
---
## What sil is
**A commerce catalog built for agents, not browsers.** That's sil.
sil is a [UCP](https://github.com/universal-commerce-protocol/ucp) (Universal Commerce Protocol) commerce service, and `sil-openclaw` wires it into your OpenClaw agent โ so it can find products, compare prices and availability, pull up full detail, and surface a checkout link the moment you say *buy*. Powered by [4GPTs](https://4gpts.com).
Today the plugin covers **identity and catalog** โ registration plus search and product lookup. The rest of the UCP journey (cart, checkout, order, fulfillment) lands as those domains ship, and the same plugin grows with them.
---
## See it in action
**You, shopping through your agent โ no store, no tabs:**
```text
you find me a mechanical keyboard under $100, tactile switches
agent searched the sil catalog โ 3 strong matches:
1. Keychron V3 (Brown) $89 in stock
2. NuPhy Air75 V2 $99 in stock
3. Akko 3068B $72 low stock
want detail on any of these, or a checkout link?
you tell me about the keychron
agent Keychron V3 โ QMK/VIA, hot-swappable, Brown tactile.
options: ABS / PBT keycaps ยท US / ISO layout
featured: PBT keycaps, US layout โ $89, ships in 2 days
โ checkout: sil.4gpts.com/c/kc-v3-pbt-us
you perfect, send it
agent done โ here's your checkout link, ready to pay:
sil.4gpts.com/c/kc-v3-pbt-us
```
> **You said three things. The agent did the shopping** โ searched, compared, fetched the detail, and handed you a ready-to-buy link. No browser, no forms, no fourteen open tabs.
---
## Identity & authentication
**sil gives your agent an identity โ and the capability to use it.** One browser sign-in links your OpenClaw agent to a sil identity it holds on your behalf โ your name, your saved addresses. That identity is what lets the agent *transact*: it can search, compare, and surface checkout links with any merchant that speaks [UCP](https://github.com/universal-commerce-protocol/ucp) (the Universal Commerce Protocol), all under your account, without you ever touching a store login.
Registering is the only manual step. After that the agent carries your identity for you โ ask *"who am I on sil?"* anytime to see exactly what it's holding.
---
## Tools
Namespaced `sil_*` so they never collide with other plugins. Your agent calls them for you โ you just say what you want.
**Identity**
| Tool | What it does |
|---|---|
| `sil_register` | Start a browser sign-in and link your agent to your sil identity. Returns an `auth_url` to open; once you've signed in, the agent is registered and can transact. Takes no arguments. |
| `sil_whoami` | Read your sil identity โ name and saved addresses โ as the agent sees it. Takes no arguments. |
**Catalog**
| Tool | What it does |
|---|---|
| `sil_search` | Search for purchasable products. A free-text `query` plus optional filters: `category`, `price_min`/`price_max`, `ship_to` (delivery destination โ leave empty to ship to your registered address), `condition` (`new` / `secondhand`), `available`, and `local_merchants` (best-effort bias toward shops in the user's own country). Results are **localized** to the shopper โ issue the `query` in their own language for the best local results (e.g. search in French for French stores). Returns a ranked list of variants โ each with `id`, `title`, `price`, `availability`, `checkout_url`, `source`, plus (where the source provides them) evaluate-before-buy detail: a product/variant `url` to view, a `description`, `media`, the product `options`, and the `seller`'s **shipping & return policy links** โ and a pagination `cursor`. Location filters take ISO codes (`US`, `CA`), not place names. |
| `sil_product_get` | Resolve `ids` you already hold to full products in UCP shape โ `description`, `options`, `media`, the `seller`'s shipping & return policy links, and the featured purchasable variant with fresh `price`, `availability`, `url` (the page to view), and `checkout_url` (the link that buys). Re-fetch right before buying; those values are point-in-time, not guarantees. Ids that no longer resolve come back in `not_found`. |
---
## Skills
The plugin ships one bundled skill โ **`sil`** ๐ โ that your agent loads automatically the first time you express a shopping intent. You don't invoke it; it's the playbook that makes the four tools work well together:
- **Routes intent to the right tool.** *"find me a keyboard"* โ `sil_search`, *"look these up"* โ `sil_product_get`, *"who am I?"* โ `sil_whoami`, *"sign me up"* โ `sil_register`.
- **Recovers the right way.** Every tool reports a status; the skill follows that tool's own recovery hint โ re-register, fix the query, or retry โ instead of guessing a fix that won't work.
- **Keeps prices honest.** It treats price, availability, and checkout links as point-in-time and re-checks an item right before you buy, so the link you get is the link you pay.
Because the skill ships inside the plugin, installing the plugin installs the skill โ there's nothing extra to set up.
---
## Security
The plugin holds your sil credentials and transacts on your behalf. The full disclosure โ what it touches, what it stores, and how to report an issue โ is in **[SECURITY.md](./SECURITY.md)**.
---
## Developing
```bash
pnpm install
pnpm build # pnpm clean && tsc โ dist/
pnpm test # vitest (unit + integration)
pnpm typecheck # tsc --noEmit
```
Releasing is two steps: `pnpm version <patch|minor|major>` (bump โ sync manifest โ cut changelog โ test โ tag โ push), then `pnpm release` (build โ pack โ npm `sil-openclaw` + ClawHub `@4gpts/sil` โ the same contents, re-packed under each registry's name). Release notes in [`CHANGELOG.md`](https://github.com/Context4GPTs/sil-openclaw/blob/main/CHANGELOG.md). Adding a tool is three steps, enforced by a drift-guard test.
---
**Built by [4GPTs](https://4gpts.com)** ยท Apache-2.0 ยท [@4gpts on X](https://x.com/4gpts)
tools
Comments
Sign in to leave a comment