Wdrażanie Maxiful w całej organizacji

Jak przebiega instalacja

Na obu platformach Maxiful to aplikacja desktopowa, którą każda osoba instaluje dla siebie. Przy pierwszym uruchomieniu przygotowuje dla tej osoby środowisko uruchomieniowe asystentów: OpenClaw, otwartoźródłowe środowisko dla agentów, działające na kopii Node.js, którą Maxiful instaluje dla tej osoby. Proces w tle tego środowiska, czyli brama (gateway), uruchamia asystentów i startuje ponownie przy każdym zalogowaniu się tej osoby na komputerze.

W Windows

Dla każdej osoby osobno, bez uprawnień administratora. Instalator Maxiful-x64-setup.exe działa jako osoba zalogowana w Windows i instaluje się w jej folderze %LOCALAPPDATA%\Maxiful. Pojawia się na liście zainstalowanych aplikacji tej osoby, więc każdy, kto używa Maxiful na danym komputerze, ma własną instalację.

Windows 10 lub nowszy, 64-bitowy. Okno Maxiful wyświetla Microsoft Edge WebView2. Jeśli brakuje środowiska WebView2 Runtime, instalator pobiera instalator WebView2 Microsoftu z go.microsoft.com i uruchamia go po cichu.

Na Macu

Jedna aplikacja w /Applications, konfigurowana dla każdej osoby. Maxiful dla Maca jest dostarczany jako obraz dysku Maxiful-arm64.dmg z Maxiful.app w środku, podpisany identyfikatorem Apple Developer ID i notaryzowany przez Apple (szczegóły podpisu znajdziesz w sekcji Mac: Intune i Jamf Pro). Po skopiowaniu do /Applications, ręcznie lub przez system zarządzania urządzeniami, jest jedną aplikacją dla wszystkich osób korzystających z Maca; każda osoba, która ją otworzy, loguje się i dostaje własną instalację, a jej asystenci i dane są w jej folderze domowym.

macOS 13 lub nowszy, na Apple silicon lub Intelu. Aplikacja ma jedną kompilację dla obu.

Windows: instalacja cicha

Maxiful-x64-setup.exe /S

Kody wyjścia. 0 oznacza, że instalacja się zakończyła, każdy inny kod, że nie. Kod 2 może mieć kilka przyczyn; jedną z nich jest inny program, który przez 30 sekund blokuje któryś z plików Maxiful, i wtedy nic nie zostało zmienione. Instalator zamyka uruchomione Maxiful tej osoby, zanim zacznie zapisywać pliki.

Na istniejącej instalacji. Uruchomienie nowszego instalatora w ten sam sposób aktualizuje Maxiful na miejscu, a asystenci i dane tej osoby zostają. Sprawdziliśmy to na naszym testowym komputerze z Windows 26 października 2026 r., z wersji 0.9.54 do podpisanej 0.9.58.

Foldery w Microsoft Defender

Foldery robocze Maxiful zmieniają tysiące plików przy każdym starcie zespołu, dlatego Maxiful prosi Windows, by Microsoft Defender pomijał cztery z nich. Bez przełącznika /DEFENDER instalacja pyta o to po zapisaniu plików: Windows wyświetla własny monit o uprawnienia, a osobę bez uprawnień administratora prosi o dane logowania administratora. Jeśli nikt nie odpowie, Windows sam zamyka monit po około dwóch minutach, a instalacja i tak się kończy. Maxiful pyta jeszcze raz przy następnym uruchomieniu; drugi monit bez odpowiedzi liczy się jako odmowa i nie pojawia się ponownie.

Z /DEFENDER=managed lub /DEFENDER=off (dokładnie w tej postaci) ani instalacja, ani aktualizacja, ani uruchomienie nie pyta Windows, a w ustawieniach Maxiful widać, że Microsoft Defender na tym komputerze zarządza twój dział IT. Gdy foldery są skanowane, wszystko działa, tylko zespół startuje wolniej. Osoba może później sama włączyć wykluczenia w ustawieniach Maxiful, w opcji Pozwól Defenderowi pomijać foldery robocze Maxiful, która pyta Windows tak jak wyżej.

Windows: Microsoft Intune (aplikacja Win32)

Instalację cichą i aktualizację na istniejącej instalacji sprawdziliśmy na naszym testowym komputerze z Windows. Ta procedura opiera się na dokumentacji Microsoftu o aplikacjach Win32 i nie była uruchamiana w dzierżawie Intune; jeśli u ciebie działa inaczej, napisz do nas na [email protected].

