fill_login tool and Clawboo fills the username, password and any one-time code straight into that page. The agent gets told only whether it worked.
Before you begin
- The agent needs a browser of its own, from the Playwright or Chrome DevTools connector (see Every agent gets a browser), open on the site’s sign-in page. Every agent is given one; an agent whose browser was taken away, or with neither connector connected, is not offered the fill. With neither connected, Settings > Website logins says so; you can still save logins.
- For an
httpssite, use the Playwright browser. It is the one that can show Clawboo the site’s certificate. The Chrome DevTools browser cannot, so it fills only plainhttppages on your own computer, such ashttp://localhost:3000, and on any other site the agent is told to open the page in the Playwright browser. - The tool is offered to Claude Code, Codex, Hermes and Clawboo Native agents. OpenClaw agents do not get it, because Clawboo cannot tell which OpenClaw agent is calling (see OpenClaw agents and connectors). Hermes keeps one tool list for all of an agent’s runs, so a Hermes agent sees
fill_logineven in a run that may not use it (such as a routine’s), and a call there is refused.
Save a login
1
Open Website logins
Go to Settings > Website logins and choose Add login.
2
Enter the site and the login
- Site address: the address you sign in at, such as
example.comorhttps://accounts.example.com. Clawboo keeps only its origin:https, the host and the port. - Username and Password.
- One-time code key (optional): the setup key a site shows next to its authenticator QR code. Clawboo then fills the current six-digit code too.
- Label (optional), to tell your logins apart.
3
Choose Save login
The login goes into Clawboo’s encrypted vault. From then on the dashboard shows only the site, the label, and whether a username or one-time code is set. Nothing reads a username, password or key back to the page, so to change one, choose Edit and type the new value. Fields you leave empty keep their value.
example.com and accounts.example.com), save it for each.
Connect 1Password
Clawboo can also look logins up in 1Password, through 1Password’s official SDK and a service account you create for it.- In 1Password, create a service account with read access to the vault that holds the logins your agents may use. Give it only those vaults.
- In Settings > Website logins, paste its token under 1Password and choose Connect. Clawboo checks that the token can read at least one vault before it saves it, in the vault.
How an agent signs in
- The agent opens the site’s sign-in page in its browser.
- It calls
fill_loginwith the site, for exampleexample.com. - Clawboo checks the page’s address in the browser itself. The page must be on exactly the login’s origin: the same scheme, host and port. A subdomain, a look-alike name or plain
httpdoes not match. Onhttps, the browser must also accept the site’s certificate: a page with a certificate error gets nothing, even one the agent clicked through the warning to reach. - Clawboo fills only the fields the page shows, and none whose form sends it to another site, counting a
<base>address the page sets. A page that asks for the email first gets only the username; the password goes in on the next step, when the agent callsfill_loginagain. - The agent submits the form.
fill_login answers one of:
Clawboo fills through the browser connector the agent already uses, in the tab it has open. It reads the page’s address from the browser itself, never from the agent, and checks it again inside the page in the same step that fills, so a page that moved to another site in between gets nothing. In the Playwright browser the fill runs in a script world of its own, apart from the page’s scripts, so the page cannot catch the values on their way in. While you have taken over the agent’s browser, it fills nothing.
What only a person can do
A CAPTCHA, a passkey and a card check (such as a bank’s 3-D Secure step) are left to you. When the run is working on a board task, Clawboo hands the task back to the person who asked for it, with a note saying which site and what it asks for, and the card moves to Needs you. Open the agent’s page, take over its browser to finish signing in, then press Retry. In a chat with no task, the agent tells you in its reply instead.Whose logins a run may use
Logins belong to the person who saved them, and a run uses only its own person’s logins and 1Password. Clawboo decides whose run it is once, when the run starts:- The person who started it: who sent the chat message, or pressed Retry or Assign on a task the task runner works.
- Otherwise, the person who asked for the run’s task, or for the nearest task above it that names someone.
Who may use an agent can use what it holds
An agent works for everyone who may use it, and what it holds comes with it, logins included. Two things follow, so decide who may use each agent, and who may ask each team for work, with that in mind:- A sign-in stays in the agent’s browser. Each agent has one browser. After a fill, the site keeps that browser signed in, as any browser stays signed in, so the agent’s later runs are signed in there too, for anyone who uses that agent.
- A team works for everyone who asks it for work. An agent can hand out work under any task of its own team, and that work counts as asked for by whoever asked for the task above it. So work an agent hands out under your task signs in with your logins.
What this protects, and what it does not
- Clawboo never hands the model a login. No username, password, one-time code or 1Password token is in what
fill_loginanswers, in the event log, in the tool audit, in the server’s log or in any REST answer. The vault lends the saved passwords to the scrub that cleans stored text. - What is masked, and what is not. Clawboo masks the username, password and one-time code it filled out of that agent’s browser tool results, error messages included, for a day after the fill. That covers the text the model reads, the tool audit and the event log. A value is masked from the moment Clawboo reads it, before it goes to the page. A value shorter than 4 characters is not masked, because masking it would wipe ordinary page text. Screenshots are not masked: a screenshot shows whatever the page shows, so a password field the agent revealed (with a show-password button, say) reaches the model in the picture. The mask also catches only a value copied out as it was filled, not one an agent changed first.
- A login reaches only its own site. The origin check is on the live page, not the agent’s word for it, and on
httpsthe browser must accept the site’s certificate. - A filled password is in the page. The agent drives that page, so it can still read a field it can see, show it in a screenshot, or run a script that sends it elsewhere. Give an agent only logins for accounts you would trust it to use.
- A run’s Tools address can be read while the run lasts. Each run’s Tools address carries a reference to the run, and whoever holds that address can call
fill_loginas that run until it ends. A Claude Code run gets the address on its command line, and Codex keeps it in its runtime folder. A Hermes agent’s one address stands for whichever of its runs is going, and Hermes keeps it in its runtime folder too. Every agent on the agent user can read those folders, so while a run of yours is going, another agent on this Clawboo could sign in with your logins through it. - A sign-in stays with the agent. Whoever may use that agent uses its signed-in browser too (see Who may use an agent can use what it holds).
- With
CLAWBOO_AGENT_USERon, agents run as their own operating-system user and cannot read the vault, its key or the 1Password token. Without it, agents run as your user: they still never get a login through Clawboo, but a misbehaving agent process could read the vault and its key from your Clawboo folder like any other program you run.
Related
- Connectors: the browsers agents fill logins into.
- Security: where the vault lives and what it protects.
- Agents on their own user: keeping the vault out of agents’ reach.
- Website logins API and the
fill_logintool.