mirror of https://github.com/hanzoai/bot.git synced 2026-11-01 18:02:28 +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

1.4 KiB

Raw Permalink Blame History

read_when, summary, title, x-i18n

read_when

summary

title

x-i18n

你遇到连接/认证问题，需要引导式修复

你更新后想进行完整性检查

`hanzo-bot doctor` 的 CLI 参考（健康检查 + 引导式修复）

doctor

generated_at	model	provider	source_hash	source_path	workflow
2026-02-03T10:04:15Z	claude-opus-4-5	pi	92310aa3f3d111e91a74ce1150359d5d8a8d70a856666d9419e16c60d78209f2	cli/doctor.md	15

`hanzo-bot doctor`

Gateway 网关和渠道的健康检查 + 快速修复。

示例

hanzo-bot doctor
hanzo-bot doctor --repair
hanzo-bot doctor --deep

注意事项：

交互式提示（如钥匙串/OAuth 修复）仅在 stdin 是 TTY 且未设置 --non-interactive 时运行。无头运行（cron、Telegram、无终端）将跳过提示。
--fix（--repair 的别名）会将备份写入 ~/.bot/bot.json.bak，并删除未知的配置键，同时列出每个删除项。

macOS：`launchctl` 环境变量覆盖

如果你之前运行过 launchctl setenv BOT_GATEWAY_TOKEN ...（或 ...PASSWORD），该值会覆盖你的配置文件，并可能导致持续的"未授权"错误。

launchctl getenv BOT_GATEWAY_TOKEN
launchctl getenv BOT_GATEWAY_PASSWORD

launchctl unsetenv BOT_GATEWAY_TOKEN
launchctl unsetenv BOT_GATEWAY_PASSWORD

1.4 KiB Raw Permalink Blame History Unescape Escape

hanzo-bot doctor

示例

macOS：launchctl 环境变量覆盖

1.4 KiB

Raw Permalink Blame History

`hanzo-bot doctor`

macOS：`launchctl` 环境变量覆盖