1. Utwórz folder pakietu z plikiem Maxiful-x64-setup.exe, pobranym z konta Maxiful i sprawdzonym pod kątem sumy SHA-256, oraz plikiem uninstall.cmd, bo Intune nie rozwija zmiennych środowiskowych w poleceniu odinstalowania:

   @echo off
   "%LOCALAPPDATA%\Maxiful\uninstall.exe" /S _?=%LOCALAPPDATA%\Maxiful
   set rc=%ERRORLEVEL%
   del /q "%LOCALAPPDATA%\Maxiful\uninstall.exe"
   rmdir "%LOCALAPPDATA%\Maxiful"
   exit /b %rc%

   _?= sprawia, że deinstalator działa na miejscu i kończy pracę, zanim skrypt przejdzie dalej; dwie kolejne linie usuwają sam deinstalator i pusty folder. Aby usunąć też asystentów i dane tej osoby, wpisz w pierwszej linii /S /REMOVEALL _?=%LOCALAPPDATA%\Maxiful (zobacz Usuwanie).
2. Utwórz plik .intunewin narzędziem Microsoft Win32 Content Prep Tool:

   IntuneWinAppUtil.exe -c C:\maxiful-package -s Maxiful-x64-setup.exe -o C:\maxiful-intunewin -q

3. Program: polecenie instalacji Maxiful-x64-setup.exe /S /DEFENDER=managed, jeśli twoja polityka Defendera dodaje cztery powyższe foldery, albo Maxiful-x64-setup.exe /S /DEFENDER=off, jeśli mają być skanowane; polecenie odinstalowania uninstall.cmd; zachowanie instalacji User; zachowanie przy ponownym uruchomieniu urządzenia No specific action; domyślne kody powrotu.
4. Requirements: 64-bitowy Windows 10 lub nowszy.
5. Reguła wykrywania: plik, ścieżka %LOCALAPPDATA%\Maxiful, plik Maxiful.exe, metoda File or folder exists.
6. Przypisanie: Required lub Available, do grup użytkowników.

Intune oczekuje instalacji, która o nic nie pyta. Z przełącznikiem /DEFENDER instalacja Maxiful o nic nie pyta; bez niego jedynym pytaniem, jakie może się pojawić, jest monit Windows dotyczący Defendera. Zanim przypiszesz aplikację szeroko, przeczytaj sekcję Pierwsze uruchomienie.

Mac: Microsoft Intune i Jamf Pro

Twój system zarządzania urządzeniami instaluje notaryzowaną aplikację Maxiful.app w /Applications, z tego samego obrazu dysku, który pobierają osoby w twojej organizacji. Oto wartości, o które poprosi.

Microsoft Intune (macOS app (DMG))

1. Apps, All Apps, Create; platforma macOS, typ macOS app (DMG); wybierz Maxiful-arm64.dmg, pobrany z konta Maxiful i sprawdzony pod kątem sumy SHA-256. Na Macach musi być agent zarządzania Intune dla macOS.
2. App information: dodaj logo, by aplikacja miała ikonę w Company Portal. Requirements: Minimum Operating System macOS 13.
3. Detection rules: Included apps ai.maxiful.desktop i jego wersja. Ignore app version No, aby instalowała się każda przesłana wersja. Ustaw też AutoUpdate na 0 (zobacz Ustawienia zarządzane): każdą wersję instalujesz przez Intune, a Maxiful sam nie szuka aktualizacji.
4. Assignments: Required (instalacja w /Applications), Available w Company Portal lub Uninstall.

Intune potrzebuje pełnego dostępu do dysku, by zaktualizować lub usunąć aplikację DMG, i w macOS 13 i nowszych prosi o niego przy przypisaniu aplikacji. Aby wdrożyć nową wersję, prześlij jej obraz dysku do tej samej aplikacji: przypisania Required aktualizują się same, a przy Available każda osoba wybiera Reinstall w Company Portal.

Jamf Pro

Jamf Pro wdraża pakiety ze swoich punktów dystrybucji. Zbuduj w Jamf Composer pakiet zawierający /Applications/Maxiful.app:

1. Na Macu skopiuj Maxiful.app z obrazu dysku do /Applications. W Composerze przeciągnij /Applications/Maxiful.app z Findera na listę Sources, aby zachował swoje miejsce w /Applications, i zbuduj pakiet z tego źródła.
2. Dodaj pakiet do punktu dystrybucji i do Jamf Pro.
3. W Computers, Policies utwórz nową politykę. W General ustaw wyzwalacz i częstotliwość wykonania; w sekcji Packages dodaj pakiet z akcją Install i wybierz punkt dystrybucji.
4. Na karcie Scope wybierz komputery albo udostępnij politykę w Self Service.
5. Każdą nową wersję spakuj tak samo i wdróż polityką, a AutoUpdate ustaw na 0 (zobacz Ustawienia zarządzane), aby Maxiful sam nie szukał aktualizacji.

Te kroki opierają się na dokumentacji Microsoftu i Jamf i nie były uruchamiane w dzierżawie Intune ani Jamf; jeśli u ciebie działa inaczej, napisz do nas na [email protected].

