Captain V1 is retiring: every account moves to the new Captain

Aakash Bakhle

Aakash Bakhle

Published on

1 minute read

Captain V1 is being retired. From now on, every assistant runs on the new Captain, the version with scenarios, response guidelines, guardrails, audience and schedule controls, and the new playground.

On Chatwoot Cloud

If you use Captain on Chatwoot Cloud, you are already on the new version and nothing changes for you. Your assistants, connected inboxes, documents, and FAQs stay as they are.

The old free-form instructions field is no longer used. Assistants now take their behavior from scenarios, response guidelines, and guardrails.

On self-hosted installations

The next Chatwoot release removes V1. After you install it, Captain always uses the new version, and there is no option to switch back.

If your assistants rely on the old instructions field, move that behavior into the new settings before you upgrade. Installations with no old instructions do not need to do anything.

Use the migration task. From v4.16.0 onward, Chatwoot includes a task that reads an assistant's old instructions and drafts FAQs, response guidelines, guardrails, and scenario candidates. Run it while your installation still has V1, review every draft, and then apply it.

Set it up by hand. Add the guidelines, guardrails, and scenarios to the assistant yourself. Take this path if your model provider cannot serve the model the migration task uses.

Before you upgrade, back up your database and test a migrated assistant in the playground and in a connected inbox. The self-hosted upgrade guide has the full steps and commands.

You can review each assistant's guidelines and guardrails under Captain > Settings, and its scenarios under Captain > Scenarios. If something doesn't work the way you expected after the move, let us know.