开始使用
v2026.8.1:安装和入门
OpenClaw 现在为新的 Mac、Linux 和 Windows installs 提供了从下载到第一次有用对话的更清晰路径,而 iPhone、iPad 和 Android 将配对和权限放在人们需要的地方。引导式设置可以重复使用受支持的订阅、API 密钥和已可用的 本地模型 ,在保存之前验证所选模型,并在连接准备就绪时将其移交给 Web 应用程序或终端。
安装OpenClaw
支持的安装路径 现在使应用程序或命令在安装后可用。从下载或磁盘映像打开的 Mac 应用程序可以将自身移动到应用程序中,在其中更新和登录时启动可以正常工作。在 Linux 和其他 Unix 系统上,安装程序使 openclaw 在新的终端会话中可用,而不要求您手动编辑 shell 启动文件。
在任何更改之前,将停止未经身份验证而暴露 OpenClaw 的网络安装。当准备取消或失败时,重新安装还可以保护现有的工作设置,并在报告是否可达之前为 OpenClaw 提供启动时间。
来源和完整变更列表
改进
错误修复
- 防止新鲜状态网关启动超时 #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 验证停止
文档
连接订阅、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
文档
在 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
文档
在 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 在重置之前验证提供程序、网关、迁移和工作区选择,可以将现有数据移动到垃圾箱,但有效确认的重置仍然具有破坏性。
来源和完整变更列表
改进
错误修复
- 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 不会放弃风险确认,并且故意跳过服务启动仍然可以在没有可访问网关的情况下完成,因此自动化必须检查报告的运行状况,而不是仅信任退出状态。
来源和完整变更列表
改进
错误修复
- 恢复仪表板并中断的首次设置 #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
文档