Rzecz otwierana przy logowaniu dla bramy

Brama asystentów działa jako LaunchAgent każdej osoby, z etykietą ai.openclaw.<name>. W macOS 13 i nowszych zatwierdza ją automatycznie ładunek Service Management (zarządzane rzeczy otwierane przy logowaniu) z typem reguły Label prefix i wartością ai.openclaw..

Pierwsze uruchomienie: co robi każda osoba

Po instalacji cichej albo skopiowaniu przez MDM do /Applications Maxiful jest gotowy do otwarcia. Przy pierwszym uruchomieniu każda osoba wykonuje poniższe kroki, tak samo w Windows jak na Macu; dział IT nie może ich wykonać za nią.

• Każda osoba loguje się własnym adresem e-mail: Maxiful wysyła link do logowania, który otwiera aplikację. Jeśli właściciel obszaru roboczego skonfigurował logowanie jednokrotne dla domeny e-mail twojej organizacji, osoba może zamiast tego wybrać Kontynuuj z kontem służbowym, co otwiera w przeglądarce logowanie twojego dostawcy tożsamości (Microsoft Entra ID, Google Workspace, Okta, inny dostawca OpenID Connect lub dostawca SAML 2.0); przy włączonym Enforce single sign-on również link z e-maila przekazuje logowanie do twojego dostawcy.
• Osoba zakładająca nowy obszar roboczy wpisuje kod konfiguracji ze swojego konta Maxiful. Kod działa na pierwszym komputerze, na którym zostanie użyty.
• Współpracownik zaproszony do obszaru roboczego dołącza do niego zamiast tego; tak samo osoba z twoich zweryfikowanych domen, która loguje się przez twojego dostawcę, gdy u właściciela włączona jest opcja Add people to my workspace when they sign in. Każde nowe urządzenie współpracownika czeka, aż właściciel obszaru roboczego wpuści je na stronie Zespół, w sekcji Osoby.

Następnie konfiguracja instaluje dla tej osoby Node.js i środowisko uruchomieniowe, po czym uruchamia zespół. Potrzebuje do tego hostów sieciowych wymienionych poniżej.

Na Macu: uprawnienia, o które prosi macOS

Maxiful prosi macOS o uprawnienie dopiero wtedy, gdy jakaś funkcja po raz pierwszy go potrzebuje, a macOS wyświetla własne pytanie:

• Powiadomienia, gdy Maxiful po raz pierwszy ma coś do pokazania, np. odpowiedź, która przychodzi, gdy jego okno jest w tle.
• Mikrofon i Rozpoznawanie mowy, gdy osoba po raz pierwszy dyktuje wiadomość lub rozmawia z asystentem.
• Dostępność, Nagrywanie ekranu i Monitorowanie wprowadzania, gdy właściciel po raz pierwszy pozwala asystentom korzystać z komputera.

Gdzie działa zespół i komputer zawsze włączony

Zespół działa na komputerze właściciela: asystenci, ich pamięć i rozmowy są w instalacji właściciela na tym komputerze, a współpracownicy łączą się z nią ze swoich urządzeń. Biuro, które chce, by zespół odpowiadał całą dobę, uruchamia instalację właściciela na komputerze, który się nie wyłącza:

• Mac z zalogowanym kontem macOS właściciela. Brama jest LaunchAgentem tego konta i startuje po zalogowaniu się na nie, więc po każdym ponownym uruchomieniu zaloguj konto jeszcze raz albo włącz automatyczne logowanie, którego macOS nie oferuje przy włączonym FileVault.
• Komputer z Windows, który sam loguje się na konto Windows właściciela (automatyczne logowanie w Windows). Maxiful uruchamia bramę po zalogowaniu się na konto; start przy rozruchu wymagałby instalacji z podwyższonymi uprawnieniami, której Maxiful nigdy nie wykonuje.

Modele AI konta odpowiadają naraz tylko na jednym komputerze. Jeśli właściciel używa Maxiful także na laptopie i wybierze tam Używaj Maxiful tutaj, asystenci na komputerze zawsze włączonym przestają odpowiadać, dopóki właściciel nie wybierze tej opcji ponownie na tym komputerze.

Aby samodzielnie instalować każdą aktualizację na tym komputerze, ustaw AutoUpdate na 0 (zobacz Ustawienia zarządzane). Kopie zapasowe Maxiful to archiwa zapisywane na tym samym komputerze, w folderze domowym właściciela w <name>-shared/backups; kopiuj je poza komputer własnymi narzędziami do kopii zapasowych.

Co umieszcza na komputerze

<name> poniżej to krótka nazwa danej instalacji.

W Windows

Procesy w systemie Windows

