企业官网建设流程全解析

KiloClaw 平台 FAQ 实践指南：模型切换、文件访问、SSH 限制与更新机制全解析

【免费下载链接】kilocodeKilo is the all-in-one agentic engineering platform. Build, ship, and iterate faster with the most popular open source coding agent.项目地址: https://gitcode.com/GitHub_Trending/ki/kilocode

本文是 KiloClaw（Kilo 托管的 OpenClaw 托管服务）故障排查区 FAQ 文档的完整实战指南。文章围绕托管 Agent 实例日常运维中最常见的四类问题——模型切换、文件系统访问、SSH 访问限制与平台更新机制——逐一给出标准操作路径，并结合仓库内 dashboard 参考文档、Control UI 文档 与 架构说明 进行深度补充。读完本文，你将掌握 KiloClaw 实例的模型热切换、配置恢复、安全边界识别与安全升级的完整实操方案。

⚠️EOL 提示：根据 kiloclaw-eol 提示片段，KiloClaw 已不再向新用户开放，产品支持即将终止。本文档保留供存量用户参考，内容不再维护。文中的操作路径与限制说明均以仓库内现存文档为准。

一、如何切换模型：Chat 命令与 Dashboard 双通道

KiloClaw 的模型切换有两条互不冲突的路径，适用于不同场景。原 FAQ 明确指出：无论从哪条路径切换，都不需要重新部署（No redeploy is needed）。

1. 从 OpenClaw Control UI 聊天窗口切换

在 OpenClaw Control UI 的Chat标签页中，直接输入/model命令即可实时切换模型。这是最直接的方式，适合在会话进行中快速调整。

2. 从 KiloClaw Dashboard 切换

访问 https://app.kilo.ai/claw（KiloClaw Dashboard），在Settings中选择目标模型，点击Save完成切换。

结合 dashboard 参考文档 可以了解到该路径的更多细节：

• Dashboard 上的模型选择下拉框配合Save & Provision按钮生效；
• API Key 由平台托管，保存时会自动刷新，你无需手动输入任何密钥，且该 Key 有30 天有效期；
• 官方文档特别提醒：切换模型后如果 Agent 仍在使用旧模型，需确认已点击Save & Provision（这会刷新 API Key 并保存新模型），必要时再Restart OpenClaw让变更完全生效——这条补充说明见 common-questions 文档。

3. 模型目录与全量浏览（进阶）

Control UI 模型切换文档 展示了更完整的命令行体系。KiloClaw 通过kilocodeprovider 暴露了335+ 个模型（另一处概览文档则提到 Kilo Gateway 默认提供500+ 模型，见 overview 文档，两处数字口径不同，均以各自文档原文为准），并可在不离开聊天的前提下浏览与切换：

每次/models响应底部都会附带快捷键提示，便于切换、翻页和全量列出。若希望修改所有新会话的默认模型，可编辑openclaw.json中的agents.defaults.model.primary字段——通过 Control UI 的Config标签页操作，或直接在 KiloClaw Dashboard 的下拉框中快速选择。

二、能否访问文件系统：Dashboard 文件浏览器与 Agent 文件工具

FAQ 明确给出肯定答复：可以。有两种访问途径：

1. Dashboard 文件浏览器：直接从 KiloClaw Dashboard 访问实例文件，路径为/root/.openclaw/。这对于检查或恢复配置文件（尤其是openclaw.json）非常实用。
2. Agent 内置文件工具：通过你的 OpenClaw Agent 自带的文件操作工具与文件交互。

配置恢复的完整链路

common-questions 文档 补充了文件访问在排障中的典型用法：使用 Dashboard 的编辑文件对话框浏览/root/.openclaw/，其中可能存在openclaw.bak备份文件，可手动恢复。

而 dashboard 参考文档 则提供了更系统的Restore Config（恢复默认配置）机制，适用于openclaw.json损坏（例如 Agent 编辑配置时引入错误）的场景：

1. 将当前openclaw.json备份到/root/.openclaw/；
2. 从环境变量（channel token、模型设置等）重新生成openclaw.json；
3. 重启 gateway。

该操作不影响你的文件、工作区与持久化数据，仅重置 OpenClaw 配置文件。官方还给出排障建议：如果实例陷入崩溃循环且无法访问 Control UI，可先在 Dashboard 上尝试Restore Config而不是直接重新部署。注意该操作不可撤销，执行前务必确认已保存重要配置变更。

文件与配置所在位置（架构视角）

architecture 文档 从架构层说明：OpenClaw 配置位于/root/.openclaw，工作区位于/root/clawd。每个用户独占一台机器与持久化卷，不存在用户间共享的基础设施；存储固定于实例创建时的区域（region-pinned）。API Key、频道 token 等敏感数据在机器配置中以静态加密（encryption at rest）方式保存。

三、能否通过 SSH 访问实例：出于安全考虑被禁用

FAQ 明确指出：出于安全原因，当前所有 KiloClaw 实例均禁用 SSH 访问。这是平台保障用户环境安全的多项措施之一。

