卸载

两种方式：

• 如果 opensoul 仍已安装，使用简单方式。
• 如果 CLI 已删除但服务仍在运行，使用手动服务移除。

简单方式（CLI 仍已安装）

推荐：使用内置卸载程序：

opensoul uninstall

非交互式（自动化 / npx）：

opensoul uninstall --all --yes --non-interactive
npx -y opensoul uninstall --all --yes --non-interactive

手动步骤（效果相同）：

1. 停止 Gateway 网关服务：

opensoul gateway stop

2. 卸载 Gateway 网关服务（launchd/systemd/schtasks）：

opensoul gateway uninstall

3. 删除状态 + 配置：

rm -rf "${OPENSOUL_STATE_DIR:-$HOME/.opensoul}"

如果你将 OPENSOUL_CONFIG_PATH 设置为状态目录外的自定义位置，也请删除该文件。

4. 删除你的工作区（可选，移除智能体文件）：

rm -rf ~/.opensoul/workspace

5. 移除 CLI 安装（选择你使用的那个）：

npm rm -g opensoul
pnpm remove -g opensoul
bun remove -g opensoul

6. 如果你安装了 macOS 应用：

rm -rf /Applications/OpenSoul.app

注意事项：

• 如果你使用了配置文件（--profile / OPENSOUL_PROFILE），对每个状态目录重复步骤 3（默认为 ~/.opensoul-<profile>）。
• 在远程模式下，状态目录位于 Gateway 网关主机上，因此也需要在那里运行步骤 1-4。

手动服务移除（CLI 未安装）

如果 Gateway 网关服务持续运行但 opensoul 缺失，请使用此方法。

macOS（launchd）

默认标签是 ai.opensoul.gateway（或 ai.opensoul.<profile>；旧版 com.opensoul.* 可能仍然存在）：

launchctl bootout gui/$UID/ai.opensoul.gateway
rm -f ~/Library/LaunchAgents/ai.opensoul.gateway.plist

如果你使用了配置文件，请将标签和 plist 名称替换为 ai.opensoul.<profile>。如果存在任何旧版 com.opensoul.* plist，请将其移除。

Linux（systemd 用户单元）

默认单元名称是 opensoul-gateway.service（或 opensoul-gateway-<profile>.service）：

systemctl --user disable --now opensoul-gateway.service
rm -f ~/.config/systemd/user/opensoul-gateway.service
systemctl --user daemon-reload

Windows（计划任务）

默认任务名称是 OpenSoul Gateway（或 OpenSoul Gateway (<profile>)）。 任务脚本位于你的状态目录下。

schtasks /Delete /F /TN "OpenSoul Gateway"
Remove-Item -Force "$env:USERPROFILE\.opensoul\gateway.cmd"

如果你使用了配置文件，请删除匹配的任务名称和 ~\.opensoul-<profile>\gateway.cmd。

普通安装 vs 源码检出

普通安装（install.sh / npm / pnpm / bun）

如果你使用了 https://opensoul.ai/install.sh 或 install.ps1，CLI 是通过 npm install -g opensoul@latest 安装的。 使用 npm rm -g opensoul 移除（或 pnpm remove -g / bun remove -g，如果你是用那种方式安装的）。

源码检出（git clone）

如果你从仓库检出运行（git clone + opensoul ... / bun run opensoul ...）：

1. 在删除仓库之前卸载 Gateway 网关服务（使用上面的简单方式或手动服务移除）。
2. 删除仓库目录。
3. 按上述方式移除状态 + 工作区。