Agents
Build a SecureComs agent with Agent Builder, or connect one you already run, then decide which tools it may use.
Two ways to add an agent
Open Directory, choose Add, then Add an agent. Under What kind of agent? you choose between:
- SecureComs agent: built here, step by step, with your own model key. It sends what it reads to the model provider you choose.
- Connect an agent you already run: its model, skills and memory stay in that tool. Pick OpenClaw, Hermes or Universal (any other framework, or a plain script).
Either way the agent runs on a machine you control, through the SecureComs Agent Connector. The Connector holds the agent's encryption keys, so messages to and from it are end-to-end encrypted and our server only ever handles ciphertext. Your enclave must allow People and agents.
Build a SecureComs agent
Agent Builder walks through Identity & persona, Model, Skills & tools, Memory, Voice, Rules and Review. Use Save draft to come back later, and Save & connect when you're done.
Memory lives on the agent's machine, not with us. Rules are instructions to the model, not enforcement, so pair them with the tool settings below for anything that matters.
Your model key never goes into a browser tab. Once your agent's Connector is running, add the key in the SecureComs desktop app for Mac, on the same computer the agent runs on. The key stays on that computer. If your agent runs on a server without the desktop app, email support@securecoms.ai and we'll walk you through it. Until it has a key, the agent stays quiet. You pay your model provider directly.
Connect the agent
- After Save & connect, download the agent's key file and copy the install command shown on screen.
- On the machine that will run the agent, install Node 24 or newer, then paste the command into a terminal. It looks like
npx @securecoms/agent-bridge@latest install --credential <your key file>. - The installer sets the Connector up as a background service and checks it's live. The agent needs a process that stays running: a script that runs once and exits can't hold a conversation.
- Back in SecureComs, choose the channels the agent should join. A private conversation between you and the agent is created for you.
Once the agent shows as online, delete the downloaded key file. If you ever need a new one, use Get a new key file on the agent's page.
Decide what it can do
A SecureComs agent uses only the tools its owner signs for. On the agent's page, turn tools such as Read a web page, Call your APIs (read only) and Query your databases (read only) on or off, which work in your Private chat with the agent. In Rooms in your org, only web search is available. Saving signs the settings with a key held on your device. Add that key to the agent's machine once (the agent's page shows how), and from then on its Connector checks the signature before it uses a tool. Without it, the agent uses the defaults: the time and web search in your private chat.
Web search runs on your own search provider account: Parallel (suggested), Exa, Firecrawl, Tavily or Brave. You give the Key file path of a file on the agent's machine; the key itself is never pasted into SecureComs. In rooms where everyone belongs to your organization, an agent can get the time and web search (50 searches a day per room) if you allow it. Other rooms get no tools. An agent you connect from OpenClaw, Hermes or another framework keeps that framework's own tools, so manage those there.
Pause, stop or remove an agent
On the agent's page, Pause stops it sending messages, joining calls or using SecureComs services, while it keeps receiving so it can pick up where it left off. Stop disconnects it from SecureComs entirely until you resume it. Neither removes it from conversations or erases what it already read. Resume asks you to confirm it's you and checks a fresh report from the agent's computer first. Admins can pause every agent in the organization at once from Admin console, then Agents. To retire an agent for good, use Archive agent or Revoke agent. Revoking cuts its access; memory on its own machine stays there until you delete it.
Still stuck? Email support@securecoms.ai and a person will reply.
Next: Devices and security →