Help
Troubleshooting
Common problems, their likely cause, and what to try, grouped by area.
How to use this page
Find the area your problem is in, then the row that matches what you see. Each row links to the page that explains the feature in full. If nothing matches, go to Still stuck?.
Two quick checks solve many problems. First, look under Result in the task window and for an approval dialog: a task that seems stuck is often waiting for you. Second, open the Execution Trace to see which step is running or failed. See Follow progress.
Setup and AI providers
| Problem | Likely cause | What to try |
|---|---|---|
| Tasks stop with "No API key configured for …" | No key is saved, or the saved keys were deleted. | Right-click the tray icon, choose Settings, paste your key and click Save. See Add or change your key. |
| Save shows an error and nothing is saved | Your provider rejected the key, your account has no credit, or the model name is wrong or not allowed. | Read the message and fix what it names. See Errors you may see. |
| The error starts with "Voice provider:" | The problem is with the voice provider's key, not the task provider's. | Check the key in the Voice Provider section. See Task provider and voice provider. |
| "Could not reach the Action Wright server" when you click Save | A part of ActionWright was not ready yet. | Wait a moment and click Save again. If it keeps happening, choose Quit in the tray menu and open ActionWright again. See Errors you may see. |
| Simple questions work, but browser or Computer Use tasks fail with a provider error | Your task model does not accept images. The check at Save does not test image input. | Choose a task model that accepts images and supports tool calls. See Models. |
| A task pauses with a message about credit, a key or a model | Your provider account cannot pay, or the key or model stopped working during the task. | Fix it at your provider or in Settings, then click Continue. See AI provider errors. |
| Push-to-Talk and Voice mode don't work, but typed tasks do | Your task provider is Anthropic and no voice provider key is saved, so speech is off. | Choose a voice provider in the Voice Provider section and enter its key. See Task provider and voice provider. |
| Your provider bill is higher than the token counter suggests | The counter shows only the orchestrator's tokens for one turn, not the agents' work. | Check your provider's dashboard for exact usage. See Token counter and Costs. |
Launch and required updates
| Problem | Likely cause | What to try |
|---|---|---|
| Action Wright — Connection Required at launch, and ActionWright closes | ActionWright could not verify that your version is supported, usually because you are offline. | Connect to the internet, then open ActionWright again. See Required updates. |
| ActionWright started offline before, but not today | It starts without internet only within three days of its last successful version check. | Connect to the internet before you launch. See Required updates. |
| Action Wright — Update Required at launch | Your version is no longer supported. | Open the Microsoft Store, go to Library, and update ActionWright. Then open it again. See Required updates. |
| The task window does not appear | It was closed. ActionWright is still running in the tray. | Press ctrl+shift+a, or double-click the tray icon. See Opening ActionWright again. |
| You cannot find the tray icon | Windows hides some icons. | Click the arrow in the notification area that shows hidden icons. See The tray icon and its menu. |
| ActionWright starts every time you sign in to Windows | It is set up to start with Windows. | Turn off Action Wright in Windows Settings > Apps > Startup. See Starting with Windows. |
| You want to see the tutorial again | The tutorial shows only on the first launch. | There is currently no way to open it again. These docs cover the same topics, starting with Overview. |
Voice and Push-to-Talk
| Problem | Likely cause | What to try |
|---|---|---|
| Nothing happens when you say "Hey Yoo" | Voice mode is off, or it was turned on without a restart. | Tick Enable Voice mode (say "Hey Yoo" to start a task) in Settings, then choose Quit in the tray menu and open ActionWright again. See Turn on Voice mode. |
| Voice mode still does not react after a restart | ActionWright cannot use the microphone. | Check microphone access and the Windows default microphone, then restart ActionWright. See Microphone access. |
| Transcription failed after Push-to-Talk | No voice provider key, a provider problem, or nothing was recorded. | Check the voice provider in Settings. Hold ctrl+space while you speak and release after you finish. See Dictate with Push-to-Talk. |
| Dictated text does not appear | No text field had focus, or the app blocks pasting. | Click in the field and try again. The text is on your clipboard, so you can paste it with ctrl+v. See Push-to-Talk and your clipboard. |
| Something you copied earlier is gone | Push-to-Talk replaces the clipboard with the dictated text. | Paste what you need before you dictate. See Push-to-Talk and your clipboard. |
| The voice panel shows PROCESSING..., then closes with no answer | Your speech could not be transcribed. | Check the voice provider and its key in Settings, then try again. See Voice troubleshooting. |
| Answers appear but are not spoken, for example after an update | Your voice provider could not generate speech, or a speech model saved in Settings is no longer offered. | Check the voice provider and its key. Under Voice Advanced Settings, clear STT Model and TTS Model so the current defaults are used, then click Save. See Speech models. |
| A voice task asks something, and you can't answer by voice | Questions, approvals and pause prompts are answered in the task window, even for voice tasks. | Answer in the task window or the approval dialog. See When a voice task needs you. |
Another app's ctrl+space shortcut stopped working | ActionWright reserves ctrl+space for Push-to-Talk while it runs. | Use that app's menu instead, or quit ActionWright while you need the shortcut. See Good to know. |
The task window
| Problem | Likely cause | What to try |
|---|---|---|
| The task seems stuck | A long step is still running, or the task is waiting for you. A waiting task has no time limit. | Open the Execution Trace to see the running step. Look under Result for a question or prompt, and look for an approval dialog. See When a task waits for you. |
| The task waits with Reply (optional)... and Done | You need to do a step yourself, such as signing in. | Do the step, then click Done. See When a task waits for you. |
| "Step budget reached" appears | The orchestrator or an agent used all its steps. | Read the trace first. Click Yes, Continue for a fresh set of steps, or No, Stop and split the job into smaller tasks. See The step limit. |
| Stop takes a moment | The action that is running finishes first. | Wait for "Task was stopped by the user." See Stop a task. |
| You pressed Stop while an action was running | That action, for example sending an email, submitting a form or writing a file, may or may not have happened. | Check the result yourself before you continue or try again. See Stop a task. |
| "Continue where you stopped" starts over or repeats work | The stopped run was forgotten after New Chat or a restart, or you stopped the same job more than once. | Tell ActionWright what is already done, for example "the first email was already sent". See Continue a stopped task. |
ctrl+esc does not stop a task | The task is waiting for you. The shortcut stops only a task that is running. | Click Stop in the task window. See Stop a task. |
| Continue after a provider pause ends with an error | You switched to a different provider while the task was paused. | Run the task again. During a pause, change only the credit, key or model of the same provider. See AI provider errors. |
enter does nothing | A task is still running, or the box and attachments are empty. | Wait for the result or press Stop. Type a task or attach a file. See Run a task. |
| The answer ignores an attached file or image | The file type is passed by path only, the PDF has no text, or you attached the image to an answer instead of a task message. | Save the content in a readable format, and attach images to a task message. See Which files are read. |
| A task with a large attached image fails with a provider error | Your provider may not accept an image that large. ActionWright sends attached images at their original size. | Make the image smaller or crop it, then try again. See Attachment limits. |
| A follow-up doesn't know a detail from the last task | When a task ends, only your messages and the final answer are kept for follow-ups. Pages and files it read, and answers you gave during the task, are dropped. | Repeat the detail in your message. Next time, ask for the details you need in the answer. See After a task ends. |
| A long task forgets an early detail | ActionWright shortens the record of long tasks automatically. | Repeat the detail in your next message. See Long tasks are shortened. |
| Your earlier conversation is gone | Conversations are kept only while ActionWright runs. Quitting clears them. | There is no chat history to reopen. See Where it is kept. |
Files
| Problem | Likely cause | What to try |
|---|---|---|
| ActionWright asks you to choose a folder | The task needs files, and no root folder or attachment is set. | Pick the folder in the question and click Submit, or set Root folder (optional): before you run the task. See If no scope is set. |
| The agent can't reach a file | The file is outside your root folder, or you attached files without a root folder. | Choose a root folder that contains the file, or attach the file. See Where it can work. |
| A file you know is there isn't found | It is deeper than the search reaches, its name doesn't match what the agent searched for, or it is a protected file. | Tell the agent which folder it is in, or choose a root folder closer to it. See Limits. |
| The agent can't read a document | Its type isn't supported, it is a scanned PDF, it is a very large picture, or the file is damaged. | Save it as .docx, .xlsx, .pptx or a PDF with text, or make the picture smaller. See Files it can read. |
| It can't make or change a Word, Excel, PowerPoint or PDF file | The file agent writes plain-text files only. | Ask for a text or CSV file instead. See What it cannot do. |
| A move, rename or edit fails | The file is open in another app, or Windows doesn't allow the change. | Close the file in the other app and ask again. See If something goes wrong. |
| Something went to the Recycle Bin by mistake | You approved Move to Recycle Bin. | The item is usually in the Recycle Bin. Open it, right-click the item and choose Restore. On network and removable drives, Windows may have deleted it permanently. See No permanent delete. |
| A file's text was replaced or changed by mistake | Write File or Edit File ran. The old text does not go to the Recycle Bin. | Restore the file from your backup, or from Windows File History if you use it. See Replacing and editing text. |
Browser
| Problem | Likely cause | What to try |
|---|---|---|
| A message says Google Chrome is required | Chrome is not installed. The browser agent uses the Chrome on your PC. | Install Google Chrome, then run the task again. See Before you begin. |
| "Could not open browser: …" | The agent browser could not start. | Click Show Agent Browser again. If it keeps failing, quit and restart ActionWright. See If something goes wrong. |
| The agent isn't signed in to a site | You signed in to your everyday Chrome, not to the agent browser. They don't share sign-ins. | Click Show Agent Browser and sign in there. See Sign in ahead of time. |
| The task waits for a sign-in, a code or payment details | The browser agent hands these steps to you. It does not type passwords, codes or payment details. | Complete the step in the agent browser, then click Done. See When it hands control to you. |
| A robot check keeps appearing | Some sites check for automated browsing. | Complete the check in the agent browser and click Done. If it keeps coming back, do that part of the task yourself. See Limits. |
| You want to sign out or clear the agent browser | There is no ActionWright setting for this. | Open the agent browser with Show Agent Browser and sign out on each site. See Sign out or clear the profile. |
| An action was blocked | It did not match your request, or it was already done or denied in this chat. | Say exactly what you want in a new message, for example "submit the form". See Protections. |
| The agent can't upload a file | The file isn't attached to the chat, or it is over 100 MB. | Attach the file with + and ask again. See Protections. |
| A downloaded file is missing | You denied a program download, or the download started as the task's last step. | Check your Windows Downloads folder, or ask again. See Protections. |
Computer Use
| Problem | Likely cause | What to try |
|---|---|---|
| The task reports it cannot use Computer Use | Enable Computer Use agent (screen control) is off. | Turn it on in Settings and ask again. You don't need to restart. See Turn Computer Use on or off. |
| The task fails with a provider error as soon as Computer Use starts | Your task model does not accept images. | Choose a model that accepts images. See Models. |
| It clicks or types in the wrong place | You used the mouse or keyboard while it worked, or a pop-up appeared. | Leave the mouse and keyboard alone, close the pop-up, and ask again. See Leave the mouse and keyboard alone. |
| An app doesn't open | Some Microsoft Store apps can't be opened by name, or the name doesn't match the app's name in the Start menu. | Open the app yourself and ask again, or use the name exactly as the Start menu shows it. See Limits. |
| It keeps repeating the same kind of action | It is stuck on a step. | Press ctrl+esc. Then describe a different way in a new message, or do that step yourself. See Limits. |
| A Windows administrator prompt is on the screen | An app asked for administrator permission. Computer Use cannot answer these prompts. | Answer the prompt yourself. If the task is waiting, click Done. See What it hands back to you. |
| ActionWright says another screen session is active | Computer Use is still busy with another task. Only one task can use it at a time. | Wait for the other task to finish, or stop it, then ask again. If it keeps happening, quit and restart ActionWright. See Limits. |
| Your clipboard holds different text | Computer Use pasted long or non-English text through the clipboard. | Copy your own content again. See Your clipboard. |
| Private windows were open during a task | Computer Use sends screenshots of your screen to your AI provider. | Before the next task, close what the task doesn't need. Minimizing is not enough. See What is sent to your AI provider. |
Approvals
| Problem | Likely cause | What to try |
|---|---|---|
| A task waits, but no question appears under Result | An Action Approval Required dialog is waiting for your answer. | Find the dialog and answer it. It stays on top of other windows, and the tray icon shows a count. If the task window is not in front, Windows also shows a Confirmation required notification. See A waiting approval. |
You clicked Deny, pressed esc or closed the dialog by mistake | Each of these counts as Deny, so the action was not done. ActionWright may then try another way, ask you, or stop. | Say in a new message what you want, for example "go ahead and move the files". See When you deny. |
An action was approved when you pressed enter | Allow Once is the default button, so enter approves. | Check what the action did, and click Stop if the task should not go on. Next time, read the preview before you press any key. See Your choices. |
| A dialog asks about an action you asked for | Your words didn't clearly ask for that action, its effect wasn't clear, or it pays or orders something. ActionWright is built to always ask before paying. | Read the dialog and allow it if it is right. Next time, name the action in your request, for example "send the reply". See What asks first. |
| The dialog has no Always Allow button | That action asks every time. This is true for Move to Recycle Bin and for every browser and Computer Use action. | Choose Allow Once or Deny. See Always Allow. |
| You chose Always Allow and want to undo it | There is currently no way to see or undo Always Allow choices in the app. | The file agent still works only inside the scope you give it, so keep your root folder narrow and read each summary. See Always Allow. |
Still stuck?
Try these steps in order:
- Stop the task. Click Stop in the task window, or press
ctrl+esc. Then check what the last action did. See Stop a task. - Start a new chat. Click New Chat, then give the task again in clear words. Your root folder and the agent browser stay as they are. See Start a new chat.
- Restart ActionWright. Right-click the tray icon, choose Quit, then open ActionWright from the Start menu. Quitting clears your conversations. See The tray icon and its menu.
- Check your provider. Open Settings and click Save to test your key and model again. Check your provider's dashboard for credit, spending limits and service problems. See What the check tests.
- Check your internet connection. ActionWright needs it for every task, and to start unless a recent version check succeeded. See Required updates.
For what ActionWright does not do yet, see Known limitations. For quick answers, see FAQ.
Still stuck? Contact support.
