跳转至

CLI 参考

本文档介绍分步引导的接入行为、输出结果及内部机制。 如需完整演示,请参阅接入引导(CLI)。完整的 CLI 标志参考(所有 --flag、非交互示例、特定提供方的命令), 请参阅 openclaw onboard。

向导的作用

全新本地引导式接入会显示一行指向 安全指南的提示,以及一个选择:快速开始或 自定义设置。快速开始会记录安全确认;自定义设置 会显示完整的安全说明并要求确认。快速开始会复用检测到的 AI 访问配置、验证该配置、保存配置,并以前台 Gateway 打开 Web 仪表盘。它使用代理名称 main 和完全访问权限, 将遥测同意保持为未设置状态,并跳过路由确认、记忆导入 和应用推荐。Ctrl+C 停止 Gateway 但不会移除配置; openclaw gateway install 可稍后启用后台运行。

自定义设置保留完整的引导提示。如果快速开始未找到可用 路由,则继续手动提供方设置和其余引导步骤, 包括 Gateway 服务安装。快速开始对代理名称 (main)、访问模式(完全访问)和遥测(同意未设置)的默认值保持不变。 请参阅引导默认值。

经典向导(openclaw onboard --classic)在本地模式下会引导你完成:

  • 工作区位置和引导文件
  • 模型与认证设置(Anthropic、OpenAI Code 订阅 OAuth、xAI、OpenCode、自定义端点以及更多提供方自有的认证流程)
  • Gateway 设置(端口、绑定、认证、Tailscale)
  • 频道与提供方(Discord、飞书、Google Chat、iMessage、Mattermost、Microsoft Teams、QQ 机器人、Signal、Slack、Telegram、WhatsApp 以及其他内置或插件频道)
  • Web 搜索提供方(可选)
  • 技能设置
  • 守护进程安装(LaunchAgent、systemd 用户单元或原生 Windows 计划任务(含启动文件夹回退))
  • 健康检查

远程模式会将本机配置为连接到其他位置的 Gateway。它不会 在远程主机上安装或修改任何内容。

本地流程详情

以下步骤描述经典向导。引导式快速开始路径已在 上文描述。

1. 设置模式

  • 若未配置默认模型,菜单包含 快速开始(推荐)(默认)以及 手动设置。
  • 若已配置默认模型,保留现有模型配置会出现在首位并成为默认选项, 其后依次为 快速开始(推荐)和 手动设置。 显式的非 skip --auth-choice 或单个提供方凭据 标志仍会在不更改现有默认模型的情况下配置该提供方, 除非该提供方要求你选择模型。多个提供方 标志需要显式指定 --auth-choice。
  • 当存在迁移提供方时,从其他代理导入会出现在 上述设置选项之后。选择它会打开提供方列表, 其中包含从 Claude 导入、从 Codex 导入和 从 Hermes 导入等条目。检测到的来源会首先显示其路径; 其他可用提供方会要求输入来源路径。显式导入标志 会直接执行导入并跳过此菜单。在导入开始前,可从 提供方列表使用“返回”回到设置模式。
  • 重新运行向导不会清除任何内容,除非你传入 --reset。 Reset 是一个命令标志,不是设置模式选项。
  • --reset-scope 接受 config(仅配置)、 config+creds+sessions(默认)或 full(还会移除工作区)。 在将状态移至废纸篓之前,该命令 会验证 TTY 可用性以及可拒绝的 CLI 选项。非交互式 设置也必须在重置前传入 --accept-risk。交互式经典 设置会在显示风险确认之前执行重置;拒绝 该提示不会撤销已执行的重置。
  • 迁移导入选项(--flow import、--import-from、 --import-source 和 --import-secrets)不能与 --reset 组合使用;请在未使用 --reset 的情况下运行导入。
  • 若未使用 --reset,无效配置或旧版密钥会停止向导, 并要求你先运行 openclaw doctor 再继续。

