开始使用

v2026.8.1:安装和入门

OpenClaw 现在为新的 Mac、Linux 和 Windows installs 提供了从下载到第一次有用对话的更清晰路径,而 iPhone、iPad 和 Android 将配对和权限放在人们需要的地方。引导式设置可以重复使用受支持的订阅、API 密钥和已可用的 本地模型 ,在保存之前验证所选模型,并在连接准备就绪时将其移交给 Web 应用程序或终端。

安装OpenClaw

支持的安装路径 现在使应用程序或命令在安装后可用。从下载或磁盘映像打开的 Mac 应用程序可以将自身移动到应用程序中,在其中更新和登录时启动可以正常工作。在 Linux 和其他 Unix 系统上,安装程序使 openclaw 在新的终端会话中可用,而不要求您手动编辑 shell 启动文件。

在任何更改之前,将停止未经身份验证而暴露 OpenClaw 的网络安装。当准备取消或失败时,重新安装还可以保护现有的工作设置,并在报告是否可达之前为 OpenClaw 提供启动时间。

来源和完整变更列表

改进

  • 安装临时 macOS 在应用程序中启动 #104661
  • feat(docker):在运行时镜像中安装openssh-client #131710
  • 以简单语言阐明入门引导安全指南 #120172

错误修复

  • 防止新鲜状态网关启动超时 #111701
  • 在模型运行时准备期间保持网关启动响应 #112262
  • 添加用于载入的安全网关令牌恢复 #118051
  • 安装后保持 OpenClaw 在新的 Unix shell 中可用 #124779
  • 在交互式登录中尊重远程标志 #111517
  • 切换到令牌身份验证时删除过时的远程密码 #112544
  • 在网关准备就绪后让首次启动环回 CLI 调用连接 #114380
  • 避免规范内部挂钩的首次启动延迟 #117493
  • 在加入期间进行外部网关监督 #119846
  • H非交互式设置期间的网关密码 #126690
  • 加入远程网关密码验证 #126768
  • 修复:取消安装重新安装时保留网关#130617
  • fix:跨设置共享托管网关启动准备情况 #130682
  • fix(安装):防止低内存安装后 OOM #132555
  • fix(cli):网关重启后完成远程登录 #133257
  • 防止管道安装程序子进程消耗安装脚本 #87799
  • 阻止未经身份验证的网络网关服务安装#98022
  • 更新新的CLI安装到Node 22.22.2 #104073
  • 在安装服务之前等待网关警告 #104173
  • 验证所选运行时映像中的 Docker 时区 #116153
  • 避免登录失败导致 shell 完成权限错误 #125263
  • 在网关副作用之前保留配置更改 #125751
  • fix(安装程序):避免从 Linux 软件包存储库 #130369 预发布 Node
  • fix(安装程序):避免在源安装 #130900 后重新启动网关两次
  • fix:避免守护程序安装 #132206 中的冷 SecretRef 验证停止

文档

  • 正确的README设置指南和贡献者头像尺寸#113547
  • 简化 README 的首次设置 #118376
  • 添加 ChromeOS 和 Crostini 安装指南 #107663
  • 停止告诉托管安装程序用户登录两次 #125246
连接订阅、API 密钥或本地模型

引导式设置 现在开始查找您可能已经拥有的 AI 访问权限。它可以重复使用经过验证的 Codex、ChatGPT 或 Claude CLI 登录,接受 API 密钥,运行支持的提供商自己的登录,或查找合格的 Ollama 和 LM Studio 模型,然后证明确切的选择可以在保留该模型和凭证之前回答。已在计算机上运行的访问可以成为设置的一部分,而不是其他需要配置的内容。

对于 OpenAI 帐户,设置使用登录帐户实际可以访问的模型,同时保留您自己配置的路由,管理员可以准备受支持的 本地模型 以及实时进度。查找或下载本地模型只是开始,因此受支持的本地模型屏幕不会显示开始聊天,直到该确切选择通过激活。

来源和完整变更列表

