WorkBuddy for Mosaico
Hold the talk button on Mosaico to hand tasks over to the cloud or the computer’s WorkBuddy. Task progress, replies, and personal points can be viewed on the screen.
First Connection · Common Questions · Privacy Notice
Features
- Voice Dispatch: Choose cloud or computer tasks, hold to speak, release to send; cloud tasks allow model selection.
- Read Replies: View task progress, scroll to read long replies, the home page will indicate new messages.
- Continue Chatting: Follow up on the device, or continue the conversation on the WorkBuddy web page on the computer; Q&A syncs to the device.
- Personal Points: The home page shows account, points, and update time, refreshing roughly every minute.
Download the Windows computer companion on this page (WorkBuddyCompanion-windows-x64.zip).
WorkBuddy × Mosaico User Guide
Follow the steps below to install firmware, connect an account, and start using voice tasks.
Preparation
- A Mosaico, a USB data cable, and a Windows 10 (or later) x64 computer.
- WorkBuddy computer companion and the WorkBuddy Windows client.
- A WorkBuddy account and Wi‑Fi for the device.
The first connection is completed via USB. After setup, you can keep the cable plugged in or switch to wireless. Point synchronization requires a logged‑in WorkBuddy computer client.
Install Device Firmware
Use Vibe Mode 0.3.0 to install WorkBuddy.
Before updating Vibe Mode or installing device firmware, back up important data on the device.
- Power off Mosaico, long‑press the power button at the lower right to enter Vibe Mode.
- In Vibe Mode, connect Wi‑Fi and tap Download on the home page.
- Enter the six‑digit installation code provided on the community software page, confirm the WorkBuddy information, then download and run.
- After installation and launch, the device goes directly to WorkBuddy. Tap the settings icon at the top right, and select an internet‑connected network under Wi‑Fi.
Button locations and networking methods are described in the Mosaico official installation guide. After installation, a short press of the power button boots into WorkBuddy.
If Settings → IDEAs in 0.3.0 shows Storage needs formatting, you must initialize storage first. Formatting deletes saved works and files, so back up any important data. Tap Format, then long‑press Hold to format; after NAND formatted appears, return to install WorkBuddy.
First Connection
1. Install the Computer Companion
If WorkBuddy is running on the computer, exit from the tray first. Fully extract the companion zip, then double‑click WorkBuddyCompanion.exe. The program will install the companion and open a setup wizard.
Follow the prompts on the “Ready to start” page: connect Mosaico to Wi‑Fi, then connect it to the computer via USB, keeping the device on the WorkBuddy page. After the wizard shows “Computer ready”, click Next: Connect Account.
2. Connect WorkBuddy Account
Tap Open Official Authorization, log in on the WorkBuddy official website and grant permission, then return to the wizard.
Next, tap Open WorkBuddy Client, and log in with the same account on the computer client. The client syncs points and runs computer tasks. Tap Next: Confirm Device.
3. Confirm Device
Tap Start USB Pairing. After Mosaico shows a connection confirmation page, verify the account and computer name, then tap Confirm Connection. When the computer wizard indicates the device is paired, proceed to Start Using.
4. Set to Launch with WorkBuddy
Tap Open Client and Set Up, then in the computer WorkBuddy go to:
Expert·Skills·Connectors → Connectors → Custom Connectors
Find mosaico-device-companion and allow it to run as prompted. Return to the wizard; after “Client connection received” appears, tap Finish and Close.
On Mosaico, tap Task → Voice Dispatch, hold the button to state a request, release and wait for a reply.
Later, opening the computer WorkBuddy will launch the companion automatically; exiting WorkBuddy from the client tray also exits the companion.
Daily Use
Dispatch Tasks and View Replies
On the WorkBuddy home page, go to Task → Voice Dispatch and select a task type:
| Task Type | Suitable Use |
|---|---|
| Cloud Task | Draft copy, organize ideas, choose model as needed |
| Computer Task | Have WorkBuddy handle files and data on the computer; keep the computer client running |
After selecting the task type, hold the voice button to speak, then release to send.
The task list shows progress; tap a task to read the reply. Long replies can be scrolled vertically. Tap the top‑left “‹ Task” to return to the list.
For computer tasks, after “Computer reply received” appears, you can continue checking execution progress and approvals in the client.
Relay Chat Between Computer and Device
Open a cloud conversation and tap Continue Speaking to follow up. Keep the computer companion running, tap Open on Computer, and the same WorkBuddy dialogue opens in the default browser.
After chatting on the web, the device will indicate a new message; tap to view the added Q&A.
View Points and New Replies
The home page shows personal points, used points, total, and update time, auto‑refreshing about every minute, or you can tap Refresh.
When disconnected, the last data is retained and the update time is shown; reconnection resumes synchronization.
When a recent task receives a new reply, a reply entry appears on the home page; tap to read.
Cable‑Free Use
In Mosaico Settings → Computer Connection, verify wireless connectivity; once confirmed you can operate without the cable.
You may also keep the USB connection and, in the companion’s Daily Settings → Connection Diagnosis, tap Deep Check Wireless Connection.
The computer can use Ethernet while Mosaico uses Wi‑Fi, as long as the two networks can communicate.
After re‑plugging USB, the companion prefers the data‑line connection. If the network or computer address changes, plug in USB and follow the wizard prompts to update the connection.
Manage the Computer Companion
Tap the orange circular icon on the right side of the Windows taskbar to open Daily Settings. The icon may also be hidden under the “Show hidden icons” arrow.
Here you can check points, fix connections, manage the account, and configure voice services.
After closing the settings page, the companion continues running in the tray. Double‑click WorkBuddyCompanion.exe again to reopen settings.
Choose a launch mode and click Save Launch Mode:
- Launch and exit with WorkBuddy: Starts the companion when the client opens; both exit together when the client fully quits.
- Run independently after Windows login: Starts the companion after you log into Windows; it keeps running after WorkBuddy exits.
If you need the companion to run independently temporarily, tap Keep Running This Time. After clicking Restore Saved Mode, it runs according to the selected option.
To stop the companion, right‑click the tray icon and choose Exit Companion.
Voice Service
The default is Mosaico’s official speech‑recognition service.
You can use a custom voice service; we recommend Alibaba Cloud Bailei Speech Service. Configure it in the computer companion’s Daily Settings → Voice Service using the setup wizard:
- Connect a powered‑on Mosaico to the computer via USB.
- In the wizard, tap Open Bailei Console to create a personal API Key, enter the Key and select the appropriate region; if you have a dedicated business space, fill in its ID.
- Follow the prompts to speak a test phrase and verify the recognized text.
- After a successful test, save and restart the device to continue using it.
Usage and fees for personal voice services can be viewed in the Bailei console.
Common Questions
| Situation | Solution |
|---|---|
| Cannot find the companion connector in WorkBuddy | After completing the current task, fully exit WorkBuddy from the tray, reopen it, and allow mosaico-device-companion to run under Custom Connectors |
| USB not connected or device shows no confirmation page | Use a data‑transfer capable USB cable, open WorkBuddy on the device, and re‑check in the wizard; if firmware maintenance is in progress, wait until it finishes before connecting |
| Wireless connection check fails | Ensure the device is on Wi‑Fi and the computer is online, then check in Mosaico Settings → Computer Connection. You can also plug in the cable and use the companion’s deep check; retry later if the device is busy. If the two networks are isolated, continue using the cable |
| Points not updating | Log into the same account on the computer WorkBuddy, then in the companion’s Daily Settings tap Check Client Points |
| Client points read method not compatible | Update the computer companion as described in Update Computer Companion, then tap Check Client Points again. Points may be temporarily unavailable, but task functions remain usable |
| Connection breaks after network change or companion shows “Needs Repair” | In the companion’s daily settings tap Repair Computer Connection and follow the prompts; re‑plug USB if a device‑connection update is required |
| Settings page disconnects | Tap Reconnect; if it still does not recover, reopen settings from the companion tray |
| Voice not clear or recognition fails | Verify the device’s Wi‑Fi can access the internet, speak again in a quiet environment; if the service is reported unavailable, check configuration in Daily Settings → Voice Service |
| Cloud task fails | Open the task to view the error; if authorization is required, reconnect the account in the computer companion. If the content was not sent, re‑dispatch the task |
| Task shows “Result Unknown” | In the original task details tap Query Status, or view the original WorkBuddy conversation. Do not resend the same task until a result is confirmed |
| Browser shows certificate error | Make sure you are opening https://www.workbuddy.cn; ask your corporate network administrator to check network certificates, or retry on a trusted network |
Mosaico’s Settings → Computer Connection shows connection status; the companion’s Connection Diagnosis can further inspect it. If the issue persists, provide feedback in the Mosaico community discussion area with screenshots and steps taken.
Update the Computer Companion
After the current task finishes, close the settings page, fully extract the new package, and run WorkBuddyCompanion.exe. When prompted to switch versions, click Confirm Version Switch. Account, pairing, and task records are retained.
If you are updating to restore point synchronization, tap Check Client Points in daily settings.
Stop or Remove the Computer Companion
Right‑click the tray icon and select Exit Companion. To use it again, double‑click the EXE, or fully exit and reopen WorkBuddy.
To uninstall the program:
- In daily settings choose Launch and exit with WorkBuddy, click Save Launch Mode, and disable independent launch at Windows login.
- In WorkBuddy remove the
mosaico-device-companionconnector and fully exit the client. - Exit the companion, close the settings page. Press Win + R, type
%LOCALAPPDATA%\Programs, and delete theWorkBuddyCompanionfolder.
Account, pairing, and task data remain in the user directory and can be used after reinstalling.
Third‑party licenses and corresponding source code are in the page attachment WorkBuddy-Third-Party.zip.
Data and Privacy Statement
Account Authorization
Account login and authorization are completed on the official WorkBuddy website. The authorization service handles credential requests and renewals, and the desktop assistant saves renewal credentials. Paired devices use short‑term access credentials to invoke task functions.
Voice and Tasks
By default, recordings are sent to the official Mosaico speech recognition service, and the recognized text is sent to WorkBuddy. If you switch to your own Alibaba Cloud Bailei speech service in the desktop assistant, recordings will be sent to Alibaba Cloud for recognition; usage and fees are calculated according to Alibaba Cloud’s rules. The device and desktop assistant will store recent tasks and replies for viewing history and continuing conversations.
Execution and approval of computer tasks are handled in the WorkBuddy client; cloud sessions can continue on the official WorkBuddy website. Clicking “Open on Computer” will open the corresponding session in a browser.
Account Information and Points
The assistant uses the login information of the local WorkBuddy client to query account information and personal points. The client login information remains on the computer, and the device receives nickname, avatar, and points data. Points synchronization is supported only for personal accounts.
Stopping Use
Right‑click the assistant’s tray icon and select “Exit Assistant” to stop synchronization. After removing the program, the local account, pairing, and task records will still be retained, and they can be used again after reinstalling.
Comments (0)