openclaw onboard¶
引导式设置会首先建立推理能力:它会检测现有的 AI 访问方式,等待你选择提供商,验证该连接,仅持久化可用的路由,然后启动 OpenClaw 来配置其余部分。openclaw setup 在新系统上或存在任何引导选项时进入此流程;已配置的系统使用不带额外参数的 openclaw setup 进行系统代理聊天。openclaw setup --baseline 仅写入基线配置/工作区。
交互式 CLI 流程的逐步讲解。
OpenClaw 引导如何协同工作。
输出、内部机制以及每步行为。
非交互标志和脚本化设置。
macOS 菜单栏应用的引导流程。
示例¶
openclaw onboard
openclaw onboard --tui
openclaw onboard --classic
openclaw onboard --modern
openclaw onboard --flow quickstart
openclaw onboard --agent-name robby
openclaw onboard --flow manual
openclaw onboard --flow import
openclaw onboard --import-from hermes --import-source ~/.hermes
openclaw onboard --skip-bootstrap
openclaw onboard recommendations --json
openclaw onboard recommendations --agent writer --json
openclaw onboard recommendations --agent writer acknowledge
openclaw onboard recommendations acknowledge --agent writer
openclaw onboard recommendations refresh --agent writer
openclaw onboard recommendations acknowledge
openclaw onboard recommendations acknowledge --retry "<failed-id>"
openclaw onboard recommendations refresh
openclaw onboard --mode remote --remote-url wss://gateway-host:18789
openclaw onboard recommendations 会读取引导期间存储的待处理应用推荐匹配项。添加 --json 可获取首次运行引导所使用的机器可读列表。该命令不会重新扫描已安装的应用,也不会调用模型。其输出仅包含经过验证的安装 ID、来源和层级;它有意省略不受信任的 Marketplace 文案、模型理由和本地应用标签。推荐提议被答复后,该命令返回空列表,未来的引导运行将完全跳过此步骤。openclaw onboard recommendations refresh 会清除已存储的提议,以便下一次引导运行重新扫描已安装的应用并创建新的提议。
传入 --agent <id> 可为读取、acknowledge、acknowledge --retry 或 refresh 操作选择已配置的代理。该参数可放在子命令之前或之后;子命令上的显式值优先于父级值。这些操作仅使用该代理的工作区推荐。未使用选择器时,命令保持现有的默认代理行为,并在属主不明确时要求你选择一个代理。空白或未知的代理 ID 会导致操作失败,且不会更改已存储的推荐;使用 openclaw agents list 可查找已配置的 ID。
全新工作区会将推荐选择推迟到引导对话中处理。该对话处理完用户的选择后,openclaw onboard recommendations acknowledge 会将存储的提议标记为已答复。该确认操作是幂等的。如果某个已选安装失败,请使用 --retry <id...> 传入每个失败的不透明 ID;成功和已拒绝的匹配会被消费,而失败的匹配保持待处理状态,供后续引导运行处理。未知 ID 会导致操作失败,且不会更改已存储的提议。ClawHub 技能安装被中断后,仅当 openclaw skills verify "@owner/slug" 对同一发布者限定的推荐 ID 校验成功,且其 JSON 输出报告 openclaw.resolution.source: "installed" 时,现有目标才计为成功。仅凭注册表验证并不能证明本地安装成功。否则请使用 --retry 将该 ID 保持为待处理状态,并且不要覆盖现有技能。
标志¶
--classic: 打开完整的逐步向导。它不能与--non-interactive组合使用;自动化设置请省略--classic。--agent-name <name>: 在不存在代理名册时为第一个代理命名。交互式引导会询问 我们该怎么称呼你的第一个代理? 并建议使用main;非交互式引导除非提供了此标志,否则保持main。main这个 ID 不是保留的:如果你以后在命名代理旁边重新创建它,当创建时报告遗留会话或共享认证所有权仍附加在旧main安装上时,请先运行openclaw doctor --fix。--flow quickstart: 以最少提示打开经典向导,默认使用生成的 Gateway 密钥,不会要求你选择 Token 或密码。现有密码和可信代理配置会被保留。显式的本地 Gateway 标志(如--gateway-port、--gateway-bind、--gateway-auth和--tailscale)会覆盖对应的已存储或默认快速启动值;省略的选项保持其当前值。--flow manual(别名advanced): 打开经典向导的 手动设置 流程,对端口、绑定和密钥存储提供完整提示。默认生成 Gateway 密钥;使用--gateway-auth password或--gateway-password <value>可选择自己的密码。Tailscale Funnel 仍要求密码模式。该模式会选择已配置的密钥;客户端可以通过auth.token或auth.password之一发送它。--flow import: 针对全新设置运行检测到的迁移提供程序(例如通过--import-from hermes使用 Hermes)。确认后,引导会先在私有临时目标下暂存配置、凭据、工作区文件、记忆和技能;导入的推理必须通过实时补全测试,之后才会提升工作区和代理状态并提交配置。提升前失败或取消不会影响实时目标。无法回滚的外部激活步骤(如 Codex 插件安装)会在之后运行,并保持可从迁移报告中重试。迁移导入选项(--flow import、--import-from、--import-source和--import-secrets)不能与--reset组合使用;请在不带--reset的情况下运行导入。使用openclaw migrate可进行试运行计划、覆盖模式、经过验证的备份、报告和精确映射。--remote-url、--remote-token和--remote-password: 预填经典远程 Gateway 步骤,并覆盖本次运行的已存储远程值。传入 Token 或密码之一,不要同时传入两者。更改 URL 不会重用已存储的凭据,除非你也提供了新的 Token 或密码。交互步骤会要求输入一个 Gateway 密钥(无论远程 Gateway 将其称为 Token 还是密码),并将其存储为gateway.remote.token。凭据保持掩码状态,并遵循明文或 SecretRef 存储选择。将密钥留空并确认,以保留现有凭据。要在没有共享密钥的情况下连接,请将其留空,如果提示保留现有凭据则选择拒绝,然后明确确认 是否在没有 Gateway 密钥的情况下继续?。引用存储会在请求引用之前提供相同的确认。--modern: 是 OpenClaw 对话式设置助手的兼容别名。它与openclaw setup使用相同的实时推理门控,并且只接受--workspace、--agent-name、--accept-risk、--non-interactive和--json。其他设置标志会被拒绝,而不是被静默忽略。
引导流程¶
直接运行 openclaw onboard 会启动引导流程。它会显示安全须知,在不存在 agent 名册时询问第一个 agent 的名称,然后会预先提出一个发现性问题:完全访问(推荐——设置会自动查找 AI 应用、密钥和本地运行时)或 先询问(设置会在查看之前询问一次,或允许你手动配置)。该选择会持久化为 wizard.accessMode。允许发现后,引导流程会检测已经通过已配置模型、API 密钥环境变量和受支持的本地 CLI 可用的 AI 访问。检测仅呈现选项;它不会运行实时推理、安装插件、选择模型或持久化凭据。标记为设置与实用工具的提供商(如 Apple Foundation Models)会被验证并保存为 utilityModel,而不会替换主模型。在新安装中,它会为 OpenClaw 设置助手提供支持;请在打开常规 agent 聊天之前选择单独的主模型。添加实用工具模型时,现有的主模型和凭据保持不变。
在共享选择器中,选择检测到的连接或任意受支持的提供商。所选连接会运行一次真实的补全。如果失败,会显示错误,选择器会等待你的下一次选择。取消会停止尝试,而不会尝试其他提供商。
提供商选择器包含已安装和可安装的官方提供商。选择更多…可查看其他提供商分组;地区、套餐和认证方法随后会出现在第二个菜单中。受支持的浏览器或设备登录以及掩码 API 密钥或令牌方法使用相同的实时补全路径。OpenClaw 仅在测试成功后持久化验证过的模型路由及其凭据;失败的候选不会替换已配置的模型,也不会保存尝试过的凭据。在本地引导流程中,暂时跳过会准备指定 agent 的工作区和本地 Gateway 配置,然后退出而不启动 Gateway 或 AI 聊天。当你准备好连接 AI 时,重新运行 openclaw onboard;中断的基础设置会在其原有引导流程所有者下恢复。
在引导模式下,--workspace <dir> 提供 OpenClaw 建议的工作区和隔离的推理上下文。在你批准 OpenClaw 设置提案之前,它不会被持久化。经典和非交互式引导流程会通过其正常设置流程持久化工作区。工作区必须是目录或目录下的新路径;文件、非目录父级、悬空符号链接或符号链接循环会在设置或重置之前被拒绝,并指明失败的路径。其他检查失败(如权限错误)会被报告,而不是视为缺失目录。指向现有目录的符号链接(包括其下的新路径)是允许的。在已有 agent 名册的情况下重新运行时,引导流程会保留已配置的舰队工作区:经典向导会同时显示两个路径,并在移动之前要求明确确认,而非交互式设置会发出警告并保留当前值。对于显式管理的多 agent 舰队,提供商设置会更新已配置系统 agent 的模型和别名,而不会替换舰队范围的模型默认值或其他 agent 的模型。
推理通过后,引导流程会检查受支持的本地 AI 工具中的记忆:Claude Code 自动记忆、Codex 合并记忆和 Hermes 记忆文件。当发现任何记忆时,会有一个页面提供将它们复制到 agent 工作区的 memory/imports/ 目录下,以便进行索引召回。未经确认不会导入任何内容,之前已导入的文件会被跳过,并且你随时可以从 Control UI 的记忆导入页面稍后导入,该页面提供相同的仅记忆范围。(完整的 openclaw migrate 运行范围更广:它还可以导入配置、技能和凭据。)经典向导在准备工作区后也会显示相同的页面。
推理通过后(以及记忆导入的提议之后),引导流程会自动应用标准设置——工作区、Gateway 和会话,这与对话式 openclaw setup 聊天在回答“是”时应用的方案相同——然后根据已安装应用提供插件和技能推荐;应用名称会通过你配置的模型和 ClawHub 搜索进行匹配,并且可以使用 wizard.appRecommendations 禁用此步骤。当平台具有受支持的浏览器打开程序时,它会打开已认证的 Control UI 仪表板,并最多等待 60 秒让浏览器客户端连接。这个短暂的交接会赋予该特定已登录浏览器一个持久的 administrator 凭据。这包括安装了 wslview 的无显示 WSL。在无头 Linux、没有打开程序的 WSL 或没有显示器的 SSH 环境下,它会打印一条醒目的可复制粘贴的仪表板 URL,包括用于环回 Gateway 的 SSH 端口转发命令,并最多等待五分钟。连接成功后会在浏览器中继续;无法访问的 Gateway 或超时会回退到与之前相同的终端入口。传入 --tui 可跳过浏览器交接并强制使用该终端入口。
如果在推理成功后应用设置失败,状态会标识为工作区、Gateway 或常规设置失败,而不是 AI 检查失败。详细的错误信息会保留其恢复指导,引导流程会回退到对话式 OpenClaw 聊天以交互方式完成。频道、agent、插件和其他可选功能仍然是 OpenClaw 聊天的领域:运行 openclaw 并使用 open channel wizard for <channel> 将频道凭据收集交给掩码终端向导。要更改模型提供商或其认证方式,请退出 OpenClaw 并运行 openclaw onboard;OpenClaw 不会打开引导式或经典提供商流程。
在已配置的安装中,再次运行 openclaw onboard 会在检测到的连接组中提供当前默认模型。选择它进行验证,该验证不会重新应用设置、重新安装或重启 Gateway 服务。如果该检查失败,已配置的模型保持不变,选择器会等待你的下一次选择。该检查在你的工作区之外运行,因此由工作区插件提供的模型可能在此处失败,但在 agent 中仍然正常工作。使用 openclaw onboard --classic 进行提供商特定的认证、频道、技能、远程 Gateway 设置、导入或完整的 Gateway 控制。对于对话式的非推理设置和修复,运行 openclaw setup;openclaw onboard --modern 是经由相同推理关口的兼容性别名。经典向导可以选择性地使用实时补全来验证默认模型,但 OpenClaw 在其自身的实时推理检查通过之前不会启动。
在交互式终端中,裸 openclaw(不带子命令)根据配置状态路由:
- 如果活动配置文件缺失或没有任何已编写的设置(空文件或仅包含元数据),它将启动引导式初始设置。
- 如果配置文件存在但未通过验证,它将启动带有
openclaw doctor指导的经典初始设置路径。OpenClaw 需要可正常工作的推理能力,并且不用于修复这个预推理状态。 - 如果配置文件有效,它将打开正常的代理 TUI。如果存在一个可访问的、已配置好代理和模型的 Gateway,则会直接进入该 UI,无需初始设置或 OpenClaw。在已配置的安装中,可通过 TUI 内的
/openclaw或openclaw setup访问 OpenClaw。
远程设置复用所选 Gateway 的设备配对,包括通过回环转发的已配置远程连接。其就绪检查不会创建新的设备配对。设置聊天会在回复过程中保持稳定的已认证调用方,包括在回环连接上也是如此。
当交互式远程设置激活推理且 Gateway 需要重启时,初始设置会等待最多 45 秒,等待新的 Gateway 启动并成功完成推理检查,然后才打开设置聊天。与旧 Gateway 的健康连接不视为成功。如果重启等待超时或启动身份缺失,初始设置会报告设置已保存并停止,而不是尝试另一个提供商。请检查远程 Gateway,然后在已连接的终端中重新运行裸 openclaw。如果错误提示 Gateway 未提供启动身份,请先更新并重启该 Gateway。
明文 ws:// 被接受用于回环、私有 IP 字面量、.local 和 Tailnet *.ts.net 的 Gateway URL。对于其他受信任的私有 DNS 名称,请在初始设置进程的环境中设置 OPENCLAW_ALLOW_INSECURE_PRIVATE_WS=1。
重置¶
--reset 是一个破坏性的预分发标志,而不是经典向导的 Setup mode(设置模式)菜单中的选项。--reset-scope 控制它清除多少内容:config(仅配置)、config+creds+sessions(当未指定范围而仅传递 --reset 时的默认值)或 full(同时重置工作区)。在将状态移到废纸篓之前,初始设置会验证 TTY 可用性、重置范围、认证和 Gateway 选项、迁移导入选项,以及完整重置的工作区目标。迁移导入选项不能与 --reset 组合使用;请在不带 --reset 的情况下运行导入。非交互式设置还要求在执行重置前使用 --accept-risk。交互式经典设置在显示其风险确认之前就执行重置,因此调用 --reset 可能会在您无法拒绝该提示之前就将状态移到废纸篓。重置后,命令将根据其他标志运行引导式、经典式或非交互式初始设置。
会话重置会通过与 openclaw reset 相同的清理方式,永久移除规范 SQLite 历史记录及其拥有的存档文件。它会保留认证配置文件和无关的数据库状态。请先停止任何正在运行的 Gateway;当另一个进程占用状态目录时,初始设置会拒绝执行会话清理。
区域设置¶
交互式初始设置使用 CLI 向导的区域设置来显示固定的设置文案。它按以下顺序使用第一个非空值:
OPENCLAW_LOCALELC_ALLLC_MESSAGESLANG- 英语兜底
支持的向导区域设置为 en、zh-CN 和 zh-TW。区域设置值可以使用下划线或 POSIX 后缀形式,例如 zh_CN.UTF-8。产品名称、命令名称、配置键、URL、提供商 ID、模型 ID 以及插件/渠道标签均保持原样。
Control UI 的固定初始设置欢迎语和设置选项使用其连接到 Gateway 时报告的 UI 语言。中文 UI 区域设置使用同一套由源码维护的设置翻译;诸如 yes 和 talk to agent 之类的命令回复保持不变。
OPENCLAW_LOCALE=zh-CN openclaw onboard
OPENCLAW_LOCALE=en openclaw onboard # Explicit English override
非交互式设置¶
--non-interactive 要求使用 --accept-risk(确认代理功能强大,且完全系统访问存在风险)。--mode 默认为 local。
必需的外部插件¶
--accept-risk 并不批准插件能力。如果本地设置需要外部提供商或运行时插件,当该插件需要能力审查时,非交互式初始设置会停止。请审查并预安装所需插件,然后重新运行相同的初始设置命令。对于 OpenAI 设置所使用的官方 Codex 运行时:
# After reviewing the plugin and its declared capabilities:
openclaw plugins install codex --accept-capabilities
openclaw onboard --non-interactive --accept-risk --skip-health \
--auth-choice openai-api-key \
--secret-input-mode ref
在运行此示例之前,请先设置 OPENAI_API_KEY。codex 选择器使用 OpenClaw 的官方插件目录。如果所需插件已安装但需要批准才能启用,请改用 openclaw plugins enable <plugin-id> --accept-capabilities。该标志仅批准该插件操作;它不是全局绕过。同样的先预安装再重新运行的流程也适用于 openclaw channels add 所需的外部插件。随附的插件不需要此审查。请参阅能力同意和自动化指南。
提供商设置示例¶
openclaw onboard --non-interactive --accept-risk --skip-health \
--agent-name robby \
--auth-choice custom-api-key \
--custom-base-url "https://llm.example.com/v1" \
--custom-model-id "foo-large" \
--custom-api-key "$CUSTOM_API_KEY" \
--secret-input-mode plaintext \
--custom-compatibility openai \
--custom-image-input
--custom-api-key 是可选的;如果省略,初始设置会检查环境变量 CUSTOM_API_KEY。OpenClaw 会自动将常见的视觉模型 ID(GPT-4o/4.1/5.x、Claude 3/4、Gemini、Qwen-VL、LLaVA、Pixtral 等)标记为支持图像输入。对于未知的自定义视觉 ID,请传递 --custom-image-input,或传递 --custom-text-input 以强制使用仅文本元数据。对于支持 /v1/responses 但不支持 /v1/chat/completions 的 OpenAI 兼容端点,请使用 --custom-compatibility openai-responses;有效值为 openai(默认)、openai-responses、anthropic。
LM Studio 也有一个提供商专属的密钥标志:
openclaw onboard --non-interactive --accept-risk --skip-health \
--auth-choice lmstudio \
--custom-base-url "http://localhost:1234/v1" \
--custom-model-id "qwen/qwen3.5-9b" \
--lmstudio-api-key "$LM_API_TOKEN"
非交互式 Ollama:
openclaw onboard --non-interactive --accept-risk --skip-health \
--auth-choice ollama \
--custom-base-url "http://ollama-host:11434" \
--custom-model-id "qwen3.5:27b"
--custom-base-url 默认为 http://127.0.0.1:11434。--custom-model-id 是可选的;如果省略,引导配置会使用 Ollama 建议的默认值。kimi-k2.5:cloud 等云端模型 ID 在这里同样适用。
针对现有 llama-server 的非交互式 llama.cpp:
openclaw onboard --non-interactive --accept-risk \
--auth-choice llama-cpp-existing-server \
--custom-base-url "http://127.0.0.1:8080/v1" \
--custom-model-id "my-model" \
--llama-server-api-key "$LLAMA_SERVER_API_KEY"
--auth-choice llama-cpp 则选择受管理的本地服务器。--llama-server-api-key 是可选的;如果省略,引导配置会在环境中检查 LLAMA_SERVER_API_KEY。有关端点替换和认证配置文件行为,请参阅 llama.cpp。
将提供商密钥存储为引用(ref)而不是明文:
openclaw onboard --non-interactive --accept-risk --skip-health \
--auth-choice openai-api-key \
--secret-input-mode ref
使用 --secret-input-mode ref 时,引导配置将新凭据存储为引用(ref)而不是明文:认证配置文件使用 keyRef: { source: "env", provider: "default", id: <envVar> },自定义提供商使用 models.providers.<id>.apiKey(例如 { source: "env", provider: "default", id: "CUSTOM_API_KEY" })。添加新凭据时,请设置提供商环境变量;如果内联密钥标志没有对应的环境变量,将快速失败。现有的可解析命名认证配置文件及其 env、file、exec 或 store 引用会原样复用,不会写入新的 apiKey 或 keyRef,也无需额外的提供商环境变量。现有的明文配置文件凭据不会被迁移;请运行 openclaw secrets configure --apply,然后运行 openclaw secrets audit --check。请参阅密钥管理。
网关认证(非交互式)¶
现有的可信代理认证及其代理策略在重新运行时保持不变,除非您明确选择其他认证模式。在保留可信代理认证的同时选择 Tailscale Funnel 会被拒绝;请使用 --gateway-auth password 明确切换,或保持 Tailscale 暴露关闭。来自同主机的补全(completion)请求通过网关的环回监听器,使用已配置的本地密码(包括 SecretRef)或 OPENCLAW_GATEWAY_PASSWORD。设置完成后的健康检查仍使用已配置的本地网关端口,忽略环境中的网关 URL 和端口覆盖。
- 如果没有认证标志或现有凭据,引导配置会生成一个网关密钥,将其存储为
gateway.auth.token,并设置gateway.auth.mode: "token"。Quickstart 保留其现有的明文存储默认值;--secret-input-mode ref明确要求使用引用。运行openclaw dashboard可打开控制界面。 --gateway-auth token --gateway-token <token>存储提供的明文密钥。--gateway-password <value>选择密码模式,无需 auth-choice 提示;--gateway-auth password也会明确选择密码模式。现有的密码模式配置在重新运行时仍保持密码模式。--gateway-auth token --gateway-token-ref-env <name>将gateway.auth.token存储为环境变量 SecretRef。要求引导配置进程环境中存在同名的非空环境变量。--gateway-token和--gateway-token-ref-env互斥。- 远程引导配置使用
--remote-token <token>或--remote-password <password>作为gateway.remote凭据。--gateway-token、--gateway-token-ref-env和--gateway-password用于配置本地网关认证,在远程模式下无效。对于远程令牌 SecretRef,请设置OPENCLAW_GATEWAY_TOKEN,并使用--remote-token配合--secret-input-mode ref。 - 使用
--secret-input-mode ref时,非交互式--gateway-password和--remote-password需要匹配的OPENCLAW_GATEWAY_PASSWORD,--remote-token需要匹配的OPENCLAW_GATEWAY_TOKEN;引导配置会存储环境变量 SecretRef,并在更改状态之前拒绝缺失或不匹配的值。交互式设置也可以选择已配置的 file、exec 或 store 引用。 - 使用
--install-daemon时:由 SecretRef 管理的gateway.auth.token会被验证,但不会以解析后的明文形式持久化到监管服务(supervisor)的环境元数据中;如果该引用无法解析,安装将以 fail-closed 方式失败,并附上修复指导。如果同时配置了gateway.auth.token和gateway.auth.password,且未设置gateway.auth.mode,安装将一直阻塞,直到显式设置模式为止。 - 本地引导配置会将
gateway.mode="local"写入配置。之后若配置文件缺少gateway.mode,则表明配置损坏或手动编辑不完整,而不是有效的本地模式快捷方式。 - 本地引导配置会确保所选设置路径所需的插件可用(例如 Codex 或 Copilot 运行时)。非交互式设置无法批准新能力;请审查并预安装所需的外部插件,然后重新运行引导配置。远程引导配置仅为远程网关写入连接信息——它绝不会安装本地插件包。
--allow-unconfigured是openclaw gateway run的独立逃生通道;它不允许引导配置跳过gateway.mode。
export OPENAI_API_KEY="your-provider-key"
export OPENCLAW_GATEWAY_TOKEN="your-token"
openclaw onboard --non-interactive --accept-risk --skip-health \
--mode local \
--auth-choice openai-api-key \
--secret-input-mode ref \
--gateway-auth token \
--gateway-token-ref-env OPENCLAW_GATEWAY_TOKEN
本地网关健康检查¶
- 除非您传入
--skip-health,否则引导配置会在成功退出前等待本地网关可达。 --install-daemon首先启动受管理的网关安装路径。如果没有守护进程标志,则本地网关必须已在运行(例如openclaw gateway run)。- 显式的
--skip-daemon或--no-install-daemon会执行一次可达性检查,而不会等待网关启动。如果没有网关在监听,设置会报告网关未启动并以成功状态退出;但可达却不健康的网关仍无法通过健康检查。 - 如果您只想在自动化中写入配置/工作区/bootstrap 文件,
--skip-health可跳过等待。 --skip-bootstrap会设置agents.defaults.skipBootstrap: true,并跳过创建AGENTS.md、SOUL.md、IDENTITY.md、USER.md和BOOTSTRAP.md。- 在原生 Windows 上,
--install-daemon会首先尝试计划任务(Scheduled Tasks);如果创建任务被拒绝,则回退到每用户的启动(Startup)文件夹登录项。
交互式 ref 模式¶
- 在提示时选择 使用密钥引用,然后选择 环境变量 或已配置的密钥提供程序(
file或exec)。 - 引导流程在保存 ref 之前会运行快速的预检验证,并在失败时允许重试。
Z.AI 端点选择¶
Note
--auth-choice zai-api-key 会自动检测最适合您密钥的 Z.AI 端点和模型:Coding Plan 端点优先使用 zai/glm-5.3,如果密钥未公开这些模型,则回退到 glm-5.1,再回退到 glm-4.7;通用 API 端点使用 Z.AI 提供程序的默认值 zai/glm-5.2。若要强制使用 Coding Plan 端点,请直接选择 zai-coding-global 或 zai-coding-cn。
# Promptless endpoint selection
openclaw onboard --non-interactive --accept-risk --skip-health \
--auth-choice zai-coding-global \
--zai-api-key "$ZAI_API_KEY"
# Other Z.AI endpoint choices: zai-coding-cn, zai-global, zai-cn
Mistral:
openclaw onboard --non-interactive --accept-risk --skip-health \
--auth-choice mistral-api-key \
--mistral-api-key "$MISTRAL_API_KEY"
Arcee AI。arcee 提供程序插件提供这两种选择及其标志,因此在非交互式运行引导流程之前,请先安装它:
# Direct (chat.arcee.ai)
openclaw onboard --non-interactive --accept-risk --skip-health \
--auth-choice arceeai-api-key \
--arceeai-api-key "$ARCEEAI_API_KEY"
# Via OpenRouter
openclaw onboard --non-interactive --accept-risk --skip-health \
--auth-choice arceeai-openrouter \
--openrouter-api-key "$OPENROUTER_API_KEY"
其他非交互式标志¶
基于 Token 的模型身份验证(与 --auth-choice token 一起使用):
| 标志 | 说明 |
|---|---|
--token-provider <id> |
签发 Token 的 Token 提供程序 id |
--token <token> |
用于模型身份验证的 Token 值 |
--token-profile-id <id> |
身份验证配置文件 id(默认 <provider>:manual;某些由提供程序拥有的流程使用其自己的默认值,例如 anthropic:default) |
--token-expires-in <duration> |
可选的 Token 过期时长(例如 365d、12h) |
Cloudflare AI Gateway:--cloudflare-ai-gateway-account-id <id>、--cloudflare-ai-gateway-gateway-id <id>。
守护进程安装控制:--no-install-daemon / --skip-daemon(别名;跳过网关服务安装)、--daemon-runtime <node|bun>(默认:node)。Bun 1.4+ 配合 WAL 重置安全的 node:sqlite 是显式选择加入;仍推荐 Node。
技能:--node-manager <npm|pnpm|bun>(默认 npm)、--skip-skills。
UI 和钩子设置:--skip-ui(跳过 Control UI/TUI 提示)、--skip-hooks(跳过 webhook/钩子设置)、--skip-channels、--skip-search。
输出:--suppress-gateway-token-output 会禁用引导式引导流程中自动的 Control UI 交接。经典引导流程从不打印可复用的 Gateway Token 值或带 Token 的 URL;它仍会打印安全的恢复命令。
Note
--json 在引导式或经典引导流程中并不意味着非交互式模式。
如果没有交互式终端,两种引导流程模式都会返回结构化
JSON 错误;用于自动化时请添加 --non-interactive --accept-risk。
使用 --modern 时,JSON 是一次性的 OpenClaw 概览,并在该
单个结果后退出。其他脚本请使用 --non-interactive。无效的现有
配置也会返回一个 JSON 失败;修复指导仍输出到 stderr。
非交互式提供程序设置失败,包括无法访问的本地模型
服务器或缺少凭据,会在 stdout 上返回 JSON 错误并以非零退出
状态退出。如果没有 --json,相同的恢复指导会以可读文本打印。
提供程序预筛选¶
当某个身份验证选择隐含首选提供程序时,引导流程会将默认模型和允许列表选择器预筛选为该提供程序的模型。该筛选器还会匹配由同一插件拥有的其他提供程序,涵盖 coding-plan 变体,例如 volcengine/volcengine-plan 和 byteplus/byteplus-plan。如果首选提供程序筛选器没有返回任何已加载模型,引导流程会回退到未筛选的目录,而不是让选择器保持为空。
网络搜索后续步骤¶
某些网络搜索提供程序会在引导流程期间触发特定于提供程序的后续提示:
- Grok 可以提供可选的
x_search设置,使用相同的 xAI 身份验证和x_search模型选择。 - Kimi 可能会询问 Moonshot API 区域(
api.moonshot.ai与api.moonshot.cn)以及默认 Kimi 网络搜索模型。
其他行为¶
- 本地引导流程 DM 范围行为:CLI 设置参考。
- 最快的首次聊天:
openclaw dashboard(Control UI,无需频道设置)。 - 自定义提供程序:连接任何 OpenAI 或 Anthropic 兼容端点,包括未列出的托管提供程序。使用 未知 兼容性通过实时检查自动检测。
- 如果检测到 Hermes 状态,引导流程会提供迁移流程(参见上文
--flow import)。
常见后续命令¶
稍后使用 openclaw configure 进行有针对性的非推理更改,并使用 openclaw
channels add 进行仅频道设置。对于模型提供程序或身份验证路由更改,
请改为运行 openclaw onboard。
相关¶
- CLI 参考
openclaw setup— 系统代理入口点;单独的setup是交互式的,并在全新系统上回退到引导式引导流程
本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 cl/openclaw