mirror of https://github.com/hanzoai/bot.git synced 2026-11-01 07:38:30 +00:00

Files

T

zeekayandHanzo Dev 84e4069c2c docs name the state dir and config file the bot reads: ~/.bot/bot.json

The docs said ~/.hanzo-bot/hanzo-bot.json (and ~/.hanzo-bot-<profile>, hanzo-bot.plugin.json), which nothing reads: src/config/paths.ts resolves ~/.bot, bot.json and ~/.bot-<profile>, and plugins ship bot.plugin.json. Every such path in docs/ now names what the code opens.

Co-authored-by: Hanzo Dev <[email protected]>

2026-09-24 21:12:09 -07:00

3.6 KiB

Raw Permalink Blame History

read_when, summary, title, x-i18n

read_when

summary

title

x-i18n

你想从机器上移除 HanzoBot

卸载后 Gateway 网关服务仍在运行

完全卸载 HanzoBot（CLI、服务、状态、工作区）

卸载

generated_at	model	provider	source_hash	source_path	workflow
2026-02-03T07:50:10Z	claude-opus-4-5	pi	6673a755c5e1f90a807dd8ac92a774cff6d1bc97d125c75e8bf72a40e952a777	install/uninstall.md	15

卸载

两种方式：

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

简单方式（CLI 仍已安装）

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

hanzo-bot uninstall

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

hanzo-bot uninstall --all --yes --non-interactive
npx -y hanzo-bot uninstall --all --yes --non-interactive

手动步骤（效果相同）：

停止 Gateway 网关服务：

hanzo-bot gateway stop

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

hanzo-bot gateway uninstall

删除状态 + 配置：

rm -rf "${BOT_STATE_DIR:-$HOME/.bot}"

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

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

rm -rf ~/.bot/workspace

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

npm rm -g hanzo-bot
pnpm remove -g hanzo-bot
bun remove -g hanzo-bot

如果你安装了 macOS 应用：

rm -rf /Applications/HanzoBot.app

注意事项：

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

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

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

macOS（launchd）

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

launchctl bootout gui/$UID/bot.molt.gateway
rm -f ~/Library/LaunchAgents/bot.molt.gateway.plist

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

Linux（systemd 用户单元）

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

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

Windows（计划任务）

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

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

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

普通安装 vs 源码检出

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

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

源码检出（git clone）

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

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

3.6 KiB Raw Permalink Blame History Unescape Escape

卸载