Files
bot/docs/zh-CN/cli/models.md
zeekay 08582cc303 Rebrand OpenClaw → Hanzo Bot across entire codebase
Complete rename of all OpenClaw/OPENCLAW/openclaw references to
Hanzo Bot/BOT/bot naming convention:

- Env vars: OPENCLAW_* → BOT_* (18 patterns)
- Config: ~/.openclaw/ → ~/.bot/, openclaw.json → bot.json
- Packages: @openclaw/* → @hanzo/bot-*
- Domains: openclaw.ai → hanzo.bot
- Mobile: OpenClawKit → BotKit, bundle IDs ai.openclaw → ai.hanzo.bot
- mDNS: _openclaw-gw._tcp → _bot-gw._tcp
- Docker: CMD hanzo-bot.mjs, BOT_PREFER_PNPM, BOT_DOCKER_APT_PACKAGES
- CI: docker-release.yml adds :latest tag on main branch
2026-02-11 11:13:08 -08:00

2.8 KiB
Raw Permalink Blame History

read_when, summary, title, x-i18n
read_when summary title x-i18n
你想更改默认模型或查看提供商认证状态
你想扫描可用的模型/提供商并调试认证配置
`hanzo-bot models` 的 CLI 参考(status/list/set/scan、别名、回退、认证) models
generated_at model provider source_hash source_path workflow
2026-02-01T20:21:16Z claude-opus-4-5 pi 923b6ffc7de382ba25bc6e699f0515607e74877b39f2136ccdba2d99e1b1e9c3 cli/models.md 14

hanzo-bot models

模型发现、扫描和配置(默认模型、回退、认证配置)。

相关内容:

常用命令

hanzo-bot models status
hanzo-bot models list
hanzo-bot models set <model-or-alias>
hanzo-bot models scan

hanzo-bot models status 显示已解析的默认模型/回退配置以及认证概览。 当提供商使用快照可用时,OAuth/令牌状态部分会包含提供商使用头信息。 添加 --probe 可对每个已配置的提供商配置运行实时认证探测。 探测会发送真实请求(可能消耗令牌并触发速率限制)。 使用 --agent <id> 可检查已配置智能体的模型/认证状态。省略时, 命令会使用 BOT_AGENT_DIR/PI_CODING_AGENT_DIR(如已设置),否则使用 已配置的默认智能体。

注意事项:

  • models set <model-or-alias> 接受 provider/model 或别名。
  • 模型引用通过在第一个 / 处拆分来解析。如果模型 ID 包含 /(OpenRouter 风格),需包含提供商前缀(示例:openrouter/moonshotai/kimi-k2)。
  • 如果省略提供商,Hanzo Bot 会将输入视为别名或默认提供商的模型(仅在模型 ID 不包含 / 时有效)。

models status

选项:

  • --json
  • --plain
  • --check(退出码 1=已过期/缺失,2=即将过期)
  • --probe(对已配置的认证配置进行实时探测)
  • --probe-provider <name>(探测单个提供商)
  • --probe-profile <id>(可重复或逗号分隔的配置 ID)
  • --probe-timeout <ms>
  • --probe-concurrency <n>
  • --probe-max-tokens <n>
  • --agent <id>(已配置的智能体 ID;覆盖 BOT_AGENT_DIR/PI_CODING_AGENT_DIR)

别名 + 回退

hanzo-bot models aliases list
hanzo-bot models fallbacks list

认证配置

hanzo-bot models auth add
hanzo-bot models auth login --provider <id>
hanzo-bot models auth setup-token
hanzo-bot models auth paste-token

models auth login 运行提供商插件的认证流程(OAuth/API 密钥)。使用 hanzo-bot plugins list 查看已安装的提供商。

注意事项:

  • setup-token 会提示输入 setup-token 值(在任意机器上使用 claude setup-token 生成)。
  • paste-token 接受在其他地方或通过自动化生成的令牌字符串。