Polecenia uruchamiane przez asystentów (powłoka, PowerShell, skrypty) działają jako procesy potomne bramy, domyślnie w osobnej piaskownicy każdego asystenta. Brama nasłuchuje na 127.0.0.1 na porcie od 18800 w górę (18800 dla pierwszej instalacji), a Maxiful.exe na kolejnych portach pętli zwrotnej; na naszym testowym komputerze żaden proces Maxiful nie nasłuchiwał na innym adresie.

Na Macu

Procesy na Macu

Polecenia uruchamiane przez asystentów są procesami potomnymi bramy, domyślnie w osobnej piaskownicy każdego asystenta. Brama nasłuchuje na 127.0.0.1 na porcie od 18800 w górę, tak jak w Windows.

Hosty sieciowe do odblokowania

Każde połączenie jest otwierane z komputera na zewnątrz, przez HTTPS (przekaźnik używa też WSS). Nic po naszej stronie nie może otworzyć połączenia do komputera.

Do konfiguracji i codziennej pracy

Tylko przy użyciu danej funkcji

Jak widzą to narzędzia bezpieczeństwa

W systemie Windows

Podpisujący. Każdy publikowany przez nas instalator jest podpisany certyfikatem wystawionym dla PolyTrader Ltd (pole podmiotu certyfikatu: CN=Polytrader LTD), firmy, która wydawała Maxiful przed Maxiful AB; tak samo podpisany jest instalowany przez niego Maxiful.exe. Podpis pliku odczytasz poleceniem Get-AuthenticodeSignature, a pobrany plik porównasz z sumą kontrolną na swojej stronie konfiguracji (jak to zrobić, pokazuje Pomoc).

Niepodpisane składniki. node.exe środowiska uruchomieniowego i chrome.exe asystentów nie mają podpisu Authenticode; Maxiful sprawdza każdy z nich z zapisaną na stałe sumą SHA-256 przed użyciem. Wpis na listę dozwolonych dla nich opiera się na ścieżce.

Co dodać do listy dozwolonych: procesy %LOCALAPPDATA%\Maxiful\Maxiful.exe (podpisany) i gateway-launcher.exe, %LOCALAPPDATA%\Lanoko\node-v24.21.0\node.exe oraz %USERPROFILE%\.openclaw-*\browser\chromium\chrome-win64\chrome.exe; cztery foldery Defendera wymienione wyżej; hosty sieciowe wymienione wyżej.

Na Macu

Podpisujący. Maxiful.app jest podpisana identyfikatorem Developer ID zespołu 467H9AXX55 i notaryzowana przez Apple, więc Gatekeeper otwiera ją bez obejścia; lista dozwolonych może wskazać ją przez jej wymaganie kodu (w sekcji Mac: Intune i Jamf Pro). Podpis odczytasz poleceniem codesign -dvv /Applications/Maxiful.app.

Składniki środowiska uruchomieniowego. node bramy to oficjalny Node.js dla macOS, a przeglądarka asystentów to Chrome for Testing od Google; każdy z nich Maxiful pobiera i przed użyciem sprawdza z zapisaną na stałe sumą SHA-256. Wpis na listę dozwolonych dla nich opiera się na ścieżce.

Co dodać do listy dozwolonych: /Applications/Maxiful.app (zespół 467H9AXX55), ~/Library/Application Support/Lanoko/node-v24.21.0/bin/node i przeglądarkę w ~/.openclaw-*/browser/chromium; hosty sieciowe wymienione wyżej.

W obu systemach

Zachowanie. Proces Node.js działający w kontekście użytkownika startuje przy logowaniu, wykonuje wychodzące połączenia HTTPS, uruchamia polecenia dla asystentów i przy każdym starcie kopiuje pliki swoich wtyczek, więc zapisuje wiele plików w folderze instalacji.

CrowdStrike. CrowdStrike publikuje dla Falcon for IT pakiet treści „Search & Removal” dotyczący OpenClaw. Szuka on uruchomionych procesów OpenClaw, globalnych instalacji npm, plików binarnych OpenClaw w typowych ścieżkach, usług oraz folderów stanu i konfiguracji w folderach domowych. Jego procedura usuwania zatrzymuje usługi i procesy, odinstalowuje pakiety npm, usuwa foldery instalacji i konfiguracji oraz usuwa rejestracje usług, w tym zaplanowane zadania i pliki plist launchd. Brama Maxiful to uruchomiony proces OpenClaw ze stanem w %USERPROFILE%\.openclaw-<name> w Windows i ~/.openclaw-<name> na Macu, więc ten pakiet może ją wykryć. Uruchomione na komputerze z Maxiful usuwanie mogłoby zatrzymać zespół i skasować konfigurację i pamięć asystentów. Użyj wyszukiwania z pakietu, by sprawdzić, gdzie działa Maxiful, a usuwanie trzymaj z dala od komputerów, na których twoja organizacja używa Maxiful.

