Computer Control | LanMate User Guide
Using the Qianxin edition of LanMate?View Qianxin Edition User Guide

Computer Control

Computer control lets LanMate operate your desktop like a person: see the screen, recognize buttons, click, type, drag — and open and switch apps. On macOS it can even work in the background while you do something else, without taking over your mouse and keyboard.

Enable

Settings → Computer Control:

  1. Turn on the “Enable Computer Control” master switch
  2. On macOS, grant Accessibility (mouse and keyboard, interface elements) and Screen Recording permissions
  3. Restart LanMate after granting for it to take effect

On Linux it needs xdotool and python3-pyatspi; if a dependency is missing, the settings page shows the install command.

What it can see

Three screenshot return modes can be chosen in settings:

Mode Best for
Screenshot only Seeing the picture only; suits image-recognition style operations
Interface elements only Reading a structured list of buttons, input fields, and so on — more accurate coordinates, slower on large apps
Screenshot + interface elements Returns both; the default and generally the most robust

The matching tools are computer_screenshot / computer_screenshot_window, computer_get_ui_tree, computer_get_app_state, and computer_get_active_app.

What it can do

Ability Tools
Click, drag, scroll computer_click / computer_drag / computer_scroll / computer_move_mouse
Type text, press keys, set values computer_type / computer_press_key / computer_set_value / computer_select_text
Operate interface elements computer_ax_act (act by element semantics instead of guessing coordinates)
Open apps, switch windows, wait computer_open_app / computer_activate_window / computer_wait_for
Teaching recording computer_start_teach_record / computer_stop_teach_record
Learned skills computer_list_learned_skills / computer_refine_skill / computer_forget_skill

Operations that change your computer, such as clicking and typing, ask you first by default; you can choose “Always allow desktop app operations” or approve app by app.

Background actions (macOS)

LanMate can operate another app while you keep using the computer: your mouse and keyboard are completely unaffected. Useful when you want it to fill in forms or tidy documents while you carry on with your own work.

Teaching recording

This is a highlight of 1.0.x: the flow you perform by hand is distilled into a reusable skill.

Settings → Computer Control → Teaching recording:

When recording ends, only the desensitized steps are submitted (trigger, inputs, actions, verification); screenshots stay on this machine with the skill. If there is no reusable fixed sequence, it tells you plainly that no skill was generated.

Learned skills are managed on the same settings page: you can see replay counts, or “Forget skill” — the skill directory, steps, and keyframes are deleted together and cannot be recovered.

Taking over Office documents

With computer control enabled, LanMate can also take over the Word / Excel / PPT you currently have open:

For the fuller human-machine co-editing experience (side conversation + tracked revisions), see Office Document Editing in Files & Artifacts.

Picture-in-picture monitor

Settings → Computer Control → PiP monitor: whichever app LanMate operates, its live view is mirrored into a pinned small window. You can see exactly what it’s doing, while your mouse and keyboard stay free.

Safety guardrails

Platform support

Platform Status
macOS Supported (Accessibility + Screen Recording)
Windows Supported
Linux Supported (needs xdotool / python3-pyatspi; some enhanced capabilities depend on the system version)