改进

  • 默认全新 OpenAI 设置为 GPT-5.6 #103581
  • 将提供商登录添加到入门引导 #104502
  • 从 Control UI 配置模型提供程序 #106490
  • 在入门引导期间发现已安装的本地模型 #108605
  • 将引导模型设置添加到 Control UI #108868
  • 验证来自Control UI的当前模型连接 #109183
  • 在引导引导期间更喜欢更强的本地模型 #109250
  • 添加进程内本地GGUF文本推理#109444
  • 使用Gemma 4作为RAM-门控llama.cpp默认#109585
  • 添加统一的AI设置建议#109681
  • 跨设置表面的流提供程序准备进度 #109764
  • 自动使用精益工具曲面来验证本地模型 #110596
  • 在Web和macOS #113476上添加一键本地模型设置
  • 添加已验证的 LM Studio 和本地模型载入 #116606
  • 将 node-llama-cpp 替换为托管 llama-server #123105
  • 改进 macOS 设备代码登录 #104766
  • 将 macOS AI 连接选择与 CLI 载入 #107642 对齐
  • 澄清提供商凭证设置和 CLI 登录恢复 #108739
  • 报告在指导设置期间安装的 Pi 和 OpenCode 工具 #109624
  • 刷新 DeepSeek、Together 和 Venice 设置默认值 #113973
  • 默认全新 Cerebras 设置为 Gemma 4 31B #114015
  • 跨设置和发现统一 Ollama 模型检查 #115879
  • 打开聊天前验证 llama.cpp 设置 #116308
  • 简化已配置本地模型的恢复 #117165
  • Scope 入门引导模型浏览至所选提供商 #125373
  • 在首次运行设置期间跳过放弃的工作区加载 #126967
  • 更快的首次运行模型检测 #127053