Decyzja o liście dozwolonych należy do twojego zespołu bezpieczeństwa. Te procesy uruchamiają polecenia dla asystentów, domyślnie w piaskownicy każdego asystenta, z zatwierdzeniami opisanymi na naszej stronie Bezpieczeństwo.

Ustawienia zarządzane

Maxiful odczytuje ustawienia zarządzane od wersji 0.9.60, w Windows i na Macu; wcześniejsze wersje ich nie odczytują.

Dział IT może centralnie ustawić kilka ustawień Maxiful: w Windows za pomocą zasad grupy lub Intune, a na Macu profilem konfiguracji z Jamf, Intune lub innego narzędzia do zarządzania urządzeniami. Maxiful odczytuje je za każdym razem, gdy z nich korzysta; zmiana jednego z przełączników właściciela dociera do asystentów przy następnym uruchomieniu Maxiful, a do tego czasu informują o tym ustawienia. Ustawienie określone przez twoją organizację jest w ustawieniach Maxiful oznaczone jako Ustawione przez twoją organizację i nie można go tam zmienić, a ustawienia Maxiful wymieniają wszystko, co ustawisz, na górze sekcji Dostęp. Bez zasad Maxiful działa tak jak na komputerze, którym nie zarządza żaden dział IT.

Przełączniki właściciela

Oprócz liczby Maxiful odczytuje tekst 0, 1, true i false jako 0 lub 1. Wartość, której nie potrafi odczytać, np. inny tekst tam, gdzie powinno być 0 lub 1, inny typ rejestru (REG_QWORD, REG_EXPAND_SZ, REG_BINARY) albo nieznana nazwa w OwnerSwitches, nie jest stosowana, a ustawienia Maxiful wymieniają ją w sekcji Ustawione przez twoją organizację. W Windows dotyczy to każdej wartości w kluczu zasad i jego podkluczu, zarówno w HKLM, jak i w HKCU.

W systemie Windows

Maxiful odczytuje HKLM\SOFTWARE\Policies\Maxiful, a potem HKCU\SOFTWARE\Policies\Maxiful; wartość w HKLM ma pierwszeństwo przed tą samą wartością w HKCU. Workspace jest typu REG_SZ, a AutoUpdate typu REG_DWORD; każdy przełącznik właściciela to REG_DWORD w podkluczu OwnerSwitches, nazwany jak w tabeli. Ta para plików ADMX i ADML zapisuje dokładnie te wartości: zapisz je jako maxiful.admx i en-US\maxiful.adml w magazynie definicji zasad albo zaimportuj je do Intune jako importowane szablony administracyjne.