architecture 文档 从网络层面给出了这一安全设计的技术依据：

• 网络隔离：OpenClaw 仅绑定 loopback（本机回环地址），外部流量统一通过 Kilo 控制器代理转发；
• 逐用户认证：gateway token 按用户派生，用于对用户机器的请求进行鉴权；
• 结合前述静态加密与独立机器设计，共同构成了 KiloClaw 的纵深安全模型。

因此，需要访问实例文件时，请走上文所述 Dashboard 文件浏览器或 Agent 文件工具通道，而非 SSH。

四、如何更新 OpenClaw：禁止 Control UI 内更新，走 Dashboard Redeploy

这是 FAQ 中最具操作警示意义的一条：

• 不要在 OpenClaw Control UI 内点击Update Now——KiloClaw 实例不支持该操作，点击可能导致实例损坏；
• 更新由KiloClaw 平台团队统一管理，以确保稳定性；
• 新版本发布时，Dashboard 的Changelog会发布公告；
• 应用更新的标准动作是点击 KiloClaw Dashboard 上的Upgrade & Redeploy。

为什么不能用 Control UI 更新？

Control UI 文档 中的警告给出了根本原因：通过 Control UI 更新不会应用正确的 KiloClaw 平台镜像，可能损坏实例。也就是说，Control UI 的 Update 面向的是自托管 OpenClaw 场景，而 KiloClaw 的更新必须由平台镜像层驱动。

Redeploy 与 Upgrade & Redeploy 的区别

dashboard 参考文档 对两种部署动作做了精确定义：

关键保证：Redeploy不会删除你的文件、git 仓库、cron 任务等持久化卷上的任何内容。它不是恢复出厂设置，而是"应用配置并重启"（或"升级并重启"）。Redeploy 的完整流程为：停止机器 → 应用当前配置（环境变量、secrets、channel token）→ 重新启动。

更新时机与版本状态识别

• Changelog 每条更新会标记为feature或bugfix，并附带部署提示：Redeploy Required（必须重新部署才能生效）或Redeploy Suggested（建议部署但非必须）；
• Dashboard 的 Settings 标签页还会显示版本状态徽标：Update available（目录中存在更新版本，可用 Upgrade & Redeploy 升级）与Modified（OpenClaw 在镜像之外被独立更新，重新部署将回退到镜像版本）；
• 若希望完全掌控升级节奏，可在 Settings 中使用Version Pinning将实例固定到特定版本与变体，清除版本固定并保存即可恢复自动更新。

网关进程状态的辅助判断

更新与排障过程中，可借助 Dashboard 的Gateway Process标签页观察 OpenClaw 进程状态（详见 gateway-process 文档）：Running（正常运行）、Stopped（未运行）、Starting（启动中）、Stopping（优雅关闭中）、Crashed（意外退出，将自动重启）、Shutting Down（随机器停止或重新部署而停止）。网关崩溃时会自动重启，且机器运行与网关进程状态相互独立。

五、FAQ 之外的排障速查（常见问题速览）

围绕上文四条 FAQ 主线，common-questions 文档 还提供了几条高度关联的排障速查，一并整理如下：

• 推荐第一步：OpenClaw Doctor。确保实例运行后，点击 Dashboard 上的OpenClaw Doctor，它会运行诊断并自动修复常见配置问题，输出实时显示。
• Restart OpenClaw vs Redeploy：前者只重启 OpenClaw 进程（机器保持运行，适合快速恢复进程级问题或应用配置变更）；后者停止并重启整台机器（适用于 Changelog 显示部署提示或修改了 token/secrets 之后）。
• Telegram/Discord/Slack 机器人不响应：依次检查 Settings 中 channel token 是否已配置 → 保存后是否已 Redeploy 或 Restart OpenClaw → 是否存在待审批的 pairing request → 运行 OpenClaw Doctor。
• 网关显示 Crashed：进程会自动重启；查看 Gateway Process 标签页的退出码与重启次数；持续崩溃时运行 OpenClaw Doctor，再尝试 Redeploy 应用最新平台镜像。
• 换模型后仍使用旧模型：确认已点击Save & Provision，必要时Restart OpenClaw使变更完全生效。

结语

KiloClaw 作为 Kilo 托管的 OpenClaw 服务，其运维模型与自托管 OpenClaw 存在关键差异：模型切换可通过 Chat 命令或 Dashboard 即时完成且无需重新部署；文件与配置可通过 Dashboard 文件浏览器访问和恢复；SSH 出于安全设计被统一禁用；更新则必须遵循"平台托管 + Upgrade & Redeploy"的路径，严禁在 Control UI 内直接升级。理解这些边界，即可在存量使用期内安全、高效地管理你的实例。更多细节可进一步阅读仓库内的 KiloClaw 概览、Dashboard 参考 与 Control UI 概览。

【免费下载链接】kilocodeKilo is the all-in-one agentic engineering platform. Build, ship, and iterate faster with the most popular open source coding agent.项目地址: https://gitcode.com/GitHub_Trending/ki/kilocode