错误修复

  • 制作新鲜 AI 入门引导可靠且透明 #103962
  • 在全新 Mac 设置期间重复使用 Codex CLI 登录 #104150
  • 在引导引导期间恢复分组提供商登录 #107038
  • Harden OpenAI 加入和 Crestodian 切换 #107041
  • 在设置检测期间保持网关健康状况响应 #110625
  • 无配置网关上的解锁模型设置 #111841
  • 入门引导期间需要可行的导入和本地 AI 路由 #112028
  • 防止登录崩溃并优先考虑订阅登录 #112378
  • API-key 加入后显示帐户可用的 OpenAI 模型 #114258
  • Fix OpenAI 模型发现和安装包载入 #114288
  • 使 Ollama 和 LM Studio 上线可靠 #114405
  • 保持本地模型发现、重试和云超时正确 #114582
  • 指导Control UI用户通过不可用的AI设置#115716
  • 当没有可用模型时,将模型设置作为主要恢复操作 #116079
  • 选择可用的 GitHub Copilot 入门模型 #116590
  • Route Google 通过支持的身份验证设置 #116611
  • 荣誉Ollama模型和拉式完成合约#117171
  • 激活设置期间准备的确切本地模型 #119050
  • 在 macOS #120782 上完成 ChatGPT 订阅设置
  • OpenCode 入门选择可用模型并保留编码工具 #121414
  • Make Ollama 引导设置选择并验证工作模型 #123190
  • 将llama.cpp默认上下文提高到64K #123701
  • 完成 macOS Codex 设置和帐户模型发现 #124829
  • 当设置扫描长时间运行时检测 CLI 模型登录 #125114
  • 重启后保持Claude CLI OAuth可用 #125471
  • Scope 入门引导模型与所选提供商 #126427 挂钩
  • 修复:保留 Claude CLI 身份验证本机 #129052
  • fix(人为):本机 Claude 模型显示不正确的可用性 #129346
  • fix(auth):使 Codex 注销恢复可操作 #130866
  • 修复:模型设置激活后恢复身份验证和聊天 #133106
  • 保留 GitHub Copilot 设备登录退避 #103434
  • 停止暂停 GitHub Copilot 代币兑换 #104488
  • 查找存储在提供者别名 #106736 下的模型探测凭据
  • 在入门引导期间完成 Codex OAuth 切换 #107174
  • 删除重复的 Codex 提供商设置选项 #107979
  • 保留全新安装 ChatGPT OAuth 凭据 #108617
  • 防止 Codex 登录查找挂起 TUI #109452
  • 在提供商身份验证期间忽略空白环境凭据 #109691
  • 让Ollama设置继续过去损坏的本地模型#109895
  • 停止声称工具支持损坏的 Ollama 模型 #109921
  • fix(onboarding):停止推荐工具安装程序无法激活#109951
  • 模型检查失败时停止广告Ollama工具#109971
  • 允许 OpenAI OAuth 代币交换在假 IP 代理 #110096 后面
  • 保留失败的登录重试,以免覆盖工作设置 #111558
  • 浏览器回调后让OpenAI模型登录退出 #112211
  • 在停滞发现期间保持 Control UI 设置响应 #112338
  • 停止停滞Microsoft通过挂起登录进行 Foundry 设备代码登录#112369
  • 在加入期间重复使用主动Codex API-密钥身份验证#112770
  • 保持网页模型下载进度更新 #113613
  • 刷新提供商入门模型默认值 #113870
  • 在帐户访问中保留 OpenAI 入门选择 #114356
  • 防止 Doctor 中出现错误的提供者故障#114533
  • 保留载入推理探针的内存中会话#115452
  • 在载入期间保留选定的 Ollama 模型功能 #115467
  • 通过激活 #115704 保持已验证的 Codex 设置处于活动状态
  • 制作Gemini CLI设置恢复可操作#115835
  • 重试Ollama无需重新启动向导即可进行设置#116210
  • 坐标设置和模型设置写入#116940
  • 停止刮擦Gemini CLI OAuth证书#117167
  • 在设置过程中仅使用加载的 LM Studio 模型 #117919
  • 检测可达Ollama入门引导期间的服务#118020
  • 删除不受支持的 Google 身份验证和配额指导 #118034
  • 避免负载闲置Ollama指导设置期间的模型#118183
  • 在引导设置过程中检测运行 LM Studio 且未加载模型 #119134
  • 在已安装的本地恢复提供程序身份验证TUI模式#119283
  • 使固定macOS AI入门视觉效果和钥匙串后备#120907
  • 修复无身份验证本地模型和提示模板错误处理#121790
  • 制作macOS入门引导候选人行完全可点击#121928
  • 显示可重试错误AI访问检测超时#121940
  • 删除重复的 GPT-5.6 选择器条目 #122178
  • 在模型设置对话框中保留长 OAuth 设置链接 #122892
  • fix(openai):返回格式错误的 OAuth 代币 JSON #122962 的结构化故障
  • 无法登录时显示已配置的模型 #123130
  • 从模型设置中完成 Codex 测试和使用 #123141
  • 在 CLI 设置过程中选择最小的可用本地 Ollama 模型 #123382
  • 在提供商授权后保持模型设置处于活动状态 #123418
  • 在脚本化 macOS 载入过程中读取 Claude CLI 钥匙串身份验证 #123839
  • fix(系统代理):在本地模型设置探针中留出推理空间 #124405
  • 无效回调后保持OpenRouter登录等待#124922
  • 将加入提供商元数据范围保持在选定的提供商 #125379
  • 显示准确的 OpenAI OAuth 恢复状态,无需屏蔽提供程序故障 #125515
  • fix(tui):当会话提供程序为 CLI-backed #125677 时,本地 /auth 退出 1,且不进行任何诊断
  • 使 llama-server 身份验证更改可重现 #126498
  • 在加入期间将 OpenRouter API 密钥与 OpenRouter 一起保留 #126578
  • fix(ui):对于新客户端,模型设置停留在“检查此网关”#127695
  • fix(ollama):推迟本地服务查找直到流创建 #128399
  • fix(ui):在检查 AI 访问 #128636 时保持模型设置可见
  • fix(macos):允许冷 ChatGPT Codex 探头 #128819
  • fix(代理):保留设置CLI模型分辨率#129128
  • fix(入门):OpenAI 安装程序安装不匹配的 Codex 插件 #129195
  • fix:报告本机 Claude CLI 模型可用 #129332
  • fix(ollama):取消的云设置继续并返回凭据 #129541
  • fix(板载):保留清单等效别名验证 #129590
  • fix(板载):拒绝不可用的所需运行时间 #129855
  • fix(ollama):当模型检查不可用时保留广告上下文和工具 #130000
  • fix(llama-cpp):在设置过程中停止推荐失败模型 #130136
  • fix(人为):防止退役的 Claude CLI 配置文件破坏设置 #130225
  • fix(ollama):当检查没有返回任何结果时,云模型从发现中消失 #130240
  • fix:荣誉新鲜供应商目录发现#130412
  • fix(ollama):保留本地设置并跳过嵌入聊天默认值 #130459
  • 修复(设置):将取代的目录刷新视为激活成功#130795
  • 修复(设置):在第一个代理创建期间保留经过验证的推理#132472
  • 清理OpenAI Codex OAuth回调和过时的提示#89491
  • 接受助手管理Claude CLI验证#97492
  • 在入门引导期间省略空的提供商请求设置aad9974
  • Bound MiniMax OAuth 具有 30 秒超时的请求 #102862
  • 停止GitHub Copilot设备登录无限期挂起#103255
  • 抑制显式启用插件的信任警告 #104097
  • 展示OpenRouter OAuth准确否认错误#105448
  • 清理 GitHub Copilot 登录轮询侦听器 #106453
  • 从指导入门引导候选人中删除占位符文本 #110084
  • 发布Ollama响应后建立连接#111802
  • 解释如何从 GitHub Copilot 403 错误中恢复 #112025
  • 遵循 Azure 设备代码登录窗口#113741
  • 刷新 Qianfan 载入默认值并隔离 OpenAI 实时测试 #113999
  • 干净地拒绝格式错误的 OpenAI OAuth 令牌响应 #120685
  • 使用选择的 Codex 运行时修复提供程序密钥测试 #121500
  • 让用户在 macOS 入门引导期间切换 AI 候选人 #121613
  • 制作Codex入门引导容忍继承的加载程序路径#122731
  • 之后停止错误的缺少身份验证警告API按键输入#122756
  • 与 OpenAI 设置身份验证选择保持一致 #124729
  • 重试瞬态首次运行模型检测 #125212
  • 停止虚假提供商设置警告 #125523
  • 识别环境CLI登录以查看配置的模型可用性#125772
  • Fix Web UI 提供程序探测直接凭据 #125816
  • 在非交互式入门期间停止错误的插件警告#126734
  • 修复:报告本机Claude CLI授权状态#129364
  • 修复:干净退役Claude在医生健康之前进行身份验证#129375
  • fix(llama-cpp):现有服务器设置首先选择现成的模型 #129509
  • fix(ollama):尽管有明确的非思考能力,但设置还是选择了一个巨大的模型 #129611
  • 修复(ollama):允许使用任何已安装的本地模型重置设置#129934

