openclaw onboard¶

引导式设置，首先建立推理：它会检测现有 AI 访问，等待你选择提供商，验证该连接，仅持久化可用的路由，然后启动 OpenClaw 以配置其余部分。openclaw setup 在全新系统或存在入门选项时进入此流程；已配置的系统使用不带参数的 openclaw setup 进行系统代理聊天。openclaw setup --baseline 仅写入基线配置/工作区。

CLI 入门中心

交互式 CLI 流程的逐步说明。

入门概览

OpenClaw 入门各部分如何衔接。

CLI 设置参考

输出、内部机制和逐步行为。

CLI 自动化

非交互式标志和脚本化设置。

macOS 应用入门

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、来源和层级；它有意省略不可信的市场文案、模型原因和本地应用标签。在推荐提议被回答后，该命令返回空列表，后续入门运行将完全跳过此步骤。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，除非提供此标志。ID main 未被保留：如果你之后在已命名代理旁边重新创建它，当创建报告旧会话或共享认证所有权仍附加到旧的 main 安装时，请先运行 openclaw doctor --fix。
• --flow quickstart：以最少提示打开经典向导，默认使用生成的 Gateway 密钥，而不要求你选择 token 或 password。现有密码模式配置会被保留。显式本地 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 或 password，二者只能选其一。更改 URL 不会重用已存储凭据，除非你也提供新的 token 或 password。交互式步骤会要求一个 Gateway 密钥，无论远程 Gateway 将其称为 token 还是 password，并将其存储为 gateway.remote.token。凭据保持掩码，并遵循明文或 SecretRef 存储选择。将密钥留空并确认，可保留现有凭据。若要无需共享密钥连接，请将其留空，如果提供保留现有凭据的选项则拒绝，然后明确确认是否在没有 Gateway 密钥的情况下继续？。引用存储在询问引用之前提供相同的确认。
• --modern 是 OpenClaw 对话式设置助手的兼容性别名。它使用与 openclaw setup 相同的实时推理门控，并且仅接受 --workspace、--agent-name、--accept-risk、--non-interactive 和 --json。其他设置标志会被拒绝，而不是被静默忽略。

引导式流程¶

直接运行 openclaw onboard 会启动引导式流程。它会显示安全通知，在没有名册时询问第一个智能体的名称，然后预先询问一个发现性问题：完全访问（推荐——设置会自动查找 AI 应用、密钥和本地运行时）或先询问（设置会在查找前询问一次，或允许你手动配置）。该选择会持久保存为 wizard.accessMode。

在允许发现的情况下，引导流程会检测已通过配置的模型、API 密钥环境变量以及受支持的本地 CLI 可用的 AI 访问方式。检测仅提供选项；它不会运行实时推理、安装插件、选择模型或持久保存凭据。

标记为设置与实用工具的提供商（如 Apple Foundation Models）会被验证并保存为 utilityModel，而不会替换主模型。在新安装中，它驱动 OpenClaw 设置助手；在打开常规智能体聊天之前，请选择单独的主模型。添加实用工具模型时，现有的主模型和凭据保持不变。

在共享选择器中选择检测到的连接或任何受支持的提供商。所选连接会运行一次真实的补全。如果失败，将显示错误，选择器会等待你的下一个选择。取消会停止尝试，而不会尝试另一个提供商。

提供商选择器包含已安装和可安装的官方提供商。选择 More… 可查看其他提供商组；区域、套餐和认证方式随后会出现在第二个菜单中。受支持的浏览器或设备登录以及掩码 API 密钥或令牌方法使用相同的实时补全路径。测试成功后，OpenClaw 仅持久保存已验证的模型路由及其凭据；失败的候选不会替换已配置的模型，也不会保存尝试过的凭据。

在本地引导中，暂时跳过会准备指定智能体的工作区及本地 Gateway 配置，然后退出，且不会启动 Gateway 或 AI 聊天。当你准备连接 AI 时，重新运行 openclaw onboard；中断的基础设置会在其原有的引导所有者下继续。

