Settings Overview
Settings opens in a full-screen two-column mode (Cmd/Ctrl+,): grouped navigation on the left, the configuration panel on the right. Click the search at the top (or press Cmd/Ctrl+F) and type a keyword to jump straight to a setting; changes save immediately.
Navigation is arranged in five groups: General / Capabilities / Keyboard Shortcuts / Archive / About.
At the top of the settings page there is a “Local / Cloud” toggle: model, approval, Git policy, and other configurations are stored separately for local and cloud and never overwrite each other; pages that only take effect locally are grayed out in the cloud profile, with an explanation of why.
You can also let LanMate change settings for you in conversation: ordinary preferences are confirmed under the current approval level; sensitive configuration (approval policy, sandbox, browser/computer-control switches) always requires confirmation no matter the mode; credentials are pre-filled by LanMate and you type the key yourself in the dialog.
General
| Setting | Description |
|---|---|
| Language | Simplified Chinese / Traditional Chinese (Taiwan) / Traditional Chinese (Hong Kong) / English / Follow system |
| Menu bar / tray icon, prevent sleep | Platform appearance and blocking system sleep during tasks |
| Plugin master switch | Disables all user plugins at once without deleting them |
| Suggested follow-ups | Generates 2-4 follow-up suggestions per turn |
| Default way to open local links | Built-in browser / system browser / always ask |
| Standalone task workspace path | Where new tasks without a selected project land |
| Pop-up window shortcut | Global hotkey to summon LanMate |
| Don’t select a project by default for new tasks | Whether the last project is remembered |
Conversation behavior
Show context usage, show inter-agent communication, allow context reset, send shortcut (Enter to send / Enter for a new line), follow-up handling (queue / steer), auto-expand while thinking.
Appearance and desktop pet
Dark mode (light / dark / follow system), interface transparency, desktop pet visibility and form.
Network and proxy
Proxy mode, address, and bypass list; changes apply to new requests.
Personalization
| Setting | Description |
|---|---|
| What to call you | How LanMate addresses you (e.g., “Mr. Zhang”, “Engineer Li”) |
| Reply style | Default / concise / detailed |
| Additional requirements | Tone, format, and language habits added on top of the style |
| Enable global memory | Cross-session memory switch; deleting global memory cannot be undone |
| Automatic self-reflection | Distills experience every N turns; frequency and minimum interval are adjustable |
| Saved experience | Review entries one by one; deleting one rolls it back |
| Custom global rules | Appended to the system prompt of every session |
| Main agent profile | Edit the main agent’s system prompt |
Personal Assistant
MateBot’s identity, speaking style, dedicated model, extra persona, intro, and automatic handling all live on this page.
- Identity: name, speaking style (Lively / Gentle / Crisp), dedicated model, extra persona
- Automatic handling: processing mode (off / record only / auto-create), sources to watch, judgment rules, DM bridging
See MateBot settings and Automatic handling.
Security
| Setting | Default | Description |
|---|---|---|
| Default approval for new tasks | Auto-approve (AI-judged) | Also: always ask / read-write allowed / no approval |
| Default file protection | Workspace | Read-only (temp only) / workspace / unrestricted |
| Confirm before saving memory | On | MateBot and the main agent ask before saving a memory |
| Delete to trash | On | Deleted files can be recovered |
| Block network inside the sandbox | Off | Network is allowed by default; when on, Linux sandboxed processes lose network |
| Restrict channel file paths | On | Channel sessions can only send files inside the working directory |
| Allow project MCP configuration | Off | MCP servers in a project’s .lanmate/settings.json must be trusted explicitly |
| Post-write diagnostic check | Off | Runs the project’s declared check commands after file edits |
| Execution policy rules | — | Custom allow/deny/ask by tool, path, and command |
See Approval and Security and Sandbox and File Protection.
Storage
Shows how much space each kind of data takes (sessions, archive, skills, plugins, artifacts, cache) and lets you clean up by category; the default working directory is set here too. If the footprint grows unexpectedly after long use, clear cache and archive first rather than deleting session directories directly.
Notifications
| Type | Default |
|---|---|
| Task complete | Background only |
| Approval request | On |
| Question | On |
Sounds can be toggled separately: task complete, waiting for action, interrupted by an error.
Capabilities
| Page | What it manages |
|---|---|
| Models | Providers, models, keys, default model |
| Web search | Search service and key |
| Media generation | Image/video generation services |
| Voice | Transcription, synthesis, wake word, voice input and conversation |
| External agents | External sub-agent integration |
| Browser | Built-in browser, external Chrome bridge, site approval |
| Computer control | Master switch, permissions, screenshot mode, teach-and-record |
| Mobile remote | Remote access and pairing |
| Run host | Local / cloud execution target |
| Git | Branches, worktrees, GitHub connection |
| Automation | Declarative hooks and run history |
Keyboard Shortcuts
Global summon, session switching, sending, archiving, and more are collected here; consistent with Shortcuts & Glossary.
Archive
Archived tasks are grouped by project for review, restore, or permanent deletion; external sessions and external assets are managed separately. Archiving is not deleting — only permanent deletion actually clears the data.
Environment Check and About
Environment check lets you copy a diagnostic report and open the log folder; the About page shows version, updates, and license information. When reporting an issue, include the diagnostic report and the session ID first.