文档

  • docs(入门):在设置指南中保留所选模型 #128547
开始你们的第一次对话

成功的设置现在直接移交给 第一次对话 。图形 Mac、Linux 和 Windows 会话可以打开 Web 应用程序,而 SSH 和其他无头设置提供带有端口转发指令的经过身份验证的链接,并保持终端聊天可用。

从那里,设置对话可以完成支持的技能和网络搜索配置,然后提供外部渠道作为可选的下一步,而不是首次使用的另一个先决条件。经典向导在没有 AI 的情况下仍然可以继续,因为其实时模型检查仍然是可选的。

来源和完整变更列表

改进

  • 引导式 CLI 设置在保存之前验证 AI 访问 #101880
  • 推荐已安装应用程序的插件和技能 #109668
  • 引导本地托管流程 #109841
  • 引导 macOS 加入后添加浏览器优先切换 #110054
  • 添加对话式托管人入门引导 #110141
  • 坚持入门引导建议并缩短首次运行身份设置 #110173
  • 使用实时选项卡添加键入的入门引导问题 #110242
  • 代理的第一次聊天中的全新设置 #110331
  • 扩展浏览器入门并刷新应用程序建议 #110484
  • 向托管人聊天添加丰富的设置控件 #114631
  • 配置技能和网页搜索里面问OpenClaw #115130
  • 在询问中指导本地网关配置 OpenClaw #115363
  • 首次运行模型设置后指导可选通道设置 #116078
  • 在入门引导期间命名第一个客服人员 #123521
  • 添加选择加入无钥匙 Firecrawl 搜索和更丰富的搜索控件 #97078
  • 让用户命名新代理 #112009
  • 澄清网络搜索设置选择 #112199
  • 在入门应用程序扫描期间显示实时进度 #112414
  • 生成时约束系统代理规划器 JSON #113482
  • 提供可选工作区文件,没有错误的缺失警告 #114559

错误修复

  • 使网关加入推理优先且路由安全 #102883
  • 使对话设置在本地模型上实用 #109445
  • 在 macOS 载入中显示可操作选项卡 #110584
  • 让保管人健康状况远离托管向导答案 #111430
  • 使首次运行的浏览器登录可靠 #111465
  • 按工作区隔离入门引导建议 #111560
  • 将新的代理舱口连接到正在运行的网关 #122210
  • 使指导代理凭据与创建保持一致 #126096
  • 终端频道设置内返回导航 #108007
  • 在设置聊天中需要十进制菜单编号 #108140
  • 返回设置推理修复聊天 #109938
  • Make 设置向导复制按钮可在普通 HTTP #110139
  • Align Ask OpenClaw 成帧和确认默认值 #111263
  • 在已验证的路由上保留系统代理模型更改 #111431
  • 跳过设置时立即退出登录 #112165
  • Label 加入字段和掩码 Matrix 凭证 #112233
  • 在验证的 TUI 启动期间避免目录准备 #113136
  • 全新安装查找外部搜索插件并执行第一个任务 #114327
  • 在载入过程中等待真正的新浏览器 #117431
  • 在网关安装进度中保持通道设置移动 #117877
  • 报告设置期间浏览器启动失败 #117979
  • 入门引导切换之前构建 Control UI #118038
  • 在载入和配对期间显示剪贴板故障 #118651
  • fix(tui):退出回退之前关闭设置网关 #121183
  • 恢复开发网关名册上的设置聊天 #121784
  • 分割系统代理聊天所有权并保留切换状态 #121884
  • 在网关的 OpenClaw CLI #122765 上保持代理引导
  • 托管人通道设置检查失败时添加恢复 #124680
  • 在无显示中打开浏览器切换 WSL #124704
  • 安全完成引导代理创建 #125768
  • fix(板载):浏览器启动失败后恢复手动切换 #130272
  • 拒绝插件设置中的无效数值 #107346
  • 在入门推荐说明中保留表情符号 #110401
  • 在设置向导中跳过空白区域设置覆盖 #111076
  • 为新指定特工保留首轮舱口 #111553
  • 在设置下保留系统维护 #111686
  • 停止从淹没狭窄终端的载入进度旋转器 #112413
  • 应用时显示设置取消提示一次 #113731
  • 继续跳过-UI 引导式入门设置 #118737
  • 在设置过程中接受代理名称 #124740
  • 在引导式入门引导中保留指定代理 #126365
  • 在引导引导中保持令牌抑制 #126580
  • fix(ollama):启动本地聊天服务 #128034
  • fix(机载):范围舱口超时到初始转弯#130010
  • fix(板载):引导设置后连接终端舱口 #130082
  • fix(入门):--skip-bootstrap 仍创建身份文件 #130153
  • 修复:为Web和终端用户提供正确的代理切换指导#131646
  • fix(板载):在指导设置中启用默认挂钩 #131894

