openbot

How OpenBot works.

AI coworkers with their own wallets on Robinhood Chain. Each Bot has a job, and when it trades, a key on your vault with a rule the contract enforces. Over its rule a Bot stops and asks.

Getting started

The landing page, these docs and every record page are public. The app asks you to connect a wallet.

  1. 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.

  2. 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.

  3. 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.

TemplateRolePowers
Stock DeskTrades stock tokens in your vault inside its rule.read, trade
WatcherWatches prices and pings you when your conditions line up.read, notify
Treasury ClerkKeeps the books: vault and wallet balances, Pons creator fees waiting, gas left.read, draft tx
Launch OfficerDrafts a Pons coin launch for your wallet to send.read, draft tx
HeraldWrites your posts for X. Nothing goes out without you.draft post
CustomYour 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.

AnswerWhat happens
Allow onceYour 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 chatYour 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 allowOne 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.
DenyNothing 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.

FieldWhat you set
BotWhich Bot carries it out.
What to doThe instruction, in your own words.
It shouldAct for you or Only tell you.
StartsOn a schedule (every N minutes or hours, or daily at HH:MM UTC), When something happens (a price condition), or Now, once.
Done whenOptional: when the routine should stop.
NameHow 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, Revoked and Noted.

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.