<?xml version="1.0" encoding="utf-8"?>
<policyDefinitions xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" revision="1.0" schemaVersion="1.0" xmlns="http://schemas.microsoft.com/GroupPolicy/2006/07/PolicyDefinitions">
  <policyNamespaces>
    <target prefix="maxiful" namespace="Maxiful.Policies" />
  </policyNamespaces>
  <resources minRequiredRevision="1.0" />
  <supportedOn>
    <definitions>
      <definition name="SUPPORTED_Maxiful" displayName="$(string.SUPPORTED_Maxiful)" />
    </definitions>
  </supportedOn>
  <categories>
    <category name="Maxiful" displayName="$(string.Maxiful)" />
    <category name="OwnerSwitches" displayName="$(string.OwnerSwitches)">
      <parentCategory ref="Maxiful" />
    </category>
  </categories>
  <policies>
    <policy name="Workspace" class="Both" displayName="$(string.Workspace)" explainText="$(string.Workspace_Explain)" presentation="$(presentation.Workspace)" key="SOFTWARE\Policies\Maxiful">
      <parentCategory ref="Maxiful" />
      <supportedOn ref="SUPPORTED_Maxiful" />
      <elements>
        <text id="Workspace" valueName="Workspace" maxLength="128" required="true" />
      </elements>
    </policy>
    <policy name="AutoUpdate" class="Both" displayName="$(string.AutoUpdate)" explainText="$(string.AutoUpdate_Explain)" key="SOFTWARE\Policies\Maxiful" valueName="AutoUpdate">
      <parentCategory ref="Maxiful" />
      <supportedOn ref="SUPPORTED_Maxiful" />
      <enabledValue><decimal value="1" /></enabledValue>
      <disabledValue><decimal value="0" /></disabledValue>
    </policy>
    <policy name="OwnerSwitch_PrivateNetwork" class="Both" displayName="$(string.OwnerSwitch_PrivateNetwork)" explainText="$(string.OwnerSwitch_PrivateNetwork_Explain)" key="SOFTWARE\Policies\Maxiful\OwnerSwitches" valueName="private-network">
      <parentCategory ref="OwnerSwitches" />
      <supportedOn ref="SUPPORTED_Maxiful" />
      <enabledValue><decimal value="1" /></enabledValue>
      <disabledValue><decimal value="0" /></disabledValue>
    </policy>
    <policy name="OwnerSwitch_PaneReach" class="Both" displayName="$(string.OwnerSwitch_PaneReach)" explainText="$(string.OwnerSwitch_PaneReach_Explain)" key="SOFTWARE\Policies\Maxiful\OwnerSwitches" valueName="pane-reach">
      <parentCategory ref="OwnerSwitches" />
      <supportedOn ref="SUPPORTED_Maxiful" />
      <enabledValue><decimal value="1" /></enabledValue>
      <disabledValue><decimal value="0" /></disabledValue>
    </policy>
    <policy name="OwnerSwitch_ClaudeCodeBackground" class="Both" displayName="$(string.OwnerSwitch_ClaudeCodeBackground)" explainText="$(string.OwnerSwitch_ClaudeCodeBackground_Explain)" key="SOFTWARE\Policies\Maxiful\OwnerSwitches" valueName="claude-code-background">
      <parentCategory ref="OwnerSwitches" />
      <supportedOn ref="SUPPORTED_Maxiful" />
      <enabledValue><decimal value="1" /></enabledValue>
      <disabledValue><decimal value="0" /></disabledValue>
    </policy>
    <policy name="OwnerSwitch_SessionReach" class="Both" displayName="$(string.OwnerSwitch_SessionReach)" explainText="$(string.OwnerSwitch_SessionReach_Explain)" key="SOFTWARE\Policies\Maxiful\OwnerSwitches" valueName="session-reach">
      <parentCategory ref="OwnerSwitches" />
      <supportedOn ref="SUPPORTED_Maxiful" />
      <enabledValue><decimal value="1" /></enabledValue>
      <disabledValue><decimal value="0" /></disabledValue>
    </policy>
    <policy name="OwnerSwitch_ModelCosts" class="Both" displayName="$(string.OwnerSwitch_ModelCosts)" explainText="$(string.OwnerSwitch_ModelCosts_Explain)" key="SOFTWARE\Policies\Maxiful\OwnerSwitches" valueName="model-costs">
      <parentCategory ref="OwnerSwitches" />
      <supportedOn ref="SUPPORTED_Maxiful" />
      <enabledValue><decimal value="1" /></enabledValue>
      <disabledValue><decimal value="0" /></disabledValue>
    </policy>
    <policy name="OwnerSwitch_NextPrompt" class="Both" displayName="$(string.OwnerSwitch_NextPrompt)" explainText="$(string.OwnerSwitch_NextPrompt_Explain)" key="SOFTWARE\Policies\Maxiful\OwnerSwitches" valueName="next-prompt">
      <parentCategory ref="OwnerSwitches" />
      <supportedOn ref="SUPPORTED_Maxiful" />
      <enabledValue><decimal value="1" /></enabledValue>
      <disabledValue><decimal value="0" /></disabledValue>
    </policy>
    <policy name="OwnerSwitch_CheckinWholeConversation" class="Both" displayName="$(string.OwnerSwitch_CheckinWholeConversation)" explainText="$(string.OwnerSwitch_CheckinWholeConversation_Explain)" key="SOFTWARE\Policies\Maxiful\OwnerSwitches" valueName="checkin-whole-conversation">
      <parentCategory ref="OwnerSwitches" />
      <supportedOn ref="SUPPORTED_Maxiful" />
      <enabledValue><decimal value="1" /></enabledValue>
      <disabledValue><decimal value="0" /></disabledValue>
    </policy>
    <policy name="OwnerSwitch_VoiceNotes" class="Both" displayName="$(string.OwnerSwitch_VoiceNotes)" explainText="$(string.OwnerSwitch_VoiceNotes_Explain)" key="SOFTWARE\Policies\Maxiful\OwnerSwitches" valueName="voice-notes">
      <parentCategory ref="OwnerSwitches" />
      <supportedOn ref="SUPPORTED_Maxiful" />
      <enabledValue><decimal value="1" /></enabledValue>
      <disabledValue><decimal value="0" /></disabledValue>
    </policy>
  </policies>
</policyDefinitions>