文档

  • 文档询问 OpenClaw 网关和内存向导 #115487
  • 刷新文档英雄并完成快速启动网格#102880
  • Align 经典入门文档 #124712
  • 更正文档中的经典入门步骤顺序 #125454
在 Mac、Windows 和 Linux 上设置 OpenClaw

在 Mac 上,主指南直接指向应用程序,即使旧的启动或清理工作较晚完成,您选择的本地或远程网关仍保持选中状态。该应用程序等待本地网络提示和合法的首次运行数据升级,在继续之前验证确切的远程网关,并仅在连接准备就绪时打开仪表板。

在 Windows 上,指南指向最新签名的 x64 和 Arm64 Hub 安装程序。 PowerShell 安装程序现在可以正确识别受支持的 Node 运行时,并且可以在 Winget 安装 Node.js 后在同一会话中继续。 Windows Hub 独立更新,因此其独立稳定版本可以比 OpenClaw 版本中包含的镜像更新。

在 Linux 上,桌面设置可以修复或重新安装 OpenClaw、直接或通过 SSH 连接到本地或远程网关、验证计算机上已有的合格 AI 访问权限,并恢复中断的激活。直接证书固定连接在桌面应用程序内仍然不可用。

来源和完整变更列表

改进

  • 缩短 macOS 入门引导并移交给托管人 #117921
  • macOS AI 设置后立即打开仪表板 #120950
  • feat:将 Linux 桌面登录引入 macOS 奇偶校验 #129815
  • 让 macOS 入门使用更高的窗口 #104004
  • improve(安装程序):减少Windows Git克隆下载#130908

