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本文是 KiloClawKilo 托管的 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/clawKiloClaw 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 文档两处数字口径不同均以各自文档原文为准并可在不离开聊天的前提下浏览与切换命令说明/model status查看当前激活的模型与 provider/models kilocode浏览可用模型分页显示每页 20 个/models kilocode page跳到指定页例如/models kilocode 2/model kilocode/provider/model切换到指定模型例如/model kilocode/anthropic/claude-sonnet-4.6/models kilocode all一次性列出全部可用模型每次/models响应底部都会附带快捷键提示便于切换、翻页和全量列出。若希望修改所有新会话的默认模型可编辑openclaw.json中的agents.defaults.model.primary字段——通过 Control UI 的Config标签页操作或直接在 KiloClaw Dashboard 的下拉框中快速选择。二、能否访问文件系统Dashboard 文件浏览器与 Agent 文件工具FAQ 明确给出肯定答复可以。有两种访问途径Dashboard 文件浏览器直接从 KiloClaw Dashboard 访问实例文件路径为/root/.openclaw/。这对于检查或恢复配置文件尤其是openclaw.json非常实用。Agent 内置文件工具通过你的 OpenClaw Agent 自带的文件操作工具与文件交互。配置恢复的完整链路common-questions 文档 补充了文件访问在排障中的典型用法使用 Dashboard 的编辑文件对话框浏览/root/.openclaw/其中可能存在openclaw.bak备份文件可手动恢复。而 dashboard 参考文档 则提供了更系统的Restore Config恢复默认配置机制适用于openclaw.json损坏例如 Agent 编辑配置时引入错误的场景将当前openclaw.json备份到/root/.openclaw/从环境变量channel token、模型设置等重新生成openclaw.json重启 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使用实例最初创建时的平台版本重新部署仅需应用配置变更如修改了 Settings 中的 channel token 或 secretsUpgrade Redeploy升级到最新支持的平台版本后再部署Changelog 显示 Redeploy Required/Redeploy Suggested或希望获取最新特性与修复关键保证Redeploy不会删除你的文件、git 仓库、cron 任务等持久化卷上的任何内容。它不是恢复出厂设置而是应用配置并重启或升级并重启。Redeploy 的完整流程为停止机器 → 应用当前配置环境变量、secrets、channel token→ 重新启动。更新时机与版本状态识别Changelog 每条更新会标记为feature或bugfix并附带部署提示Redeploy Required必须重新部署才能生效或Redeploy Suggested建议部署但非必须Dashboard 的 Settings 标签页还会显示版本状态徽标Update available目录中存在更新版本可用 Upgrade Redeploy 升级与ModifiedOpenClaw 在镜像之外被独立更新重新部署将回退到镜像版本若希望完全掌控升级节奏可在 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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 KiloClaw 平台 FAQ 实践指南：模型切换、文件访问、SSH 限制与更新机制全解析
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本文是 KiloClawKilo 托管的 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/clawKiloClaw 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 文档两处数字口径不同均以各自文档原文为准并可在不离开聊天的前提下浏览与切换命令说明/model status查看当前激活的模型与 provider/models kilocode浏览可用模型分页显示每页 20 个/models kilocode page跳到指定页例如/models kilocode 2/model kilocode/provider/model切换到指定模型例如/model kilocode/anthropic/claude-sonnet-4.6/models kilocode all一次性列出全部可用模型每次/models响应底部都会附带快捷键提示便于切换、翻页和全量列出。若希望修改所有新会话的默认模型可编辑openclaw.json中的agents.defaults.model.primary字段——通过 Control UI 的Config标签页操作或直接在 KiloClaw Dashboard 的下拉框中快速选择。二、能否访问文件系统Dashboard 文件浏览器与 Agent 文件工具FAQ 明确给出肯定答复可以。有两种访问途径Dashboard 文件浏览器直接从 KiloClaw Dashboard 访问实例文件路径为/root/.openclaw/。这对于检查或恢复配置文件尤其是openclaw.json非常实用。Agent 内置文件工具通过你的 OpenClaw Agent 自带的文件操作工具与文件交互。配置恢复的完整链路common-questions 文档 补充了文件访问在排障中的典型用法使用 Dashboard 的编辑文件对话框浏览/root/.openclaw/其中可能存在openclaw.bak备份文件可手动恢复。而 dashboard 参考文档 则提供了更系统的Restore Config恢复默认配置机制适用于openclaw.json损坏例如 Agent 编辑配置时引入错误的场景将当前openclaw.json备份到/root/.openclaw/从环境变量channel token、模型设置等重新生成openclaw.json重启 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使用实例最初创建时的平台版本重新部署仅需应用配置变更如修改了 Settings 中的 channel token 或 secretsUpgrade Redeploy升级到最新支持的平台版本后再部署Changelog 显示 Redeploy Required/Redeploy Suggested或希望获取最新特性与修复关键保证Redeploy不会删除你的文件、git 仓库、cron 任务等持久化卷上的任何内容。它不是恢复出厂设置而是应用配置并重启或升级并重启。Redeploy 的完整流程为停止机器 → 应用当前配置环境变量、secrets、channel token→ 重新启动。更新时机与版本状态识别Changelog 每条更新会标记为feature或bugfix并附带部署提示Redeploy Required必须重新部署才能生效或Redeploy Suggested建议部署但非必须Dashboard 的 Settings 标签页还会显示版本状态徽标Update available目录中存在更新版本可用 Upgrade Redeploy 升级与ModifiedOpenClaw 在镜像之外被独立更新重新部署将回退到镜像版本若希望完全掌控升级节奏可在 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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考