在引导模式下，--workspace <dir> 提供 OpenClaw 建议的工作区和隔离的推理上下文。在你批准 OpenClaw 设置建议之前，它不会被持久保存。经典和非交互式引导会通过其正常设置流程持久保存工作区。工作区必须是目录或目录下的新路径；文件、非目录祖先、悬空符号链接或符号链接循环会在设置或重置之前被拒绝，并指出失败的路径。其他检查失败（如权限错误）会被报告，而不会被当作缺少目录处理。指向现有目录的符号链接（包括其下的新路径）是允许的。在已有智能体名册的情况下重新运行时，引导会保留已配置的舰队工作区：经典向导会显示两个路径，并要求在移动前明确确认；而非交互式设置会发出警告并保留当前值。对于明确管理的多智能体舰队，提供商设置会更新已配置系统智能体的模型和别名，而不会替换舰队范围的模型默认值或其他智能体的模型。

推理通过后，引导会检查受支持的本地 AI 工具中的记忆：Claude Code 自动记忆、Codex 合并记忆以及 Hermes 记忆文件。如果找到任何记忆，一个页面会提供选项，将其复制到智能体工作区的 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 聊天以交互方式完成。频道、智能体、插件和其他可选功能仍属于 OpenClaw 聊天的范畴：运行 openclaw 并使用 open channel wizard for <channel> 将频道凭据收集移交给掩码终端向导。要更改模型提供商或其认证方式，请退出 OpenClaw 并运行 openclaw onboard；OpenClaw 不会打开引导式或经典提供商流程。

在已配置的安装中，再次运行 openclaw onboard 会在已检测连接组中提供当前默认模型。选择它可进行验证，而不会重新应用设置、重新安装或重启 Gateway 服务。如果该检查失败，已配置的模型保持不变，选择器会等待你的下一个选择。该检查在你的工作区之外运行，因此由工作区插件提供的模型可能会在此失败，但仍可在智能体中正常工作。

使用 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 的设备配对，包括通过 loopback 转发的已配置远程连接。其就绪探测不会创建新的设备配对。设置聊天会在回复之间保持稳定的已认证调用方，包括在 loopback 连接上。

当交互式远程设置启用推理且 Gateway 需要重启时，入门流程会等待最多 45 秒，直到新的 Gateway 启动并成功通过推理检查，然后才打开设置聊天。与旧 Gateway 的健康连接不算数。如果重启等待超时或启动标识缺失，入门流程会报告设置已保存并停止，而不是尝试其他提供商。检查远程 Gateway，然后在已连接的终端中重新运行不带子命令的 openclaw。如果错误提示 Gateway 未提供启动标识，请先更新并重启该 Gateway。

对于 loopback、私有 IP 字面量、.local 以及 Tailnet *.ts.net 网关 URL，接受明文 ws://。对于其他受信任的私有 DNS 名称，请在入门流程进程环境中设置 OPENCLAW_ALLOW_INSECURE_PRIVATE_WS=1。

重置¶

openclaw onboard --reset
openclaw onboard --reset --reset-scope full

--reset 是一个破坏性的预分发标志，而不是经典向导的 设置模式 菜单中的一个选项。--reset-scope 控制它移除多少内容：config（仅配置）、config+creds+sessions（在传入 --reset 但未指定范围时的默认值）或 full（还会重置工作区）。在将状态移动到废纸篓之前，入门流程会验证 TTY 可用性、重置范围、身份验证和 Gateway 选项、迁移导入选项，以及完整重置的工作区目标。迁移导入选项不能与 --reset 组合使用；请在不带 --reset 的情况下运行导入。非交互式设置也要求在重置前使用 --accept-risk。交互式经典设置会在显示其风险确认之前执行重置，因此调用 --reset 可能会在你拒绝该提示之前将状态移动到废纸篓。重置后，该命令会根据其他标志运行引导式、经典或非交互式入门。

