Before you begin
- Node.js on the machine that runs Clawboo. Most connectors start with
npx, and the first start downloads the connector’s pinned package. - For a connector you sign in to (Linear, Sentry, Stripe, Composio), a browser on that same machine. The sign-in page sends you back to a temporary address on that machine.
- An account or key for the service, when the connector asks for one.
Connect a connector
Open Connectors
Find the connector
Press Connect
Check that it connected
NOTION_TOKEN) is not picked up: enter it in Connectors.
Suggestions for Filesystem and SQLite
Suggestions for Filesystem and SQLite
.db, .sqlite or .sqlite3 files within two folder levels of where you started Clawboo. You can always type a path instead.GitHub needs a token, not a sign-in
GitHub needs a token, not a sign-in
What the list holds
The list reads top to bottom in four bands:Apps reached through Composio
Clawboo cannot sign in to Google, Slack or Atlassian directly, so those apps go through Composio, a separate service that signs you in to each app.Add your Composio key
ak_), paste it into the Composio key field and press Save. You do this once.Connect an app
Connect the Composio connector
Give the app to an agent
Give a connector to an agent
You give access on the connector’s detail pane in Connectors, or on a graph: the Org chart, a team’s Team graph card, or the Graph card on an agent’s page. On a graph, click a Boo to open its ring of tiles; each connector tile on the ring is one the agent can use.- Pick agents on the connector's pane
- Pull a thread off the Boo
- Place a tile, then drop it on a Boo
Open the connector
Pick the agents
Who can use a connector
- Right after you connect it: no agent. Its tools are hidden from every agent, and a call to them is refused.
- After you give it to an agent: that agent only, with the access you chose. Every other agent still has no access until you give it to them too.
- The exception: the two browser connectors, which every agent gets automatically (next section).
Every agent gets a browser
The two browser connectors, Playwright and Chrome DevTools, are connected for you the first time Clawboo starts, unless that is turned off in Settings > System > Deployment (see Deployment settings), and every agent gets both with write access. When the exact version Clawboo pins is already installed, in npx’s cache or in thenode_modules folder Clawboo itself is installed in, each starts from that copy rather than through npx, which keeps one fewer process running and makes no registry request. Chrome DevTools runs with its usage statistics and its check for a newer version turned off. OpenClaw agents get the tiles too, but cannot use them; see OpenClaw agents and connectors. In Chrome DevTools, actions that change something, such as opening a page or clicking, ask you first, and the two that run script in the page or hand a file from this computer to a website (evaluate_script and upload_file) count as destructive and need Admin access. Playwright works the same way with write access: an agent can open pages, click, type, fill in forms, pick options, hover, drag, press keys, manage tabs, resize the window, answer page dialogs and go back, and each of those actions asks you first. Its reading tools, such as a snapshot or a screenshot of the page, need only read access and run without asking. Four Playwright tools count as destructive and need Admin access: the two that run code (browser_run_code_unsafe and browser_evaluate) and the two that can hand a file from this computer to a website (browser_file_upload and browser_drop). To stop one action asking every time, tick Do not ask again for this for 30 days on its card (see When a connector call asks you first). Both browsers start with the Clawboo dashboard’s port blocked on localhost and every name under .localhost, on every 127.x.x.x address, ::1 and 0.0.0.0, and on the address set in HOST. Chrome applies the block when it looks up an address, so a redirect, a page’s script or a WebSocket that heads for the dashboard is stopped too. Clawboo also refuses any connector call that names one of those addresses, however it is written. Together these keep an agent from opening the dashboard to approve its own requests. They do not know a name that reaches Clawboo through a reverse proxy or one listed in CLAWBOO_ALLOWED_HOSTS; there only an access token (STUDIO_ACCESS_TOKEN) keeps an agent out, because each agent’s browser has its own profile, without your sign-in cookie. Other ports, such as an app you are developing, stay reachable. Neither browser opens files on this computer: Clawboo refuses a file: or view-source: address, or a Windows path such as C:\Users, given to either one. See What agents can do on your machine for what this does not cover. Each agent has its own browser profile, so two agents can be signed in to different accounts on the same site. To let an agent sign in without ever seeing the password, save the login under Website logins. The browser tiles sit on the agent’s ring like any other connector, so you can take them away (next section), and a removed browser stays removed after a restart.
A desktop driver for each agent’s screen
Cua Driver (category Desktop) uses the apps on an agent’s own screen: it lists windows, clicks, types and reads each app’s accessibility tree. It works on Linux only, where agents get a screen of their own (see Watch a screen and take over), and it is not given to agents automatically: connect it, then give it to the agents that need it.- It runs only when agents run as their own OS user (
CLAWBOO_AGENT_USER), like a control link. It types into the agent’s browser, which otherwise runs as you, so an address it types there could open your files and Clawboo’s own. Without it, Connect says so, and agents keep everything else: their own screen, the live view, taking over from the dashboard, and their browser tools. Only Cua Driver waits. To turn agent isolation on, see Set it up on Linux. - Install it first on an agent’s Screen view (Install the desktop tools, or Install Cua Driver where agents already have a screen); Connect says so until it is installed, and refuses on macOS and Windows and where agents get no screen of their own (displays turned off, or no
Xvnc). Clawboo runs only the copy it installed, never one onPATH: its rules below are checked against that release. - Each agent gets its own Cua Driver process, run as the agent user, on that agent’s own screen and nowhere else, with a home folder of its own inside the agent’s browser folder. It talks only to that screen’s own session bus (or to none), never to your desktop session’s, so it does not switch on accessibility, or a screen reader, on your desktop. A call that names no agent, or for an agent with no screen of its own, is refused.
- It runs in its own process for each agent, never through a shared Cua Driver service, with its usage telemetry and its check for a newer version turned off. To turn them on, set
CUA_DRIVER_RS_TELEMETRY_ENABLEDorCUA_DRIVER_RS_UPDATE_CHECKin the server’s environment. - While a person has taken over an agent’s screen, its Cua Driver calls are refused, like its browser calls.
- Its actions ask you first, like a browser’s. The tools that run code, start or stop programs, install things, change the driver’s own settings, or move a file between the computer and a website (
run_script,run_steps,replay_trajectory,launch_app,kill_app,install_extension,install_ffmpeg,check_for_update,set_config,browser_set_input_files,browser_download,clipboard_write, andbrowser_prepare, which starts a browser of the driver’s own without Clawboo’s checks) count as destructive and need Admin access. - Clawboo refuses
screenshot_out_fileandoutput_dir, the arguments with which it writes a file wherever they point (so recordings are not available); a screenshot comes back in the reply instead.
See and take back access
The graph is the list of who can use what: every tile on a Boo’s ring is something that agent can reach. A connector’s detail pane also marks the agents that have it as Has access, under Who can use it?. A tile that several agents share shows a small count, such as x3; hover it to highlight the others. Click a connector tile to see its toolbar:When a connector call asks you first
Every call an agent makes through a connector passes Clawboo’s checks first. When a call needs your answer, an approval card appears in Needs you on the board, in the chat where the agent is working, and in the Governance and Capabilities panels. If nobody answers within five minutes, the call is refused. See Approvals for the cards themselves. Which calls ask depends on the connector:- GitHub, Linear, Sentry, Airtable and Notion, and any server you added yourself, ask before every call. They can read your private data, take in content from outside and send data out. That combination is how data gets leaked, so you cannot turn these questions off.
- Actions in apps reached through Composio ask every time too.
- On the other connectors, a call that only reads runs without asking when Clawboo reviewed the connector and the tool says it only reads. A call that changes something asks first when the connector can reach the internet. A destructive tool needs Admin access and asks every time. For Playwright, Clawboo’s own list decides which tools are destructive; on the other reviewed connectors, the connector marks them itself.
When an agent asks for a connector
Agents are told which connectors are connected and which ones you could add. An agent that needs one it does not have says so and stops, and a card in the chat offers a button for each connector it named, such as Connect Linear or Add key Notion. The button opens that connector in Connectors, with the asking agent already ticked under Who can use it? and marked Asked for it. As soon as the connector connects on that pane, whether by its connect button, a saved key or a sign-in, the asking agent gets write access, and risky calls ask you first. Nothing changes when the agent already has access, or when it is an OpenClaw agent, which is never ticked. If you took the agent’s access away earlier, its request does not give it back: the agent stays ticked, marked Access taken back, and Give access shares it again only if you click it. The card counts a connector as done only when it is connected and the asking agent has access. A connector that is connected but not shared with that agent shows a button such as Share Linear with Ada instead, which opens the connector and gives that agent access. Once the agent can use every connector it asked for, the card shows Continue (in a team chat): press it so the agent picks the work back up.Add your own MCP server
At the foot of the list, Add your own MCP server adds a server that speaks MCP over stdio, which means a program Clawboo starts on this machine.Fill in the form
PATH) and its Arguments, separated by spaces. Arguments go straight to the program, never through a shell.Add it
Connect it and give it to an agent
OpenClaw agents and connectors
OpenClaw agents reach Clawboo’s tools through one setting in the OpenClaw Gateway that all of them share, so Clawboo cannot tell which OpenClaw agent is calling. As a result, connectors you give an OpenClaw agent on the graph do not reach it, the browser connectors included, and Who can use it? does not let you pick one. It can use apps reached through Composio, and each action in those apps asks you first. The Gateway’s own MCP servers and plugins are separate: they are listed in the Capabilities panel.Keep connectors safe
Troubleshooting
An agent says a connector is connected but cannot use it
An agent says a connector is connected but cannot use it
Connect fails with: needs npx, which comes with Node.js
Connect fails with: needs npx, which comes with Node.js
npx on its PATH. Install Node.js from nodejs.org, restart Clawboo, and press Connect again.The first connect fails with: did not respond in time
The first connect fails with: did not respond in time
Connect fails with: did not accept that key
Connect fails with: did not accept that key
Connect fails with: accepted the key but refused the request
Connect fails with: accepted the key but refused the request
Sign-in says: Your browser blocked the sign-in window
Sign-in says: Your browser blocked the sign-in window
Saving the Composio key says: That is a Composio login key
Saving the Composio key says: That is a Composio login key
ak_ and is on your Composio project’s API keys page (Get a key opens it).A tile shows: Changed since you approved it
A tile shows: Changed since you approved it
Next steps
- Approvals: answer the cards that connector calls raise.
- Capabilities: every skill, tool and connector your agents have, in one list.
- Org chart: the graph where you give and take back access.
- What agents can do: what an agent can reach on each runtime, beyond connectors.
- Connectors API: connect connectors and manage access from scripts.