Getting started
The landing page, these docs and every record page are public. The app asks you to connect a wallet.
-
Connect a wallet on Robinhood Chain
Open the app and connect an injected wallet, such as MetaMask, on Robinhood Chain (chain id 4663). You sign in by signing a message. It costs no gas and sends nothing.
-
Create a vault
One transaction from your wallet creates your own vault contract. You choose the tokens it lists (at most 12) and a drawdown stop, and you can hand your first Bot its rule and some ETH for gas in the same transaction. Then deposit what you want your Bots to work with.
-
Hire a Bot
Pick a template, give the Bot a name and a role, and set its rule if it trades: dollars per trade, dollars per day, slippage and an expiry. A trading Bot gets its own agent address on your vault. From then on you chat with it, give it routines, and answer its approval cards.
Dry run. The vault factory is live on Robinhood Chain, so you can create a vault and give a Bot its key. While the app shows Dry run, routines run as Only tell you: a Bot writes what it would do and sends nothing.
Bots
A Bot has a name, a title, a role, a template and powers. The role is its standing instructions, sent with every run. A Bot that trades also holds an agent key on your vault, with a rule the contract enforces.
| Template | Role | Powers |
|---|---|---|
| Stock Desk | Trades stock tokens in your vault inside its rule. | read, trade |
| Watcher | Watches prices and pings you when your conditions line up. | read, notify |
| Treasury Clerk | Keeps the books: vault and wallet balances, Pons creator fees waiting, gas left. | read, draft tx |
| Launch Officer | Drafts a Pons coin launch for your wallet to send. | read, draft tx |
| Herald | Writes your posts for X. Nothing goes out without you. | draft post |
| Custom | Your own role. | read (+ trade if granted) |
- A vault holds up to 16 Bots.
- Each trading Bot has its own agent address. Its key is derived on our server from a secret seed, your vault and the Bot's id. The key never leaves the server; the app shows you the address.
- When you chat with a Bot, it runs on Claude with its identity and role as instructions. It can read prices, your vault status, balances and the Pons fees waiting for you. It cannot act from the chat: it proposes a trade, a transaction or a post, and you get an approval card.
Approvals
Over its rule a Bot stops and asks with an approval card. Every card has the same four answers. Your answer is a wallet signature or one transaction, never a form.
| Answer | What happens |
|---|---|
| Allow once | Your wallet signs this one trade (an EIP-712 Once signature, no gas) and the Bot sends it with tradeOnce. For actions outside the vault, such as launching a coin or claiming fees, your wallet sends the drafted transaction itself. |
| Allow for this chat | Your wallet signs a pass for this conversation (EIP-712 Session): a dollar cap, a per-trade cap and an end time, at most 7 days ahead and 24 hours by default. No gas. The Bot trades with tradeSession until the cap or the end time. Turn off ends the pass on chain (endSession). |
| Always allow | One transaction: grant(bot, policy) writes the Bot's standing rule on chain (per trade, per day, slippage, expiry) and sends the Bot ETH for gas. |
| Deny | Nothing is sent. The Bot is told no, and the answer goes on the record. |
What always asks
- Anything over the Bot's rule.
- Launching a coin on Pons.
- Posting on X.
- Claiming fees.
Withdraw and exit are owner only in the contract. A Bot can never take money out of your vault.
Routines
A routine is a standing instruction a Bot carries out on its own.
| Field | What you set |
|---|---|
| Bot | Which Bot carries it out. |
| What to do | The instruction, in your own words. |
| It should | Act for you or Only tell you. |
| Starts | On a schedule (every N minutes or hours, or daily at HH:MM UTC), When something happens (a price condition), or Now, once. |
| Done when | Optional: when the routine should stop. |
| Name | How it shows in your list. |
Kinds you can set up: buy on a timer (DCA), buy the dip, take profit, rebalance, price alert and a daily brief.
Act for you, or only tell you
- Act for you: the Bot trades on its own, but only inside its standing rule. Over the rule, it posts an approval card and waits for your answer.
- Only tell you: the Bot does not act. It tells you what it found and what it would do.
When routines run
A worker checks every routine every 5 minutes. Until Bots go live, it runs dry: it writes down what it would do and sends nothing.
Record
Every event is an entry in your vault's record: the time (UTC), the Bot, the kind (chat, answer, trade, routine or note), the text, and the transaction hash when there is one.
- Hash chain. Each entry's hash is
keccak256(previous hash, entry), so changing an old entry changes every hash after it. - Anchored daily. Once a day, and whenever you ask, a Bot writes the latest hash on chain with
note(digest). Anyone can check that the record was not rewritten. - Public page. /record?v=<vault> shows a vault's record next to its events on Robinhood Chain:
Traded,Passed,Granted,RevokedandNoted.
The vault contract
Your money sits in your own vault contract on Robinhood Chain, made for you by the OpenBot vault factory. You own it. Bots hold keys to it with limits the contract checks on every trade.
What a Bot can do
- Swap between the tokens your vault lists, through Uniswap's SwapRouter02, with the output landing back in your vault.
- Stay within its rule: a dollar limit per trade and per UTC day, valued at the Chainlink feeds, with a maximum slippage and an expiry.
- Go past the standing limits only with a pass you signed (Allow once or Allow for this chat).
- Anchor the record with
note(digest).
What a Bot cannot do
- Withdraw, exit, transfer or approve tokens, or call anything else.
- Trade a token your vault does not list.
- Change its own rule, grant or revoke keys, or pause and unpause the vault.
The guards on every trade
- Feed floor. The vault must receive at least the larger of the Bot's minimum out and the Chainlink price less its maximum slippage, so a bad route or a pushed pool cannot drain value.
- Limits. Per trade and per day, in dollars, from the Bot's standing rule.
- Drawdown stop. When the value of one vault unit falls more than your drawdown setting below its peak, the vault trips and every Bot stops until you re-arm it.
- Pause. While the vault is paused, no Bot trades.
Signed passes
Allow once and Allow for this chat are EIP-712 signatures from your wallet (domain "OpenBot Vault", version 1, chain id 4663, the vault as verifying contract). A signed trade skips only the standing dollar limits. The feed floor, the token list, pause and the drawdown stop still apply, and the Bot must still hold an active grant. Each Allow once nonce works one time, and you can cancel an unused one with cancelOnce. A pass for a chat lasts at most 7 days, and endSession ends it early. Wallets that are contracts sign with EIP-1271.
Owner only
Withdraw, exit, grant, revoke, pause, the token list and the drawdown stop are yours alone. Exit is the panic button: it pauses every Bot and sends every listed token in the vault to the address you choose.
The factory can set a protocol fee on Bot trades of at most 0.2% (20 bps). It starts at 0.
The vault factory's contract address appears here once it is live.
FAQ
Is my money held by OpenBot?
No. It sits in your own vault contract, and only you can withdraw or exit. A Bot can never take money out.
What if a Bot misbehaves?
Its rule caps what it can trade, and the contract checks that rule on every trade. You can pause the vault, revoke the Bot's key, or withdraw and exit at any time.
Which tokens can a Bot trade?
Only the tokens your vault lists, at most 12: USDG, ETH and stock tokens on Robinhood Chain such as NVDA, SPY, QQQ, GOOGL, AAPL, TSLA, AMZN, MSFT, META and PLTR.
What does it cost?
The vault fee is 0 at launch. Pool fees apply on every swap, and transactions on Robinhood Chain need a little ETH for gas.
Which model runs the Bots?
Claude, by Anthropic. Each Bot's identity and role go in as its instructions.
Can I end an Allow for this chat pass early?
Yes. Turn off ends it on chain, and the Bot can no longer use it.
Can anyone see what my Bots did?
Yes. Your vault's record page, /record?v=<vault>, is public, and its hashes are anchored on Robinhood Chain.
Is OpenBot affiliated with CopilotKit or Robinhood?
No. OpenBot is inspired by the open-source OpenBot by CopilotKit (MIT): we ported its product ideas, not its code. We are not affiliated with CopilotKit, Inc. or Robinhood.