2. 风险确认

  • 首次运行会要求你确认代理功能强大,且完全 系统访问存在风险。向导将确认信息存储在 wizard.securityAcknowledgedAt 中,因此后续运行不会再次询问。
  • 交互式运行会显示确认提示;拒绝则取消设置。
  • --non-interactive 要求传入 --accept-risk,若 缺少该标志则报错退出。
  • 交互式经典设置会在此提示之前执行 --reset。在重置后拒绝 不会恢复已移至废纸篓的状态。

3. 工作区

  • 默认 ~/.openclaw/workspace(可配置)。
  • 提示和 --workspace 会拒绝文件、非目录祖先、 悬空符号链接以及工作区路径或其任何祖先上的 符号链接循环,并标识出失败的路径。其他检查失败(例如 权限错误)会被报告,但不会视为目录缺失。 缺失目录和指向现有目录的符号链接是允许的。
  • 种子工作区文件用于首次运行的引导。
  • 重新运行时,现有代理名册会保留其全范围工作区, 除非你明确确认移动。非交互式重新运行会发出警告并保留 当前值。
  • 工作区布局:代理工作区。

4. 模型与认证

5. Gateway

  • 提示输入端口、绑定、密钥存储和 Tailscale 暴露。
  • 默认在令牌模式下生成 Gateway 密钥,而不会询问你 选择令牌还是密码。现有的密码模式配置会被保留。 使用 --gateway-auth password 或 --gateway-password <value> 可显式选择密码。Tailscale Funnel 仍要求使用密码模式。
  • 即使对于环回地址,也保持共享密钥认证启用,以便本地 WS 客户端必须进行身份验证。
  • 对于生成的密钥,交互式设置提供:
  • 生成/存储明文密钥(默认)
  • 使用 SecretRef(可选加入)
  • 经典快速开始会复用现有的 gateway.auth.token SecretRef(来自 env、file、exec 或 store 提供方)用于其检查和仪表盘 交接。未解析的已配置引用会以修复指引停止接入, 而不会静默削弱 Gateway 认证。
  • 显式或现有的密码模式也支持明文或 SecretRef 存储。
  • 非交互式令牌 SecretRef 路径:--gateway-token-ref-env <ENV_VAR>。
  • 要求在接入进程环境中存在非空环境变量。
  • 不能与 --gateway-token 组合使用。
  • 仅在你完全信任每个本地进程时才禁用认证。
  • 非环回绑定仍要求认证。

6. 频道

  • WhatsApp:可选二维码登录
  • Telegram:机器人令牌
  • Discord:机器人令牌
  • Google Chat:服务账号 JSON + webhook 受众
  • Mattermost:机器人令牌 + 基础 URL
  • Signal:可选 signal-cli 安装 + 账号配置
  • iMessage:imsg CLI 路径 + Messages 数据库访问;当 Gateway 在非 Mac 上运行时,使用 SSH 包装器
  • 其他捆绑安装或单独安装的频道插件可以添加各自的引导步骤。请参阅完整的频道目录。
  • DM 安全:默认为配对模式。第一条 DM 会发送一个验证码;通过 openclaw pairing approve <channel> <code> 批准,或使用允许列表。

7. Web 搜索

  • 选择提供商(Brave、Codex Hosted Search、DuckDuckGo、Exa、Firecrawl、Gemini、Grok、Kimi、MiniMax Search、Ollama Web Search、Parallel、Perplexity、SearXNG 或 Tavily),或跳过。
  • 使用 --skip-search 跳过此步骤;稍后可使用 openclaw configure --section web 重新配置。

8. 技能

  • 读取可用技能并检查要求。
  • 让您选择节点管理器:npm、pnpm 或 bun。
  • 当所需的安装程序可用时,为受信任的捆绑技能安装可选依赖项。
  • 跳过不可用的 Homebrew、uv 和 Go 安装程序,然后将受影响的技能与手动设置指南分组。安装缺失的前置条件后运行 openclaw doctor。

