How RemoteAgent.CHAT protects your API keys, code, and credentials — and why the relay model is fundamentally private.
Security is a first-class concern in RemoteAgent.CHAT’s design. The most important property is also the simplest: your API key never leaves your machine.
The relay model
RemoteAgent.CHAT is a pure relay. It routes messages between Telegram and your local agent. It does not:
Store your prompts or AI responses (only a 200-character preview for the session list)
Read your source code
See your AI API keys
Execute code on your behalf
Your AI runner calls the model API directly from your machine, using credentials stored only on your machine. The RemoteAgent.CHAT servers relay the prompt you sent via Telegram — they do not process it, interpret it, or log it beyond the preview.
Do not include sensitive secrets in your Telegram commands. While the relay
does not log prompts, treat Telegram as you would any messaging app —
appropriate for instructions, not for embedding credentials.
API key storage
API keys are stored locally in:
~/.remoteagent/config.json — global config
~/.remoteagent/agents/ — per-agent config files
These files are written by remoteagent init and read only by the local agent process. They are never uploaded, synced, or referenced by any network request made by the relay.Recommended file permissions:
When you complete pairing, the server issues a signed token stored in the per-agent config. This token authenticates the agent’s connection to the message broker and scopes it strictly to its own channels — an agent cannot access another agent’s messages or data. Tokens can be revoked by deleting the agent from the dashboard.
Telegram webhook verification
Every incoming message from Telegram is verified using a cryptographic signature before any processing occurs. Requests that fail verification are rejected immediately.
Telegram user authorization
The bot checks the Telegram user ID of every incoming message against the authorized users for your account. Messages from unauthorized IDs are silently ignored — no error response is sent, which avoids leaking information about which user IDs are registered.This check runs before the command reaches your agent, so unauthorized messages are dropped at the gateway.
Pairing code security
Pairing codes are:
Short-lived — expire after 10 minutes
Single-use — marked as used immediately on first redemption
Unpredictable — generated with cryptographically secure randomness
The pairing flow requires Telegram authentication before the code can be redeemed. This binds the agent to a verified Telegram identity, not just anyone who has the code.
Channel isolation
Each agent communicates only on its own private channel, derived from its token. An agent cannot read or write to another agent’s channel. Session output channels are similarly scoped and unknown to other users.
Payment webhook verification
Billing events are verified against a signing secret before any plan changes are applied. Plan updates are only applied after a verified webhook event — never based on redirect URLs, client-side callbacks, or untrusted inputs.
Rate limiting
The message endpoint enforces rate limiting per Telegram user ID. Requests exceeding the limit are rejected. This prevents abuse of the relay by scripts or bots flooding the system with commands.
Summary
Security control
Implementation
API key isolation
Stored locally, never transmitted
Agent authentication
Signed token, scoped per agent
Webhook integrity
Cryptographic signature on every request
User authorization
Telegram user ID check before every command
Pairing code
10-min TTL, single-use, cryptographically random
Channel isolation
Private channels per agent, token-verified
Payment integrity
Signed webhook events only
Rate limiting
Per user ID, enforced at the gateway
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"RemoteAgent.CHAT","colors":{"primary":"#1B84FF","light":"#60AEFF","dark":"#0D5ECC"},"logo":{"light":"https://mintcdn.com/remoteagentchat/px6-PCumF-TyyIWF/logo/light.svg?fit=max\u0026auto=format\u0026n=px6-PCumF-TyyIWF\u0026q=85\u0026s=73d901cf8b03ed547c879ca4b742ae75","dark":"https://mintcdn.com/remoteagentchat/px6-PCumF-TyyIWF/logo/dark.svg?fit=max\u0026auto=format\u0026n=px6-PCumF-TyyIWF\u0026q=85\u0026s=d14b2e8d649edd085e6725a3bf57b7c1"},"favicon":"https://mintlify.s3.us-west-1.amazonaws.com/remoteagentchat/favicon.svg","navbar":{"links":[{"href":"https://remoteagent.chat","label":"remoteagent.chat"}],"primary":{"type":"button","label":"Get started free","href":"https://remoteagent.chat/signup"}},"footer":{"socials":{"github":"https://github.com/ggiacomo/docs"}},"seo":{},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"remoteagent.chat","icon":"house","href":"https://remoteagent.chat"},{"anchor":"Telegram bot","icon":"paper-plane","href":"https://t.me/remoteagent_bot"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"remoteagentchat","hasAudioNarration":false,"actualSubdomain":"remoteagentchat","customDomains":["docs.remoteagent.chat"],"gitSource":{"type":"github","owner":"ggiacomo","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"entitlements":{},"buildId":"6ae94a1e2537587934550871:success","clientVersion":"0.0.4227","searchFilterCounts":[{"language":"default","tag":"Documentation","count":23},{"language":"default","tag":"Runners","count":9},{"language":"default","tag":"Using the Bot","count":3},{"language":"default","tag":"Getting Started","count":3},{"language":"default","tag":"Under the Hood","count":3},{"language":"default","tag":"Platform","count":2},{"language":"default","tag":"Reference","count":1},{"language":"default","tag":"Support","count":1},{"language":"default","tag":"Overview","count":1}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"control","enabled":true,"payload":{"type":"string","value":"control"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[]}
{"page":{"pagePath":"under-the-hood/security","slug":"/under-the-hood/security","pageMetadata":{"title":"Security","description":"How RemoteAgent.CHAT protects your API keys, code, and credentials — and why the relay model is fundamentally private.","href":"/under-the-hood/security"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"How RemoteAgent.CHAT protects your API keys, code, and credentials — and why the relay model is fundamentally private.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={code:`code`,li:`li`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Heading,Table,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Security is a first-class concern in RemoteAgent.CHAT’s design. The most important property is also the simplest: `,_jsx(_components.strong,{children:`your API key never leaves your machine`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`the-relay-model`,children:`The relay model`}),`\n`,_jsx(_components.p,{children:`RemoteAgent.CHAT is a pure relay. It routes messages between Telegram and your local agent. It does not:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Store your prompts or AI responses (only a 200-character preview for the session list)`}),`\n`,_jsx(_components.li,{children:`Read your source code`}),`\n`,_jsx(_components.li,{children:`See your AI API keys`}),`\n`,_jsx(_components.li,{children:`Execute code on your behalf`}),`\n`]}),`\n`,_jsx(_components.p,{children:`Your AI runner calls the model API directly from your machine, using credentials stored only on your machine. The RemoteAgent.CHAT servers relay the prompt you sent via Telegram — they do not process it, interpret it, or log it beyond the preview.`}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`Do not include sensitive secrets in your Telegram commands. While the relay\ndoes not log prompts, treat Telegram as you would any messaging app —\nappropriate for instructions, not for embedding credentials.`})}),`\n`,_jsx(Heading,{level:`2`,id:`api-key-storage`,children:`API key storage`}),`\n`,_jsx(_components.p,{children:`API keys are stored locally in:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`~/.remoteagent/config.json`}),` — global config`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`~/.remoteagent/agents/`}),` — per-agent config files`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`These files are written by `,_jsx(_components.code,{children:`remoteagent init`}),` and read only by the local agent process. They are never uploaded, synced, or referenced by any network request made by the relay.`]}),`\n`,_jsx(_components.p,{children:`Recommended file permissions:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`3`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`3`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`chmod`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:` 700`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` ~/.remoteagent`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`chmod`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:` 600`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` ~/.remoteagent/config.json`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`chmod`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:` 600`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` ~/.remoteagent/agents/`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`*`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`.json`})]}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`agent-authentication`,children:`Agent authentication`}),`\n`,_jsx(_components.p,{children:`When you complete pairing, the server issues a signed token stored in the per-agent config. This token authenticates the agent’s connection to the message broker and scopes it strictly to its own channels — an agent cannot access another agent’s messages or data. Tokens can be revoked by deleting the agent from the dashboard.`}),`\n`,_jsx(Heading,{level:`2`,id:`telegram-webhook-verification`,children:`Telegram webhook verification`}),`\n`,_jsx(_components.p,{children:`Every incoming message from Telegram is verified using a cryptographic signature before any processing occurs. Requests that fail verification are rejected immediately.`}),`\n`,_jsx(Heading,{level:`2`,id:`telegram-user-authorization`,children:`Telegram user authorization`}),`\n`,_jsx(_components.p,{children:`The bot checks the Telegram user ID of every incoming message against the authorized users for your account. Messages from unauthorized IDs are silently ignored — no error response is sent, which avoids leaking information about which user IDs are registered.`}),`\n`,_jsx(_components.p,{children:`This check runs before the command reaches your agent, so unauthorized messages are dropped at the gateway.`}),`\n`,_jsx(Heading,{level:`2`,id:`pairing-code-security`,children:`Pairing code security`}),`\n`,_jsx(_components.p,{children:`Pairing codes are:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Short-lived`}),` — expire after 10 minutes`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Single-use`}),` — marked as used immediately on first redemption`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Unpredictable`}),` — generated with cryptographically secure randomness`]}),`\n`]}),`\n`,_jsx(_components.p,{children:`The pairing flow requires Telegram authentication before the code can be redeemed. This binds the agent to a verified Telegram identity, not just anyone who has the code.`}),`\n`,_jsx(Heading,{level:`2`,id:`channel-isolation`,children:`Channel isolation`}),`\n`,_jsx(_components.p,{children:`Each agent communicates only on its own private channel, derived from its token. An agent cannot read or write to another agent’s channel. Session output channels are similarly scoped and unknown to other users.`}),`\n`,_jsx(Heading,{level:`2`,id:`payment-webhook-verification`,children:`Payment webhook verification`}),`\n`,_jsx(_components.p,{children:`Billing events are verified against a signing secret before any plan changes are applied. Plan updates are only applied after a verified webhook event — never based on redirect URLs, client-side callbacks, or untrusted inputs.`}),`\n`,_jsx(Heading,{level:`2`,id:`rate-limiting`,children:`Rate limiting`}),`\n`,_jsx(_components.p,{children:`The message endpoint enforces rate limiting per Telegram user ID. Requests exceeding the limit are rejected. This prevents abuse of the relay by scripts or bots flooding the system with commands.`}),`\n`,_jsx(Heading,{level:`2`,id:`summary`,children:`Summary`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Security control`}),_jsx(_components.th,{children:`Implementation`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`API key isolation`}),_jsx(_components.td,{children:`Stored locally, never transmitted`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Agent authentication`}),_jsx(_components.td,{children:`Signed token, scoped per agent`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Webhook integrity`}),_jsx(_components.td,{children:`Cryptographic signature on every request`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`User authorization`}),_jsx(_components.td,{children:`Telegram user ID check before every command`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Pairing code`}),_jsx(_components.td,{children:`10-min TTL, single-use, cryptographically random`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Channel isolation`}),_jsx(_components.td,{children:`Private channels per agent, token-verified`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Payment integrity`}),_jsx(_components.td,{children:`Signed webhook events only`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Rate limiting`}),_jsx(_components.td,{children:`Per user ID, enforced at the gateway`})]})]})]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Security","description":"How RemoteAgent.CHAT protects your API keys, code, and credentials — and why the relay model is fundamentally private.","href":"/under-the-hood/security"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"The relay model","slug":"the-relay-model","depth":2,"children":[]},{"title":"API key storage","slug":"api-key-storage","depth":2,"children":[]},{"title":"Agent authentication","slug":"agent-authentication","depth":2,"children":[]},{"title":"Telegram webhook verification","slug":"telegram-webhook-verification","depth":2,"children":[]},{"title":"Telegram user authorization","slug":"telegram-user-authorization","depth":2,"children":[]},{"title":"Pairing code security","slug":"pairing-code-security","depth":2,"children":[]},{"title":"Channel isolation","slug":"channel-isolation","depth":2,"children":[]},{"title":"Payment webhook verification","slug":"payment-webhook-verification","depth":2,"children":[]},{"title":"Rate limiting","slug":"rate-limiting","depth":2,"children":[]},{"title":"Summary","slug":"summary","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"remoteagentchat","siteName":"RemoteAgent.CHAT","title":"Security - RemoteAgent.CHAT","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-04-13T21:06:26.102Z","originalFileLocation":"under-the-hood/security.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"How RemoteAgent.CHAT protects your API keys, code, and credentials — and why the relay model is fundamentally private.\">\u003cmeta data-mint-head name=\"application-name\" content=\"RemoteAgent.CHAT\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/remoteagentchat/rKg0QyTCj8CadLFa/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/remoteagentchat/rKg0QyTCj8CadLFa/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/remoteagentchat/rKg0QyTCj8CadLFa/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/remoteagentchat/rKg0QyTCj8CadLFa/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/remoteagentchat/rKg0QyTCj8CadLFa/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/remoteagentchat/rKg0QyTCj8CadLFa/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/remoteagentchat/rKg0QyTCj8CadLFa/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/remoteagentchat/rKg0QyTCj8CadLFa/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/remoteagentchat/rKg0QyTCj8CadLFa/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Security - RemoteAgent.CHAT\">\u003cmeta data-mint-head property=\"og:description\" content=\"How RemoteAgent.CHAT protects your API keys, code, and credentials — and why the relay model is fundamentally private.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"RemoteAgent.CHAT\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.remoteagent.chat/under-the-hood/security\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://remoteagentchat.mintlify.site/_mintlify/api/og/v2?division=Under+the+Hood\u0026amp;title=Security\u0026amp;description=How+RemoteAgent.CHAT+protects+your+API+keys%2C+code%2C+and+credentials+%E2%80%94+and+why+the+relay+model+is+fundamentally+private.\u0026amp;theme=bfb3e23b8019de3f9df06c5e\u0026amp;signature=f1ec2d25979f479d3497adf46fee38ae2a92e6e24bdd900fe93d91b787e548ea\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Security - RemoteAgent.CHAT\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"How RemoteAgent.CHAT protects your API keys, code, and credentials — and why the relay model is fundamentally private.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://remoteagentchat.mintlify.site/_mintlify/api/og/v2?division=Under+the+Hood\u0026amp;title=Security\u0026amp;description=How+RemoteAgent.CHAT+protects+your+API+keys%2C+code%2C+and+credentials+%E2%80%94+and+why+the+relay+model+is+fundamentally+private.\u0026amp;theme=bfb3e23b8019de3f9df06c5e\u0026amp;signature=f1ec2d25979f479d3497adf46fee38ae2a92e6e24bdd900fe93d91b787e548ea\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/remoteagentchat/rKg0QyTCj8CadLFa/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"RemoteAgent.CHAT\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#1B84FF\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.remoteagent.chat/under-the-hood/security\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/under-the-hood/security.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.remoteagent.chat/#organization\",\"name\":\"RemoteAgent.CHAT\",\"url\":\"https://docs.remoteagent.chat\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/remoteagentchat/px6-PCumF-TyyIWF/logo/light.svg?fit=max\u0026auto=format\u0026n=px6-PCumF-TyyIWF\u0026q=85\u0026s=73d901cf8b03ed547c879ca4b742ae75\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.remoteagent.chat#website\",\"name\":\"RemoteAgent.CHAT\",\"url\":\"https://docs.remoteagent.chat\",\"publisher\":{\"@id\":\"https://docs.remoteagent.chat/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.remoteagent.chat/under-the-hood/security#webpage\",\"url\":\"https://docs.remoteagent.chat/under-the-hood/security\",\"name\":\"Security\",\"description\":\"How RemoteAgent.CHAT protects your API keys, code, and credentials — and why the relay model is fundamentally private.\",\"dateModified\":\"2026-04-13T21:06:26.102Z\",\"isPartOf\":{\"@id\":\"https://docs.remoteagent.chat#website\"},\"breadcrumb\":{\"@id\":\"https://docs.remoteagent.chat/under-the-hood/security#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.remoteagent.chat/under-the-hood/security#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Under the Hood\",\"item\":\"https://docs.remoteagent.chat/under-the-hood/architecture\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Security\",\"item\":\"https://docs.remoteagent.chat/under-the-hood/security\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.remoteagent.chat/under-the-hood/security#article\",\"headline\":\"Security\",\"name\":\"Security\",\"description\":\"How RemoteAgent.CHAT protects your API keys, code, and credentials — and why the relay model is fundamentally private.\",\"url\":\"https://docs.remoteagent.chat/under-the-hood/security\",\"mainEntityOfPage\":{\"@id\":\"https://docs.remoteagent.chat/under-the-hood/security#webpage\"},\"dateModified\":\"2026-04-13T21:06:26.102Z\",\"publisher\":{\"@id\":\"https://docs.remoteagent.chat/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.remoteagent.chat#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"RemoteAgent.CHAT\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"RemoteAgent.CHAT\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/under-the-hood/security.md","siteName":"RemoteAgent.CHAT","nav":{"global":{"anchors":[{"anchor":"remoteagent.chat","icon":"house","href":"https://remoteagent.chat"},{"anchor":"Telegram bot","icon":"paper-plane","href":"https://t.me/remoteagent_bot"}]},"tabs":[{"tab":"Documentation","groups":[{"group":"Overview","pages":[{"title":"What is RemoteAgent.CHAT?","href":"/introduction"}]},{"group":"Getting Started","pages":[{"title":"Quickstart","href":"/getting-started/quickstart"},{"title":"Pairing","href":"/getting-started/pairing"},{"title":"Best Practices","href":"/getting-started/best-practices"}]},{"group":"Runners","pages":[{"title":"Runners overview","href":"/runners/overview"},{"title":"claude-code","href":"/runners/claude-code"},{"title":"claude-sdk","href":"/runners/claude-sdk"},{"title":"opencode","href":"/runners/opencode"},{"title":"codex","href":"/runners/codex"},{"title":"gemini","href":"/runners/gemini"},{"title":"aider","href":"/runners/aider"},{"title":"openclaw","href":"/runners/openclaw"},{"title":"custom","href":"/runners/custom"}]},{"group":"Using the Bot","pages":[{"title":"Sending commands","href":"/bot/sending-commands"},{"title":"Multi-project","href":"/bot/multi-project"},{"title":"Offline alerts","href":"/bot/offline-alerts"}]},{"group":"Platform","pages":[{"title":"Dashboard","href":"/dashboard"},{"title":"Pricing","href":"/pricing"}]},{"group":"Under the Hood","pages":[{"title":"Architecture","href":"/under-the-hood/architecture"},{"title":"Services","description":"The categories of external services RemoteAgent.CHAT depends on, and what role each one plays.","href":"/under-the-hood/services"},{"title":"Security","href":"/under-the-hood/security"}]},{"group":"Reference","pages":[{"title":"CLI reference","description":"Complete reference for all remoteagent CLI commands.","href":"/cli-reference"}]},{"group":"Support","pages":[{"title":"FAQ","href":"/faq"}]}]}]},"basePath":"","title":"Security - RemoteAgent.CHAT","deploymentId":"dpl_vSEmv961Ncyvz1psVwgUnTXQMSYk","buildId":"dpl_vSEmv961Ncyvz1psVwgUnTXQMSYk","dynamics":[],"chunks":[]}