会话重置会通过与 openclaw reset 相同的清理过程，永久删除规范 SQLite 历史及其拥有的归档文件。它会保留身份验证配置文件和无关的数据库状态。请先停止任何正在运行的 Gateway；当另一个进程拥有状态目录时，入门流程会拒绝进行会话清理。

区域设置¶

交互式入门使用 CLI 向导区域设置用于固定设置文案。它会按以下顺序使用第一个非空值：

1. OPENCLAW_LOCALE
2. LC_ALL
3. LC_MESSAGES
4. LANG
5. 英语回退

支持的向导区域设置为 en、zh-CN 和 zh-TW。区域设置值可以使用下划线或 POSIX 后缀形式，例如 zh_CN.UTF-8。产品名称、命令名称、配置键、URL、提供商 ID、模型 ID 以及插件/频道标签保持原样。

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 是可选的；如果省略，引导设置会检查 env 中的 LLAMA_SERVER_API_KEY。有关端点替换和身份验证配置行为，请参阅 llama.cpp。

将提供程序密钥存储为引用而不是明文：

openclaw onboard --non-interactive --accept-risk --skip-health \
  --auth-choice openai-api-key \
  --secret-input-mode ref

使用 --secret-input-mode 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。请参阅 密钥管理。

网关身份验证（非交互式）¶

• 如果没有身份验证标志或现有凭据，引导设置会生成一个网关密钥，并将其存储为 gateway.auth.token，同时设置 gateway.auth.mode: "token"。快速入门保留其现有的明文存储默认值；--secret-input-mode ref 显式请求引用。运行 openclaw dashboard 打开 Control UI。
• --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 存储为 env SecretRef。要求引导设置进程环境中存在该名称的非空环境变量。
• --gateway-token 和 --gateway-token-ref-env 互斥。
• 远程引导设置使用 --remote-token <token> 或 --remote-password <password> 作为 gateway.remote 凭据。--gateway-token、--gateway-token-ref-env 和 --gateway-password 用于配置本地网关身份验证，在远程模式下无效。对于远程 token 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；引导设置会存储 env SecretRef，并在更改状态之前拒绝缺失或不匹配的值。交互式设置还可以选择已配置的 file、exec 或 store 引用。
• 使用 --install-daemon 时：由 SecretRef 管理的 gateway.auth.token 会被验证，但不会以已解析的明文形式持久化到 supervisor 服务环境元数据中；如果引用无法解析，安装会失败关闭并提供修复指导。如果同时配置了 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 会首先启动受管理的网关安装路径。如果没有 daemon 标志，本地网关必须已经在运行（例如 openclaw gateway run）。
• 显式 --skip-daemon 或 --no-install-daemon 会执行一次可达性探测，而不会等待 Gateway 启动。如果没有监听，设置会报告网关未启动并成功退出；可访问但不健康的网关仍会导致健康检查失败。
• 如果你只想在自动化中写入 config/workspace/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 文件夹登录项。

交互式引用模式¶

• 在提示时选择 使用密钥引用，然后选择 环境变量 或已配置的密钥提供程序（file 或 exec）。
• 引导流程在保存引用之前会运行快速预检验证，并允许你在失败时重试。

Z.AI 端点选择¶

# 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 一起使用）：

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）。使用支持 WAL 重置安全的 node:sqlite 的 Bun 1.4+ 是显式选择加入；Node 仍是推荐选项。

技能（Skills）：--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 交接。经典模式从不打印可复用的网关 Token 值或令牌化 URL；它仍会打印安全的恢复命令。

提供商预过滤¶

当某个认证选择隐含首选提供商时，引导流程会将默认模型和允许列表选择器预过滤为该提供商的模型。该过滤器也会匹配同一插件拥有的其他提供商，涵盖诸如 volcengine/volcengine-plan 和 byteplus/byteplus-plan 之类的 Coding 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。

openclaw channels add
openclaw configure
openclaw agents add <name>

相关¶

• CLI 参考
• openclaw setup — 系统智能体的入口点；单独执行 setup 是交互式的，在新系统上会转入引导模式