9. 守护进程安装

  • macOS:LaunchAgent
  • 需要已登录的用户会话;对于无头环境,请使用自定义 LaunchDaemon(不随附)。
  • 通过 WSL2 的 Linux 和 Windows:systemd 用户单元
  • 向导尝试执行 loginctl enable-linger <user>,以便注销后网关保持运行。
  • 可能会提示输入 sudo(写入 /var/lib/systemd/linger);它会先尝试不使用 sudo。
  • 原生 Windows:首选计划任务
  • 如果任务创建被拒绝,OpenClaw 将回退到每用户启动文件夹登录项并立即启动网关。
  • 计划任务仍然是首选,因为它们提供更好的监督状态。
  • 运行时选择:Node 是主要、默认和推荐的运行时。支持 WAL 重置安全 node:sqlite 的 Bun 1.4+ 可作为明确的选项使用。QuickStart 会报告安装计划选择的运行时,包括在仅 Bun 的首次安装中无受支持 Node 时选择 Bun。
  • SecretRef 管理的 gateway.auth.token 会在不将其解析后的明文值复制到监督服务元数据的情况下进行验证。未解析的令牌引用会阻止守护进程安装,并提供修复指导。
  • 如果 gateway.auth.token 和 gateway.auth.password 同时存在而 gateway.auth.mode 未设置,守护进程安装将阻塞,直到您明确选择一种模式。

10. 健康检查

  • 启动网关(如需要)并运行 openclaw health。
  • openclaw status --deep 将实时网关健康检查添加到状态输出中,包括受支持时的频道检查。

11. 完成

  • 摘要和后续步骤,包括 iOS、Android 和 macOS 应用选项。

Note

如果未检测到 GUI,向导会打印 Control UI 的 SSH 端口转发说明,而不是打开浏览器。 如果 Control UI 资源缺失,向导会尝试构建它们;后备方案是 pnpm ui:build(自动安装 UI 依赖项)。

远程模式详情

远程模式将本机配置为连接到其他位置的 Gateway。它不会在远程主机上安装或修改任何内容。