错误修复

  • 使 macOS AI 加入跟随连接的网关 #102637
  • 打开已配置网关的 macOS 仪表板 #102677
  • 使新的macOS本地设置启动并可靠地激活#108764
  • 使 macOS 入门权限在短屏幕上滚动 #112507
  • Gate macOS 网关身份验证远程登录 #117904
  • 解锁 macOS 首次启动网关设置 #119831
  • 让首次运行的macOS网关迁移完成#121012
  • 在共享状态迁移期间恢复 macOS 载入 #121313
  • fix(linux):真实安装失败、安装后修复以及可在桌面伴侣 #128614 中重新安装
  • fix(linux):首次运行桌面启动自动连接工作AI #129211
  • fix(state):在启动检查点表 #129850 之前规范地引导新状态
  • fix(桌面):保留跨模型激活的入门并重新启动 #131757
  • 在 macOS 载入期间启动现有的 CLI 网关 #104051
  • 让提前返回macOS入门引导并澄清丢失的CLI恢复#104705
  • 防止 macOS 载入安装程序输出挂起 #104827
  • 防止剪辑和停顿 macOS 载入 #107598
  • 拒绝 macOS #112161 上的公共明文网关配置文件
  • 通过网关进度步骤保持 macOS 设置轮询 #114383
  • 减少macOS入门引导时闲置的CPU使用#115896
  • 保持 macOS 登录等待本地网络权限 #120859
  • 在网关启动期间等待并发首次运行迁移 #120959
  • macOS 上线时显示网关启动失败原因 #121306
  • 将 macOS 配置文件登录保留在其托管的 CLI #121651 内
  • 在稳定网关端口上隔离命名配置文件 #122751
  • 报告终端 macOS 网关启动失败及时 #126697
  • 在远​​程 macOS 加入期间自动安装 CLI #126723
  • 隔离 macOS 配置文件并报告直接网关端点 #127007
  • 在本地网关故障后恢复 macOS 远程登录 #127033
  • 在网关更改后保持首次运行的 macOS 登录可见 #127038
  • fix(macos):切换连接模式时保留远程隧道 #127665
  • 修复:macOS载入等待网关重新启动#127713
  • fix(mac):在延迟本地故障后保持远程网关连接 #127723
  • fix(macos):使 OpenClaw 设置窗格响应 #128177
  • fix(macos):当网关启动失败时保持CLI安装完成#128350
  • fix(macos):显示正确的首次运行载入进度 #129435
  • fix(macos):在 API 密钥验证期间确认关闭登录 #129447
  • fix(macos):在载入时选择支持的 Node 版本 #129564
  • fix(macos):停止远程登录安装本地网关 #129572
  • fix(macos):显示保存失败而不是无休止的载入加载#129959
  • fix(板载):为未更改的端点保留远程网关 TLS 引脚 #131042
  • fix(ui):当托管CLI缺失#131974时恢复
  • 保持 Swift 设备配对与旧网关兼容 #80656
  • 防止 Windows 安装程序中的错误 Node 拒绝 #106252
  • winget 安装后继续 Windows 设置 Node.js #106862
  • macOS 加入期间正确的命名配置文件网关指导 #121614
  • fix(macos):防止陈旧模式开关停止新网关 #127609
  • fix(mac):保持节点服务与最新连接模式一致 #127732
  • fix(macos):解决网关已运行时的入门安装提示 #128273
  • fix(macos):停止将损坏的网关可执行文件报告为就绪 #129453
  • fix(linux):当网关重新启动时保持首次运行登录活动 #129502
  • fix(macos):CLI 安装后暂停的网关设置失去恢复 #129566
  • 修复:在验证现有 AI 连接 #129790 时,macOS 安装程序关闭而不发出警告
  • 修复:macOS登录重试以静默方式重新检查失败的AI连接#129863
  • fix(macos):入门设置行忽略空白区域中的点击 #130273
  • fix(板载):SSH隧道提示使用HTTPS用于TLS网关#130313
  • fix(安装程序):引脚 NodeSource RPM 存储库 #132286
  • 正确macOS远程网关URL指导#98548
  • macOS CLI #98631 中的自定义配置路径
  • 当 macOS 应用程序在登录时启动时保留自定义 OpenClaw 配置文件 #99752

文档

  • 将Windows用户指向最新的独立集线器安装程序#104774
  • Link macOS 登录应用程序下载 #111361
  • docs(安装):正常应用程序安装的 Surface 桌面应用程序下载链接 #127991
在 iPhone、iPad 和 Android 上设置 OpenClaw

移动设置现在将 QR 和设置代码配对放在首位,因为这是大多数人无论如何都试图找到的内容,而发现的网关以及手动主机和凭据输入仍然可用。安全的官方配对显示手机是否具有完全访问权限或受限访问权限,并且与另一台计算机的未加密连接会自动保持受限访问。

在 iPhone 和 iPad 上,当连接已受信任或与代码匹配时,有效设置 QR 现在可以在一次扫描中配对并打开主 UI,而不受信任的连接仍会停止等待批准。 OpenClaw 在请求本地网络访问之前解释了配对,让您一次决定一个可选权限,并为符合条件的管理员提供专门的设置对话以进行网关设置和修复,而无需在普通聊天中暴露该特权助手。

在 Android 上,配对在横向、窄屏幕和较大的系统文本中仍然可用。公共网关可以使用正常的证书检查,而 LAN 和 IP 连接保持显式固定,并且再次配对会保留保存的位置和通知选择,而不是悄悄更改同意;撤销的权限仍然被撤销,Google Play 版本仍然仅使用前台位置。

来源和完整变更列表

改进

  • 具有显式限制模式的完全访问移动配对 #105928
  • 放置iOS网关QR配对前置和中心#106111
  • Guide iOS 通过配对和权限首次启动 #106129
  • 使 Android 网关配对在“设置”中突出显示 #106211
  • 添加 Android 系统信任和手动网关固定 #110976
  • 为iOS添加OpenClaw设置助手#112420
  • 使iOS入门引导连接状态清除#101921
  • 刷新访问状态屏幕的本机翻译 #106260