<?xml version="1.0" encoding="utf-8"?>
<policyDefinitionResources xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" revision="1.0" schemaVersion="1.0" xmlns="http://schemas.microsoft.com/GroupPolicy/2006/07/PolicyDefinitions">
  <displayName>Maxiful</displayName>
  <description>The settings an IT department sets for Maxiful.</description>
  <resources>
    <stringTable>
      <string id="Maxiful">Maxiful</string>
      <string id="OwnerSwitches">The owner's switches</string>
      <string id="SUPPORTED_Maxiful">Maxiful for Windows</string>
      <string id="Workspace">Open only this workspace</string>
      <string id="Workspace_Explain">Maxiful on this computer opens only the workspace with this ID. The workspace's owner finds the ID in Maxiful's settings, under Access. A person who is not a member of the workspace is asked to join it by invitation, and no other workspace opens on this computer.</string>
      <string id="AutoUpdate">Let Maxiful update itself</string>
      <string id="AutoUpdate_Explain">Disabled: Maxiful does not look for, download or install updates, and you install each new version yourself. Enabled or not configured: Maxiful updates itself.</string>
      <string id="OwnerSwitch_PrivateNetwork">Let assistants open pages on this computer and my network</string>
      <string id="OwnerSwitch_PrivateNetwork_Explain">Enabled: on. Disabled: off. Not configured: the owner decides, in Maxiful's settings under Access.</string>
      <string id="OwnerSwitch_PaneReach">Let assistants' panes run code and reach outside Maxiful</string>
      <string id="OwnerSwitch_PaneReach_Explain">Enabled: on. Disabled: off. Not configured: the owner decides, in Maxiful's settings under Access.</string>
      <string id="OwnerSwitch_ClaudeCodeBackground">Let Claude Code keep long commands running in the background</string>
      <string id="OwnerSwitch_ClaudeCodeBackground_Explain">Enabled: on. Disabled: off. Not configured: the owner decides, in Maxiful's settings under Access.</string>
      <string id="OwnerSwitch_SessionReach">Assistants can look through all conversations on this computer (so they learn from past work)</string>
      <string id="OwnerSwitch_SessionReach_Explain">Enabled: on. Disabled: off. Not configured: the owner decides, in Maxiful's settings under Access.</string>
      <string id="OwnerSwitch_ModelCosts">Show model costs in dollars</string>
      <string id="OwnerSwitch_ModelCosts_Explain">Enabled: on. Disabled: off. Not configured: the owner decides, in Maxiful's settings under Advanced.</string>
      <string id="OwnerSwitch_NextPrompt">Suggest my next message</string>
      <string id="OwnerSwitch_NextPrompt_Explain">Enabled: on. Disabled: off. Not configured: the owner decides, in Maxiful's settings under Advanced.</string>
      <string id="OwnerSwitch_CheckinWholeConversation">Check-ins read the whole conversation</string>
      <string id="OwnerSwitch_CheckinWholeConversation_Explain">Enabled: on. Disabled: off. Not configured: the owner decides, in Maxiful's settings under Advanced.</string>
      <string id="OwnerSwitch_VoiceNotes">Transcribe voice notes</string>
      <string id="OwnerSwitch_VoiceNotes_Explain">Enabled: on. Disabled: off. Not configured: the owner decides, in Maxiful's settings under Voice and audio.</string>
    </stringTable>
    <presentationTable>
      <presentation id="Workspace">
        <textBox refId="Workspace">
          <label>Workspace ID</label>
        </textBox>
      </presentation>
    </presentationTable>
  </resources>
</policyDefinitionResources>

Na Macu

Maxiful odczytuje preferencje zarządzane własnej domeny, ai.maxiful.desktop, które profil konfiguracji instaluje jako ustawienia wymuszone (ładunek preferencji zarządzanych Apple, com.apple.ManagedClient.preferences). Liczy się tylko wartość ustawiona przez profil: wartość zapisana w inny sposób, np. poleceniem defaults write, nie jest odczytywana. Workspace to ciąg znaków, AutoUpdate liczba całkowita (lub wartość logiczna), a OwnerSwitches słownik z nazwami z tabeli. Ten przykładowy profil ogranicza komputer do jednego obszaru roboczego, zostawia aktualizacje tobie, wyłącza przełączniki terminala i sieci prywatnej oraz pokazuje koszty modeli; podmień ID obszaru roboczego oraz identyfikatory i UUID na własne.

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
  <key>PayloadType</key><string>Configuration</string>
  <key>PayloadVersion</key><integer>1</integer>
  <key>PayloadIdentifier</key><string>com.example.maxiful</string>
  <key>PayloadUUID</key><string>00000000-0000-0000-0000-000000000001</string>
  <key>PayloadDisplayName</key><string>Maxiful</string>
  <key>PayloadScope</key><string>System</string>
  <key>PayloadContent</key>
  <array>
    <dict>
      <key>PayloadType</key><string>com.apple.ManagedClient.preferences</string>
      <key>PayloadVersion</key><integer>1</integer>
      <key>PayloadIdentifier</key><string>com.example.maxiful.settings</string>
      <key>PayloadUUID</key><string>00000000-0000-0000-0000-000000000002</string>
      <key>PayloadDisplayName</key><string>Maxiful settings</string>
      <key>PayloadContent</key>
      <dict>
        <key>ai.maxiful.desktop</key>
        <dict>
          <key>Forced</key>
          <array>
            <dict>
              <key>mcx_preference_settings</key>
              <dict>
                <key>Workspace</key><string>YOUR-WORKSPACE-ID</string>
                <key>AutoUpdate</key><integer>0</integer>
                <key>OwnerSwitches</key>
                <dict>
                  <key>terminal</key><false/>
                  <key>private-network</key><false/>
                  <key>model-costs</key><true/>
                </dict>
              </dict>
            </dict>
          </array>
        </dict>
      </dict>
    </dict>
  </array>