您需要设置的内容:

  • 远程网关 URL(ws://... 或 wss://...)
  • 一个 Gateway 密钥(令牌或密码),或明确确认在没有共享密钥的情况下连接

1. 发现(可选)

如果 dns-sd(macOS)或 avahi-browse(Linux)可用,引导过程会先提供搜索 Bonjour/mDNS 网关信标的选项,然后再回退到手动输入 URL。配置后也会尝试广域网 DNS-SD 发现。文档:Gateway discovery、Bonjour。

2. 连接方式

选择信标后,选择直接 WebSocket 或 SSH 隧道: - 直接连接:通过 wss:// 连接,并提示信任发现的 TLS 指纹(首次使用信任固定;仅在您接受时固定)。 - SSH 隧道:打印一条使用已解析的 Gateway 服务端口的 ssh -N -L 18789:127.0.0.1:<gateway-port> <user>@<host> 命令,在通告时附带 -p <ssh-port>。先运行该命令,然后连接到 ws://127.0.0.1:18789 的本地隧道端点。

3. 身份验证

在 Gateway secret 中输入配置的令牌或密码。Gateway 接受任一线路字段;交互式设置将密钥存储为 gateway.remote.token,可选地以 SecretRef 而非明文形式存储。要在没有共享密钥的情况下连接,请将其留空,如果提供现有凭据则拒绝保留,并确认 在没有 Gateway 密钥的情况下继续?。引用存储在询问引用之前提供该确认。

Note

如果网关仅限回环且不可发现,请手动使用 SSH 隧道或 tailnet。对于回环、私有 IP 字面量、.local 和 Tailnet *.ts.net URL,接受明文 ws://;其他私有 DNS 名称需要 OPENCLAW_ALLOW_INSECURE_PRIVATE_WS=1。

身份验证和模型选项

如果在交互式引导过程中某个提供商设置步骤失败(例如没有本地登录的 CLI 复用选项),向导会显示错误并返回提供商选择器,而不是退出。显式 --auth-choice 运行仍然会为自动化快速失败。

下面的模型默认值和提供商支持说明描述的是 v2026.9.3。模型默认值随产品基线变动,如果您使用的是不同版本,请查看 Models。

Anthropic API 密钥

如果存在 ANTHROPIC_API_KEY 则使用它,否则提示输入密钥,然后将其保存供守护进程使用。

Anthropic Claude CLI

交互式引导/配置中的首选本地路径;在可用时复用现有的 Claude CLI 登录。

Anthropic 设置令牌

支持由 claude setup-token 创建的长期有效令牌。在引导过程中选择 Anthropic setup-token,或之后使用 openclaw models auth 进行管理。

OpenAI Code 订阅(OAuth)

浏览器流程;粘贴 code#state。

在全新设置且没有主模型时,会通过 Codex 运行时将 agents.defaults.model 设置为 openai/gpt-6-astra。

OpenAI Code 订阅(设备配对)

使用短期有效设备代码的浏览器配对流程。

在全新设置且没有主模型时,会通过 Codex 运行时将 agents.defaults.model 设置为 openai/gpt-6-astra。

OpenAI API 密钥

如果存在 OPENAI_API_KEY 则使用它,否则提示输入密钥,然后将凭据存储在认证配置中。

在全新设置且没有主模型时,会将 agents.defaults.model 设置为 openai/gpt-6-astra。纯直接 API 的 openai/gpt-5.6 别名仍然受支持,并解析到同一层级。

添加或重新认证 OpenAI 会保留现有显式主模型,包括 openai/gpt-5.5。如果账户未提供 GPT-5.6, 请显式选择 openai/gpt-5.5;OpenClaw 不会静默降级。

xAI(Grok)OAuth

适用于符合条件的 SuperGrok 或 X Premium 账户的浏览器登录。这是大多数用户推荐的 xAI 路径。OpenClaw 会为 Grok 模型、Grok web_search、x_search 和 code_execution 存储生成的认证配置。

xAI(Grok)设备代码

使用短代码而非 localhost 回调的远程友好型浏览器登录。请从 SSH、Docker 或 VPS 主机使用此方式。

xAI(Grok)API 密钥

提示输入 XAI_API_KEY,并将 xAI 配置为模型提供商。当你希望使用 xAI Console API 密钥而不是订阅 OAuth 时,请使用此方式。

OpenCode

提示输入 OPENCODE_API_KEY(或 OPENCODE_ZEN_API_KEY),并让你选择 Zen 或 Go 目录(一个 API 密钥同时覆盖两者)。 设置 URL:opencode.ai/auth。

API 密钥(通用)

为你存储密钥。

Vercel AI Gateway

提示输入 AI_GATEWAY_API_KEY。 更多详情:Vercel AI Gateway。

Cloudflare AI Gateway

提示输入账户 ID、网关 ID 和 CLOUDFLARE_AI_GATEWAY_API_KEY。 更多详情:Cloudflare AI Gateway。

MiniMax

配置会自动写入。托管默认值为 MiniMax-M3;API 密钥设置使用 minimax/...,OAuth 设置使用 minimax-portal/...。 更多详情:MiniMax。

StepFun

对于中国或全球端点上的 StepFun 标准版或 Step Plan,配置会自动写入。 标准版当前包括 step-3.5-flash,Step Plan 还包括 step-3.5-flash-2603。 更多详情:StepFun。

Synthetic(Anthropic 兼容)

提示输入 SYNTHETIC_API_KEY。 更多详情:Synthetic。

Ollama(云端和本地开放模型)

首先提示选择 Cloud + Local 或 Local only。 对于没有本地 Ollama 主机的托管模型,请改为选择 Ollama Cloud(--auth-choice ollama-cloud)。 基于主机的模式会提示输入 base URL(默认 http://127.0.0.1:11434),发现可用模型,并建议默认值。 Cloud + Local 还会检查该 Ollama 主机是否已登录以进行云端访问。 更多详情:Ollama。

Moonshot 和 Kimi Coding

Moonshot(Kimi K2)和 Kimi Coding 配置会自动写入。 更多详情:Moonshot AI (Kimi + Kimi Coding)。

自定义提供商

支持 OpenAI 兼容、OpenAI Responses 兼容和 Anthropic 兼容端点。 API base URL 必须使用 http:// 或 https://;其他 URL 方案会在验证前被拒绝。

交互式引导支持与其他提供商 API 密钥流程相同的 API 密钥存储选项: - 现在粘贴 API 密钥(明文) - 使用 secret 引用(env 引用或已配置的 provider 引用,并进行预检验证)

引导过程会为常见视觉模型 ID(GPT-4o/4.1/5.x、Claude 3/4、Gemini、Qwen-VL、LLaVA、Pixtral 及类似模型)推断图像支持,并仅在模型名称未知时询问。

非交互式标志: - --auth-choice custom-api-key - --custom-base-url - --custom-model-id - --custom-api-key(可选;回退到 CUSTOM_API_KEY) - --custom-provider-id(可选) - --custom-compatibility <openai|openai-responses|anthropic>(可选;默认 openai) - --custom-image-input / --custom-text-input(可选;覆盖推断的模型输入能力)

跳过

保持认证未配置。

模型行为:

  • 从检测到的选项中选择默认模型,或手动输入提供商和模型。
  • 当引导从提供商认证选择开始时,模型选择器会自动优先选择该提供商。对于 Volcengine 和 BytePlus,相同偏好 也会匹配它们的 coding-plan 变体(volcengine-plan/*、 byteplus-plan/*)。
  • 如果该首选提供商筛选结果为空,选择器会回退到完整目录,而不是不显示任何模型。
  • 向导会运行模型检查,并在配置的模型未知或缺少认证时发出警告。

凭据和配置路径:

  • 代理本地认证配置(API 密钥、令牌和 OAuth):~/.openclaw/agents/<agentId>/agent/openclaw-agent.sqlite(auth_profile_store)。
  • 共享认证配置:~/.openclaw/state/openclaw.sqlite;代理本地配置会覆盖此回退基础。旧安装会将共享存储保留在主代理数据库中,直到 openclaw doctor --fix 将其迁移。
  • 仅用于旧版导入:auth-profiles.json、每个代理的 auth.json 以及 ~/.openclaw/credentials/oauth.json。运行 openclaw doctor --fix 将它们导入 SQLite;新登录不会写入这些文件。

路径遵循 $OPENCLAW_STATE_DIR。有关共享存储和代理本地行为,请参阅 身份验证凭据语义。

凭据存储模式:

  • 默认引导设置行为会将 API 密钥以明文值持久化到身份验证配置文件中。
  • --secret-input-mode ref 启用引用模式,而不是明文密钥存储。 在交互式设置中,你可以选择以下任一方式:
  • 环境变量引用(例如 keyRef: { source: "env", provider: "default", id: "OPENAI_API_KEY" })
  • 已配置的提供方引用(file 或 exec),包含提供方别名 + id
  • 交互式引用模式在保存前运行快速预检验证。
  • 环境变量引用:验证变量名 + 当前引导设置环境中的非空值。
  • 提供方引用:验证提供方配置并解析所请求的 id。
  • 如果预检失败,引导设置会显示错误并允许你重试。
  • 在非交互模式下,--secret-input-mode ref 仅为新凭据创建基于环境变量的引用。
  • 添加新凭据时,请在引导设置进程环境中设置提供方环境变量。
  • 内联密钥标志(例如 --openai-api-key)要求设置该环境变量;否则引导设置会快速失败。
  • 现有可解析的命名身份验证配置文件会被原样复用,包括现有的 env、file、exec 和 store 引用;不会写入新的 apiKey 或 keyRef,也不需要额外的提供方环境变量。
  • 对于新的自定义提供方凭据,非交互式 ref 模式会将 models.providers.<id>.apiKey 存储为 { source: "env", provider: "default", id: "CUSTOM_API_KEY" }。
  • 在该自定义提供方情况下,--custom-api-key 要求设置 CUSTOM_API_KEY;否则引导设置会快速失败。
  • 现有明文配置文件凭据保持不变;引用模式不会迁移它们。运行 openclaw secrets configure --apply,然后运行 openclaw secrets audit --check。请参阅 密钥管理。
  • Gateway 设置默认在 token 模式下生成密钥。交互式存储 选项为 生成/存储明文密钥(默认)或 使用 SecretRef。 现有密码模式、--gateway-auth password 或 --gateway-password <value> 使用密码存储,支持明文或 SecretRef。
  • 非交互式 token SecretRef 路径:--gateway-token-ref-env <ENV_VAR>。
  • 指定的环境变量在引导设置进程中必须非空。 --gateway-token 与 --gateway-token-ref-env 互斥。
  • 现有明文设置将继续保持不变地工作。

无头与服务器设置

在 Gateway 主机 上运行身份验证设置,使用与 Gateway 相同的操作系统用户和状态目录。通过 SSH 时,请使用交互式终端:

openclaw configure --section model

选择你的提供方支持的身份验证方式。对于浏览器 OAuth 流程,请在本地浏览器中打开显示的 URL,并在提示时将重定向 URL 或授权代码粘贴回 Gateway 主机上的终端。如果提供方提供设备代码登录,请在本地浏览器中完成显示的 URL/代码,同时 Gateway 主机的登录进程等待。完成的登录会将凭据以 SQLite 形式持久化到该主机上;无需交接凭据文件。

对于特定代理,请在 Gateway 主机上运行 openclaw models auth login --provider <id> --agent <agentId>。请参阅 Models CLI 和 OAuth。

对于无人值守设置,请使用提供方 API 密钥配合 非交互式引导设置。如果使用 --secret-input-mode ref,请确保所引用的环境变量对 Gateway 服务和引导设置进程均可用。请参阅 身份验证。

在 Gateway 主机上使用 openclaw models status 验证结果(对于特定代理,请添加 --agent <agentId>)。远程客户端引导设置仅配置本地客户端连接;它不会在服务器上设置提供方凭据。不要复制 auth-profiles.json 或替换 SQLite 数据库来转移登录。

输出与内部实现

~/.openclaw/openclaw.json 中的典型字段:

  • agents.defaults.workspace
  • 当传入 --skip-bootstrap 时,agents.defaults.skipBootstrap
  • 当所选提供方需要时,agents.defaults.model 和提供方配置
  • tools.profile(本地引导设置在未设置时选择 "full",包括重新运行时;显式配置和其他工具策略会被保留)。完整工具选择并不等同于 Full Access 执行权限。请参阅 工具配置。
  • gateway.*(mode、bind、auth、tailscale)
  • session.dmScope(引导设置会保留显式值,否则保持未设置,因此 main 默认值会将所有渠道的直接消息保留在代理的滚动主会话中——这是个人代理的默认值。对于共享或多用户收件箱,请使用 per-channel-peer;当 openclaw security audit 检测到多用户 DM 流量时,会建议隔离)
  • channels.telegram.botToken、channels.discord.token、channels.matrix.*、channels.signal.*、channels.imessage.*
  • 在提示期间选择加入时,会启用渠道允许列表。Discord、Matrix、Microsoft Teams 和 Slack 在可能时将名称解析为 ID;其他渠道直接接受其原生 ID。
  • skills.install.nodeManager
  • setup --node-manager 标志接受 npm、pnpm 或 bun。
  • 手动配置之后仍可以设置 skills.install.nodeManager: "yarn"。
  • wizard.lastRunAt
  • wizard.lastRunVersion
  • wizard.lastRunCommit
  • wizard.lastRunCommand
  • wizard.lastRunMode
  • wizard.securityAcknowledgedAt

openclaw agents add 会写入 agents.entries.* 和可选的 bindings。

WhatsApp 凭据位于 ~/.openclaw/credentials/whatsapp/<accountId>/ 下。 活动会话和转录存储在 ~/.openclaw/agents/<agentId>/agent/openclaw-agent.sqlite 中。 ~/.openclaw/agents/<agentId>/sessions/ 目录用于旧版迁移输入以及归档/支持工件。

Note

某些渠道以插件形式提供。在设置过程中选择时,向导会先提示安装插件(npm 或本地路径),然后再进行渠道配置。

已安装应用推荐

模型访问检查成功后,macOS 上的经典交互式入门会扫描应用名称和 bundle ID,而不会请求 macOS 隐私权限。它会搜索官方插件目录和 ClawHub,然后要求已配置的模型拒绝错误的名称匹配,并推荐相关的插件或技能。默认仅选择来自官方插件目录的推荐匹配项;可选匹配项和所有 ClawHub 技能都需要显式选择。

结果屏幕会列出检测到的应用,并显示:“应用名称使用你配置的模型和 ClawHub 搜索进行了匹配。”将 wizard.appRecommendations 设置为 false 可禁用此入门步骤以及 Gateway 对节点应用清单的访问。Quick start、classic QuickStart 或非 macOS 入门不会使用该扫描。

非交互式设置

--non-interactive 需要 --accept-risk(确认代理功能强大,且完全系统访问存在风险):

openclaw onboard --non-interactive --accept-risk --skip-health \
  --auth-choice apiKey \
  --anthropic-api-key "$ANTHROPIC_API_KEY"

--mode 默认为 local。--json 会更改输出格式,但不表示非交互式模式。完整的标志语义和 Gateway SecretRef 示例,请参见 openclaw onboard。特定提供商的脚本位于 CLI 自动化。

Gateway 向导 RPC

  • wizard.start
  • wizard.next
  • wizard.cancel
  • wizard.status

客户端(macOS 应用和 Control UI)可以渲染步骤,而无需重新实现入门逻辑。

当设置准入繁忙时,wizard.start 和模型设置启动/激活方法会返回 UNAVAILABLE,并带有 details.code: "SETUP_ADMISSION_BUSY"。这意味着请求的操作尚未开始:客户端可以放弃该次尝试,并在竞争的设置完成后允许显式重试。向导的终止 error 也会结束该操作,但不意味着之前的写入已被回滚。通用请求失败、超时、断开连接以及缺少向导都不能确定设置是否已运行;客户端必须保留这种不确定性,而不是自动重试或声称激活成功。

如果 Gateway 重启导致内存中的模型设置向导丢失,Control UI 会刷新已保存的模型和提供商状态。已配置的模型可供显式验证并继续设置;如果没有配置,提供商选项将再次可用,而无需等待旧向导的截止时间。刷新失败会保留恢复保护,并可通过 再次检查 重试。恢复永远不会重放之前的登录或回答,不会将已保存的模型视为验证成功,也不会要求删除设置状态。支持配置热重载的模型设置会在不重启 Gateway 的情况下生效。

Signal 设置行为

  • 从官方 signal-cli GitHub 发布下载相应的发布资产(原生构建,仅限 Linux x86-64)
  • 在其他平台(macOS、非 x64 Linux)上,改为通过 Homebrew 安装
  • 将发布资产安装存储在 ~/.openclaw/tools/signal-cli/<version>/ 下
  • 在配置中写入 channels.signal.transport.cliPath,并设置 kind: "managed-native"
  • 尚不支持原生 Windows;请在 WSL2 中运行入门以获取 Linux 安装路径

本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 cl/openclaw