错误修复

  • 替换死端 iOS 网关连接 #103289
  • 在 TLS 检查期间保留 Android 网关主机名 #105072
  • 使 Android 入门在横向和大文本中响应 #108405
  • 配对后保持最新 iOS 设置连接 #108779
  • 使用大文本保持 Android 入门操作可到达 #111747
  • 将 Android 连接到粘贴的网关主机和端口 #113722
  • fix(网关):停止挂起安全链接创建 #128545
  • fix(android):防止不可用的SMS重新打开入门引导审批#129077
  • fix(android):在载入过程中保留后台位置 #129543
  • fix(android):保留通知转发同意#129715
  • fix(android):在登录过程中保留禁用的位置同意 #129961
  • fix(android):序列化旧网关发现#131001
  • fix(ios):一步完成QR配对 #131267
  • 允许 Android 入门权限文本换行 #103649
  • 在重新连接期间保持 iOS 网关错误可见 #105875
  • fix(android):跳过范围IPv6发现地址#130165
  • fix(ios):停止将不完整的网关设置归咎于设备存储 #130407
  • 在 iOS 加入期间重点关注丢失的网关凭证 #98189

文档

  • 从本机节点配对中分离手机浏览器恢复 #123767
移动、导入或重置现有设置

来自 Claude、Codex 和 Hermes 的导入现在发生在临时暂存区域中,其中 OpenClaw 在激活新设置之前会验证或修复模型路线。如果源、导入计划或目标在此过程中发生变化,升级就会停止,而不是根据不同的数据重播半完成的导入。

重新运行入门引导会保留您已经使用的工作区,除非您批准移动,并且指定代理通过支持的创建和仅配置重置来保留他们拥有的凭据。 OpenClaw 在重置之前验证提供程序、网关、迁移和工作区选择,可以将现有数据移动到垃圾箱,但有效确认的重置仍然具有破坏性。

来源和完整变更列表

改进

  • 在发布迁移之前暂存 #112798
  • 允许安全地重复使用 main 作为代理 ID #123609

错误修复

  • Make 失败的 Hermes 导入导入可重试 #103290
  • 导入当前 Hermes 状态和提供商合同 #106758
  • 删除状态之前验证载入重置 #111348
  • 在配置的默认代理上保留加入效果 #112738
  • 状态初始化后允许首次运行导入 #122967
  • 与自己的代理#123871保持多代理CLI操作
  • fix(板载):保留提供者凭据与指定的第一代理#127572
  • 在 Codex 载入期间保留插件所有权 #103372
  • 重新运行载入时保留网关设置 #111569
  • 在重新运行载入期间保留现有代理工作区 #111787
  • 在快速入门载入期间启用显式网关选项 #112396
  • 隔离非默认网关工作区和技能 #114487
  • 在迁移期间保留旧模型限制 #114983
  • 无头复位期间保护 OpenClaw 状态 #116491
  • 保留当前模型时尊重显式提供商身份验证 #117883
  • 荣耀网关 CLI 手动上线时的设置 #122961
  • 让载入导入在运行时状态初始化中幸存 #123106
  • 迁移旧版 Ollama 配置文件以进行引导式设置 #123341
  • Doctor 处理显式多代理配置文件,不会出现错误故障 #124010
  • 全新安装时停止幻像身份验证迁移通知 #124929
  • 集团代理进口经典入门引导#126515
  • 载入内存导入失败时显示可重试错误 #126738
  • 在载入期间尊重配置的系统代理 #126861
  • fix(doctor):迁移后保留 Claude CLI 覆盖可选择 #126866
  • 荣誉提供商凭据,同时保留现有模型 #126946
  • fix:在入门引导期间保留旧工作区 #127059
  • fix(板载):在配置重置期间保留命名代理配置文件 #127716
  • fix(板载):提供商设置更改了托管队列中的错误代理模型 #128119
  • fix(migrate-claude):重新运行 Claude 迁移会重复导入的指令 #130429
  • fix:医生跳过每个代理旧模型参考 #130725
  • fix(配置):添加自定义提供程序时保留现有的主要模型 #131034
  • fix(配置):跨提供商身份验证覆盖保留主要模型 #131119
  • 在 Claude CLI 迁移期间保留 Anthropic 模型设置 #103622
  • 阻止迁移配置导入中的原型污染 #106116
  • 在载入迁移期间处理非目录路径 #109161
  • 在加入期间重置每个客服人员的会话历史记录 #112610
  • 当载入配置不可读时保护默认工作区 #114110
  • 复位丢失时拒绝复位范围 #115554
  • Hide 空 Matrix 全新安装时的迁移噪音 #122808
  • 在配置中保留系统代理工作区所有权 #125377
  • 将遗留模型参考警告指向Doctor的迁移命令#125660
  • 在创建的代理上保留命名载入状态 #126463
  • fix(板载):当 --import-from 未知时命名可用的提供商 #127780
  • fix(stepfun):重复载入时保留选定的模型 #129045
  • fix(板载):保留保存的技能包管理器#130438