</dict>
</plist>

Aktualizacje

Maxiful szuka nowej wersji w maxiful.ai przy uruchomieniu i co sześć godzin. Osoba wybiera Zaktualizuj i uruchom ponownie lub Później. Nowa wersja Maxiful może zawierać nowsze środowisko uruchomieniowe OpenClaw; Maxiful aktualizuje je wtedy dla tej osoby przez npm, z registry.npmjs.org.

Aby samodzielnie instalować każdą nową wersję, tak by Maxiful żadnej nie szukał, w Windows lub na Macu ustaw AutoUpdate na 0 (zob. Ustawienia zarządzane): Maxiful informuje wtedy, że aktualizacje instaluje twoja organizacja.

W systemie Windows

Nowa wersja to podpisany instalator, sprawdzany przed uruchomieniem kluczem wbudowanym w aplikację, a aktualizacja uruchamia go w trybie pasywnym. Możesz też samodzielnie wdrażać każdy nowy instalator z przełącznikiem /S, jak wyżej.

Na Macu

Nowa wersja to podpisane archiwum aplikacji, sprawdzane przed użyciem kluczem wbudowanym w aplikację; zastępuje aplikację w miejscu, jeśli konto danej osoby może zmieniać tę kopię.

Kopia, której dana osoba nie może zmienić. Jeśli /Applications/Maxiful.app należy do systemu (jej właścicielem jest root), a konto danej osoby nie może jej zmienić, Maxiful nie aktualizuje się sam: niczego nie pobiera, nigdy nie prosi o hasło administratora, nie oferuje Zaktualizuj i uruchom ponownie i w miejscu, gdzie pokazuje aktualizacje, informuje, że dostępna jest nowsza wersja i że aktualizacje na tym Macu instaluje twoja organizacja. Każdą nową wersję wdrażaj przez MDM: w Intune prześlij jej obraz dysku do tej samej aplikacji; w Jamf Pro zbuduj jej pakiet w Composer i wdróż go jak wyżej. Kopia, którą może zmieniać konto administratora, aktualizuje się sama dla tego konta, jak na każdym Macu.

Usuwanie Maxiful

Wszystko, przez osobę korzystającą z aplikacji: w ustawieniach Maxiful wybierz Usuń Maxiful z tego komputera. Ta opcja zatrzymuje proces w tle i to, co uruchamia go przy logowaniu (zaplanowane zadania w Windows, LaunchAgent na Macu), usuwa dane i poświadczenia instalacji oraz środowisko uruchomieniowe Node.js, które zainstalowała, chyba że korzysta z niego jeszcze inna instalacja na komputerze. W Windows po zamknięciu Maxiful uruchamia się następnie dezinstalator; na Macu aplikacja trafia do Kosza, jeśli konto tej osoby ma do tego uprawnienia. Własne dokumenty tej osoby pozostają nietknięte.

W Windows

Wszystko, w trybie cichym: %LOCALAPPDATA%\Maxiful\uninstall.exe /S /REMOVEALL wykonuje Usuń Maxiful z tego komputera w imieniu osoby, do której należy instalacja, bez nikogo przy ekranie, a potem usuwa aplikację. Tej operacji nie da się cofnąć. Lista usuniętych elementów i tych, których nie udało się usunąć, trafia do pliku removal-report.json w %LOCALAPPDATA%\ai.maxiful.desktop\logs.

Bez /REMOVEALL: %LOCALAPPDATA%\Maxiful\uninstall.exe /S, które uruchamia opisana wyżej procedura dla Intune, usuwa aplikację, jej skróty, zadanie opiekuna zespołu i wykluczenia Defendera dodane przez Maxiful (Windows może ponownie wyświetlić swój monit w ich sprawie). Zatrzymuje też proces asystentów działający w tle i usuwa to, co uruchamia go przy logowaniu, ale zachowuje środowisko uruchomieniowe i dane instalacji. Plik installer.log, obok pozostałych logów aplikacji, pokazuje, czy coś pozostało uruchomione.

Na Macu

Najpierw wykonaj Usuń Maxiful z tego komputera dla każdej osoby: samo usunięcie aplikacji zostawia działającą w tle bramę tej osoby ze wszystkim, co przechowuje. Następnie usuń /Applications/Maxiful.app za pomocą MDM, na przykład przypisaniem Uninstall w Intune.