离线模式使用指南：断网时ToClaw的基础功能详解
网络中断时，ToClaw 的云端依赖看似会切断你的工作流。但通过预先配置，你完全可以解锁其离线操作能力，确保核心任务不受网络波动影响。
实现离线工作的关键在于四个核心策略：配置本地 OpenClaw 网关、预加载技能包、启用本地 SQLite 任务队列，以及调用内置的 CLI 工具链。以下将详细解析每种方法的配置步骤，让你在断网环境下也能维持生产力。
一、配置本地 OpenClaw 网关实现离线解析
ToClaw 通过对接本地运行的 OpenClaw 网关，可在离线状态下完成指令解析与任务调度。这相当于将 AI 处理能力部署到你的本地环境中。
首先，请确保已安装并初始化 OpenClaw CLI。初始化操作需在有网络时执行一次：openclaw init --skip-cloud-setup。
随后，在本地启动网关并指定端口，同时启用离线模式：openclaw gateway --port 18789 --offline。其中的 --offline 参数至关重要，它强制网关在无网状态下运行。
接下来，定位 ToClaw 的配置文件（通常位于 ~/.todesk/toclaws/config.json），修改 "aiEndpoint" 字段，将其指向你的本地网关地址，例如："http://localhost:18789/v1/chat/completions"。
最后，重启 ToDesk 客户端，进入 ToClaw 界面后点击右上角的“刷新连接状态”。若看到“本地网关已就绪”的提示，则表明离线指令解析通道已成功建立。
二、预载技能包至本地环境
将常用技能包提前下载到本地，是保障离线功能可用的有效方法。这些技能包是包含完整逻辑的静态文件，无需网络即可调用。
在有网络时，从 OpenClaw 技能包官方地址下载所需的 .tar.gz 压缩包，例如 file-processor-v1.3.tar.gz。
下载后，将其解压至固定目录。Windows 用户可存放于 C:\todesk\toclaws\skills\file-processor\，macOS 用户则可选择 ~/Library/Application Support/ToDesk/toclaws/skills/file-processor/。
之后，编辑 ToClaw 主配置文件，在 skills 配置节点下添加该本地路径的引用："path": "~/todesk/toclaws/skills/file-processor"。
配置完成并重启 ToClaw 后，该技能将出现在列表中，并带有 OFFLINE 标识，表明其为可离线调用的本地技能。
三、启用基于 SQLite 的本地任务队列
在弱网或断网场景下，启用本地任务队列可实现“先缓存，后同步”。ToClaw 会将指令转为 JSON 任务暂存于本地 SQLite 数据库，待网络恢复后自动提交。
启用此功能只需在 ToClaw 设置页面勾选“启用离线任务缓存”。系统会自动在配置目录生成 toclaws-queue.db 数据库文件。
为验证功能正常，可在终端检查数据库写入权限：sqlite3 ~/.todesk/toclaws/toclaws-queue.db "SELECT COUNT(*) FROM tasks;"。若返回计数大于 0，则表明写入正常。
此时，尝试执行一个支持离线的操作（如“整理桌面截图”）。观察任务面板，若状态显示为“已入队（离线）”，则证明任务已成功进入本地队列。你甚至可以断开网络再次测试，新任务应仍能成功提交，且时间戳与本地系统时间一致。
四、调用内置 CLI 工具链执行本地操作
作为最彻底的离线方案，ToClaw 内置的 CLI 工具链（如 toclip、tosnap、tofile）完全在本地进程内执行，不依赖任何网络请求。
首先，打开 ToClaw 的终端面板（快捷键通常为 Ctrl+Shift+T）。输入 tofile --help，若能显示帮助信息而非网络错误，则表明工具链可用。
随后，你即可执行各类本地操作。例如：移动文件 tofile move ~/Downloads/*.pdf ~/Documents/PDF-Archive/；截屏并 OCR 识别文字 tosnap --ocr --output ~/Desktop/screenshot.txt；或将剪贴板内容保存为带时间戳的文本文件 toclip --save ~/Desktop/clip-$(date +%s).txt。
这套工具链虽不如 AI 指令灵活，但其稳定性和响应速度在完全断网的环境下提供了可靠的操作保障。
通过合理组合本地网关、预载技能、队列缓存与原生 CLI 这四种方案，你可以根据实际网络状况与任务需求，构建出强韧的离线工作流，有效降低对云端服务的绝对依赖，保障工作连续性。