自动设置和从中断中恢复

非交互式加入 现在会在创建代理或写入配置之前拒绝无效的提供程序、身份验证、网关、工作区和冲突的流程选择。当请求 --json 时,失败会返回一个机器可读的结果,而不是空的或混合的输出,并且在已知当前持有者的情况下,同一配置文件的并发设置会很快失败,而不是坐在那里看起来冻结。

取消或中断的设置会撤销过时的工作,而失败的提供商登录或本地模型准备可以重试,而无需取消新的尝试。网关运行状况故障保留在带有原始诊断和恢复提示的设置内,但 --json 不会放弃风险确认,并且故意跳过服务启动仍然可以在没有可访问网关的情况下完成,因此自动化必须检查报告的运行状况,而不是仅信任退出状态。

来源和完整变更列表

改进

  • 按照一项安全顺序进行设置和医生维修 #114375
  • 在托管设置中添加一键取消 #118953

错误修复

  • 恢复仪表板并中断的首次设置 #118388
  • 使中断的登录安全地取消、重试和恢复 #121415
  • 将运行状况检查失败保留在设置流程中 #126758
  • fix(ui):防止中断的模型设置阻止重试 #127657
  • 在安装程序写入之前拒绝无效的入门选项 #111680
  • 在基线设置期间保留无效配置 #112010
  • 网关重新启动后恢复过期的设置向导 #112286
  • 恢复新鲜的非交互式入门引导 #113601
  • 在创建设置状态之前验证非交互式载入 #114823
  • 保持托管设置退出以停止网关 #115671
  • 取消后防止重复远程设置 #115856
  • 在网关配置重新加载期间保持托管向导处于活动状态 #120582
  • 序列化入门和插件安装 #121482
  • 锁定释放失败后网关设置恢复 #121915
  • 终端向导状态后允许替换设置 #122054
  • 当另一个入门会话处于活动状态时快速失败 #122968
  • 让故意未启动的网关完成上线 #123857
  • 通过 Ctrl-D 彻底取消载入或关闭标准输入 #124780
  • 在 JSON 摘要中报告登录运行状况故障 #126801
  • 在远程加入中拒绝本地网关凭据 #127015
  • fix(板载):针对一个故障停止打印两条矛盾的修复行 #127698
  • fix(板载):在没有有效的customBindHost的情况下拒绝--gateway-bind自定义#127779
  • fix(板载):JSON命令在没有终端的情况下不返回输出#129437
  • fix(cli):当现有配置无效时发出 JSON 失败 #129578
  • refactor(system-agent):统一操作员切换和提案生命周期 #131630
  • 完成后允许立即更换设置向导 5c308e0
  • 在完成向导会话之前释放设置许可 f3e1efe
  • 拒绝未知的非交互式入门引导身份验证选择 #111409
  • 在自动加入期间忽略空白工作区输入 #115537
  • 拒绝矛盾的非交互式 TUI 入门引导 #115573
  • 拒绝冲突的自定义模型输入标志 #115595
  • 在本地加入期间拒绝仅远程标志 #115636
  • 当请求的守护程序安装失败时加载失败 #122845
  • 防止工作区设置失败发布入门引导配置 #124092
  • 从环境载入中拒绝命令形状的 API 密钥 #126776
  • 拒绝忽略的入门引导建议操作选项 #126973
  • 使入门引导身份验证选择帮助匹配接受的值 #127030
  • fix(板载):在选项验证失败时发出 JSON #127794
  • fix(板载):针对剩余的非交互式选项拒绝发出 JSON #127976
  • fix(入门):保留 JSON 输出以拒绝设置选项 #128542
  • fix(板载):拒绝无效的提供商选择,而没有静默成功 #128574
  • fix(cli):使托管网关和 Node 恢复提示可操作 #129243
  • fix(节点):损坏的 Node 服务建议修复网关 #129545
  • fix(入门):恢复提示针对错误的网关#129577
  • fix(设置):因无效基线配置 #129867 发出 JSON 失败
  • fix(onboarding):缺少ESM包错误省略修复提示#130159
  • fix(onboarding):远程重试提示省略所需的风险确认 #130174
  • fix(cli):针对拒绝的入门引导推荐选项 #130245 返回 JSON 错误
  • 修复(板载):远程设置不再启用本地挂钩#130292
  • fix(doctor):停止将延迟创建的会话目录标记为缺失 #130704
  • fix(向导):需要文字 true 进行确认 #131238

文档

  • 修复非交互式入门命令示例 #121954
  • 正确的载入命令和 Google Chat 凭证 #118936
  • 更正载入设置命令 #126964
本页有帮助吗?