Skip to content

Security

This page is for deciding whether to connect a computer. It says what the product does, including the parts you may not like.

  • An agent with Full access can do what your user account on that computer can do.
  • Allowed folders are where agents start and what the app can browse. They are not a sandbox.
  • The machine connects out over https. It accepts no inbound connections.
  • API keys and your Claude login stay on the machine. The service never has them.
  • The service stores your conversations and can read them. Messages are not end-to-end encrypted.

An agent is Claude Code running on your machine as the user who started monoclaw. It has that user’s files, shell and environment variables. Two settings limit it, and the machine enforces both, whatever the service or the agent says.

Access is the ceiling.

Access What it allows
Full Reads, edits files and runs commands. It starts in its folder but is not confined to it: a command can reach anything your account can. It also follows the Claude Code settings on that computer and in that folder.
Read-only Reads, searches and looks things up on the web. No commands, no edits, no sending files. It removes the tools that change things; it is still not a sandbox.
Chat only Talks, and messages other agents. No other tools.

Permissions decide when an agent stops to ask.

Permissions What happens
Auto A safety check approves each action and asks you only when unsure. This is the default.
Ask Asks before every change or command.
Accept edits Edits files without asking; asks before commands.
Plan Plans only; changes nothing.

When an agent asks, you see a card with the exact command or change and Allow and Deny. Only people answer: the person who started the task, or an owner. A request nobody answers within 10 minutes is denied.

A machine has a list of allowed folders. An agent’s folder must be inside one, the app can only browse inside them, and the machine refuses to start an agent anywhere else. Files an agent sends to the chat must come from its own folder.

That is all they do. A Full agent can run a command that reads or changes a file anywhere your account can. MonoClaw refuses to allow a folder that contains its own settings folder, but it does not wall an agent in. For a real wall, run the machine in its own user account, a container or a separate computer.

The machine opens one connection out to command.monoclaw.ai over https and keeps it open. It listens on no port. It refuses a plain http address unless you explicitly allow it for development.

  • API keys (Anthropic, ElevenLabs, fal) are stored on the machine: in the login keychain on macOS; in the system keyring on Linux when secret-tool is available, otherwise in a file only your user can read; in a file only your user can read on Windows.
  • A key typed in the app is encrypted in your browser for that one machine before it is sent. The service passes it on and cannot read it. The machine must be online to receive it.
  • The service keeps a name for each key and its last four characters, so you can tell keys apart.
  • A Claude subscription login is Claude Code’s own, on your computer. It never reaches the service.
  • Monthly caps on a key are counted and enforced on the machine.

Keys kept in a file can be read by anything running as your user, which includes a Full agent.

Your account (email, handle, name), your projects, the whole conversation including agents’ steps, attachments, voice recordings and the audio made for replies, each machine’s name, system, folders and modules, and for organisations who belongs and what they can open.

The service can read all of this. Everyone who can open a project sees everything in it.

Each machine keeps its own policy, which the service cannot override:

Terminal window
monoclaw config show

It lists the permission modes the machine accepts, how many agents may run at once, and whether an approver may edit an agent’s command before allowing it (off by default). The mode that skips all approvals is not on the list unless you add it yourself with monoclaw config set. Folders are also set only on the machine. See Machines.

The machine program updates itself: it asks the service which version is current, installs that version of @monoclaw/machine with npm, without install scripts, and restarts between tasks. A machine below the service’s minimum version cannot connect until it updates. This means you trust MonoClaw’s releases, as with any program that updates itself.

In an organisation, a member can drive an agent that runs on an owner’s machine, with that agent’s access and that machine’s login or key. Give shared agents their own machine or user account, and prefer an API key to a personal subscription for them. See Organisations.

  • Run agents on a machine, and in a user account, you are comfortable giving them.
  • Keep secrets out of folders agents work in.
  • Keep paid API keys on machines that run no Full agents, and set a monthly cap.
  • Use Read-only or Chat only for agents that do not need to change anything.

Send security reports to hello@monoclaw.ai.