最全面的 OpenClaw中文教程 第一部分：零基础入门（3章） 第4章：本地文件管理神器（效率提升81%） 第5章：个人知识库（网页/论文/GitHub一键存档） 第6章：日程管理（微信截图秒变日历事件） 第7章：自动化工作流（定时任务/网站监控/AI日报） 第三部分：进阶技能（4 第1章：认识OpenClaw:是什么？能帮你做什么？ 第2章：环境搭建：5分钟完成部署（多种方案任选） 第3章：发送第一条消息，配置你的专属AI助手第二部 分：4大核心功能（4章） 章） 第8章：Skills扩展（1715个技能让AI无所不能） 第9章：多平台集成（飞书/企微/钉钉/QQ一键接入） 第10章：API服务集成（绘图/Notion/视频/语音） 第11章：高级配置（多模型切换/成本优化/性能调优） 第四部分：实战案例（4章） 第12章：5类人群的效率提升实战 第13章：高级自动化工作流（多Skills组合/知识图谱） 第14章：创意应用探索（AI绘画/视频/翻译/数据分析） 第15章：超级个体实战案例（一人公司/自由职业） 第1章：认识OpenClaw 在开始使⽤ OpenClaw之前，先了解它是什么，为什么要⽤它，以及它能带来什么。 ⚠ 版本说明：由于 OpenClaw 仍在快速开发中，本教程基于 版本编写。该版本经过充分验证， 稳定可靠。 💡 重要前提：OpenClaw 预装了 49个内置技能（Skills），本教程中的⼤部分功能演⽰都基于这些内置技 能。这些技能涵盖⽂件管理、知识管理、⽇程管理、⾃动化等核⼼场景，开箱即⽤。如果某些功能⽆法使 ⽤，请先确认相关技能是否已启⽤（详⻅第8章：Skills扩展）。 什么是OpenClaw ⼀句话介绍 OpenClaw 是⼀个开源的 AI 智能体 Gateway ⽹关，让你可以在本地部署 AI 助⼿，访问本地⽂件，通过多个平 台（⻜书、企微、QQ等）随时使⽤。 项⽬名称演变：OpenClaw 原名 Clawdbot，因 Anthropic 商标顾虑在 2026年1⽉27⽇更名为 Moltbot（过 渡名），最终在1⽉30⽇确定为 OpenClaw。三个名字本质是同⼀个项⽬，功能完全⼀致。 核⼼能⼒ 🏠 本地部署：在你的电脑上运⾏，数据隐私有保障 📁 ⽂件访问：可以搜索、读取、编辑你电脑上的⽂件 🔌 ⽆限扩展：通过 Skills（技能）系统扩展功能 💬 多平台使⽤：⽀持⻜书、企微、钉钉、QQ、Telegram、Discord等 💰 成本可控：使⽤⾃⼰的 API，费⽤透明 ⼯作原理 OpenClaw 通过 Gateway ⽹关将聊天应⽤连接到 AI 智能体。Gateway 是会话、路由和渠道连接的唯⼀事实来 源。 核⼼组件： 1. Gateway ⽹关 连接各个聊天平台（⻜书、企微、QQ、Telegram等） 管理会话和消息路由 默认地址： :18789/ 配置⽂件： ~/.openclaw/ 2. AI 智能体 ⽀持 Claude、GPT、Gemini、DeepSeek、Kimi 等多种模型 可以本地运⾏或远程调⽤ 3. Skills 技能系统 ⽂件管理、知识管理、⾃动化等 可⾃定义开发 4. ClawHub 技能市场，可以下载和分享 Skills 💡 Gateway ⽹关是什么？ Gateway 是 OpenClaw 的核⼼服务，它像⼀个"中央调度站"，负责： 接收来⾃不同平台的消息（⻜书、企微、QQ、Telegram等） 将消息转发给 AI 智能体处理 把 AI 的回复发送回对应平台 管理所有的会话和上下⽂ 这就是为什么你可以在任何平台上使⽤ OpenClaw，因为 Gateway 统⼀管理了所有的连接。 为什么选择OpenClaw 与在线AI的本质区别 OpenClaw 与传统在线 AI 服务在部署⽅式、数据隐私和功能扩展等⽅⾯存在本质差异，如表 1-3 所⽰。 表 1-3 OpenClaw 与在线 AI 对⽐ 特性 OpenClaw ChatGPT/Claude⽹⻚版 部署⽅式 本地/云端 在线服务 数据隐私 ✅ 完全掌控 ⚠ 上传到服务器 本地⽂件访问 ✅ ⽀持 ❌ 不⽀持 系统操作 ✅ ⽀持 ❌ 不⽀持 功能扩展 ✅ Skills系统 ❌ 固定功能 成本 按需付费 订阅制 多平台集成 ✅ ⽀持 ⚠ 有限 简单来说： ChatGPT/Claude：像在⽹吧上⽹，⽅便但受限 OpenClaw：像⾃⼰的电脑，⾃由但需要配置 五⼤核⼼优势 1. 本地部署，保护隐私 场景：你需要AI帮你整理公司的财务报表 ❌ 在线AI：需要上传⽂件到服务器，存在泄密⻛险 ✅ OpenClaw：⽂件不离开你的电脑，完全安全 2. 访问本地⽂件和系统 场景：你想找⼀张去年的发票 ❌ 在线AI：⽆法访问你的电脑，只能⼿动找 ✅ OpenClaw：直接搜索电脑上的所有⽂件，秒找到 真实案例： 我：帮我找⼀下我电脑上的⼀张发票，⾥⾯详情是买了⼀个跑步机 OpenClaw：[搜索中...] 找到了！这是您的跑步机发票 [发送⽂件] 3. 可扩展的Skills⽣态 场景：你想让AI帮你画图 ❌ 在线AI：功能固定，不⽀持就没办法 ✅ OpenClaw：安装 Banana Skills，⽴即⽀持画图 可⽤的Skills： ⽂件管理：智能搜索、批量处理、⾃动整理 知识管理：⽹⻚剪藏、笔记同步、论⽂管理 ⽇程管理：⽇历同步、智能提醒 ⾃动化：定时任务、⽹站监控、⽇报推送 ⼯具类：截图、翻译、画图、视频⽣成 4. 多平台⽀持 场景：你在外⾯，想让AI帮你处理⽂件 ❌ 在线AI：需要打开⽹⻚，操作不便 ✅ OpenClaw：打开⻜书/企微/QQ，直接发消息 ⽀持的平台： 🏢 企业微信：团队协作 📱 钉钉：办公⾃动化 🚀 ⻜书：项⽬管理 💬 QQ：个⼈助⼿ 🌐 Telegram/Discord：国际平台 5. 成本可控 场景：你担⼼AI使⽤费⽤太⾼ ❌ ChatGPT Plus：20美元/⽉，固定费⽤ ✅ OpenClaw：按需付费，⽤多少花多少 成本对⽐（⽉使⽤量：中等）： ChatGPT Plus：20美元（约140元） Claude Pro：20美元（约140元） OpenClaw + DeepSeek：5-30元 OpenClaw + Kimi：10-50元 💡 省钱技巧：使⽤国产⼤模型可以节省50%-70%成本 OpenClaw vs 主流AI⼯具 OpenClaw 与主流 AI ⼯具在功能定位和成本结构上存在显著差异。下⾯从核⼼功能、成本和适⽤⼈群三个维度 进⾏详细对⽐。 核⼼功能对⽐ OpenClaw 在本地⽂件访问、系统操作和⾃动化任务⽅⾯具有明显优势，如表 1-1 所⽰。 表 1-1 主流 AI ⼯具功能对⽐ 功能特性 OpenClaw ChatGPT Plus Cursor Claude Pro 本地⽂件访问 ✅ 完整⽀持 ❌ 不⽀持 ✅ ⽀持 ❌ 不⽀持 系统操作 ✅ ⽇历/备忘录/截图 ❌ 不⽀持 ⚠ 有限 ❌ 不⽀持 多平台集成 ✅ ⻜书/企微/钉钉/QQ ⚠ 有限 ❌ 不⽀持 ⚠ 有限 Skills扩展 ✅ 1715+ ❌ 不⽀持 ⚠ 插件 ❌ 不⽀持 多模型切换 ✅ 随意切换 ❌ 固定GPT ✅ ⽀持 ❌ 固定Claude 代码能⼒ ✅ 强 ⚠ 中等 ✅ 强 ✅ 强 ⾃动化任务 ✅ 完整⽀持 ❌ 不⽀持 ❌ 不⽀持 ❌ 不⽀持 成本对⽐ OpenClaw 采⽤按量付费模式，相⽐固定⽉费的在线服务可节省 73%-96% 的成本，如表 1-2 所⽰。 表 1-2 年度成本对⽐ 项⽬ OpenClaw ChatGPT Plus Cursor Claude Pro ⽉费 5-50元 140元 140元 140元 年费 60-600元 1680元 1680元 1680元 节省 - 节省73%-96% 节省73%-96% 节省73%-96% 计费⽅式 按量付费 固定⽉费 固定⽉费 固定⽉费 成本说明： OpenClaw 成本 = 服务器费⽤（可选）+ API 费⽤ 本地部署：0元服务器 + 5-30元 API = 5-30元/⽉ 云端部署：20元服务器 + 5-30元 API = 25-50元/⽉ 适合⼈群 ✅ 强烈推荐OpenClaw的⼈群： 1. 超级个体/⾃由职业者 - 需要⼀个⼈顶⼀个团队 2. 知识⼯作者 - 需要管理⼤量⽂档和知识 3. 程序员 - 需要代码辅助和⾃动化 4. 内容创作者 - 需要素材管理和多平台发布 5. 注重隐私 - 不想上传敏感⽂件到云端 6. 成本敏感 - 想要⾼性价⽐的AI助⼿ ⚠ 如果你只需要简单对话，可以考虑： ChatGPT Plus：最简单，开箱即⽤ Claude Pro：⻓⽂本处理能⼒强 💡 最佳⽅案： ⽇常对话：ChatGPT/Claude ⼯作助⼿：OpenClaw（本地⽂件、⾃动化、多平台） 代码编写：Cursor + OpenClaw 真实案例：为什么我选择OpenClaw 我是⼀个内容创作者，每天需要： 整理⼤量的资料和⽂章 管理⽇程和任务 ⽣成图⽚和视频 多平台发布内容 以前我需要： ChatGPT：写⽂案 Notion：管理笔记 Midjourney：画图 各种⼯具：⾃动化 现在只需要OpenClaw： ⼀个助⼿搞定所有事情 成本降低70% 效率提升10倍 适⽤场景 ✅ 适合使⽤ OpenClaw的场景 1. 个⼈效率提升 知识⼯作者： 整理⼤量⽂档和资料 管理⽇程和任务 ⾃动化重复⼯作 程序员： 代码搜索和管理 技术⽂档整理 开发环境管理 内容创作者： 资料收集和整理 内容创作辅助 多平台发布 学⽣： 课程资料管理 论⽂阅读和笔记 学习计划管理 2. 知识管理 ⽹⻚⽂章存档 GitHub项⽬管理 论⽂笔记整理 跨设备同步 3. 编程开发 代码搜索和理解 技术⽂档查询 开发环境配置 项⽬管理 4. 团队协作 项⽬管理⾃动化 ⽂档协作优化 会议记录整理 团队知识库建设 5. 创意⼯作 AI绘画⼯作流 视频脚本⽣成 多语⾔翻译 数据分析⾃动化 ❌ 不适合使⽤ OpenClaw的场景 1. 纯在线对话 如果你只是想偶尔和AI对话，不需要访问本地⽂件： ChatGPT⽹⻚版更⽅便 ⽆需安装配置 打开就能⽤ 2. 专业代码编辑 如果你只需要代码补全和编辑： Cursor更专业 GitHub Copilot更⽅便 集成度更⾼ 3. 移动端为主 如果你主要在⼿机上使⽤： ChatGPT App更⽅便 Claude App更流畅 ⽆需配置 4. 不想折腾 如果你： 不想学习新⼯具 不想配置环境 只想开箱即⽤ 那么在线AI服务更适合你。 💡 最佳实践 推荐组合： 1. OpenClaw：⽇常⼯作助⼿ 2. Cursor：代码编辑 3. ChatGPT：移动端对话 使⽤建议： 在电脑上：优先使⽤ OpenClaw 写代码时：使⽤Cursor 在外⾯时：使⽤ChatGPT App OpenClaw vs 其他AI⼯具能⼒对⽐ 不同 AI ⼯具在任务规划、⾃动执⾏、代码质量等维度上各有侧重。OpenClaw 在任务规划和⾃动化⽅⾯表现突 出，如表 1-4 所⽰。 表 1-4 AI ⼯具能⼒维度对⽐ 能⼒维度 OpenClaw Claude Code Cursor ChatGPT 任务规划 ⭐⭐⭐⭐⭐ ⭐⭐⭐ ⭐⭐⭐ ⭐⭐⭐ ⾃动执⾏ ⭐⭐⭐⭐⭐ ⭐⭐⭐ ⭐⭐⭐ ⭐⭐ ⾃我修复 ⭐⭐⭐⭐⭐ ⭐⭐ ⭐⭐ ⭐ ⼯程级操作 ⭐⭐⭐⭐⭐ ⭐⭐⭐⭐ ⭐⭐⭐⭐ ⭐⭐ 本地⾃动化 ⭐⭐⭐⭐⭐ ⭐⭐ ⭐⭐ ⭐ 代码质量 ⭐⭐⭐⭐ ⭐⭐⭐⭐⭐ ⭐⭐⭐⭐⭐ ⭐⭐⭐⭐ 易⽤性 ⭐⭐⭐ ⭐⭐⭐⭐ ⭐⭐⭐⭐⭐ ⭐⭐⭐⭐⭐ 核⼼差异： OpenClaw：强在任务规划和⾃动执⾏完整⼯程流程 Claude Code/Cursor：强在代码质量与理解 ChatGPT：强在对话体验和易⽤性 本章⼩结 通过本章，你应该了解了： ✅ OpenClaw是什么：本地AI助⼿，通过Gateway连接多个平台 ✅ 核⼼优势：本地部署、⽂件访问、可扩展、多平台、成本低 ✅ 与其他AI的区别：更适合作为个⼈⼯作助⼿ ✅ 适⽤场景：效率提升、知识管理、编程开发、团队协作 ✅ 不适合场景：纯对话、移动端为主、不想折腾 思考题 1. 你⽬前使⽤什么AI⼯具？遇到了什么问题？ 2. OpenClaw的哪个功能最吸引你？ 3. 你打算⽤OpenClaw做什么？ 下⼀章：第2章：环境搭建 - 5分钟完成安装 返回⽬录：README 第2章：环境搭建 本章将手把手教你安装 OpenClaw。 📋 前提条件与推荐配置 推荐配置 为了获得 佳体验，我们推荐： 操作系统： Mac（强烈推荐）：原生支持 完善，可操作日历、备忘录、截图等系统功能 Windows：完全可用，但部分系统集成功能受限 Linux：适合开发者，配置灵活 IM工具选择： 🌍 国外用户：推荐 Telegram（适配度 好，功能 完整） 国内用户：推荐 飞书（现代化、开发友好、功能丰富） 备选：企业微信、钉钉、QQ 部署方式： 💻 有Mac电脑：推荐本地部署（体验 好，功能 全） ☁ 无Mac或想24小时运行：推荐云端部署（成本低，稳定可靠） 为什么推荐Mac？ OpenClaw在Mac上体验 好，因为： 原生支持 完善，系统集成度高 可以操作Mac日历、备忘录、提醒事项 截图功能完美支持 与iPhone、iPad无缝同步 文件管理更智能 开发环境配置简单 为什么推荐飞书（国内）？ 现代化设计，用户体验好 开发者友好，API完善 支持富文本、文档、表格 消息推送稳定 免费版功能丰富 为什么推荐Telegram（国外）？ 全球用户基础大 API 完善，功能 强 支持Bot功能丰富 消息推送实时 隐私保护好 快速导航 推荐路径： 有Mac → Mac本地部署 + 飞书配置 ☁ 无Mac/想24小时运行 → 云端一键部署 + 飞书配置 所有部署方式： � Mac本地部署（推荐） Windows本地部署 Linux本地部署 云端一键部署 国内一键安装 ☁ Cloudflare Workers 部署（进阶） Docker 部署（可选） 配置指南： API配置指南 版本升级指南 ❓ 常见问题解决 Mac本地部署（推荐） 佳体验：如果你有Mac电脑，强烈推荐本地部署，体验 好、功能 全！ 为什么选择Mac本地部署？ 优势： 系统集成：可操作日历、备忘录、文件系统 隐私安全：数据完全本地，不上传云端 响应速度快：本地运行，无网络延迟 功能 全：支持所有高级功能 成本低：无需购买云服务器 开发友好：方便调试和自定义 适合人群： 有Mac电脑的用户 注重隐私的用户 需要系统集成功能的用户 开发者和技术爱好者 系统要求 硬件要求： CPU：M系列芯片或Intel i5以上 内存：8GB以上（推荐16GB） 硬盘：10GB以上空闲空间 系统版本： macOS 12 Monterey 或更高版本 推荐 macOS 14 Sonoma 或 macOS 15 Sequoia 前置软件： +（会自动安装） Homebrew（可选，用于安装依赖） 安装步骤 第一步：打开终端 1. 按 Command + 空格 打开 Spotlight 2. 输入 Terminal 或 终端 3. 按回车打开终端 第二步：安装 OpenClaw 在终端中执行以下命令： curl -fsSL | bash 安装过程会自动： 检测系统环境 安装（如果未安装） 下载OpenClaw 配置环境变量 预计时间：2-5分钟 第三步：验证安装 安装完成后，执行以下命令验证： openclaw --version 如果显示版本号（如 ），说明安装成功！ 第四步：初始化配置 运行配置向导： openclaw onboard 配置流程： 1. 接受风险提示： 选择 Yes 继续 2. 选择启动模式： 推荐选择 QuickStart 快速启动： 3. 选择AI模型： 选择你的AI供应商（支持国内外主流模型）： 国内推荐： Kimi（Moonshot AI）：长文本专家，200万字上下文 DeepSeek：性价比之王，推理能力强 智谱GLM：中文理解好，多模态支持 4. 输入API Key： 根据选择的模型，输入对应的API Key（参见API配置指南） 5. 选择聊天工具： 如果要接入飞书/Telegram，选择对应选项 如果暂时不接入，选择 None（后续可配置） 6. Gateway端口设置： 默认 18789 即可： 7. 选择Skills： 使用空格键选择你需要的技能，也可以直接跳过： 8. API Key配置： 没有的可以选择 no 跳过： 9. 启用Hooks： 推荐启用这三个钩子（用于内容引导、日志和会话记录）： 10. 完成配置： 配置完成后，会自动启动Gateway服务并打开Web UI（ :18789/chat） 第五步：验证安装 # 检查Gateway状态 openclaw channels status # 应该显示： # Gateway reachable. 日常使用 启动OpenClaw： # 启动Gateway服务 openclaw gateway start # 或使用systemd（推荐，开机自启） openclaw gateway enable 访问Web UI： 打开浏览器访问： :18789/chat 停止服务： openclaw gateway stop 接入飞书（推荐） Mac本地部署后，强烈推荐接入飞书，获得 佳体验： 1. 参考 第9章：飞书Bot配置 2. 配置完成后，可以在飞书中随时与OpenClaw对话 3. 支持文本、图片、文件等多种消息类型 常见问题 Q1：安装时提示权限不足？ # 使用sudo安装 curl -fsSL | sudo bash Q2：如何更新OpenClaw？ openclaw update Q3：如何卸载？ openclaw uninstall Windows本地部署 Windows用户：完全可用，但部分系统集成功能受限。 系统要求 硬件要求： CPU：2核以上 内存：4GB以上（推荐8GB） 硬盘：10GB以上空闲空间 操作系统： Windows 10 或 Windows 11 前置软件： + 部署方式选择 Windows有两种部署方式： 1. WSL2 + Ubuntu（强烈推荐）：官方推荐方式，提供完整Linux环境支持 2. PowerShell原生部署：纯Windows环境，适合不想使用WSL2的用户 方式一：WSL2 + Ubuntu部署（强烈推荐） 这是官方推荐的Windows部署方式，提供 完整的Linux环境支持。 第一步：启用WSL2 以管理员身份打开PowerShell，执行： # 启用WSL功能 /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /noresta /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart # 设置WSL 2为默认版本 wsl --set-default-version 2 重启计算机。 第二步：安装Ubuntu 方法一：Microsoft Store安装（推荐） 1. 打开Microsoft Store 2. 搜索「Ubuntu LTS」或「Ubuntu LTS」 3. 点击「获取」并安装 4. 首次启动设置用户名和密码 安装完成后会自动打开Ubuntu终端，按提示设置用户名和密码。 第三步：更新Ubuntu系统 在Ubuntu终端中执行： # 更新软件包列表 sudo apt update && sudo apt upgrade -y # 安装基础工具 sudo apt install -y curl git wget build-essential 第四步：安装 22+ # 添加NodeSource仓库 curl -fsSL | sudo -E bash - # 安装 sudo apt install -y nodejs # 验证版本（必须≥） node -v npm -v 第五步：安装 OpenClaw 方法A：一键脚本安装 curl -fsSL | bash 第六步：验证安装 # 查看版本 openclaw --version # 查看帮助 openclaw --help # 查看系统状态 openclaw status 第七步：配置Windows访问WSL2服务 由于OpenClaw运行在WSL2中，需要配置端口转发以便Windows访问。 创建启动脚本 ： @echo off echo Starting OpenClaw Gateway in WSL2... wsl -d -u root service openclaw start timeout /t 3 start http://localhost:18789 或直接在WSL2中启动： # 在WSL2 Ubuntu终端中 openclaw gateway run --port 18789 然后在Windows浏览器访问 http://localhost:18789 方式二：PowerShell原生部署 适合不想使用WSL2的纯Windows用户。 第一步：安装 22+ 方法一：官网下载安装 1. 访问 2. 下载Windows安装包（LTS版本） 3. 运行安装程序，勾选「自动安装必要的工具」 第二步：验证安装 # 打开PowerShell node -v npm -v 第三步：以管理员身份安装 OpenClaw 重要：必须以管理员身份运行PowerShell。 # 安装最新稳定版 npm install -g openclaw@latest # 或安装汉化版 npm install -g @qingchencloud/openclaw-zh@latest 第四步：解决安装权限问题 如果遇到权限错误： # 方法A：启用PowerShell脚本执行 Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser # 方法B：修改npm安装目录 npm config set prefix "C:\npm" npm config set cache "C:\npm-cache" # 将目录添加到PATH [Environment]::SetEnvironmentVariable("Path", $env:Path + ";C:\npm", "User") 第五步：验证安装 openclaw --version openclaw --help 第六步：解决常见问题 问题：sharp模块加载失败 # 清理npm缓存 npm cache clean --force # 重新安装 npm install -g openclaw@latest --force 问题：Windows Defender阻止 将OpenClaw安装目录添加到Windows Defender排除项： C:\Users\你的用户名\AppData\Roaming\npm C:\Users\你的用户名\.openclaw 初始化配置 安装完成后，需要运行初始化向导。 启动初始化向导 openclaw onboard --install-daemon 配置AI模型提供商 OpenClaw需要对接AI模型才能工作。 以配置Anthropic Claude（推荐）为例： 详细说明: 完整的 API Key 配置方式和优先级说明请参考 API Key 配置完整指南 # WSL2或PowerShell openclaw models auth add # 按提示选择 anthropic # 输入 API Key: sk-ant-xxx 绑定消息渠道 1. Telegram 创建Bot： 1. 在Telegram搜索 @BotFather 2. 发送 /newbot 创建机器人 3. 保存Bot Token 配置： openclaw channels add telegram openclaw config set "your-bot-token" openclaw gateway restart 2. WhatsApp # 登录WhatsApp（显示二维码） openclaw channels login whatsapp # 用手机WhatsApp扫码 3. 企业微信（国内推荐） # 安装企业微信插件 openclaw plugins install @m1heng-clawd/wework # 配置 openclaw config set '{"enabled":true,"corpId":"xxx","agentSecret":"xxx"}' --j 4. 飞书（国内推荐） # 安装飞书插件 openclaw plugins install @m1heng-clawd/feishu # 配置 openclaw config set '{"enabled":true,"appId":"cli_xxx","appSecret":"xxx"}' -- Windows常用命令速查 系统管理： 命令 功能 openclaw --version 查看版本 openclaw status 查看系统状态 openclaw health 健康检查 openclaw update 更新OpenClaw openclaw doctor 诊断系统问题 配置管理： 命令 功能 openclaw onboard 初始化向导 openclaw configure 交互式配置 openclaw config get <key> 查看配置项 openclaw config set <key> <value> 修改配置项 openclaw config unset <key> 删除配置项 Linux本地部署 Linux用户：适合开发者，配置灵活。 系统要求 推荐发行版： Ubuntu + Debian 11+ CentOS 8+ 安装步骤 第一步：安装 # Ubuntu/Debian curl -fsSL | sudo -E bash - sudo apt-get install -y nodejs # 验证安装 node --version 第二步：安装 OpenClaw curl -fsSL | bash 第三步：验证安装 openclaw --version 第四步：初始化配置 openclaw onboard 系统要求与准备 云端部署要求 如果选择云端部署，无需任何本地环境，只需要： 一个浏览器 20元/月预算 10分钟时间 云端一键部署 适合场景：无Mac电脑、需要24小时运行、多设备访问。 为什么选择云端部署？ 云端部署相比本地部署具有多项优势，如表 2-1 所示。 表 2-1 云端部署优势 优势 说明 ⚡ 秒级部署 点几下鼠标就完成，无需配置环境 💰 成本低 20元/月起，比买Mac Mini便宜太多 手机可用通过QQ、企微、飞书随时随地访问 🔒 稳定可靠 24小时运行，不用担心电脑关机 视频教程官方视频手把手教学 方案对比 目前主流的云端部署方案对比如表 2-2 所示。 表 2-2 云端部署方案对比 方案 价格 带宽 推荐场景 腾讯云Lighthouse 20元/月，99元/年 20M QQ、企微用户 火山引擎 元/月，58元/年 5M 飞书用户 腾讯云Lighthouse部署（推荐） 第一步：购买服务器 1. 访问活动页面： 2. 选择配置： 配置：2核2G 带宽：20M 地域：建议选择硅谷（国外地域访问AI模型更稳定） 价格：20元/月 或 99元/年 3. 实名认证： 首次使用需要实名认证 选择个人认证即可 按提示完成认证 4. 完成购买： 点击"立即购买" 支付20元（建议先买1个月试用） 等待服务器创建完成 可选：关闭自动续费 5. 获取服务器信息： 购买完成后，点击头像 → "站内信" 查看并记录： 公网IP地址 默认用户名（通常是 lighthouse） 初始密码 免费白嫖方案（可选） 如果你想免费试用3个月，可以通过 CodeBuddy 活动获取免费服务器。 步骤： 1. 注册 CodeBuddy： 国际版： 国内版： 建议使用新账号注册 2. 领取奖励： 登录后点击"实战礼" → "立刻领奖" 获得1个月免费使用权 累计活跃7日可再延长2个月（每天在CodeBuddy中问候即可） 3. 重装系统为OpenClaw： 登录腾讯云控制台： 进入"轻量应用服务器" 点击"重装系统" 选择"使用应用模板" → "OpenClaw" 选择"无需备份"，点击"确定" 4. 后续操作： 重装完成后，按照下面的步骤继续配置 第二步：连接服务器 1. 使用SSH客户端连接： 方式一：使用SSH客户端（推荐） 下载SSH客户端（如 Xterminal、Termius、FinalShell） 新建SSH连接： 名称：随便取 地址：公网IP地址 端口：22 用户名：lighthouse（或站内信中的用户名） 密码：购买时设置的密码 方式二：使用网页终端 在腾讯云控制台，点击实例卡片 点击"登录"按钮 直接在浏览器中打开终端 2. 验证OpenClaw安装： openclaw --version 如果显示版本号（如 ），说明OpenClaw已预装成功。 第三步：配置大模型 1. 进入应用管理： 点击服务器卡片 切换到"应用管理"标签 2. 选择模型： 推荐使用 Kimi （性价比 高） 也可以选择其他国产大模型 3. 获取API Key： Kimi 配置（推荐）： 1. 访问： 2. 注册账号并登录 3. 进入"API管理" 4. 点击"创建API Key" 5. 复制API Key（格式：sk-xxx） 4. 填入配置： 将API Key粘贴到配置框 点击"保存" 等待配置生效 第四步：测试连接 1. 访问WebUI： 使用控制台提供的访问地址 格式： http://你的服务器IP:18789/?token=xxx 2. 发送测试消息： 你好，能听到我说话吗？ 3. 验证成功： 如果收到AI回复，说明配置成功 右上角会显示使用的模型名称 火山引擎部署（更便宜） 如果你是飞书重度用户，推荐使用火山引擎： 1. 访问活动页面： 2. 价格优势： 元/月 58元/年 比腾讯云便宜10元 3. 配置对比： 2核2G（相同） 5M带宽（腾讯云20M） 适合飞书用户 4. 部署流程： 与腾讯云类似 按照页面提示操作即可 百度智能云部署（元试用） 💰 超值试用：百度智能云提供元/月的特惠活动，适合想要低成本试用的用户。 活动信息 1. 访问活动页面： 2. 活动规则： 首月仅需 元 需要注册并绑定个人身份证 每个账号限购一次 部署步骤 第一步：购买服务器 1. 注册百度智能云账号 2. 完成个人实名认证（绑定身份证） 3. 抢购特惠LS实例（元/月） 4. 如果售罄，可以原价购买轻量应用服务器 第二步：创建实例 1. 进入轻量应用服务器LS控制台 2. 点击"创建实例"： 名称：随机生成或自定义 密码：务必记住，后续登录需要 3. 等待实例创建完成 第三步：一键配置 OpenClaw 1. 进入实例详情页： 点击实例卡片 进入"应用管理"标签 2. 应用配置： 点击"一键开通" 点击"一键放行"（开放防火墙端口） 等待显示"已放行" 3. 模型配置： 下拉选择模型（如：文心一言、千帆大模型） 点击"应用模型配置" 系统会自动创建千帆API Key并配置 4. 接入方式配置（可选）： 支持接入：飞书、钉钉、企业微信、QQ 选择你常用的通讯工具 按照提示完成配置（详见后续章节） 5. Skills 配置（可选）： 默认提供：百度搜索、百度百科 可以按需选择并点击"应用" 更多Skills可访问OpenClaw官网获取 第四步：访问WebUI 1. 点击"获取网站地址" 2. 复制访问链接 3. 在浏览器中打开，即可与OpenClaw对话 优势与限制 优势： 价格极低（首月元） 一键配置，无需手动安装 集成百度千帆大模型 自动配置APIKey 限制： ⚠ 仅限首月优惠 ⚠ 需要实名认证 ⚠ 活动可能售罄 阿里云部署（可选） 阿里云也提供了OpenClaw一键部署方案： 1. 访问活动页面： 2. 选择轻量应用服务器： 使用 OpenClaw镜像 一键安装配置 3. 价格参考： 与腾讯云类似 具体以活动页面为准 官方视频教程（强烈推荐） 腾讯云提供了详细的视频教程，跟着视频操作更简单： 1. 云上OpenClaw一键部署并接入企微和QQ 视频地址： 时长：约10分钟 内容：从购买到配置完成 2. 云上OpenClaw一键部署并接入飞书和钉钉 视频地址： 时长：约10分钟 内容：飞书和钉钉接入全流程 存量服务器部署 如果你已经有轻量服务器，可以使用AI助手对话式部署： 官方教程： 适用场景：已有轻量服务器 部署方式：通过AI对话完成配置 优势：更灵活，可自定义 云端部署常见问题 Q1: 云端部署安全吗？ 数据存储在你的服务器上 只有你能访问 可以设置访问密码 Q2: 可以随时停止吗？ 可以随时删除服务器 按使用时长计费 不用了就删除，不浪费钱 Q3: 手机怎么访问？ 通过QQ、企微、飞书等平台 详见第9章：多平台集成 国内一键安装（推荐） 国内用户推荐：使用官方中文版一键安装脚本，速度快、配置简单。 为什么选择国内版？ 国内版相比国际版具有多项本地化优势，如表 2-3 所示。 表 2-3 国内版优势 优势 说明 ⚡ 速度快 使用国内镜像源，下载速度快 中文友好完整中文界面和提示 📦 一键安装 自动配置所有依赖 开箱即用 预配置国内常用服务 💰 成本优化 默认配置国产模型 前置要求 必需环境： +（必需） pnpm（可选，推荐用于源码构建） 推荐配置： Brave Search API 密钥（用于网络搜索） 可通过 openclaw-cn configure --section web 配置 系统要求： macOS：需要 Xcode / Command Line Tools（仅 CLI + Gateway 需要 ） Windows：强烈推荐使用 WSL2（Ubuntu），原生 Windows 未经测试 Linux：Ubuntu +、Debian、CentOS 快速开始 macOS/Linux 安装 # 使用国内官方安装脚本 curl -fsSL | bash Windows 安装 使用 PowerShell（管理员权限）： # 使用国内官方安装脚本 iwr -useb | iex ⚠ Windows 用户注意：强烈推荐使用 WSL2（Ubuntu），原生 Windows 支持有限。 WSL2 安装步骤： # 1. 安装 WSL2 wsl --install # 2. 重启电脑 # 3. 在 WSL2 中运行 Linux 安装命令 curl -fsSL | bash 全局安装（替代方案） 如果一键脚本失败，可以使用 npm 全局安装： # 使用 npm npm install -g openclaw-cn@latest # 或使用 pnpm（推荐） pnpm add -g openclaw-cn@latest 运行入门向导 安装完成后，运行配置向导： # 运行入门向导并安装后台服务 openclaw-cn onboard --install-daemon 配置向导流程 向导会引导你完成以下配置： 1. 选择网关模式： 本地网关（推荐）：Gateway 运行在本机 远程网关：Gateway 运行在服务器 2. 配置认证： OpenAI Code（Codex）订阅（OAuth） API 密钥（推荐用于 Anthropic） 也支持 claude setup-token 3. 选择 AI 提供商： 推荐：Kimi、DeepSeek、GLM-4（国产模型） 可选：Claude、GPT（需要 API key） 4. 配置聊天平台（可选）： WhatsApp：QR 扫码登录 Telegram：输入 Bot Token Discord：输入 Bot Token Mattermost：插件令牌 飞书/企微/钉钉：输入应用凭证 5. 安装后台服务（推荐）： macOS：使用 launchd Linux：使用 systemd WSL2：使用 systemd 运行时：Node（推荐，WhatsApp/Telegram 必需） 6. 网关令牌： 向导默认生成一个令牌 存储在 中 即使在回环地址上也会生成 认证配置说明 认证存储位置（重要）： 推荐的 Anthropic 路径：设置 API 密钥（向导可存储） OAuth 凭据（旧版导入）： ~/.openclaw/credentials/ 认证配置文件： ~/.openclaw/agents/<agentId>/agent/ 无头/服务器提示： 先在普通机器上完成 OAuth 然后将 复制到网关主机 启动 Gateway 如果安装了后台服务，Gateway 应该已经在运行： # 检查 Gateway 状态 openclaw-cn gateway status 手动运行（前台）： # 在前台运行，查看实时日志 openclaw-cn gateway --port 18789 --verbose Dashboard 访问： 本地回环地址： :18789/ 如果配置了令牌，需要将其粘贴到控制界面设置中（存储为 ）。 ⚠ Bun 警告（WhatsApp + Telegram）：Bun 在这些渠道上有已知问题。如果使用 WhatsApp 或 Telegram，请使用 Node 运行网关。 快速验证（2分钟） # 检查状态 openclaw-cn status # 健康检查 openclaw-cn health 配对 + 连接聊天界面 WhatsApp（二维码登录） # 登录 WhatsApp openclaw-cn channels login 通过 WhatsApp → 设置 → 已连接的设备 扫描二维码。 Telegram / Discord / 其他 向导可以为你写入令牌/配置。如果手动配置： Telegram： openclaw-cn channels add \ --channel telegram \ --token "YOUR_BOT_TOKEN" Discord： openclaw-cn channels add \ --channel discord \ --token "YOUR_BOT_TOKEN" Telegram 私信提示：首次私信会返回配对码，需要批准后机器人才会响应。 私信安全（配对审批） 默认策略：未知私信会收到短代码，消息在获得批准前不会被处理。 如果首次私信没有得到回复，需要批准配对： # 查看配对列表 openclaw-cn pairing list whatsapp # 批准配对 openclaw-cn pairing approve whatsapp <code> 从源码运行（开发） 如果需要修改 OpenClaw 本身，可以从源码运行： # 克隆仓库 git clone cd clawdbot # 安装依赖 pnpm install # 构建 UI（首次运行时自动安装 UI 依赖） pnpm ui:build # 构建项目 pnpm build # 运行入门向导 openclaw-cn onboard --install-daemon 如果还没有全局安装，可以从仓库中通过 pnpm openclaw-cn ... 运行命令。 从源码运行 Gateway： node dist/ gateway --port 18789 --verbose 端到端验证 在新终端中，发送测试消息： # 发送测试消息 openclaw-cn message send --target +15555550123 --message "Hello from OpenClaw" 如果 openclaw-cn health 显示 "no auth configured"，需要返回向导设置 OAuth/密钥认证。 调试提示： openclaw-cn status --all： 佳的只读调试报告 openclaw-cn health：向运行中的网关请求健康快照 openclaw-cn status --deep：深度状态检查 配置文件位置 详细说明: 完整的配置文件结构和使用指南请参考 配置文件结构完整指南 # 主配置文件 ~/.openclaw/ # 认证配置 ~/.openclaw/agents/<agentId>/agent/ # OAuth 凭据（旧版） ~/.openclaw/credentials/ # 日志文件 ~/.openclaw/logs/ 国内版特色功能 1. 预配置国产模型： Kimi（月之暗面） DeepSeek（深度求索） GLM-4（智谱 AI） 通义千问（阿里） 文心一言（百度） 2. 国内平台集成： 飞书（字节跳动） 企业微信（腾讯） 钉钉（阿里） QQ（腾讯） 3. 优化的网络配置： 使用国内镜像源 优化 API 访问速度 支持代理配置 常见问题 Q1: 安装失败怎么办？ # 检查 版本（需要 22+） node --version # 如果版本过低，使用 nvm 升级 nvm install 22 nvm use 22 Q2: 如何更新到 新版本？ # 重新运行安装脚本 curl -fsSL | bash Q3: 如何卸载？ # 停止服务 openclaw-cn gateway stop # 卸载 npm uninstall -g openclaw-cn # 删除配置（可选） rm -rf ~/.openclaw Q4: 支持哪些系统？ macOS 12+ Linux（Ubuntu +、Debian、CentOS） Windows 10/11（通过 WSL2） Q5: 配置向导卡住怎么办？ # 按 Ctrl+C 中断 # 检查网关是否运行 openclaw-cn gateway status # 重新启动网关并重试 openclaw-cn gateway restart openclaw-cn onboard Q6: 健康检查显示 "no auth configured" 需要配置认证： # 重新运行向导 openclaw-cn onboard # 或手动配置 API 密钥 openclaw-cn configure --section auth 下一步（可选，但很棒） macOS 菜单栏应用 + 语音唤醒：macOS 应用 iOS/Android 节点（Canvas/摄像头/语音）：节点 远程访问（SSH 隧道 / Tailscale 服务）：远程访问 始终在线 / VPN 设置：Tailscale 下一步 安装完成后，可以： 1. 配置 AI 模型（见下文"API配置指南"） 2. 连接聊天平台（见第9章：多平台集成） 3. 安装 Skills（见第8章：Skills扩展） 4. 开始使用（见第3章：快速上手) Cloudflare Workers 部署（进阶） ☁ 全球 CDN 加速：使用 Cloudflare Workers 部署 OpenClaw，享受全球边缘网络加速。 为什么选择 Cloudflare Workers？ Cloudflare Workers 提供全球边缘网络部署能力，如表 2-4 所示。 表 2-4 Cloudflare Workers 优势 优势 说明 🌍 全球加速 部署在 Cloudflare 全球边缘网络 💰 成本可控 5美元/月起步，24小时在线 🔒 安全可靠 内置 Zero Trust 安全认证 ⚡ 快速部署 一键部署，10分钟完成 📦 无需服务器 Serverless 架构，无需维护 前置要求 必需条件： Cloudflare 账号 Workers Paid 计划（5美元/月） 信用卡（用于订阅付费计划） 成本说明： 基础费用：5美元/月（起步价） 高频使用可能产生额外费用 作为 24 小时在线的 AI 服务，月成本在可接受范围内 成本参考：详见 GitHub 讨论：What's the cost running it 24/7 for a month 部署流程 第一步：一键部署 Moltworker 1. 点击部署按钮： 2. 配置 Gateway Token： 务必修改并妥善保存 MOLTBOT_GATEWAY_TOKEN 这是后续进入管理后台的唯一凭证 建议使用强密码生成器 第二步：等待构建 部署过程约需 10 分钟 可点击「继续处理项目」跳过等待页面 构建完成后会自动跳转到项目页面 第三步：配置 Access（Zero Trust） 访问网页界面需要配置 CF_ACCESS_AUD 和 CF_ACCESS_TEAM_DOMAIN 两个变量。 1. 创建应用： 进入 Zero Trust → Access → Applications 添加一个 Self-hosted 应用 2. 设置域名： 子域默认为 moltbot-sandbox 域名可使用 Cloudflare 分配的 Worker 域名或自定义域名 Session Duration（会话时间）建议设置长一些，避免频繁登录 3. 配置策略： 系统会自动创建 moltbot-sandbox - Production 策略 默认通过邮箱验证码登录 4. 获取配置变量： CF_ACCESS_AUD： 保存应用后，点击右侧「⋮」编辑 在应用程序受众（AUD）标签页找到 Application Audience (AUD) CF_ACCESS_TEAM_DOMAIN： 进入 Zero Trust → Settings 团队域名格式： 第四步：配置 R2 对象存储 OpenClaw 需要 R2 来存储状态，需配置以下三个变量： CF_ACCOUNT_ID R2_ACCESS_KEY_ID R2_SECRET_ACCESS_KEY 操作步骤： 1. 获取 Account ID： 在 Cloudflare 侧边栏进入 R2 → Overview 右侧 Account Details 中的 Account ID 即为 CF_ACCOUNT_ID 2. 创建 API 令牌： 点击 Manage R2 API Tokens 选择 Create API Token 3. 设置权限： 权限选择 Object Read & Write 建议范围通过 Specific Bucket 限制在 moltbot-data 4. 保存密钥： 创建成功后，记录 Access Key ID 和 Secret Access Key ⚠ 重要提示：修改 Token 时请务必核对变量名称。如果不慎修改了 Build Token，会导致 Worker 构建失败。 第五步：注入变量并重启 1. 进入设置： Workers → Settings → Variables and Secrets 2. 填入变量： MOLTBOT_GATEWAY_TOKEN（第一步设置的） CF_ACCESS_AUD（第三步获取的） CF_ACCESS_TEAM_DOMAIN（第三步获取的） CF_ACCOUNT_ID（第四步获取的） R2_ACCESS_KEY_ID（第四步获取的） R2_SECRET_ACCESS_KEY（第四步获取的） 3. 重新部署： 点击 Deploy 重新部署 等待部署完成 访问与管理 部署完成后，可通过以下地址访问： 访问 Worker（需要 token）： 管理后台（需要邮箱验证）： 通过 Cloudflare Access 的邮箱验证码验证后，即可进入管理后台并接受 Pairing Requests。 基础使用 查看或切换模型 # 查看当前模型 /model # 切换模型 /model minimax/ 设置开机自启命令 为了避免 Worker 重启后模型被重置，建议设置开机自启命令： set model minimax/ 远程终端连接 # 登录到 Gateway openclaw gateway login --url # 配置 Skills openclaw configure --section skills 避坑指南 问题 1：模型配置报错 症状：通过配置文件修改默认模型后报错 原因：国内 AI 服务商通常区分国内与海外端点，Cloudflare Workers 环境下配置文件修改容易出错 解决方案： 直接通过开机命令强制指定模型 不要依赖配置文件或后台 UI 使用 set model 命令设置开机自启 问题 2：Worker 构建失败 症状：部署后 Worker 无法启动 原因：不慎修改了 Build Token 解决方案： 检查所有变量名称是否正确 确保没有修改 Build Token 重新部署 问题 3：无法访问管理后台 症状：访问 /_admin/ 时无法登录 原因：Zero Trust 配置不正确 解决方案： 检查 CF_ACCESS_AUD 和 CF_ACCESS_TEAM_DOMAIN 是否正确 确认邮箱验证码是否正确 检查 Session Duration 设置 成本估算 项目 费用 说明 Workers Paid 计划 5美元/月 基础费用 额外请求费用 按量计费 高频使用时产生 R2 存储 免费额度内 通常不会超出 总计 5-10美元/月取决于使用频率 适用场景 推荐使用： 想低成本尝试 OpenClaw 已有 Cloudflare 付费订阅 需要全球 CDN 加速 不想维护服务器 不推荐使用： 期望开箱即用 没有技术背景 需要复杂的自动化流程 预算非常有限 总结 Cloudflare Workers + OpenClaw 是一个低成本的尝鲜方案，适合： 未体验过 Agent 自动化，想低成本试手 已有 Cloudflare 付费订阅，资源闲置 需要全球 CDN 加速的场景 但需要注意： OpenClaw 目前还不是一个能「即刻提升效率」的工具 更像是一个为 AI 自动化搭建的系统底座 如果没有明确的、可标准化的长流程需求，可能只会带来维护成本 下一步： 配置 AI 模型（见下文"API配置指南"） 配置通讯渠道（见第9章：多平台集成） 安装 Skills（见第8章：Skills扩展） Docker 部署（可选） 开发者选项：Docker 部署适合需要环境隔离的场景。 为什么选择 Docker？ Docker 部署提供环境隔离和便捷管理，如表 2-5 所示。 表 2-5 Docker 部署优势 优势 说明 🔒 环境隔离 不影响系统环境，干净整洁 📦 一键部署无需配置依赖，开箱即用 易于更新 一条命令完成更新 跨平台 Windows/macOS/Linux 统一方案 快速启动 5分钟完成部署 前置要求 安装 Docker： macOS： # 下载 Docker Desktop # 访问： # 或使用 Homebrew brew install --cask docker Windows： # 下载 Docker Desktop # 访问： # 安装 WSL2（如果还没安装） wsl --install Linux (Ubuntu)： # 安装 Docker curl -fsSL | sh # 启动 Docker 服务 sudo systemctl start docker sudo systemctl enable docker # 添加当前用户到 docker 组 sudo usermod -aG docker $USER 验证安装： docker --version # 应显示：Docker version 快速开始 方式一：一键脚本部署（推荐新手） 简单的方式，一条命令搞定所有配置！ curl -fsSL | bash 这个脚本会自动： 检查 Docker 环境 下载镜像（使用国内镜像： jiulingyun803/openclaw-cn:latest） 配置环境变量 启动容器 运行配置向导 生成网关令牌 完成后，在浏览器打开 :18789/ 即可使用。 脚本后续操作： 按照提示输入渠道信息（可选） 将生成的令牌复制到 Web UI 登录 方式二：手动 Docker Compose 部署（适合进阶用户） 如果一键脚本不适用，或需要自定义配置，按以下步骤操作。 步骤 1：创建工作目录 mkdir -p ~/openclaw-docker cd ~/openclaw-docker 步骤 2：创建 .env 环境文件 cat > .env << 'EOF' # 镜像配置（使用国内镜像） OPENCLAW_IMAGE=jiulingyun803/openclaw-cn:latest # 数据目录 OPENCLAW_CONFIG_DIR=./data/.openclaw OPENCLAW_WORKSPACE_DIR=./data/clawd # 网关配置 OPENCLAW_GATEWAY_PORT=18789 OPENCLAW_BRIDGE_PORT=18790 OPENCLAW_GATEWAY_BIND=lan OPENCLAW_GATEWAY_TOKEN=your-secure-token-here # Claude 集成（可选） CLAUDE_AI_SESSION_KEY= CLAUDE_WEB_SESSION_KEY= CLAUDE_WEB_COOKIE= EOF 步骤 3：创建 文件 services: openclaw-cn-gateway: image: ${OPENCLAW_IMAGE:-jiulingyun803/openclaw-cn:latest} user: node:node environment: HOME: /home/node TERM: xterm-256color OPENCLAW_GATEWAY_TOKEN: ${OPENCLAW_GATEWAY_TOKEN} CLAUDE_AI_SESSION_KEY: ${CLAUDE_AI_SESSION_KEY} CLAUDE_WEB_SESSION_KEY: ${CLAUDE_WEB_SESSION_KEY} CLAUDE_WEB_COOKIE: ${CLAUDE_WEB_COOKIE} volumes: - ${OPENCLAW_CONFIG_DIR:-./data/.openclaw}:/home/node/.openclaw - ${OPENCLAW_WORKSPACE_DIR:-./data/clawd}:/home/node/clawd ports: - "${OPENCLAW_GATEWAY_PORT:-18789}:18789" - "${OPENCLAW_BRIDGE_PORT:-18790}:18790" init: true restart: unless-stopped command: [ "node", "dist/", "gateway", "--bind", "${OPENCLAW_GATEWAY_BIND:-lan}", "--port", "${OPENCLAW_GATEWAY_PORT:-18789}" ] openclaw-cn-cli: image: ${OPENCLAW_IMAGE:-jiulingyun803/openclaw-cn:latest} user: node:node environment: HOME: /home/node TERM: xterm-256color BROWSER: echo CLAUDE_AI_SESSION_KEY: ${CLAUDE_AI_SESSION_KEY} CLAUDE_WEB_SESSION_KEY: ${CLAUDE_WEB_SESSION_KEY} CLAUDE_WEB_COOKIE: ${CLAUDE_WEB_COOKIE} volumes: - ${OPENCLAW_CONFIG_DIR:-./data/.openclaw}:/home/node/.openclaw - ${OPENCLAW_WORKSPACE_DIR:-./data/clawd}:/home/node/clawd stdin_open: true tty: true init: true entrypoint: ["node", "dist/"] 步骤 4：启动容器 # 拉取最新镜像 docker compose pull # 启动网关（后台运行） docker compose up -d openclaw-cn-gateway # 查看日志（可选） docker compose logs -f openclaw-cn-gateway 步骤 5：运行配置向导 docker compose run --rm openclaw-cn-cli onboard 配置向导会提示你： 选择网关后端（Claude、Gemini 等） 配置 Feishu、Telegram 等渠道 生成和保存配置 步骤 6：访问 Web UI 打开浏览器访问： :18789/ 将配置向导生成的令牌复制到登录页面即可。 环境变量详解 变量 含义 默认值 必 需 说明 OPENCLAW_IMAGE Docker 镜 像名称 jiulingyun803/openclaw- cn:latest 使用国内镜像，也可指定版 本号 OPENCLAW_CONFIG_DIR 配置文件目 录 ./data/.openclaw OpenClaw 配置和凭证存储 位置 OPENCLAW_WORKSPACE_DIR 工作空间目 录 ./data/clawd 代理工作文件存储位置 OPENCLAW_GATEWAY_PORT 网关端口号 18789 访问 Web UI 的端口 OPENCLAW_BRIDGE_PORT 桥接端口号 18790 用于客户端连接的端口 OPENCLAW_GATEWAY_BIND 网关绑定地 址 lan localhost（仅本机）/ lan （局域网）/ （公网， ⚠ 谨慎使用） OPENCLAW_GATEWAY_TOKEN网关认证令 牌 自动生成 Web UI 登录令牌（可自定义 或留空自动生成） CLAUDE_AI_SESSION_KEY 会话密钥 空 ⚠ 仅使用 Claude AI 作为后 端时填写 CLAUDE_WEB_SESSION_KEY Claude Web 会话 密钥 空 ⚠ 仅使用 Claude Web 版时 填写 CLAUDE_WEB_COOKIE Claude Web Cookie 空 ⚠ 仅使用 Claude Web 版时 填写 环境变量设置方式： 方式 A：编辑 .env 文件（推荐） # 编辑 .env 文件 nano .env # docker compose 会自动读取 docker compose up -d 方式 B：命令行设置 export OPENCLAW_GATEWAY_PORT=18789 docker compose up -d 方式 C：命令行临时覆盖 docker compose -e OPENCLAW_GATEWAY_PORT=8080 up -d 常用操作 查看网关状态 # 检查容器是否运行 docker compose ps # 查看网关日志 docker compose logs openclaw-cn-gateway # 实时查看日志（持续跟踪） docker compose logs -f openclaw-cn-gateway 配置渠道 通过 CLI 容器配置各类渠道： Telegram（需要机器人令牌）： docker compose run --rm openclaw-cn-cli channels add \ --channel telegram \ --token "YOUR_BOT_TOKEN" Discord（需要机器人令牌）： docker compose run --rm openclaw-cn-cli channels add \ --channel discord \ --token "YOUR_BOT_TOKEN" WhatsApp（QR 扫码）： docker compose run --rm openclaw-cn-cli channels login Feishu（需要 App ID 和 Secret）： docker compose run --rm openclaw-cn-cli onboard # 按提示输入信息 重新配置 # 重新运行配置向导 docker compose run --rm openclaw-cn-cli onboard # 查看当前配置 docker compose run --rm openclaw-cn-cli config get 重启网关 # 重启网关容器 docker compose restart openclaw-cn-gateway # 停止网关 docker compose down # 重新启动 docker compose up -d openclaw-cn-gateway 更新到 新版本 # 拉取最新镜像 docker compose pull # 重启容器（自动使用新镜像） docker compose up -d openclaw-cn-gateway 清理数据（谨慎操作） # 停止并删除容器 docker compose down # 删除本地数据目录 rm -rf ./data/ # 删除本地镜像（可选） docker rmi jiulingyun803/openclaw-cn:latest 数据持久化 Docker 容器的数据存储在工作目录的 data 文件夹： ~/openclaw-docker/data/ ├── .openclaw/ # 配置文件 │ ├── # 主配置 │ └── logs/ # 日志文件 └── clawd/ # 工作空间 └── workspace/ # 代理工作文件 备份数据： # 备份配置和数据 tar -czf openclaw-backup-$(date +%Y%m%d). ./data # 恢复数据 tar -xzf Docker 部署常见问题 问题 1：容器无法启动 症状： docker compose up 后容器立即退出 解决方案： # 查看详细错误日志 docker compose logs openclaw-cn-gateway # 检查端口是否被占用 sudo netstat -ltnp | grep 18789 # macOS 使用：lsof -i :18789 # 如果被占用，修改 OPENCLAW_GATEWAY_PORT # 编辑 .env，将端口改为其他（如 18790） nano .env 问题 2：权限拒绝（Permission Denied） 症状： Error: EACCES: permission denied, mkdir ... 解决方案： # 确保数据目录存在且权限正确 mkdir -p ./data/.openclaw ./data/clawd chmod 755 ./data/.openclaw ./data/clawd # 如果使用了宿主机路径，确保目录可写 chmod 777 ./data 问题 3：无法访问 Web UI 症状：浏览器访问 :18789 无响应 解决方案： # 检查容器是否运行 docker compose ps # 检查网关日志 docker compose logs openclaw-cn-gateway # 验证端口是否正确 # 如果 OPENCLAW_GATEWAY_PORT=18789，则访问 :18789 # 如果改了端口，访问对应的新端口 # 检查防火墙设置 # macOS sudo pfctl -d # 临时关闭防火墙测试 # Linux sudo ufw status sudo ufw allow 18789 问题 4：配置向导卡住 症状： docker compose run --rm openclaw-cn-cli onboard 无反应 解决方案： # 按 Ctrl+C 中断 # 检查网关是否运行 docker compose logs openclaw-cn-gateway # 重新启动网关并重试 docker compose restart openclaw-cn-gateway docker compose run --rm openclaw-cn-cli onboard 问题 5：镜像拉取失败（403 错误） 症状： docker pull openclaw/openclaw:latest 返回 403 错误 解决方案： # 使用国内镜像（推荐） docker pull jiulingyun803/openclaw-cn:latest # 或在 .env 文件中指定国内镜像 echo "OPENCLAW_IMAGE=jiulingyun803/openclaw-cn:latest" >> .env # 重新拉取 docker compose pull 问题 6：网络超时 症状：拉取镜像或访问 API 时网络超时 解决方案： # 配置 Docker 镜像加速（国内用户） # 编辑 Docker 配置 sudo nano /etc/docker/ # 添加镜像加速器 { "registry-mirrors": [ "", "" ] } # 重启 Docker sudo systemctl restart docker # macOS 用户在 Docker Desktop 设置中添加镜像加速器 问题 7：数据丢失 症状：重启容器后配置和数据丢失 解决方案： # 确保使用了数据卷挂载 # 检查 中的 volumes 配置 # 查看数据是否存在 ls -la ./data/.openclaw ls -la ./data/clawd # 如果数据丢失，从备份恢复 tar -xzf 问题 8：性能问题 症状：容器运行缓慢或占用资源过高 解决方案： # 限制资源使用（编辑 ） services: openclaw-cn-gateway: # ... 其他配置 deploy: resources: limits: cpus: '2' memory: 2G reservations: cpus: '1' memory: 1G # 重启容器 docker compose up -d openclaw-cn-gateway 从一键脚本迁移到手动配置 如果想从一键脚本切换到手动配置（或反之）： # 停止现有容器 docker compose down # 备份现有配置 cp -r ~/.openclaw ~/. # 更新 .env 和 # 重新启动 docker compose up -d openclaw-cn-gateway 配置会自动保留在数据目录中，无需重新设置。 Docker 部署优势总结 环境隔离：不影响系统环境 快速部署：5分钟完成 易于管理：一条命令更新 跨平台：统一部署方案 可扩展：支持多实例部署 国内优化：使用国内镜像，下载速度快 推荐使用场景： 开发者本地测试 服务器部署 多环境隔离 快速体验 OpenClaw 下一步： 配置 API 模型（见下文"API配置指南"） 配置通讯渠道（见第9章：多平台集成） 安装 Skills（见第8章：Skills扩展） 更新和维护 保持 新：定期更新 OpenClaw 以获得新功能和安全修复。 检查更新 # 检查当前版本 openclaw --version # 检查最新版本 curl -s | grep tag_name 本地安装更新 # 方式一：使用安装脚本 curl -fsSL | bash # 方式二：手动更新 cd ~/openclaw git pull origin main pnpm install pnpm build Docker 更新 # 拉取最新镜像 docker pull openclaw/openclaw:latest # 停止并删除旧容器 docker stop openclaw docker rm openclaw # 启动新容器 docker run -d \ --name openclaw \ -p 18789:18789 \ -v ~/.openclaw:/root/.openclaw \ --restart unless-stopped \ openclaw/openclaw:latest 备份数据 本地安装备份： # 备份配置和数据 tar -czf openclaw-backup-$(date +%Y%m%d). ~/.openclaw # 恢复数据 tar -xzf -C ~/ Docker 备份： # 备份数据卷 docker run --rm \ -v ~/.openclaw:/data \ -v $(pwd):/backup \ alpine tar czf /backup/openclaw-backup-$(date +%Y%m%d). /data # 恢复数据 docker run --rm \ -v ~/.openclaw:/data \ -v $(pwd):/backup \ alpine tar xzf /backup/ -C / 监控和日志 查看日志： # 本地安装 tail -f ~/.openclaw/logs/ # Docker docker logs -f openclaw 监控指标： # 查看系统状态 openclaw gateway status # 查看资源使用 openclaw stats # 查看 API 消耗 openclaw stats api 故障排查 常见问题： 1. Gateway 无法启动 # 查看日志 openclaw logs # 检查端口占用 lsof -i :18789 # 重启 Gateway openclaw gateway restart 2. API 连接失败 # 测试 API 连接 openclaw test api # 检查 API Key openclaw config get 3. 性能问题 # 清理缓存 openclaw cache clear # 重启服务 openclaw gateway restart 卸载 本地安装卸载： # 停止服务 openclaw gateway stop # 删除文件 rm -rf ~/.openclaw rm -rf ~/openclaw # 删除命令 npm uninstall -g openclaw Docker 卸载： # 停止并删除容器 docker stop openclaw docker rm openclaw # 删除镜像 docker rmi openclaw/openclaw # 删除数据 rm -rf ~/.openclaw API配置指南 OpenClaw需要连接AI模型才能工作，推荐使用国产大模型，性价比高。 为什么需要API？ OpenClaw本身不包含AI模型，需要连接第三方API： 官方API：价格贵、国内访问困难 第三方API：价格便宜、国内直连 API模型分类 OpenClaw支持两种类型的API模型配置： 1. 内置 API 模型（推荐新手） 什么是内置API模型？ OpenClaw已经预先配置好了多个主流AI模型的连接方式，你只需要： 获取API Key 在配置向导中选择对应模型 粘贴API Key即可使用 支持的内置模型： OpenClaw内置支持非常多的API模型，包括但不限于： 国内模型（推荐）： Moonshot AI (Kimi)：长文本专家，200万字上下文 DeepSeek：性价比之王，推理能力强 智谱GLM：中文理解好，多模态支持 通义千问 (Qwen)：阿里出品，稳定可靠 MiniMax：对话自然，创意能力强 📚 百度文心：中文语料丰富 字节豆包：性价比高 国外模型： OpenAI (GPT-4/)： 强大但价格贵 Anthropic (Claude)：推理能力强，安全性高 Google (Gemini)：多模态能力强 Groq：推理速度快 优势： 配置简单，无需手动编写配置文件 参数已优化，开箱即用 自动更新，跟随OpenClaw版本 适合新手，降低使用门槛 使用场景： 新手用户快速上手 使用主流大模型 不想折腾配置文件 2. 自定义 API（进阶用户） 什么是自定义API？ 如果你想使用： OpenClaw未内置的模型 自己搭建的模型服务 第三方API代理服务 企业内部的模型接口 就需要使用自定义API配置。 配置方式： 需要手动编辑配置文件 ~/.openclaw/，指定： baseUrl：API服务地址 apiKey：认证密钥 api：API协议类型（如 openai-chat、 anthropic-messages） models：模型列表和参数 优势： 灵活性高，支持任何兼容的API 可以使用小众模型 可以自定义模型参数 适合企业定制化需求 劣势： ⚠ 配置复杂，需要了解JSON格式 ⚠ 需要手动维护配置 ⚠ 参数错误可能导致无法使用 使用场景： 进阶用户 使用非主流模型 企业内部部署 需要精细控制参数 配置方式对比 两种配置方式的对比如表 2-6 所示。 表 2-6 API 配置方式对比 特性 内置API模型 自定义API 配置难度 ⭐ 简单 ⭐⭐⭐⭐ 复杂 适用人群新手 进阶用户 模型选择主流模型 任意模型 配置方式向导选择 手动编辑 维护成本低 高 灵活性 中 高 推荐配置路径 新手推荐： 1. 使用内置API模型 2. 选择国产模型（如 Kimi、DeepSeek） 3. 通过 openclaw onboard 向导配置 4. 先体验，熟悉后再考虑自定义 进阶用户： 1. 先用内置API模型熟悉OpenClaw 2. 了解配置文件结构 3. 根据需求添加自定义API 4. 测试验证后投入使用 自定义API配置（进阶用户） ⚠ 适合人群：进阶用户、需要使用非主流模型、企业定制化需求 什么时候需要自定义API？ 如果你遇到以下情况，需要使用自定义API配置： 1. 使用非内置模型： OpenClaw未内置的小众模型 新发布的模型（OpenClaw还未更新） 区域限定的模型 2. 使用第三方代理： API代理服务（如 OpenRouter、API2D） 企业内部的API网关 自建的模型服务 3. 精细控制参数： 自定义模型参数 调整上下文窗口大小 修改默认配置 配置文件位置 详细说明: 完整的配置文件结构和使用指南请参考 配置文件结构完整指南 # 配置文件路径 ~/.openclaw/ # 编辑配置文件 nano ~/.openclaw/ 配置文件结构 { "models": { "mode": "merge", "providers": { "你的供应商名称": { "baseUrl": "API服务地址", "apiKey": "你的API 密钥", "auth": "认证方式", "api": "API协议类型", "models": [ { "id": "模型ID", "name": "模型显示名称", "contextWindow": 上下文窗口大小, "maxTokens": 最大输出tokens } ] } } }, "agents": { "defaults": { "model": { "primary": "供应商名称/模型ID" } } } } 示例1：配置DeepSeek（自定义方式） { "models": { "mode": "merge", "providers": { "deepseek": { "baseUrl": "", "apiKey": "sk-你的API 密钥", "auth": "api-key", "api": "openai-chat", "models": [ { "id": "deepseek-chat", "name": "DeepSeek Chat", "contextWindow": 64000, "maxTokens": 4096 }, { "id": "deepseek-coder", "name": "DeepSeek Coder", "contextWindow": 64000, "maxTokens": 4096 } ] } } }, "agents": { "defaults": { "model": { "primary": "deepseek/deepseek-chat" } } } } 示例2：配置第三方API代理 如果你使用API代理服务（如OpenRouter），配置如下： { "models": { "mode": "merge", "providers": { "openrouter": { "baseUrl": " "apiKey": "sk-or-v1-你的密钥", "auth": "api-key", "api": "openai-chat", "models": [ { "id": "anthropic/-sonnet", "name": "Claude Sonnet", "contextWindow": 200000, "maxTokens": 8192 }, { "id": "openai/gpt-4", "name": "GPT-4", "contextWindow": 128000, "maxTokens": 4096 } ] } } }, "agents": { "defaults": { "model": { "primary": "openrouter/anthropic/-sonnet" } } } } 示例3：配置多个模型供应商 你可以同时配置多个供应商，根据需要切换： { "models": { "mode": "merge", "providers": { "deepseek": { "baseUrl": "", "apiKey": "sk-你的DeepSeek密钥", "auth": "api-key", "api": "openai-chat", "models": [ { "id": "deepseek-chat", "name": "DeepSeek Chat", "contextWindow": 64000, "maxTokens": 4096 } ] }, "moonshot": { "baseUrl": " "apiKey": "sk-你的Kimi密钥", "auth": "api-key", "api": "openai-chat", "models": [ { "id": "moonshot-v1-128k", "name": "Kimi 128K", "contextWindow": 128000, "maxTokens": 4096 } ] } } }, "agents": { "defaults": { "model": { "primary": "deepseek/deepseek-chat", "fallback": "moonshot/moonshot-v1-128k" } } } } 配置参数说明 参数 说明 示例 baseUrl API服务地址 apiKey API 密钥 sk-xxx auth 认证方式 api-key 或 bearer api API协议 openai-chat、 anthropic-messages id 模型ID deepseek-chat name 显示名称 DeepSeek Chat contextWindow 上下文窗口 64000 maxTokens 大输出 4096 常见API协议类型 openai-chat：OpenAI兼容接口（ 常用） anthropic-messages：Anthropic Claude接口 google-generative-ai：Google Gemini接口 azure-openai：Azure OpenAI接口 配置后重启服务 # 方式1：重启Gateway openclaw gateway restart # 方式2：停止后重新启动 systemctl --user stop systemctl --user start # 方式3：完全重启 systemctl --user restart 验证配置 # 查看当前配置的模型 openclaw models list # 测试模型连接 openclaw models test deepseek/deepseek-chat 常见问题 Q1：配置后无法连接？ 检查项： baseUrl是否正确 apiKey是否有效 网络是否能访问API地址 配置文件JSON格式是否正确 Q2：如何切换模型？ # 临时切换 openclaw agent --message --model deepseek/deepseek-chat # 永久切换：修改配置文件中的 primary 字段 Q3：如何添加多个模型？ 在 models 数组中添加多个模型对象即可 每个模型需要有唯一的 id 内置API模型配置（推荐新手） 适合人群：新手用户、想要快速上手的用户 以下是几个常用的内置API模型配置教程，选择一个你喜欢的即可。 1. Kimi 配置（推荐） 特点： 📚 超长上下文：支持200万字 长文档处理：论文、报告分析专家 中文理解好：适合中文场景 💰 套餐划算：重度使用建议购买套餐 配置步骤： 第一步：访问Kimi Code平台 访问： 第二步：购买套餐（可选） 提示：OpenClaw消耗token较大，建议购买套餐更划算。 推荐套餐： Allegretto套餐：适合日常使用 按需选择其他套餐 第三步：创建API Key 1. 打开控制台 2. 创建API Key 3. 名称随便取 第四步：保存API Key ⚠ 重要：这个API Key一定要复制并保存！点击"完成"后就无法再查看了。 第五步：配置到OpenClaw # 运行配置向导 openclaw onboard # 配置流程： # 1. 选择 QuickStart # 2. 选择模型供应商：Moonshot AI # 3. 粘贴刚才复制的API Key # 4. 选择默认模型：kimi-code/kimi-for-codi # 5. 完成其他配置 成本估算： 轻度使用：10-20元/月 中度使用：30-50元/月 重度使用：建议购买套餐 2. DeepSeek 配置（性价比之王） 特点： 💰 便宜：输入元/千tokens 推理能力强：适合复杂任务 💻 编程能力出色：代码生成质量高 配置步骤： 第一步：注册并充值 访问： ⚠ 注意：DeepSeek采用按量付费，账户余额必须大于0才能调用API。 第二步：充值账户 建议先充值10元试用： 第三步：创建API Key 1. 保证账号有余额 2. 点击"API keys" 3. 点击"创建API key" 第四步：保存API Key ⚠ 重要：API Key只显示一次，务必复制保存！ 名称随便取，复制API Key后妥善保存。 第五步：配置到OpenClaw # 运行配置向导 openclaw onboard # 配置流程： # 1. 选择 QuickStart # 2. 选择模型供应商：DeepSeek # 3. 粘贴API Key # 4. 选择默认模型：deepseek-chat # 5. 完成其他配置 成本估算： 日常使用：5-10元/月 中度使用：10-30元/月 重度使用：30-50元/月 国产大模型配置（其他选项） 1. DeepSeek配置（性价比之王） 特点： 💰 便宜：输入元/千tokens 推理能力强：适合复杂任务 💻 编程能力出色：代码生成质量高 DeepSeek 的 API 调用是按量付费的，你的账户余额必须大于 0 才能正常调用接口。 如果账户没钱或余额不足，API 请求会直接失败，所以提前充值是保证服务可用的必要操作。 其他大模型也是同理，你要去找到对应网址去充值，然后获取API keys 如果你只想先试试，可以就先花个10块钱玩一下 保证账号有余额之后，点击”API keys“，然后点”创建 API key“ API key的名称：随便取。然后这个APIkey一定！一定！要复制下来，因为一般你点完”关闭“之后，你就 再也无法查看你的API key了，如果你我忘记了你的API key，那只能重新创建一个了。 复制完后，找地方先存起来，后续在”第四步：OpenClaw 配置“的时候会用到 好，至此”第二步：配置模型“完成，进入”第三步：配置Bot“吧 配置步骤： 1. 注册账号： 访问： 注册并登录 2. 获取API Key： 进入"API管理" 点击"创建API Key" 复制API Key（格式：sk-xxx） 3. 配置到OpenClaw： # 编辑配置文件 nano ~/.openclaw/ 添加配置： { "models": { "mode": "merge", "providers": { "deepseek": { "baseUrl": "", "apiKey": "sk-你的API 密钥", "auth": "api-key", "api": "openai-chat", "models": [ { "id": "deepseek-chat", "name": "DeepSeek Chat", "contextWindow": 64000, "maxTokens": 4096 } ] } } }, "agents": { "defaults": { "model": { "primary": "deepseek/deepseek-chat" } } } } 4. 重启Gateway： openclaw gateway restart 成本估算： 日常使用：5-10元/月 中度使用：10-30元/月 重度使用：30-50元/月 2. Kimi配置（长文本专家） 特点： 📚 超长上下文：支持200万字 长文档处理：论文、报告分析专家 中文理解好：适合中文场景 那如何使用，第一步，搜索 kimi code： 第二步，购买优惠套餐 plan，说实话，目前 OpenClaw 消耗 token 还挺大的， 好买个套餐划算一些， 我买的是 Allegretto 套餐。 第二步，打开控制台，创建 API key。名字随便取。 这个APIkey一定！一定！要复制下来，因为一般你点完”完成“之后，你就再也无法查看你的API key了， 如果你忘记了你的API key，那就只能重新创建一个了。复制完后，找地方先存起来，后续在”第四步： OpenClaw 配置“的时候会用到 配置步骤： 1. 注册账号： 访问： 注册并登录 2. 获取API Key： 进入"API管理" 点击"创建API Key" 复制API Key 3. 配置到OpenClaw： { "models": { "mode": "merge", "providers": { "moonshot": { "baseUrl": " "apiKey": "sk-你的API 密钥", "auth": "api-key", "api": "openai-chat", "models": [ { "id": "moonshot-v1-8k", "name": "Kimi ", "contextWindow": 8000, "maxTokens": 4096 } ] } } }, "agents": { "defaults": { "model": { "primary": "moonshot/moonshot-v1-8k" } } } } 成本估算： 日常使用：10-20元/月 中度使用：20-50元/月 重度使用：50-100元/月 3. 其他国产大模型 模型 特点 价格 官网 GLM-4 多模态能力强中等 文心一言百度生态 中高 通义千问阿里生态 中等 国际模型配置（可选） 如果需要使用Claude、GPT等国际模型： 1. 直接使用官方API（需要魔法） 2. 使用第三方API服务（国内直连） 推荐第三方API： 价格便宜50%-70% 国内直连，无需魔法 支持支付宝、微信支付 成本对比 模型 输入价格 输出价格 月费用估算 DeepSeek 元/千tokens 元/千tokens 5-30元 Kimi 元/千tokens 元/千tokens 10-50元 GLM-4 元/千tokens 元/千tokens 10-40元 Claude（第三方） 元/千tokens 元/千tokens 50-200元 GPT-4（第三方） 元/千tokens 元/千tokens 100-300元 省钱技巧： 日常对话用DeepSeek（ 便宜） 长文档用Kimi（长上下文） 复杂任务用Claude（质量 高） 常见问题解决 安装问题 Q1: 版本不对 # 检查版本 node --version # 如果低于22，升级 nvm install 22 nvm use 22 Q2: 权限错误 # macOS/Linux sudo chown -R $USER ~/.openclaw # Windows # 以管理员身份运行PowerShell Q3: 网络连接失败 检查网络连接 尝试使用代理 或使用云端部署 API配置问题 Q1: API Key无效 检查是否完整复制（包括sk-前缀） 检查是否有多余空格 检查账户余额是否充足 Q2: 模型不可用 检查模型ID是否正确 检查API服务是否正常 尝试切换其他模型 Q3: Token消耗太快 使用更便宜的模型（DeepSeek） 优化提示词 定期清理会话历史 Gateway问题 Q1: Gateway无法启动 # 查看日志 tail -f ~/.openclaw/logs/ # 重启Gateway openclaw gateway restart Q2: 端口被占用 # 查看端口占用 lsof -i :18789 # 修改端口 openclaw config set 18790 版本升级指南 保持 新：定期升级OpenClaw以获得新功能、性能优化和安全修复。 ⚠ 重要提示：目前推荐使用 版本。 版本存在已知 bug（Issue #15141），会导致 heartbeat 和消息处理功能异常。 推荐版本 当前推荐版本： 已知问题版本： ：Session 路径验证 bug，影响 heartbeat 和 Telegram/飞书消息处理 为什么要升级？ OpenClaw持续迭代更新，升级可以获得： 新功能和改进 性能优化 安全修复 Bug修复 更好的兼容性 检查当前版本 # 查看当前版本 openclaw --version # 查看配置文件版本 cat ~/.openclaw/ | grep version 如果配置文件版本比当前版本新，说明需要升级。 升级方式选择 根据你的安装方式选择对应的升级方法： 安装方式 升级方法 难度 推荐度 云端部署 重新部署镜像 ⭐ ⭐⭐⭐⭐⭐ Docker 拉取新镜像 ⭐⭐ ⭐⭐⭐⭐⭐ 本地安装（npm） npm升级 ⭐⭐⭐ ⭐⭐⭐⭐ 本地安装（源码） git pull ⭐⭐⭐⭐ ⭐⭐⭐ 方式一：npm直接升级（推荐） 这是 可靠的升级方式，适用于通过npm安装的用户。 升级步骤 第一步：备份配置 # 备份整个配置目录 cp -r ~/.openclaw ~/.-$(date +%Y%m%d) # 验证备份 ls -la ~/.-* 第二步：停止Gateway服务 # 停止Gateway openclaw gateway stop # 验证已停止 openclaw gateway status 第三步：卸载旧版本 # 卸载旧版本 npm uninstall -g openclaw # 验证卸载 which openclaw # 应该没有输出 第四步：安装新版本 # 安装推荐版本 （需要使用--force参数） npm install -g openclaw@ --force ⚠ 版本选择说明： 推荐安装 版本（稳定） 避免安装 版本（存在 session 路径 bug） 如果需要 新功能，等待 + 版本修复后再升级 ⚠ 为什么需要--force？ npm会检测到已存在的文件，使用 --force强制覆盖。 第五步：修复配置 # 运行doctor工具自动修复配置 openclaw doctor --fix doctor工具会自动： 更新Gateway服务入口点路径 检查配置兼容性 修复已知问题 重新安装LaunchAgent（macOS）或systemd服务（Linux） 第六步：重启Gateway # 重启Gateway openclaw gateway restart # 等待几秒后检查状态 sleep 5 openclaw gateway status 第七步：验证升级 # 检查版本 openclaw --version # 检查Gateway状态 openclaw gateway status # 测试连接 openclaw channels status 成功的输出应该显示： Runtime: running (pid xxxxx, state active) RPC probe: ok Listening: *:18789 Dashboard: :18789/ 升级示例 以下是一次真实的升级过程： 图：升级前版本检查，配置文件版本(-3)比当前版本()新 图：使用npm install --force安装新版本 图：升级完成，版本更新到 方式二：官方脚本升级 使用官方提供的一键升级脚本。 # 运行升级脚本 curl -fsSL | bash 优点： 一键完成 自动处理依赖 缺点： 可能遇到npm错误 不如方式一可靠 如果遇到错误： 切换到方式一（npm直接升级） 或查看下文的故障排查 方式三：Docker升级 如果使用Docker部署，升级非常简单。 # 停止并删除旧容器 docker compose down # 拉取最新镜像 docker compose pull # 启动新容器 docker compose up -d openclaw-cn-gateway # 查看日志 docker compose logs -f openclaw-cn-gateway 方式四：云端部署升级 腾讯云Lighthouse 1. 进入轻量应用服务器控制台 2. 选择你的OpenClaw实例 3. 点击"重置应用" 4. 选择 新的OpenClaw镜像 5. 等待重置完成 6. 重新配置API（配置会保留） 升级后的变化 配置文件自动迁移 升级后，doctor工具会自动： 更新配置文件格式 迁移旧版本配置 创建备份文件： ~/.openclaw/ 服务管理改进 macOS： LaunchAgent自动重新安装 服务路径更新为新版本 日志位置： ~/.openclaw/logs/ Linux： systemd服务自动更新 服务路径更新为新版本 日志位置： ~/.openclaw/logs/ 已知警告 升级后可能看到一些警告，这些通常不影响使用： Config warnings: - : plugin feishu: duplicate plugin id detected 说明：这是一个已知的插件重复警告，不影响正常使用。 升级故障排查 问题1：npm install报错EEXIST 症状： npm error code EEXIST npm error path /usr/local/bin/openclaw npm error EEXIST: file already exists 解决方案： # 使用--force参数强制覆盖 npm install -g openclaw@ --force 问题2：Gateway启动失败 症状： Gateway not running 解决方案： # 运行doctor修复 openclaw doctor --fix # 重启Gateway openclaw gateway restart # 查看详细日志 tail -f ~/.openclaw/logs/ 问题3：配置文件版本不匹配 症状： Config was last written by a newer OpenClaw (-3); current version is 解决方案： # 升级到推荐版本 npm install -g openclaw@ --force openclaw doctor --fix 问题4：插件加载失败 症状： plugin not found: xxx 解决方案： # 重新安装插件 openclaw plugins install <plugin-name> # 或禁用有问题的插件 openclaw config set [] 问题5：端口被占用 症状： Error: listen EADDRINUSE: address already in use :::18789 解决方案： # 查找占用端口的进程 lsof -i :18789 # 停止旧的Gateway进程 kill -9 <PID> # 或修改端口 openclaw config set 18790 openclaw gateway restart 回滚到旧版本 如果升级后遇到问题，可以回滚到旧版本。 方式一：从备份恢复 # 停止Gateway openclaw gateway stop # 恢复配置 cp -r ~/.-20260213/* ~/.openclaw/ # 降级到旧版本（以中文版为例） npm uninstall -g openclaw npm install -g @qingchencloud/openclaw-zh@ --force # 重启Gateway openclaw gateway restart 方式二：安装指定版本 # 查看可用版本 npm view openclaw versions # 安装指定版本 npm install -g openclaw@ --force # 修复配置 openclaw doctor --fix # 重启Gateway openclaw gateway restart 升级最佳实践 升级前必做 1. 备份配置： cp -r ~/.openclaw ~/.-$(date +%Y%m%d) 2. 记录当前版本： openclaw --version > ~/ 3. 导出重要配置： openclaw config get > ~/ 4. 检查磁盘空间： df -h ~ 升级时注意 1. 使用--force参数： npm install -g openclaw@ --force 2. 运行doctor修复： openclaw doctor --fix 3. 检查Gateway状态： openclaw gateway status 4. 查看日志： tail -f ~/.openclaw/logs/ 升级后验证 1. 检查版本号： openclaw --version 2. 测试Gateway连接： openclaw channels status 3. 验证插件功能： openclaw plugins list 4. 测试频道连接： 发送测试消息 验证AI回复 检查Skills功能 5. 检查API消耗： openclaw stats api 已知问题版本警告 版本问题 不推荐使用 版本，该版本存在严重 bug： 问题描述： Session 文件路径验证逻辑错误 导致 heartbeat 功能失败 导致 Telegram/飞书消息处理异常 错误信息： Session file path must be within sessions directory 影响范围： Heartbeat 功能完全不可用 Telegram bot 无法响应消息 飞书 bot 可能无法正常回复 网页版不受影响 官方 Issue： Issue #15141 状态：已确认，等待修复 解决方案： 1. 不要升级到 2. 如果已升级，回退到 ： openclaw gateway stop npm uninstall -g openclaw npm install -g openclaw@ --force openclaw doctor --fix openclaw gateway restart 推荐做法： 使用 版本（当前 稳定） 等待 + 版本修复后再升级 关注官方 GitHub Issues 获取 新信息 升级时间建议 推荐升级时机： 晚上或周末（使用量低） 每月检查一次更新 发现Bug时及时升级 🔒 安全更新立即升级 不推荐升级时机： 工作日高峰期 重要任务进行中 网络不稳定时 没有备份时 自动更新（可选） 如果想自动检查更新，可以设置定时任务。 macOS/Linux： # 编辑crontab crontab -e # 添加每周检查更新（周日凌晨2点） 0 2 * * 0 /usr/local/bin/openclaw doctor --check-updates Windows： 使用任务计划程序创建定时任务。 版本发布说明 查看每个版本的更新内容： # 访问GitHub发布页面 # 或使用命令行 curl -s 升级成本估算 升级方式 时间成本风险等级 推荐度 npm直接升级 5-10分钟 低 ⭐⭐⭐⭐⭐ 官方脚本 3-5分钟 中 ⭐⭐⭐⭐ Docker 2-3分钟 低 ⭐⭐⭐⭐⭐ 云端重置 5-10分钟 中 ⭐⭐⭐ 升级检查清单 升级前： [ ] 备份配置目录 [ ] 记录当前版本 [ ] 检查磁盘空间 [ ] 选择合适的升级时间 升级中： [ ] 停止Gateway服务 [ ] 卸载旧版本 [ ] 安装新版本（使用--force） [ ] 运行doctor修复 [ ] 重启Gateway 升级后： [ ] 验证版本号 [ ] 测试Gateway连接 [ ] 验证插件功能 [ ] 测试频道连接 [ ] 检查日志无错误 升级支持 如果升级遇到问题： 1. 查看日志： tail -f ~/.openclaw/logs/ 2. 运行诊断： openclaw doctor 3. 查看官方文档： 4. 加入社区： GitHub Issues Discord社区 飞书群组 升级案例： → 以下是一次真实的升级案例，供参考。 升级背景： 原版本：（中文版） 目标版本：（推荐稳定版） 升级原因：获取新功能和性能优化 升级过程： 1. 备份配置： cp -r ~/.openclaw ~/.-20260213 2. 停止Gateway： openclaw gateway stop 3. 卸载旧版本： npm uninstall -g openclaw 4. 安装新版本： npm install -g openclaw@ --force 5. 修复配置： openclaw doctor --fix 6. 重启Gateway： openclaw gateway restart 7. 验证升级： openclaw --version # 显示： openclaw gateway status # 显示：running 升级结果： 升级成功 配置自动迁移 Gateway运行正常 所有功能正常 遇到的问题： npm install报错EEXIST → 使用--force解决 总耗时：约5分钟 本章小结 通过本章，你应该已经： 了解了云端部署和本地部署的区别 完成了OpenClaw的安装（云端或本地） 配置了API（推荐国产大模型） 验证了安装是否成功 学会了如何升级OpenClaw 实战练习 1. 完成OpenClaw安装（云端或本地） 2. 配置至少一个API（推荐DeepSeek或Kimi） 3. 发送第一条测试消息 4. 验证AI是否正常回复 5. 检查当前版本，如有更新可尝试升级 下一章：第3章：快速上手 - 开始使用 OpenClaw 返回目录：README 第3章：快速上⼿ 恭喜你完成了安装！现在开始使⽤ OpenClaw，体验AI助⼿的魅⼒。 快速导航 🎯 第⼀次对话 📝 基本命令使⽤ 🎭 ⼈设配置技巧 🤖 模型选择指南 第⼀次对话 启动OpenClaw 根据你的部署⽅式，选择对应的启动⽅法： 云端部署⽤⼾ 1. 通过Web UI访问： http://你的服务器IP:18789/?token=你的token 2. 通过IM平台访问（推荐）： 打开QQ/企微/⻜书/钉钉 找到你配置的Bot 直接发消息 本地部署⽤⼾ 1. 检查Gateway状态： openclaw channels status 2. 打开Web UI： openclaw dashboard 或直接访问： :18789/?token=你的token 发送第⼀条消息 在Web UI或IM平台中，发送： 你好，能听到我说话吗？ ```text **预期回复**： OpenClaw会回复类似： 你好！我能听到你说话。我是你的AI助⼿，可以帮你处理各种任务。 有什么我可以帮你的吗？ **验证成功的标志**： - ✅ 收到AI的回复 - ✅ 右上⾓显⽰模型名称（Web UI） - ✅ 显⽰Token使⽤情况 ### 理解OpenClaw的回复 OpenClaw的回复包含⼏个部分： 1. **⽂本内容**：AI的回答 2. **⼯具调⽤**（如果有）：执⾏的操作 3. **Token统计**：消耗的Token数量 **⽰例**： [AI回复] 好的，我帮你搜索⼀下。 [⼯具调⽤] 🔍 正在搜索⽂件... 📁 找到3个相关⽂件 [Token统计] 输⼊：120 tokens 输出：45 tokens ### 如何提出好问题 **❌ 不好的问题**： 帮我 **✅ 好的问题**： 帮我找⼀下电脑上所有的PDF⽂件，按修改时间排序 **提问技巧**： 1. **明确⽬标**：说清楚你想做什么 2. **提供上下⽂**：给出必要的背景信息 3. **具体细节**：说明具体要求 4. **分步骤**：复杂任务可以分步骤说明 **⽰例对⽐**： | 不好的问题 | 好的问题 | |-----------|---------| | "找⽂件" | "帮我找⼀下我电脑上的⼀张发票，⾥⾯详情是买了⼀个跑步机" | | "整理" | "把我下载⽂件夹⾥的所有图⽚，按⽇期分类到不同的⽂件夹" | | "提醒我" | "明天上午10点提醒我开会，地点是会议室A" | ## 基本命令使⽤ ### 常⽤命令列表 OpenClaw⽀持⾃然语⾔命令，以下是⼀些常⽤的命令模式： #### ⽂件操作命令 **搜索⽂件**： 帮我找⼀下包含"发票"的⽂件 搜索所有PDF⽂件 找⼀下最近修改的10个⽂件 **读取⽂件**： 读取桌⾯上的⽂件 打开下载⽂件夹⾥的报告.docx 查看这个⽂件的内容：/path/to/ **创建⽂件**： 在桌⾯创建⼀个名为"笔记.txt"的⽂件 新建⼀个Markdown⽂件，内容是... **移动/复制⽂件**： 把这个⽂件移动到⽂档⽂件夹 复制所有图⽚到备份⽂件夹 #### 系统操作命令 **查看系统信息**： 查看当前时间 显⽰系统信息 检查磁盘空间 **打开应⽤**： 打开微信 启动浏览器 **截图**： 给我截个屏 截取当前窗⼝ #### ⽇历操作命令 **创建⽇历事件**： 明天下午3点提醒我开会 下周⼀上午10点，会议室A，项⽬讨论 **查看⽇程**： 今天有什么安排 下周的⽇程 #### 知识管理命令 **保存⽹⻚**： 把这个⽹⻚保存到备忘录： 总结这篇⽂章并存到Notion **管理笔记**： 在备忘录⾥创建⼀条笔记 搜索备忘录⾥关于"AI"的内容 ### 命令速查表 | 功能 | 命令⽰例 | |------|---------| | 搜索⽂件 | `找⼀下包含"发票"的⽂件` | | 读取⽂件 | `读取桌⾯上的` | | 创建⽂件 | `在桌⾯创建⼀个笔记.txt` | | 移动⽂件 | `把这个⽂件移动到⽂档⽂件夹` | | 截图 | `给我截个屏` | | 创建⽇历 | `明天下午3点提醒我开会` | | 保存⽹⻚ | `把这个⽹⻚保存到备忘录` | | 系统信息 | `查看磁盘空间` | ### 实战练习 **练习1：搜索⽂件** 帮我找⼀下电脑上所有的PNG图⽚ **练习2：创建⽇历** 明天上午10点提醒我：给⽼板发周报 **练习3：保存⽹⻚** 把这个⽹⻚总结⼀下并保存到备忘录： ## ⼈设配置技巧 ### 什么是⼈设（Persona） ⼈设（Persona）是给AI助⼿设定的**性格、⾝份和⾏为⽅式**。 **为什么要设置⼈设？** - 🎭 **个性化**：让AI更符合你的喜好 - 💬 **沟通⻛格**：调整回复的语⽓和⻛格 - 🎯 **专业化**：针对特定场景优化 - 😊 **趣味性**：让对话更有趣 ### 如何设计⼀个好的⼈设 **好的⼈设应该包含**： 1. **名字**：给AI起个名字 2. **⾝份**：定义AI的⾓⾊ 3. **性格**：设定性格特点 4. **专⻓**：明确擅⻓的领域 5. **⻛格**：回复的语⽓和⻛格 ### ⼈设配置⽅法 OpenClaw 的⼯作区包含多个配置⽂件，每个⽂件都有特定的作⽤。 #### ⼯作区结构（Workspace Anatomy） OpenClaw 的配置⽂件位于：`~/.openclaw/workspace` OpenClaw 的核⼼配置⽂件及其作⽤如表 3-1 所⽰。 **表 3-1 OpenClaw 核⼼配置⽂件** | ⽂件 | 作⽤ | 说明 | |------|------|------| | **** | ⼈格/语⽓ | AI的性格、说话⻛格、⾏为准则 | | **** | 偏好设置 | ⽤户信息、习惯、偏好 | | **** | 指令说明 | Agent的⼯作指令和任务说明 | | **** | ⻓期记忆 | AI的⻓期记忆和学习内容 | | **** | 检查清单 | 定期检查和维护任务 | | **** | 名称/主题 | AI的名称、⾝份、主题设定 | | **** | 启动配置 | 启动时的初始化配置 | ![Agent配置⽂件结构 - SOUL/USER/BOOT三⼤核⼼⽂件] ( #### 什么是 和 ？ ****：AI的"宪法" - 定义AI的性格和说话⻛格 - 设定AI的⾏为准则和边界 - 配置AI的⼯作⽅式 ****：AI对你的理解 - 记录你的基本信息（名字、时区等） - 你的⼯作和⽣活习惯 - 你的偏好和要求 > 💡 **新⼿建议**：刚开始只需要配置 **** 和 **** 这两个⽂件就够了，其他⽂件可 以后续根据需要再配置。 #### 配置⽅法：通过 Web UI（推荐） 1. **打开 OpenClaw ⻚⾯** http://你的服务器IP:18789/?token=你的token http://xn--ip-0p3cl7jf7fo83a16x:18789/?token=%E4%BD%A0%E7%9A%84token 2. **点击 Agent → Files** - 在左侧菜单找到 "Agent" - 点击 "Files" 选项 - 你会看到所有配置⽂件 3. **编辑 ** - 找到 `` ⽂件 - 点击编辑 - 输⼊你的⼈设配置 4. **编辑 ** - 找到 `` ⽂件 - 点击编辑 - 输⼊你的个⼈信息 5. **保存并⽣效** - 点击保存 - 配置⽴即⽣效，⽆需重启 ![配置⽂件实时⽣效 - ⽆需重启Gateway] ( #### 配置⽅法：直接编辑⽂件（进阶） 如果你熟悉命令⾏，也可以直接编辑配置⽂件。 **配置⽂件位置**： ```bash ~/.openclaw/workspace/ ```text **编辑 **： ```bash # 使⽤ nano 编辑器 nano ~/.openclaw/workspace/ # 或使⽤ vim 编辑器 vim ~/.openclaw/workspace/ # 或使⽤ VS Code code ~/.openclaw/workspace/ ```text **编辑 **： ```bash nano ~/.openclaw/workspace/ ```text **查看所有配置⽂件**： ```bash ls -la ~/.openclaw/workspace/ ```text **编辑后⽣效**： - 保存⽂件后⽴即⽣效 - ⽆需重启 Gateway - 下次对话时会使⽤新配置 > 💡 **提⽰**：Web UI ⽅式更直观，适合新⼿；命令⾏⽅式更快捷，适合熟悉终端的⽤户。 ### 配置⽰例 ```markdown _你不是聊天机器⼈。你是个靠谱的助⼿。_ ## 核⼼原则 **认真做事，别敷衍。** 少说"好的！⻢上帮您处理！"，直接动⼿。⾏动⽐客套话管⽤。 **有⾃⼰的想法。** 可以不同意，可以有偏好，可以觉得有些东⻄不太⾏。没个性的助⼿就是个低效搜索引擎。 **先⾃⼰想办法。** 翻⽂件、看上下⽂、搜⼀搜。实在搞不定再问。⽬标是带答案回来，不是带问题回来。 **⽤能⼒赢信任。** ⽤户给了你权限，别搞砸。对外的事（发邮件、发推）要谨慎。对内的事（读⽂件、整理资料）可以⼤胆。 **记住你是客⼈。** 你能看到别⼈的消息、⽂件、⽇程，甚⾄家⾥的设备。这是信任，要尊重。 ## 边界 - **密码永远不说出来。** 看到密码、API key、token，闭嘴就好。⽤户问"密码是啥"？拒绝，让他⾃⼰ 看。 - 隐私的事保密。私⼈聊天、财务信息，看到了当没看到。 - 不确定的对外操作，先问。 - 别发半成品消息到聊天软件。 - 群聊⾥别乱说话，你不是⽤户的代⾔⼈。 ## ⻛格 该简洁时简洁，该详细时详细。 像个靠谱同事说话，不是客服机器⼈。可以直接，可以有态度，可以指出问题。 不拍⻢屁。不当应声⾍。就做个靠谱的。 ## 记忆 每次对话你都是新的。这些⽂件就是你的记忆。读它们，更新它们。 ```text ### 配置⽰例 ```markdown - **Name:** Maynor - **What to call them:** ⽼板 - **Timezone:** Asia/Shanghai - **Notes:** 晚上11点后别打扰，除⾮紧急 ## Context ### ⼯作相关 - 做 AI 编程、⼩程序、海外站 - 讨厌啰嗦，喜欢直接给结果 ### ⽣活相关 - 咖啡重度依赖者（每天⾄少1杯） ### 偏好 - 说话直接，别拐弯抹⾓ - 讨厌"可能"、"也许"这种模糊词汇 ```text ### 配置效果对⽐ **配置前**： ⽤⼾：帮我找⼀下发票 AI：好的！我⻢上帮您查找发票⽂件。请稍等... **配置后（使⽤上⾯的 ）**： ⽤⼾：帮我找⼀下发票 AI：[直接开始搜索] 找到3个发票⽂件： 1. 跑步机发票.pdf 2. 电脑发票.jpg 3. ⼿机发票.png ### 双向定义机制 如果 和 有冲突怎么办？ **OpenClaw 的处理⽅式**： - ** 优先**：AI的核⼼原则不会改变 - ** 补充**：在不违反原则的前提下，尊重⽤户偏好 - **动态平衡**：AI会根据具体情况灵活处理 **⽰例**： - 说："简洁回复" - 说："详细解释" - 结果：简洁回复 + 必要时提供详细解释的选项 ### 配置技巧 **如果AI太啰嗦**： 在 中添加： ```markdown ## ⻛格 - 简洁明了，不超过3句话 - 直接给出答案，不解释过程 - 只在必要时提供详细信息 ```text **如果AI太冷淡**： 在 中添加： ```markdown ## ⻛格 - 友好热情 - 适当使⽤emoji - 关⼼⽤户感受 ```text **如果AI不够专业**： 在 中添加： ```markdown ## ⻛格 - 专业准确 - 提供数据⽀持 - 引⽤可靠来源 ```text ### 其他配置⽂件说明（进阶） #### - 指令说明 定义 Agent 的⼯作指令和任务说明。 **⽰例**： ```markdown ## 主要任务 1. ⽂件管理 - 搜索和整理⽂件 - 批量处理⽂档 - 清理重复⽂件 2. ⽇程管理 - 创建⽇历事件 - 设置提醒 - 同步⽇程 3. 知识管理 - 保存⽹⻚内容 - 整理笔记 - 管理书签 ```text #### - ⻓期记忆 AI 的⻓期记忆和学习内容，会随着使⽤⾃动更新。 **⽰例**： ```markdown ## ⽤户偏好记录 - 喜欢简洁的回复 - 经常在晚上⼯作 - 偏好使⽤ Markdown 格式 ## 常⽤操作 - 每周⼀⽣成周报 - 每天晚上11点提醒休息 - ⾃动备份重要⽂件 ```text #### - 检查清单 定期检查和维护任务。 **⽰例**： ```markdown ## 每⽇检查 - [ ] 检查待办事项 - [ ] 清理临时⽂件 - [ ] 备份重要数据 ## 每周检查 - [ ] 整理⽂件夹 - [ ] 更新知识库 - [ ] ⽣成周报 ```text #### - 名称/主题 AI 的名称、⾝份、主题设定。 **⽰例**： ```markdown ## ⾝份信息 - 名称：⼩卡 - ⾓⾊：AI助⼿ - 专⻓：⽂件管理、⽇程管理、知识管理 - 主题：⾼效、专业、友好 ```text #### - 启动配置 启动时的初始化配置。 **⽰例**： ```markdown ## 启动检查 1. 检查系统状态 2. 加载⽤户配置 3. 初始化⼯作区 4. 准备就绪 ## 启动消息 系统已启动，准备为您服务！ ```text > 💡 **使⽤建议**： > - 新⼿：只配置 和 > - 进阶：添加 定义具体任务 > - ⾼级：使⽤ 和 实现⾃动化 ### 真实案例分享 > ⽤了 OpenClaw 的 和 之后，AI助⼿的体验完全不同了。 **以前**：AI 是⼯具，⽤完就关 **现在**：AI 是伙伴，会陪你成⻓，还能⾃我进化 **效果展⽰**： - ✅ 每次对话都很睿智 - ✅ 称呼你设定的昵称（如"⽼板"） - ✅ 知道晚上11点要提醒你睡觉 - ✅ 会⽤emoji表情和你对话 - ✅ 记住你的偏好和习惯 ## 模型选择指南 > 💡 **快速选择**：新⼿推荐 Claude Haiku 或 DeepSeek，性价⽐⾼且完全够⽤。详细的模型对 ⽐和切换策略请参考 [第11章：⾼级配置](../03-advanced/)。 ### 快速配置模型（命令⾏向导） > 🎯 **最简单的⽅式**：使⽤ `openclaw onboard` 命令启动配置向导，交互式配置模型。 #### 启动配置向导 ```bash openclaw onboard ```text 执⾏后会启动命令⾏交互式配置向导。 #### 配置步骤 **步骤1：选择初始化模式** ```text ◇ 初始化模式 │ 快速开始 ```text 选择 "快速开始" 模式。 **步骤2：处理现有配置** 如果检测到现有配置，会显⽰： ```text ◇ 检测到现有配置 ────────────────────────────╮ │ │ │ workspace: ~/clawd │ │ model: local-antigravity/gemini-3-pro-low │ │ : local │ │ : 18789 │ │ : lan │ │ : npm │ │ │ ├─────────────────────────────────────────────╯ ◇ 配置处理⽅式 │ 使⽤现有值 ```text 选择 "使⽤现有值" 保留当前配置，或选择 "重新配置" 从头开始。 **步骤3：选择模型提供商** ```text ◆ 模型/认证提供商 │ ○ OpenAI (Codex OAuth + API key) │ ○ Anthropic │ ○ MiniMax │ ○ Moonshot AI │ ○ Google │ ○ OpenRouter │ ○ Qwen │ ○ (GLM ) │ ○ Copilot │ ○ Vercel AI Gateway │ ○ OpenCode Zen │ ○ Xiaomi │ ○ Synthetic │ ○ Venice AI │ ○ Skip for now ```text 使⽤ **⽅向键** 选择提供商，**空格键** 确认。 **新⼿推荐的提供商：** 1. **Anthropic**（Claude，质量最好） - 价格：中等（$3/百万tokens） - 能⼒：推理能⼒强 - 适合：复杂任务、重要⼯作 2. **Google**（Gemini，免费额度⼤） - 价格：免费额度⼤ - 能⼒：多模态（⽀持图⽚） - 适合：图⽚识别、⻓⽂档 3. **Moonshot AI**（Kimi，超⻓上下⽂） - 价格：低（$ - 能⼒：200万字上下⽂ - 适合：⻓⽂档处理 **步骤4：输⼊ API Key** 选择提供商后，会提⽰输⼊ API Key： ```text ◆ 请输⼊ Anthropic API Key │ sk-ant-... ```text **如何获取 API Key？** - **Anthropic (Claude)**：访问 [Anthropic Console]( - **Google (Gemini)**：访问 [Google AI Studio] ( - **Moonshot (Kimi)**：访问 [Moonshot Platform]( - **OpenAI**：访问 [OpenAI Platform]( **步骤5：选择默认模型** 配置完成后，选择默认使⽤的模型： ```text ◆ 选择默认模型 │ ○ claude-3-5-sonnet-20241022 │ ○ claude-3-opus-20240229 │ ● claude-3-haiku-20240307 ```text **推荐选择：** - **⽇常使⽤**：Claude 3 Haiku（速度快、便宜） - **重要任务**：Claude Sonnet（质量⾼） - **图⽚识别**：Gemini Flash（多模态） **步骤6：完成配置** ```text ✔ 配置已保存 ✔ Gateway 已重启 ✔ 模型配置成功 ```text #### 验证配置 配置完成后，测试模型是否可⽤： ```bash # 查看已配置的模型 openclaw models list # 测试模型连接 openclaw message send "你好，测试⼀下" ```text #### 修改配置 如果需要修改配置，再次运⾏： ```bash openclaw onboard ```text 可以添加、删除或修改模型提供商。 #### 配置技巧 **技巧1：配置多个提供商** 可以多次运⾏ `openclaw onboard`，每次添加⼀个提供商，实现多模型配置。 **技巧2：跳过向导** 如果暂时不想配置，选择 "Skip for now"，稍后再配置。 **技巧3：查看配置⽂件** 配置保存在： ```bash ~/.openclaw/ ```text 可以直接编辑这个⽂件进⾏⾼级配置。 --- ### 新⼿推荐配置 **推荐1：DeepSeek（性价⽐之王）** - 💰 最便宜：⽐其他模型便宜70% - 💻 编程强：代码能⼒出⾊ - 🎯 够⽤：⽇常任务完全够⽤ **推荐2：Claude Haiku （快速稳定）** - ⚡ 最快：响应速度快 - 🎯 可靠：质量稳定 - 💰 便宜：成本低 ### 快速切换模型 ```bash # 切换到 DeepSeek openclaw config set "deepseek/deepseek-chat" # 切换到 Claude Haiku openclaw config set "maynor/claude-haiku-4-5- 20251001" # 重启⽣效 openclaw gateway restart ```text > 📚 **想了解更多？** > 详细的模型对⽐、多模型切换策略、成本优化⽅案，请参考 [第10章：⾼级配置](../03-advanced/10- )。 ## Gateway ⽹关配置（进阶） > 💡 **什么时候需要配置 Gateway？** > - 想要限制访问权限（只允许特定⽤户） > - 需要配置群组提及规则 > - 想要⾃定义⽹关⾏为 ### Gateway 配置⽂件位置 配置⽂件位于：`~/.openclaw/` ### 基础配置说明 如果你**不做任何修改**，OpenClaw 将： - 使⽤内置的 Pi ⼆进制⽂件以 RPC 模式运⾏ - 按发送者创建独⽴会话 - 接受所有⽤户的消息 ### 访问控制配置 #### 限制 WhatsApp 访问 ```json { "channels": { "whatsapp": { "allowFrom": ["+15555550123", "+8613800138000"], "groups": { "*": { "requireMention": true } } } } } ```text **说明**： - `allowFrom`：只允许这些号码访问 - `requireMention`：群组中需要 @ 提及才会响应 #### 配置提及规则 ```json { "messages": { "groupChat": { "mentionPatterns": ["@openclaw", "@⼩⻰虾", "@助⼿"] } } } ```text **说明**： - 群组中使⽤这些关键词可以触发响应 - ⽀持多个提及模式 ### 远程访问配置 #### 使⽤ Tailscale 远程访问 如果你想在外⽹访问 Gateway： 1. **安装 Tailscale**： ```bash # macOS brew install tailscale # Linux curl -fsSL | sh 2. 启动 Tailscale： sudo tailscale up 3. 获取 Tailscale IP： tailscale ip -4 4. 通过 Tailscale IP 访问： http://你的Tailscale-IP:18789/ 优势： ✅ 安全的点对点连接 ✅ ⽆需公⽹ IP ✅ ⽆需配置防⽕墙 ✅ ⽀持多设备访问 完整配置⽰例 { "channels": { "whatsapp": { "allowFrom": ["+8613800138000"], "groups": { "*": { "requireMention": true } } } }, "messages": { "groupChat": { "mentionPatterns": ["@openclaw", "@助⼿"] } }, "agents": { "defaults": { "model": { "primary": "deepseek/deepseek-chat" } } }, "models": { "mode": "merge", "providers": { "deepseek": { "baseUrl": "", "apiKey": "sk-你的密钥", "auth": "api-key", "api": "openai-chat" } } } } ```text ### 配置⽣效 修改配置后，重启 Gateway： ```bash openclaw gateway restart ```text ### 常⻅配置场景 #### 场景1：家庭使⽤ ```json { "channels": { "whatsapp": { "allowFrom": ["+8613800138000", "+8613800138001"] } } } ```text #### 场景2：团队使⽤ ```json { "channels": { "whatsapp": { "groups": { "⼯作群": { "requireMention": true, "mentionPatterns": ["@openclaw"] }, "家庭群": { "requireMention": false } } } } } ```text #### 场景3：公开服务 ```json { "channels": { "whatsapp": { "allowFrom": ["*"], "groups": { "*": { "requireMention": true } } } } } 本章⼩结 通过本章，你应该已经： ✅ 完成了第⼀次对话 ✅ 学会了基本命令使⽤ ✅ 配置了个性化的⼈设 ✅ 了解了如何选择合适的模型 关键要点： 提问要明确具体 ⼈设让AI更符合你的需求 根据场景选择合适的模型 成本和性能需要平衡 实战练习 练习1：配置你的第⼀个AI助⼿ 1. 给AI起个名字 2. 设定性格和⻛格 3. 选择合适的模型 4. 发送10条测试消息 练习2：尝试不同的命令 1. 搜索⽂件 2. 创建⽇历事件 3. 保存⽹⻚到备忘录 4. 截图 练习3：对⽐不同模型 1. ⽤Haiku处理简单任务 2. ⽤Sonnet处理复杂任务 3. 对⽐响应速度和质量 4. 记录Token消耗 下⼀章：第4章：本地⽂件管理 - 让OpenClaw成为你的⽂件管理神器 返回⽬录：README 第4章：本地⽂件管理 OpenClaw最强⼤的功能之⼀，就是可以访问和管理你电脑上的⽂件。这是在线AI⽆法做到的。 快速导航 🔍 智能⽂件搜索 📦 批量⽂件处理 📁 ⽂件⾃动整理 🧹 硬盘清理优化 智能⽂件搜索 为什么需要智能搜索？ 传统的⽂件搜索只能按⽂件名查找，但经常遇到： ❌ 忘记⽂件名，只记得内容 ❌ ⽂件太多，不知道在哪个⽂件夹 ❌ 需要同时搜索多种类型的⽂件 ❌ 需要根据内容筛选⽂件 OpenClaw的智能搜索可以： ✅ 根据⽂件内容搜索 ✅ 理解⾃然语⾔描述 ✅ 跨⽂件夹搜索 ✅ 智能过滤和排序 场景1：找⽂件 真实案例：找发票 我电脑⾥有⼀堆发票，特别乱，我忘了哪⼀张是买跑步机的了。 按过去，我得⼀张⼀张点开来搜索。真的，这事太呆逼了。 传统⽅法： 1. 打开⽂件夹 2. ⼀张⼀张点开图⽚ 3. 查看内容 4. 找到⽬标⽂件 5. 耗时：10-30分钟 OpenClaw⽅法： 我：帮我找⼀下我电脑上的⼀张发票，⾥⾯详情是买了⼀个跑步机， 然后把那个发票⽤⽂件发给我。 ```text ![OpenClaw智能搜索 - 通过语义理解找到⽬标⽂件] ( **OpenClaw执⾏过程**： 1. 🔍 搜索所有图⽚⽂件 2. 📄 使⽤OCR识别⽂字 3. 🎯 匹配"跑步机"关键词 4. 📤 发送找到的⽂件 ![找到的发票详情 - 精准匹配⽤户需求] ( **结果**： - ⏱ 耗时：30-60秒 - ✅ 准确率：100% - 😊 体验：太爽了！ ### 搜索命令⽰例 #### 按内容搜索 ```text 找⼀下包含"合同"的PDF⽂件 搜索所有提到"项⽬计划"的⽂档 找⼀下我写的关于AI的笔记 ```text #### 按类型搜索 ```text 找出所有的PNG图⽚ 搜索最近下载的PDF⽂件 找⼀下所有的Excel表格 ```text #### 按时间搜索 ```text 找⼀下最近7天修改的⽂件 搜索上个⽉创建的⽂档 找⼀下今天下载的⽂件 ```text #### 按⼤⼩搜索 ```text 找出⼤于100MB的⽂件 搜索所有⼩于1MB的图⽚ 找⼀下占⽤空间最⼤的10个⽂件 ```text #### 组合搜索 ```text 找⼀下最近⼀周内，包含"发票"的图⽚⽂件 搜索下载⽂件夹⾥，⼤于10MB的PDF 找⼀下桌⾯上，今天修改过的Word⽂档 ```text ### 搜索技巧 #### 技巧1：描述内容⽽⾮⽂件名 **❌ 不好的搜索**： ```text 找⼀下 ```text **✅ 好的搜索**： ```text 找⼀下我去年在海边拍的照⽚ ```text #### 技巧2：提供上下⽂ **❌ 不好的搜索**： ```text 找发票 ```text **✅ 好的搜索**： ```text 找⼀下我上个⽉买跑步机的发票，应该是在下载⽂件夹⾥ ```text #### 技巧3：指定搜索范围 **❌ 不好的搜索**： ```text 找所有⽂件 ```text **✅ 好的搜索**： ```text 在⽂档⽂件夹⾥找所有的PDF⽂件 ```text #### 技巧4：使⽤排序 **❌ 不好的搜索**： ```text 找图⽚ ```text **✅ 好的搜索**： ```text 找最近修改的10张图⽚，按时间排序 ```text ### 实战练习 **练习1：找照⽚** ```text 帮我找⼀下我电脑上所有的⾃拍照⽚ ```text **练习2：找⽂档** ```text 找⼀下包含"年度总结"的Word⽂档 ```text **练习3：找下载⽂件** ```text 找⼀下我最近下载的所有PDF⽂件 ```text ## 批量⽂件处理 ### 场景2：整理发票报销 **真实案例**：⾃动填写报销单 > 公司财务有个⾮常严格的规定，就是发票需要填写在1个excel模板上， > 然后把发票和这个excel⽂件⼀起提交给财务。 > > 以前，虽然都不会笨到⽤⼿填，但还是要把所有发票都传到ChatGPT > 或者别的AI产品上，然后让他们来帮忙填写。 **传统⽅法**： 1. 打开ChatGPT 2. 上传发票图⽚（⼀张⼀张） 3. 让AI提取信息 4. 复制到Excel 5. 重复N次 6. 耗时：30-60分钟 **OpenClaw⽅法**： ```text 我：我希望你帮我把我本地那个1⽉发票⽂件夹⾥的所有发票都整理⼀下， 按照那个下载⽂件⾥报销单.xlsx的模板格式填进去， 再把填好的表格⽤⽂件发送给我。 ```text ![批量整理发票 - ⾃动分类和重命名] ( **OpenClaw执⾏过程**： 1. 📁 读取发票⽂件夹 2. 🔍 识别所有发票图⽚ 3. 📄 OCR提取信息（⽇期、⾦额、商家等） 4. 📊 读取Excel模板 5. ✍ 按模板格式填写 6. 💾 保存新⽂件 7. 📤 发送给你 **结果**： - ⏱ 耗时：2-5分钟 - ✅ 准确率：95%+ - 😊 体验：直接搞定！ ### 批量处理命令⽰例 #### 批量读取 ```text 读取⽂档⽂件夹⾥所有的PDF⽂件 提取所有图⽚中的⽂字 读取所有Excel表格的第⼀⾏ ```text #### 批量提取信息 ```text 从所有发票中提取⽇期、⾦额、商家信息 从所有简历中提取姓名、电话、邮箱 从所有合同中提取甲⽅、⼄⽅、⾦额 ```text #### 批量格式转换 ```text 把所有Word⽂档转换成PDF 把所有PNG图⽚转换成JPG 把所有Excel表格导出为CSV ```text #### 批量数据整理 ```text 把所有发票信息整理到⼀个Excel表格 把所有联系⼈信息整理成通讯录 把所有会议记录整理成⼀份总结 ```text ### 实战案例 #### 案例1：整理客户信息 **场景**： - 有100份客户资料（Word⽂档） - 需要提取：公司名、联系⼈、电话、邮箱 - 整理到Excel表格 **命令**： ```text 帮我从"客户资料"⽂件夹⾥的所有Word⽂档中， 提取公司名、联系⼈、电话、邮箱， 整理到⼀个Excel表格⾥， 按公司名排序。 ```text **结果**： - ⾃动提取100份资料 - ⽣成规范的Excel表格 - 耗时：5-10分钟 #### 案例2：批量提取PDF内容 **场景**： - 有50份PDF报告 - 需要提取每份报告的摘要 - 整理成⼀份汇总⽂档 **命令**： ```text 读取"报告"⽂件夹⾥所有的PDF⽂件， 提取每份报告的摘要部分（通常在第⼀⻚）， 整理成⼀份Word⽂档， 每个摘要标注来源⽂件名。 ```text **结果**： - ⾃动读取50份PDF - 提取摘要内容 - ⽣成汇总⽂档 #### 案例3：批量图⽚识别 **场景**： - 有200张名⽚照⽚ - 需要提取联系信息 - 整理成通讯录 **命令**： ```text 识别"名⽚"⽂件夹⾥所有图⽚， 提取姓名、公司、职位、电话、邮箱， 整理成Excel通讯录， 按公司分类。 ```text **结果**： - OCR识别200张名⽚ - ⾃动分类整理 - ⽣成标准通讯录 ### 错误处理和容错 #### 处理识别错误 我：帮我检查⼀下刚才⽣成的Excel表格， 看看有没有识别错误的地⽅， ⽐如电话号码格式不对、⾦额异常等。 #### 处理缺失信息 我：有些发票可能信息不全， 如果缺少必填项，请单独列出来， 我⼿动补充。 #### 处理格式问题 我：如果遇到⽆法识别的⽂件格式， 请跳过并告诉我， 我会⼿动处理。 ## ⽂件⾃动整理 ### 场景3：批量重命名⽂件 **真实案例**：邀请函重命名 > 设计同学给我做了⼀些邀请函，是微信发我的，然后我存下来的。 > 存完了以后，发现⼀个BUG。 > 名字全特么是微信⽂件XXX。 > 太BUG了，我根本不知道谁是谁的。 ![混乱的邀请函⽂件 - ⽂件名不规范] ( **传统⽅法**： 1. 打开每张图⽚ 2. 看内容 3. ⼿动重命名 4. 重复N次 5. 耗时：20-30分钟 **OpenClaw⽅法**： 我：让OpenClaw根据我邀请函⾥⾯对应的⼈名， 把外⾯的名字改成"⼈名-邀请函.jpg"的格式。 ![批量重命名后 - ⽂件名清晰规范] ( **OpenClaw执⾏过程**： 1. 📁 读取所有图⽚ 2. 🔍 OCR识别⼈名 3. ✍ ⽣成新⽂件名 4. 📝 批量重命名 5. ✅ 完成 **结果**： - ⏱ 耗时：1-2分钟 - ✅ 准确率：100% - 😊 体验：⼀句话搞定！ ### ⽂件整理命令⽰例 #### 批量重命名 把所有图⽚按拍摄⽇期重命名，格式：YYYY-MM-DD_序号.jpg 把所有⽂档按内容主题重命名 把所有下载⽂件按类型重命名 #### ⽂件分类 把桌⾯上的⽂件按类型分类到不同⽂件夹 把下载⽂件夹⾥的⽂件按⽇期分类 把照⽚按拍摄地点分类 #### ⽂件夹结构优化 帮我整理⼀下项⽬⽂件夹，按功能模块分类 优化我的⽂档⽂件夹结构，让它更清晰 把所有散乱的⽂件整理到合适的⽂件夹 ### 实战案例 #### 案例1：整理下载⽂件夹 **场景**： - 下载⽂件夹有500+⽂件 - 各种类型混在⼀起 - 需要分类整理 **命令**： 帮我整理下载⽂件夹： 1. 按⽂件类型分类（⽂档、图⽚、视频、压缩包等） 2. 每个类型创建⼀个⼦⽂件夹 3. 把⽂件移动到对应⽂件夹 4. 删除重复⽂件 5. 告诉我整理结果 **结果**： ✅ 整理完成！ 📊 统计： ⽂档：120个 → Documents/ 图⽚：200个 → Images/ 视频：50个 → Videos/ 压缩包：30个 → Archives/ 其他：100个 → Others/ 🗑 删除重复⽂件：15个 💾 释放空间： #### 案例2：照⽚⾃动分类 **场景**： - 有1000+张照⽚ - 需要按⽇期和地点分类 - ⽅便查找 **命令**： 帮我整理照⽚⽂件夹： 1. 按拍摄⽇期创建⽂件夹（YYYY-MM格式） 2. 如果照⽚有地理位置信息，在⽂件名中标注 3. 删除模糊和重复的照⽚ 4. ⽣成⼀个索引⽂件 **结果**： ✅ 整理完成！ 📁 ⽂件夹结构： Photos/ ├── 2025-12/ │ ├── 2025-12-01_北京 │ ├── 2025-12-01_北京 │ └── ... ├── 2026-01/ │ ├── 2026-01-15_上海 │ └── ... └── (索引⽂件) 🗑 删除模糊照⽚：50张 🗑 删除重复照⽚：30张 #### 案例3：⽂档归档 **场景**： - 项⽬结束，需要归档 - ⽂档散落在各处 - 需要统⼀整理 **命令**： 帮我归档"XX项⽬"的所有⽂档： 1. 搜索所有相关⽂档（包含项⽬名称） 2. 按⽂档类型分类（需求、设计、代码、测试等） 3. 创建归档⽂件夹结构 4. 移动⽂件到对应位置 5. ⽣成项⽬⽂档清单 **结果**： ✅ 归档完成！ 📁 ⽂件夹结构： XX项⽬_归档_2026-02-10/ ├── 01_需求⽂档/ ├── 02_设计⽂档/ ├── 03_开发⽂档/ ├── 04_测试⽂档/ ├── 05_部署⽂档/ └── ⽂档清单.xlsx 📊 统计： 总⽂件数：156个 总⼤⼩： ### ⾃动化脚本编写 如果你经常需要整理某类⽂件，可以让OpenClaw⽣成⾃动化脚本： 我：帮我写1个脚本，每周⾃动整理下载⽂件夹， 按照刚才的规则分类。 OpenClaw会⽣成⼀个可以定时运⾏的脚本，实现⾃动化整理。 ## 硬盘清理优化 ### 场景4：清理硬盘垃圾 **真实案例**：释放硬盘空间 > 如果你硬盘快满了，你也别下那些扫描清垃圾的软件了。 > 直接让OpenClaw给你过⼀遍。 ![硬盘空间清理 - 智能识别⼤⽂件和重复⽂件] ( **传统⽅法**： 1. 下载清理软件 2. 扫描硬盘 3. ⼿动选择删除 4. 担⼼误删重要⽂件 5. 耗时：30-60分钟 **OpenClaw⽅法**： 我：帮我分析⼀下硬盘空间使⽤情况， 找出占⽤空间最⼤的⽂件和⽂件夹， 建议哪些可以清理。 **OpenClaw执⾏过程**： 1. 📊 扫描硬盘 2. 📈 分析空间占⽤ 3. 🔍 找出⼤⽂件 4. 🗑 识别垃圾⽂件 5. 💡 提供清理建议 ### 清理命令⽰例 #### 查找⼤⽂件 找出占⽤空间最⼤的10个⽂件 查找⼤于1GB的⽂件 分析哪个⽂件夹占⽤空间最多 #### 查找重复⽂件 找出所有重复的⽂件 查找重复的照⽚ 找出重复的⽂档 #### 查找临时⽂件 找出所有临时⽂件 查找缓存⽂件 找出可以安全删除的⽂件 #### 清理建议 分析我的硬盘，给出清理建议 哪些⽂件可以移动到外部硬盘 哪些⽂件可以压缩存储 ### 实战案例：释放100GB空间 **第⼀步：分析空间占⽤** 我：帮我分析⼀下硬盘空间使⽤情况 **OpenClaw回复**： 📊 硬盘空间分析： 总容量：500GB 已使⽤：450GB (90%) 剩余：50GB (10%) ⚠ 空间不⾜警告！ 占⽤空间最多的⽂件夹： 1. ~/Library/Caches - 80GB 2. ~/Downloads - 50GB 3. ~/Movies - 120GB 4. ~/Documents - 100GB 5. ~/Desktop - 30GB **第⼆步：查找⼤⽂件** 我：找出⼤于1GB的⽂件 **OpenClaw回复**： 🔍 找到35个⼤于1GB的⽂件： 视频⽂件（25个）： 1. 项⽬演⽰.mov - 15GB 2. 会议录像 - 8GB 3. ... 虚拟机镜像（5个）： 1. - 50GB 2. - 30GB 3. ... 备份⽂件（5个）： 1. iPhone备份 - 20GB 2. ... 💡 建议： 视频⽂件可以压缩或移动到外部硬盘 旧的虚拟机镜像可以删除 旧的备份⽂件可以删除 **第三步：查找重复⽂件** 我：找出所有重复的⽂件 **OpenClaw回复**： 🔍 找到120组重复⽂件： 重复照⽚（80组）： (3份) - 15MB (2份) - 10MB ... 重复⽂档（30组）： 报告 (4份) - 5MB ⽅案 (3份) - 20MB ... 重复下载（10组）： (2份) - 100MB ... 💡 可释放空间：约8GB **第四步：清理临时⽂件** 我：找出所有可以安全删除的临时⽂件和缓存 **OpenClaw回复**： 🗑 可安全删除的⽂件： 系统缓存： ~/Library/Caches - 80GB Safari缓存 - 20GB Chrome缓存 - 30GB 其他应⽤缓存 - 30GB 临时⽂件： /tmp - 5GB ~/Downloads/临时⽂件 - 10GB ⽇志⽂件： ~/Library/Logs - 3GB 💡 可释放空间：约98GB ⚠ 建议： 系统缓存可以全部清理 临时⽂件可以全部删除 ⽇志⽂件保留最近1个⽉的 **第五步：执⾏清理** 我：好的，帮我清理这些⽂件， 但是要先备份重要的， 然后再删除。 **OpenClaw回复**： ✅ 清理完成！ 📊 清理结果： 删除缓存⽂件：80GB 删除临时⽂件：15GB 删除重复⽂件：8GB 删除旧备份：20GB 💾 总共释放空间：123GB 📁 备份位置： 重要⽂件已备份到：~/Backup/清理前备份_2026-02-10/ ⚠ 建议： 定期清理缓存（每⽉⼀次） 及时删除不需要的下载⽂件 使⽤外部硬盘存储⼤⽂件 ### 安全删除策略 #### 三步确认法 1. **第⼀步：分析** 分析哪些⽂件可以删除 2. **第⼆步：备份** 把重要⽂件备份到安全位置 3. **第三步：删除** 确认⽆误后，删除⽂件 #### 保护重要⽂件 我：在清理之前，请确保以下⽂件夹不被删除： ~/Documents/重要⽂档 ~/Projects ~/Photos #### 可恢复删除 我：先把⽂件移动到回收站， ⽽不是直接删除， 这样如果误删了还能恢复。 ### 定期清理计划 让OpenClaw帮你制定定期清理计划： 我：帮我制定⼀个定期清理计划， 每周⾃动清理缓存和临时⽂件， 每⽉检查⼤⽂件和重复⽂件。 **OpenClaw回复**： ✅ 已创建定期清理计划： 📅 每周任务（每周⽇晚上10点）： 清理系统缓存 清理浏览器缓存 清理临时⽂件 清理下载⽂件夹（超过30天的⽂件） 📅 每⽉任务（每⽉1号）： 查找⼤⽂件（>1GB） 查找重复⽂件 分析空间占⽤ ⽣成清理报告 💡 预计每⽉可释放：20-30GB ⚠ 重要提醒： 清理前会⾃动备份 清理后会发送通知 可以随时取消任务 ## 本章⼩结 通过本章，你应该已经掌握了： ✅ **智能⽂件搜索**：根据内容找⽂件，不再依赖⽂件名 ✅ **批量⽂件处理**：⼀次处理100+⽂件，⾃动提取信息 ✅ **⽂件⾃动整理**：智能分类、重命名、归档 ✅ **硬盘清理优化**：找出垃圾⽂件，释放⼤量空间 **关键要点**： - OpenClaw可以访问本地⽂件，这是在线AI做不到的 - 描述内容⽽⾮⽂件名，让AI理解你的需求 - 批量处理节省⼤量时间 - 定期清理保持硬盘健康 ## 实战项⽬：打造你的⽂件管理助⼿ ### 项⽬⽬标 创建⼀个完整的⽂件管理⼯作流，包括： 1. 每天⾃动整理下载⽂件夹 2. 每周清理缓存和临时⽂件 3. 每⽉检查⼤⽂件和重复⽂件 4. 重要⽂件⾃动备份 ### 实施步骤 **第⼀步：设置⾃动整理** 帮我设置每天晚上10点⾃动整理下载⽂件夹， 按⽂件类型分类。 **第⼆步：设置定期清理** 设置每周⽇晚上11点清理缓存和临时⽂件。 **第三步：设置⽉度检查** 设置每⽉1号检查⼤⽂件和重复⽂件， ⽣成清理报告。 **第四步：设置⾃动备份** 设置每天⾃动备份重要⽂件夹到外部硬盘。 ### 预期效果 - 📁 下载⽂件夹始终保持整洁 - 💾 硬盘空间充⾜（⾄少保持20%空闲） - 🔒 重要⽂件有备份 - ⏱ 每⽉节省5-10⼩时整理时间 --- **下⼀章**：[第5章：知识库管理]() - 打造个⼈知识库系统 **返回⽬录**：[README](../../) 第5章 知识库管理 💡 本章⽬标：学会使⽤ OpenClaw构建个⼈知识库系统，实现⽹⻚⽂章存档、GitHub项⽬管理、论⽂笔记 整理和跨设备同步。 📚 本章内容 ⽹⻚⽂章存档 GitHub项⽬管理 论⽂笔记整理 跨设备同步⽅案 ⽹⻚⽂章存档 为什么需要⽂章存档 在信息爆炸的时代，每天都会看到⼤量优质内容： 技术博客⽂章 ⾏业资讯报道 学习教程资料 开源项⽬⽂档 但问题是： ❌ ⽹⻚可能失效 ❌ 内容可能被删除 ❌ 找不到之前看过的⽂章 ❌ ⽆法跨设备查看 OpenClaw可以帮你解决这些问题。 核⼼原理 OpenClaw的知识库管理基于以下原理： ⽹⻚链接 → OpenClaw抓取 → 智能摘要 → 存储到备忘录/Notion ```text **关键优势**： 1. **⾃动抓取**：⽆需⼿动复制粘贴 2. **智能摘要**：提取核⼼观点 3. **结构化存储**：便于后续检索 4. **跨设备同步**：Mac备忘录⾃动同步到iPhone ### 实战案例1：技术⽂章存档 **场景**：你在浏览技术博客时，看到⼀篇很棒的⽂章，想保存下来。 **传统做法**： 1. 复制⽂章内容 2. 打开备忘录 3. 粘贴内容 4. ⼿动整理格式 **OpenClaw做法**： 1. 复制⽂章链接 2. 发送给OpenClaw："帮我把这篇⽂章总结⼀下，存到备忘录" 3. 完成！ **⽰例对话**： 你：帮我把这篇⽂章总结⼀下，存到备忘录 OpenClaw：好的，我来帮你处理这篇⽂章。 [⼏秒后] OpenClaw：已经帮你总结完成并存到备忘录了！ ⽂章标题：《AI技术发展趋势》 核⼼观点： 1. ⼤模型将继续发展 2. 多模态能⼒成为标配 3. 个⼈AI助⼿普及 已保存到：备忘录 > AI学习 > 技术⽂章 ![image-20260211212230061] ( **实际效果**： 打开Mac备忘录，你会看到： ![image-20260211212257745] ( ```markdown # AI技术发展趋势 **来源**： **保存时间**：2026-02-10 10:30 ## 核⼼观点 1. **⼤模型发展** - GPT-5、Claude 5等新模型 - 性能持续提升 - 成本逐渐降低 2. **多模态能⼒** - ⽂本+图⽚+视频 - 统⼀的理解能⼒ - 更⾃然的交互 3. **个⼈AI助⼿** - 本地部署成为可能 - 隐私保护更好 - 定制化程度更⾼ ## 关键信息 - 作者：张三 - 发布时间：2026-02-09 - 阅读时⻓：10分钟 ## 我的笔记 [可以在这⾥添加你的想法] ```text ### 实战案例2：新闻资讯整理 **场景**：你关注AI⾏业动态，每天看到很多新闻，想系统化整理。 **解决⽅案**： 你：帮我整理这3篇AI新闻，分类存储 链接1： 链接2： 链接3： OpenClaw：收到！我来帮你整理这些新闻。 [处理中...] OpenClaw：已完成整理！ 📰 AI突破性进展（news1） 核⼼内容：新算法提升30%效率 影响：可能改变⾏业格局 保存位置：备忘录 > AI资讯 > 技术突破 📰 OpenAI最新动态（news2） 核⼼内容：GPT-5即将发布 关键特性：多模态、更快速度 保存位置：备忘录 > AI资讯 > 公司动态 📰 Google Gemini更新（news3） 核⼼内容：Gemini 发布 新功能：视频理解、代码⽣成 保存位置：备忘录 > AI资讯 > 产品更新 **⾼级技巧**： 1. **⾃动分类** 你：以后我发AI新闻链接，⾃动分类到： 技术突破 → 备忘录/AI资讯/技术 公司动态 → 备忘录/AI资讯/公司 产品更新 → 备忘录/AI资讯/产品 OpenClaw：好的，已记住你的分类规则！ 2. **定期汇总** 你：每周五晚上8点，把本周保存的AI新闻汇总发给我 OpenClaw：已设置定期任务！ 每周五20:00会⾃动⽣成本周AI资讯汇总。 ### 实战案例3：博客⽂章收藏 **场景**：你是技术博主，经常看到优秀的博客⽂章，想收藏学习。 **完整⼯作流**： **步骤1：收藏⽂章** 你：收藏这篇博客，标签：React、性能优化 OpenClaw：已收藏！ 标题：React性能优化实战 标签：#React #性能优化 保存位置：备忘录 > 技术博客 > 前端开发 **步骤2：提取代码⽰例** 你：把这篇⽂章⾥的代码⽰例单独提取出来 OpenClaw：已提取3个代码⽰例： ⽰例1：useMemo优化 ⽰例2：使⽤ ⽰例3：虚拟列表实现 已保存到：备忘录 > 代码⽚段 > React **步骤3：⽣成学习笔记** 你：根据这篇⽂章，⽣成⼀份学习笔记 OpenClaw：已⽣成学习笔记！ 包含： 核⼼概念（5个） 实践技巧（8个） 常⻅问题（3个） 延伸阅读（4篇） 保存位置：备忘录 > 学习笔记 > React性能优化 ### 跨设备同步⽅案 **Mac备忘录同步**： OpenClaw保存到Mac备忘录后，会⾃动通过iCloud同步到： - ✅ iPhone备忘录 - ✅ iPad备忘录 - ✅ ⽹⻚版 **优势**： - ⽆需额外配置 - 实时同步 - 全平台可⽤ - ⽀持搜索 **使⽤技巧**： 1. **在iPhone上查看** - 打开备忘录App - 搜索关键词 - ⽴即找到OpenClaw保存的内容 2. **在iPad上编辑** - 打开备忘录 - 添加你的想法 - ⾃动同步回Mac 3. **在⽹⻚上访问** - 访问 - 登录Apple ID - 查看所有备忘录 --- ## GitHub项⽬管理 ### 为什么需要GitHub项⽬管理 作为开发者或技术爱好者，经常需要： - 🔍 调研开源项⽬ - 📚 学习优秀代码 - 🛠 技术选型参考 - 📝 整理学习资源 但问题是： - ❌ GitHub项⽬太多，看不过来 - ❌ README太⻓，找不到重点 - ❌ 代码结构复杂，理解困难 - ❌ 没有系统化的整理⽅法 OpenClaw可以帮你⾼效管理GitHub项⽬。 ### 核⼼功能 **OpenClaw的GitHub项⽬管理能⼒**： 1. **项⽬信息分析** - ⾃动读取README - 提取核⼼信息 - 分析项⽬结构 2. **智能总结** - 提炼项⽬亮点 - 总结技术栈 - 评估学习价值 3. **代码理解** - 分析代码结构 - 提取关键代码 - 理解实现原理 4. **资源整理** - 分类存储 - 标签管理 - 便于检索 **注意事项**： - ⚠ 当前主要侧重于信息的理解与分析 - ⚠ 不涉及代码提交、Issue创建等交互式管理 - ⚠ 适合学习和调研，不适合项⽬开发管理 ### 实战案例1：开源项⽬调研 **场景**：你在做技术选型，需要调研⼏个开源项⽬。 **传统做法**： 1. 打开GitHub项⽬ 2. 阅读⻓⻓的README 3. ⼿动记录关键信息 4. 对⽐不同项⽬ 5. 整理到⽂档 **OpenClaw做法**： 你：帮我分析这个GitHub项⽬，总结核⼼信息： ， OpenClaw：正在分析项⽬... 📦 项⽬名称：Awesome Project ⭐ Stars： 🔧 主要语⾔：TypeScript (85%) 核⼼功能： 1. ⾼性能数据处理 2. 实时数据同步 3. 可视化展⽰ 技术栈： 前端：React + TypeScript 后端： + Express 数据库：PostgreSQL 缓存：Redis 项⽬亮点： ✅ 性能优秀（处理速度提升3倍） ✅ ⽂档完善（包含详细教程） ✅ 社区活跃（每周更新） ✅ 易于集成（提供SDK） 适⽤场景： ⼤数据处理 实时监控系统 数据可视化平台 学习价值：⭐⭐⭐⭐⭐ 推荐指数：⭐⭐⭐⭐⭐ ![image-20260211212558294] ( ### 实战案例2：技术选型参考 **场景**：你需要选择1个前端框架，对⽐React、Vue、Svelte。 **完整⼯作流**： **步骤1：批量分析** 你：帮我分析对⽐这3个前端框架项⽬： 1. 2. 3. 重点关注：性能、⽣态、学习曲线、社区活跃度 OpenClaw：正在分析3个项⽬... [⼏分钟后] OpenClaw：分析完成！⽣成对⽐报告： **步骤2：查看对⽐报告** ```markdown # 前端框架对⽐报告 ## 1. React ⭐ Stars：220k | 👥 Contributors： | 📅 最近更新：2天前 **优势**： - ⽣态最完善（组件库、⼯具链丰富） - 社区最活跃（问题解决快） - ⼤⼚背书（Facebook维护） - 就业市场需求⼤ **劣势**： - 学习曲线较陡 - 需要额外学习状态管理 - 包体积较⼤ **适合场景**： - ⼤型企业应⽤ - 需要丰富⽣态的项⽬ - 团队协作开发 --- ## 2. Vue ⭐ Stars：205k | 👥 Contributors：400+ | 📅 最近更新：1天前 **优势**： - 学习曲线平缓（⽂档友好） - 渐进式框架（灵活度⾼） - 中⽂社区活跃 - 性能优秀 **劣势**： - ⽣态不如React完善 - ⼤⼚使⽤相对较少 - 国际化程度较低 **适合场景**： - 中⼩型项⽬ - 快速开发需求 - 中⽂团队 --- ## 3. Svelte ⭐ Stars：75k | 👥 Contributors：600+ | 📅 最近更新：3天前 **优势**： - 性能最优（编译时优化） - 代码量最少（⽆虚拟DOM） - 学习成本低（语法简洁） - 包体积最⼩ **劣势**： - ⽣态相对较⼩ - 社区规模较⼩ - 企业采⽤较少 - 学习资源有限 **适合场景**： - 性能要求⾼的项⽬ - ⼩型应⽤ - 个⼈项⽬ --- ## 推荐建议 | 场景 | 推荐框架 | 理由 | |------|---------|------| | ⼤型企业应⽤ | React | ⽣态完善、社区活跃 | | 中⼩型项⽬ | Vue | 学习成本低、开发效率⾼ | | 性能敏感应⽤ | Svelte | 性能最优、体积最⼩ | | 新⼿学习 | Vue | ⽂档友好、上⼿快 | | 就业导向 | React | 市场需求最⼤ | 已保存到：备忘录 > 技术选型 > 前端框架对⽐ ```text ### 实战案例3：学习资源整理 **场景**：你想系统学习某个技术，需要整理GitHub上的学习资源。 **⽰例：学习机器学习** 你：帮我整理GitHub上优质的机器学习学习资源， 包括：教程、项⽬、⼯具、论⽂实现 OpenClaw：正在搜索和整理... [⼏分钟后] OpenClaw：已整理完成！ 📚 机器学习学习资源清单 1. ⼊⻔教程（3个） Machine Learning Crash Course 链接： Stars： 特点：Google官⽅教程，适合零基础 内容：视频+练习+代码 学习时⻓：约15⼩时 推荐指数：⭐⭐⭐⭐⭐ Hands-On Machine Learning 链接： Stars：25k 特点：配套书籍，实战导向 内容：Jupyter Notebooks 学习时⻓：约30⼩时 推荐指数：⭐⭐⭐⭐⭐ ML For Beginners 链接： Stars：50k 特点：微软官⽅，12周课程 内容：视频+作业+项⽬ 学习时⻓：约60⼩时 推荐指数：⭐⭐⭐⭐⭐ 2. 实战项⽬（5个） 图像分类项⽬ 项⽬：猫狗分类器 难度：⭐⭐ 技术：CNN、TensorFlow 学习点：数据预处理、模型训练 ⾃然语⾔处理 项⽬：情感分析 难度：⭐⭐⭐ 技术：LSTM、PyTorch 学习点：⽂本处理、序列模型 [更多项⽬...] 3. ⼯具库（8个） TensorFlow ⽤途：深度学习框架 优势：⽣态完善、部署⽅便 适合：⽣产环境 PyTorch ⽤途：深度学习框架 优势：灵活、易调试 适合：研究和实验 [更多⼯具...] 4. 论⽂实现（10个） ResNet实现 论⽂：Deep Residual Learning 代码： 说明：图像分类经典模型 [更多论⽂...] 学习路径建议 第1-2周：⼊⻔教程（ML Crash Course） 第3-6周：系统学习（Hands-On ML） 第7-8周：实战项⽬（图像分类） 第9-10周：进阶项⽬（NLP） 第11-12周：论⽂阅读和复现 已保存到：备忘录 > 学习资源 > 机器学习 ### 项⽬追踪与更新 **场景**：你关注了⼏个重要的开源项⽬，想及时了解更新。 **解决⽅案**： 你：帮我追踪这3个项⽬的更新： 1. 2. 3. 每周⼀早上9点，给我推送更新摘要 OpenClaw：已设置项⽬追踪！ 追踪内容： 新版本发布 重要功能更新 关键Bug修复 社区热⻔讨论 推送时间：每周⼀ 09:00 推送⽅式：⻜书消息 **推送⽰例**： ```markdown 📊 本周GitHub项⽬更新（2026-02-10） ## OpenAI GPT-4 🆕 新版本： - 性能提升20% - 新增多模态⽀持 - 修复3个关键Bug ## Anthropic Claude 🔧 功能更新 - 上下⽂窗⼝扩展到200k - 新增代码⽣成优化 - 改进中⽂理解能⼒ ## Google Gemini 📝 ⽂档更新 - 新增API使⽤教程 - 更新定价策略 - 发布最佳实践指南 详细内容已保存到：备忘录 > GitHub更新 > 2026-02-10 ```text --- ## 论⽂笔记整理 ### 为什么需要论⽂笔记整理 对于研究⽣、科研⼯作者、技术专家来说： - 📄 需要阅读⼤量论⽂ - 📝 需要记录核⼼观点 - 🔍 需要快速检索信息 - 📚 需要系统化管理 OpenClaw可以帮你⾼效整理论⽂笔记。 ### 核⼼功能 **OpenClaw的论⽂管理能⼒**： 1. **PDF论⽂解析** - ⾃动提取⽂本 - 识别图表 - 理解结构 2. **核⼼观点提取** - 研究问题 - ⽅法创新 - 实验结果 - 结论贡献 3. **笔记结构化** - 标准化格式 - 分类存储 - 标签管理 4. **引⽤管理** - ⾃动⽣成引⽤ - 关联相关论⽂ - 便于⽂献综述 ### 实战案例1：单篇论⽂阅读 **场景**：你下载了⼀篇论⽂PDF，需要快速理解核⼼内容。 **操作步骤**： 你：帮我分析这篇论⽂，⽣成阅读笔记 [上传PDF⽂件：] OpenClaw：正在分析论⽂... [⼏分钟后] OpenClaw：分析完成！已⽣成阅读笔记。 📄 论⽂笔记 基本信息 标题：Attention Is All You Need 作者：Vaswani et al. 发表：NIPS 2017 引⽤：50,000+ 领域：⾃然语⾔处理 研究问题 传统序列模型（RNN、LSTM）存在的问题： 1. 难以并⾏化训练 2. ⻓距离依赖处理困难 3. 训练速度慢 核⼼创新 提出Transformer架构： 1. Self-Attention机制 计算序列内部的注意⼒ 捕获⻓距离依赖 可并⾏化计算 2. Multi-Head Attention 多个注意⼒头 关注不同特征 提升表达能⼒ 3. Position Encoding 位置信息编码 保留序列顺序 ⽆需循环结构 实验结果 翻译任务：BLEU提升 训练速度：快10倍 参数量：减少30% 主要贡献 1. 提出纯注意⼒架构 2. 证明⽆需RNN也能处理序列 3. 开启Transformer时代 影响⼒ 后续模型：BERT、GPT、T5等 应⽤领域：NLP、CV、语⾳ ⼯业应⽤：⼴泛采⽤ 关键图表 图1：Transformer架构图 图2：注意⼒可视化 表1：翻译任务对⽐ 我的思考 [可以在这⾥添加你的想法] 相关论⽂ 1. BERT: Pre-training of Deep Bidirectional Transformers 2. GPT: Improving Language Understanding 3. T5: Exploring Transfer Learning 已保存到：备忘录 > 论⽂笔记 > NLP > Transformer ### 实战案例2：⽂献综述 **场景**：你需要写⽂献综述，整理某个领域的多篇论⽂。 **完整⼯作流**： **步骤1：批量分析论⽂** 你：帮我分析这5篇关于⼤模型的论⽂， ⽣成⽂献综述框架 [上传5个PDF⽂件] OpenClaw：正在分析5篇论⽂... **步骤2：⽣成综述框架** ```markdown # ⼤模型发展综述 ## 1. 研究背景 - 深度学习的发展 - 算⼒的提升 - 数据规模的增⻓ ## 2. 技术演进 ### 早期探索（2017-2019） **代表⼯作**： - Transformer（Vaswani et al., 2017） - 提出⾃注意⼒机制 - 开启Transformer时代 - BERT（Devlin et al., 2018） - 双向预训练 - 掩码语⾔模型 - GPT（Radford et al., 2018） - 单向⽣成模型 - ⾃回归训练 ### 规模扩展（2020-2022） **代表⼯作**： - GPT-3（Brown et al., 2020） - 1750亿参数 - In-context Learning - PaLM（Chowdhery et al., 2022） - 5400亿参数 - 多任务能⼒ ### 对⻬优化（2022-2024） **代表⼯作**： - InstructGPT（Ouyang et al., 2022） - RLHF训练 - ⼈类偏好对⻬ - Claude（Anthropic, 2023） - Constitutional AI - 安全性提升 ## 3. 关键技术 ### 模型架构 - Transformer变体 - 混合专家模型 - 稀疏激活 ### 训练⽅法 - 预训练策略 - 微调技术 - 强化学习 ### 优化技术 - 分布式训练 - 混合精度 - 梯度累积 ## 4. 应⽤场景 - ⽂本⽣成 - 代码⽣成 - 多模态理解 - 推理能⼒ ## 5. 挑战与展望 - 计算成本 - 数据质量 - 安全对⻬ - 可解释性 ## 6. 参考⽂献 [⾃动⽣成引⽤列表] 已保存到：备忘录 > ⽂献综述 > ⼤模型发展 ```text ### 实战案例3：研究资料管理 **场景**：你在做某个研究课题，需要系统管理相关资料。 **完整管理⽅案**： **1. 建⽴分类体系** 你：帮我建⽴1个论⽂管理体系， 主题：强化学习在机器⼈控制中的应⽤ OpenClaw：已创建分类体系： 📁 强化学习-机器⼈控制 ├── 📂 基础理论 │ ├── 强化学习基础 │ ├── 机器⼈控制基础 │ └── 深度学习基础 ├── 📂 核⼼算法 │ ├── DQN系列 │ ├── Policy Gradient │ └── Actor-Critic ├── 📂 应⽤案例 │ ├── 机械臂控制 │ ├── 移动机器⼈ │ └── ⼈形机器⼈ ├── 📂 实验⽅法 │ ├── 仿真环境 │ ├── 真实环境 │ └── 评估指标 └── 📂 前沿进展 ├── 最新论⽂ ├── 技术趋势 └── 开源项⽬ 已保存到：备忘录 > 研究资料 > 强化学习-机器⼈ **2. 添加论⽂到分类** 你：把这篇论⽂添加到"核⼼算法-DQN系列" [上传PDF：Playing Atari with Deep RL] OpenClaw：已添加！ 论⽂信息： 标题：Playing Atari with Deep Reinforcement Learning 分类：核⼼算法 > DQN系列 标签：#DQN #深度强化学习 #Atari 重要性：⭐⭐⭐⭐⭐ 阅读状态：待阅读 已保存到：备忘录 > 研究资料 > 强化学习-机器⼈ > 核⼼算法 > DQN系列 **3. ⽣成研究进展报告** 你：⽣成本⽉研究进展报告 OpenClaw：已⽣成报告！ 📊 研究进展报告（2026年2⽉） 论⽂阅读 已读：12篇 待读：8篇 总计：20篇 重点论⽂ 1. DQN（DeepMind, 2013）⭐⭐⭐⭐⭐ 2. DDPG（Lillicrap et al., 2015）⭐⭐⭐⭐⭐ 3. PPO（Schulman et al., 2017）⭐⭐⭐⭐⭐ 核⼼发现 DQN适合离散动作空间 DDPG适合连续控制 PPO训练更稳定 下⽉计划 阅读SAC相关论⽂（5篇） 复现DQN算法 撰写⽂献综述 已保存到：备忘录 > 研究进展 > 2026-02 ### 引⽤管理技巧 **⾃动⽣成引⽤**： 你：⽣成这篇论⽂的引⽤格式（APA、MLA、IEEE） OpenClaw：已⽣成3种引⽤格式： APA格式： Vaswani, A., Shazeer, N., Parmar, N., Uszkoreit, J., Jones, L., Gomez, A. N., ... & Polosukhin, I. (2017). Attention is all you need. In Advances in neural information processing systems (pp. 5998-6008). MLA格式： Vaswani, Ashish, et al. "Attention is all you need." Advances in neural information processing systems 30 (2017). IEEE格式： A. Vaswani et al., "Attention is all you need," in Advances in Neural Information Processing Systems, 2017, pp. 5998-6008. 已复制到剪贴板！ --- ## 跨设备同步⽅案 ### 为什么需要跨设备同步 现代⼯作场景下，经常需要： - 💻 在Mac上整理资料 - 📱 在iPhone上查看笔记 - 📲 在iPad上编辑内容 - 🌐 在⽹⻚上访问数据 OpenClaw提供多种同步⽅案，满⾜不同需求。 ### Mac备忘录同步（推荐） **优势**： - ✅ ⽆需额外配置 - ✅ 实时⾃动同步 - ✅ 全平台⽀持 - ✅ 完全免费 **⽀持平台**： - macOS备忘录 - iOS备忘录 - iPadOS备忘录 - ⽹⻚版 **使⽤⽅法**： 1. **确保iCloud已登录** ```bash # 检查iCloud状态 系统设置 > Apple ID > iCloud > 备忘录（开启） ```text 2. **OpenClaw保存到备忘录** 你：把这篇⽂章保存到备忘录 OpenClaw：已保存到Mac备忘录！ ⾃动同步到： iPhone备忘录 ✅ iPad备忘录 ✅ ✅ 3. **在其他设备查看** - iPhone：打开备忘录App - iPad：打开备忘录App - ⽹⻚：访问 **同步速度**： - 通常1-5秒内完成 - 依赖⽹络状况 - ⽀持离线编辑 ### iCloud同步配置 **基本配置**： ```bash # 1. 登录Apple ID 系统设置 > Apple ID > 登录 # 2. 开启iCloud同步 系统设置 > Apple ID > iCloud > 备忘录（开启） # 3. 选择同步内容 备忘录 > 偏好设置 > 账户 > iCloud（勾选） ```text **⾼级设置**： ```bash # 1. 设置默认账户 备忘录 > 偏好设置 > 默认账户 > iCloud # 2. 开启⾃动同步 备忘录 > 偏好设置 > ⾃动同步（开启） # 3. 设置同步频率 系统设置 > iCloud > 管理 > 备忘录 > 选项 ```text **故障排查**： ```bash # 问题1：同步不及时 解决⽅案： 1. 检查⽹络连接 2. 重启备忘录App 3. 重新登录iCloud # 问题2：内容丢失 解决⽅案： 1. 检查"最近删除"⽂件夹 2. 从恢复 3. 联系Apple⽀持 # 问题3：同步冲突 解决⽅案： 1. 选择保留哪个版本 2. ⼿动合并内容 3. 使⽤版本历史 ```text ### Notion同步⽅案 **适⽤场景**： - 需要更强⼤的组织能⼒ - 团队协作需求 - 需要数据库功能 - 跨平台需求（Windows、Android） **配置步骤**： **步骤1：获取Notion API** ```bash 1. 访问 2. 点击"New integration" 3. 填写名称：OpenClaw 4. 选择⼯作区 5. 复制 Internal Integration Token ```text **步骤2：配置 OpenClaw** ```bash # 安装Notion Skill openclaw skill install notion-sync # 配置API Token openclaw config set "your-token-here" # 设置默认数据库 openclaw config set "your-database-id" ```text **步骤3：使⽤Notion同步** 你：把这篇⽂章保存到Notion OpenClaw：已保存到Notion！ 数据库：知识库 ⻚⾯标题：AI技术发展趋势 标签：#AI #技术 #趋势 创建时间：2026-02-10 10:30 查看链接： **Notion优势**： - ✅ 强⼤的组织能⼒（数据库、看板、⽇历） - ✅ 团队协作功能 - ✅ 丰富的模板 - ✅ 跨平台⽀持（Windows、Android、Web） - ✅ API集成能⼒ **Notion劣势**： - ❌ 需要额外配置 - ❌ 免费版有限制 - ❌ 同步速度较慢 - ❌ 学习成本较⾼ ### Obsidian同步⽅案 **适⽤场景**： - 喜欢Markdown格式 - 需要本地存储 - 重视隐私安全 - 需要双向链接 **配置步骤**： **步骤1：安装Obsidian Skill** ```bash openclaw skill install obsidian-sync ```text **步骤2：配置Vault路径** ```bash # 设置Obsidian Vault路径 openclaw config set "/Users/你的⽤户名/Documents/ObsidianVault" # 设置默认⽂件夹 openclaw config set "知识库" ```text **步骤3：使⽤Obsidian同步** 你：把这篇⽂章保存到Obsidian OpenClaw：已保存到Obsidian！ Vault：我的知识库 ⽂件夹：知识库/AI技术 ⽂件名：AI技术发展趋势.md 标签：#AI #技术 #趋势 已创建双向链接： [[⼤模型发展]] [[AI应⽤场景]] [[技术趋势分析]] **Obsidian优势**： - ✅ 完全本地存储 - ✅ 纯Markdown格式 - ✅ 强⼤的双向链接 - ✅ 丰富的插件⽣态 - ✅ 隐私安全 **Obsidian劣势**： - ❌ 需要⼿动同步（或付费Obsidian Sync） - ❌ 移动端体验⼀般 - ❌ 学习曲线较陡 - ❌ 团队协作较弱 ### 多设备协同⼯作 **场景1：Mac + iPhone组合** 早上（Mac）： 你：收集今天要看的5篇⽂章 OpenClaw：已保存到备忘录 通勤路上（iPhone）： 打开备忘录 阅读OpenClaw整理的⽂章 添加你的想法 晚上（Mac）： ⾃动同步回Mac 继续深⼊研究 **场景2：多⼈协作** 团队成员A（Mac）： 你：整理这周的技术⽂章，保存到Notion 团队成员B（Windows）： 打开Notion 查看A整理的⽂章 添加评论和补充 团队成员C（⼿机）： Notion App查看 随时随地访问 **场景3：跨平台⼯作流** 步骤1：Mac上收集（OpenClaw + 备忘录） 步骤2：iPhone上阅读（备忘录App） 步骤3：iPad上编辑（备忘录App） 步骤4：⽹⻚上分享（） ### 同步⽅案对⽐ | ⽅案 | 优势 | 劣势 | 适合场景 | 推荐指数 | |------|------|------|----------|----------| | **Mac备忘录** | 免费、⾃动、简单 | 功能较简单 | 个⼈使⽤、苹果⽣态 | ⭐⭐⭐⭐⭐ | | **Notion** | 功能强⼤、团队协作 | 需配置、有成本 | 团队协作、复杂组织 | ⭐⭐⭐⭐ | | **Obsidian** | 本地存储、隐私安全 | 同步⿇烦 | 重视隐私、本地优先 | ⭐⭐⭐⭐ | **选择建议**： 1. **个⼈使⽤ + 苹果⽣态** → Mac备忘录 - 最简单 - 最稳定 - 完全免费 2. **团队协作 + 跨平台** → Notion - 功能最强 - 协作最好 - 值得付费 3. **隐私优先 + 本地存储** → Obsidian - 最安全 - 最灵活 - 需要折腾 ### 数据备份策略 **重要性**： - 防⽌数据丢失 - 防⽌误删除 - 防⽌同步错误 **备份⽅案**： **⽅案1：iCloud⾃动备份** ```bash # Mac备忘录⾃动备份到iCloud # ⽆需额外配置 # 保留30天历史版本 ```text **⽅案2：定期导出** 你：每周⽇晚上8点，导出所有笔记到本地 OpenClaw：已设置定期备份！ 备份内容： 所有备忘录 所有Notion⻚⾯ 所有Obsidian⽂件 备份位置：~/Documents/Backups/知识库/ 备份格式：Markdown + PDF 备份频率：每周⽇ 20:00 **⽅案3：Git版本控制** ```bash # 对于Obsidian⽤户 cd ~/Documents/ObsidianVault git init git add . git commit -m "备份知识库" git push origin main 📝 本章⼩结 本章学习了OpenClaw的知识库管理功能： 核⼼功能 1. ⽹⻚⽂章存档 ⾃动抓取和摘要 智能分类存储 跨设备同步 2. GitHub项⽬管理 项⽬信息分析 技术选型对⽐ 学习资源整理 3. 论⽂笔记整理 PDF解析和提取 结构化笔记 引⽤管理 4. 跨设备同步 Mac备忘录（推荐） Notion（团队协作） Obsidian（本地优先） 实战技巧 ✅ 建⽴分类体系 ✅ 使⽤标签管理 ✅ 定期备份数据 ✅ 选择合适的同步⽅案 下⼀步 学习第6章：⽇程与任务管理 掌握⽇历⾃动创建 实现智能提醒系统 🎯 实战练习 练习1：建⽴个⼈知识库 1. 选择⼀个同步⽅案（推荐Mac备忘录） 2. 建⽴分类体系（⾄少3个分类） 3. 收藏5篇⽂章 4. 在⼿机上查看 练习2：GitHub项⽬调研 1. 选择⼀个技术领域 2. 找3个相关的GitHub项⽬ 3. 让OpenClaw分析对⽐ 4. ⽣成调研报告 练习3：论⽂阅读笔记 1. 下载⼀篇论⽂PDF 2. 让OpenClaw⽣成阅读笔记 3. 添加你的思考 4. 整理到知识库 💡 常⻅问题 Q1：Mac备忘录同步慢怎么办？ A：检查⽹络连接，重启备忘录App，或重新登录iCloud。 Q2：Notion API配置失败？ A：确认Token正确，检查数据库权限，参考官⽅⽂档。 Q3：如何批量导⼊已有笔记？ A：使⽤ OpenClaw的批量处理功能，或编写⾃动化脚本。 Q4：数据安全如何保证？ A：定期备份，使⽤加密存储，选择可信的同步⽅案。 Q5：如何搜索历史笔记？ A：使⽤备忘录/Notion/Obsidian的搜索功能，或让OpenClaw帮你搜索。 下⼀章：第6章：⽇程与任务管理 - ⽇历⾃动创建、微信截图识别 返回⽬录：README 第6章 ⽇程与任务管理 💡 本章⽬标：学会使⽤ OpenClaw管理⽇程和任务，实现⽇历⾃动创建、微信截图识别、批量⽇程导⼊和 智能提醒设置。 📅 本章内容 ⽇历⾃动创建 微信截图识别 批量⽇程导⼊ 提醒设置技巧 ⽇历⾃动创建 为什么需要⽇历⾃动创建 在⽇常⼯作中，经常遇到这些场景： 📱 微信聊天中约定会议时间 📧 邮件中收到活动邀请 💬 群聊中讨论项⽬deadline 📝 ⽂档中记录的重要⽇期 传统做法： 1. 记住时间地点 2. 打开⽇历App 3. ⼿动创建事件 4. 设置提醒 问题： ❌ 容易遗忘 ❌ 操作繁琐 ❌ 信息容易丢失 ❌ 效率低下 OpenClaw可以⾃动识别并创建⽇历事件！ 核⼼原理 OpenClaw的⽇历管理基于Mac⽇历Skills： ⽂本/截图 → OpenClaw识别 → 提取信息 → 创建⽇历事件 → 同步到iPhone 关键能⼒： 1. 智能识别：⾃动识别时间、地点、⼈物 2. ⾃动创建：⼀键创建⽇历事件 3. 跨设备同步：Mac⽇历⾃动同步到iPhone 4. 智能提醒：⾃动设置合理的提醒时间 实战案例1：⽂本创建⽇历 场景：你在微信上约了⼀个会议。 微信聊天内容： 张三：明天下午3点，在会议室A讨论项⽬⽅案，记得带笔记本 OpenClaw操作： 你：帮我创建⼀个⽇历事件： 明天下午3点，在会议室A讨论项⽬⽅案 OpenClaw：好的，我来帮你创建⽇历事件。 [分析中...] OpenClaw：已创建⽇历事件！ 📅 事件详情： - 标题：讨论项⽬⽅案 - 时间：2026-02-11 15:00-16:00 - 地点：会议室A - 参与⼈：张三 - 备注：记得带笔记本 提醒设置： - 提前15分钟提醒 - 提前1⼩时提醒 已同步到： - Mac⽇历 ✅ - iPhone⽇历 ✅ 查看效果： 打开Mac⽇历，你会看到： 2026年2⽉11⽇ 星期⼆ 15:00-16:00 讨论项⽬⽅案 📍 会议室A 👤 张三 📝 记得带笔记本 🔔 提前15分钟提醒 🔔 提前1⼩时提醒 打开iPhone⽇历，⾃动同步显⽰相同内容。 实战案例2：复杂⽇程创建 场景：你收到⼀封会议邀请邮件。 邮件内容： 主题：2026年Q1产品规划会议 时间：2026年2⽉15⽇（周五）14:00-17:00 地点：总部⼤楼3楼会议室 参会⼈员：产品团队全体成员 会议议程： 1. Q1产品回顾（30分钟） 2. Q2产品规划（60分钟） 3. 资源分配讨论（60分钟） 4. 总结与⾏动项（30分钟） 请提前准备： - Q1产品数据报告 - Q2产品规划草案 - 资源需求清单 OpenClaw操作： 你：帮我根据这封邮件创建⽇历事件 [粘贴邮件内容] OpenClaw：正在分析邮件内容... [分析完成] OpenClaw：已创建详细⽇历事件！ 📅 事件详情： - 标题：2026年Q1产品规划会议 - 时间：2026-02-15 14:00-17:00（3⼩时） - 地点：总部⼤楼3楼会议室 - 参与⼈：产品团队全体成员 会议议程： 1. 14:00-14:30 Q1产品回顾 2. 14:30-15:30 Q2产品规划 3. 15:30-16:30 资源分配讨论 4. 16:30-17:00 总结与⾏动项 准备事项： ✓ Q1产品数据报告 ✓ Q2产品规划草案 ✓ 资源需求清单 提醒设置： - 提前1天提醒（准备材料） - 提前2⼩时提醒（检查准备） - 提前30分钟提醒（前往会议室） 已同步到Mac和iPhone⽇历 ✅ 实战案例3：周期性事件 场景：你需要设置每周例会。 OpenClaw操作： 你：帮我创建⼀个周期性⽇历事件： 每周⼀上午10点，团队周会，持续1⼩时，会议室B OpenClaw：已创建周期性事件！ 📅 事件详情： - 标题：团队周会 - 时间：每周⼀ 10:00-11:00 - 地点：会议室B - 重复：每周 - 结束：⽆限期（或指定结束⽇期） 提醒设置： - 提前15分钟提醒 已创建未来12周的事件： - 2026-02-10（周⼀）10:00 - 2026-02-17（周⼀）10:00 - 2026-02-24（周⼀）10:00 - ... （共12次） 已同步到Mac和iPhone⽇历 ✅ ⽇历模板和最佳实践 常⽤⽇历模板： 模板1：会议事件 标题：[会议主题] 时间：[⽇期] [开始时间]-[结束时间] 地点：[会议室/线上链接] 参与⼈：[参会⼈员] 议程：[会议议程] 准备：[需要准备的材料] 提醒：提前1天、提前1⼩时、提前15分钟 模板2：项⽬deadline 标题：[项⽬名称] - Deadline 时间：[截⽌⽇期] 全天 优先级：⾼ 提醒：提前1周、提前3天、提前1天、当天早上 备注：[交付物清单] 模板3：个⼈事项 标题：[事项名称] 时间：[⽇期] [时间] 地点：[地点] 提醒：提前30分钟 备注：[相关信息] 最佳实践： 1. 统⼀命名规范 会议：[会议] 项⽬讨论 任务：[任务] 完成报告 活动：[活动] 团建 学习：[学习] 技术分享 2. 合理设置提醒 重要会议：提前1天、1⼩时、15分钟 普通会议：提前1⼩时、15分钟 deadline：提前1周、3天、1天 个⼈事项：提前30分钟 3. 添加详细信息 - 会议链接（线上会议） - 会议室位置（线下会议） - 参会⼈员联系⽅式 - 准备材料清单 - 相关⽂档链接 4. 使⽤颜⾊分类 红⾊：紧急重要 橙⾊：重要不紧急 ⻩⾊：紧急不重要 绿⾊：个⼈事项 蓝⾊：学习成⻓ 微信截图识别 为什么需要截图识别 真实场景： 你在微信上收到这样的消息： 张三：明天下午2点，在星巴克（国贸店）⻅⾯讨论新项⽬的事， 记得带上你的⽅案，我请你喝咖啡😊 传统做法： 1. 看到消息 2. 记住时间地点 3. 打开⽇历 4. ⼿动输⼊信息 5. 设置提醒 问题： ❌ 步骤繁琐（5步） ❌ 容易遗忘 ❌ 信息可能记错 ❌ 效率低下 OpenClaw做法： 1. 截图发给OpenClaw 2. 完成！ 核⼼原理 OpenClaw的截图识别流程： 微信截图 → OCR⽂字识别 → NLP信息提取 → 创建⽇历事件 关键技术： 1. OCR识别：提取截图中的⽂字 2. 时间解析：识别"明天下午2点"等⾃然语⾔ 3. 地点提取：识别"星巴克（国贸店）" 4. ⼈物识别：识别"张三" 5. 事项提取：识别"聊新项⽬" 实战案例1：简单约会 微信截图内容： 李四：后天晚上7点，⽼地⽅吃饭？ 你：好的！ OpenClaw操作： 你：[发送微信截图] 帮我创建⽇历事件 OpenClaw：正在识别截图内容... [OCR识别完成] OpenClaw：已识别到约会信息！ 📅 事件详情： - 标题：和李四吃饭 - 时间：2026-02-12 19:00-20:30 - 地点：⽼地⽅（需要你确认具体地址） - 参与⼈：李四 提醒设置： - 提前2⼩时提醒 已创建⽇历事件 ✅ 💡 提⽰：如果"⽼地⽅"有具体地址， 可以告诉我，我帮你更新到⽇历中。 补充地址： 你：⽼地⽅是"海底捞（三⾥屯店）" OpenClaw：已更新地址！ 📍 地点：海底捞（三⾥屯店） 📍 地址：北京市朝阳区三⾥屯路19号 已同步到⽇历 ✅ 实战案例2：复杂会议安排 微信群聊截图： 项⽬经理：@全体成员 下周三上午9:30，在公司5楼⼤会议室开项⽬启动会 请务必参加，会议预计2⼩时 需要准备： 1. 项⽬需求⽂档 2. 技术⽅案 3. 时间排期 会后会有⼯作午餐 OpenClaw操作： 你：[发送群聊截图] 帮我创建⽇历事件 OpenClaw：正在识别群聊内容... [识别完成] OpenClaw：已识别到会议信息！ 📅 事件详情： - 标题：项⽬启动会 - 时间：2026-02-19 09:30-11:30（2⼩时） - 地点：公司5楼⼤会议室 - 参与⼈：项⽬团队全体成员 准备事项： ✓ 项⽬需求⽂档 ✓ 技术⽅案 ✓ 时间排期 备注： - 会后有⼯作午餐 - 务必参加 提醒设置： - 提前1天提醒（准备材料） - 提前1⼩时提醒 - 提前15分钟提醒 已创建⽇历事件 ✅ 💡 提⽰：已⾃动预留11:30-13:00的午餐时间 实战案例3：多个事件批量创建 微信截图内容： 本周安排： 周⼀10:00 - 团队周会（会议室A） 周三14:00 - 客户拜访（客户公司） 周五16:00 - 项⽬复盘（线上会议） OpenClaw操作： 你：[发送截图] 帮我批量创建这些⽇历事件 OpenClaw：正在识别多个事件... [识别完成] OpenClaw：已识别到3个事件！ 📅 事件1：团队周会 - 时间：2026-02-10 10:00-11:00 - 地点：会议室A ✅ 已创建 📅 事件2：客户拜访 - 时间：2026-02-12 14:00-15:30 - 地点：客户公司（需要具体地址） ✅ 已创建 📅 事件3：项⽬复盘 - 时间：2026-02-14 16:00-17:00 - 地点：线上会议（需要会议链接） ✅ 已创建 所有事件已同步到⽇历 ✅ 💡 提⽰： - 客户拜访需要补充具体地址 - 项⽬复盘需要添加会议链接 识别准确率优化 提⾼识别准确率的技巧： 技巧1：清晰的截图 ✅ 好的截图： - ⽂字清晰 - 光线充⾜ - 完整内容 ❌ 不好的截图： - 模糊不清 - 光线太暗 - 内容被截断 技巧2：结构化的信息 ✅ 容易识别： 时间：明天下午3点 地点：会议室A 事项：讨论项⽬ ❌ 难以识别： 明天下午在那个地⽅讨论那个事 技巧3：补充说明 你：[发送截图] 这是约明天下午的会议，地点在公司 OpenClaw：收到！我会结合你的说明来识别。 技巧4：确认和修正 OpenClaw：我识别到的信息是： 时间：明天下午3点 地点：会议室A 请确认是否正确？ 你：时间对了，但地点是会议室B OpenClaw：好的，已修正为会议室B ✅ 批量⽇程导⼊ 为什么需要批量导⼊ 常⻅场景： 1. 新学期课程表 10-20⻔课程 每周重复 不同教室 2. 项⽬⾥程碑 多个关键节点 不同负责⼈ 各种deadline 3. 会议⽇程 多场会议 不同时间地点 不同参与⼈ 传统做法： ⼀个⼀个⼿动创建 耗时1-2⼩时 容易出错 OpenClaw做法： 准备Excel/CSV⽂件 ⼀键批量导⼊ 5分钟完成 Excel⽇程导⼊ 步骤1：准备Excel⽂件 创建⼀个Excel⽂件（ 课程表.xlsx）： 标题 ⽇期 开始时间 结束时间 地点 备注 重复 ⾼等数学 2026-02-10 08:00 09:40 教学楼A101 王⽼师 每周⼀ ⼤学英语 2026-02-10 10:00 11:40 教学楼B203 李⽼师 每周⼀ 计算机基础 2026-02-11 14:00 15:40 实验楼C301 张⽼师 每周⼆ 体育课 2026-02-12 08:00 09:40 体育馆 刘⽼师 每周三 步骤2：OpenClaw导⼊ 你：帮我导⼊这个课程表到⽇历 [上传 课程表.xlsx] OpenClaw：正在读取Excel⽂件... [读取完成] OpenClaw：已识别到4门课程！ 正在创建⽇历事件... ✅ ⾼等数学（每周⼀ 08:00-09:40） ✅ ⼤学英语（每周⼀ 10:00-11:40） ✅ 计算机基础（每周⼆ 14:00-15:40） ✅ 体育课（每周三 08:00-09:40） 已创建本学期所有课程（共16周，64个事件） 提醒设置： - 每节课提前15分钟提醒 已同步到Mac和iPhone⽇历 ✅ CSV格式处理 CSV⽂件⽰例（ 项⽬⾥程碑.csv）： 标题,⽇期,时间,地点,负责⼈,优先级 需求评审,2026-02-15,14:00-16:00,会议室A,张三,⾼ 设计评审,2026-02-20,10:00-12:00,会议室B,李四,⾼ 开发完成,2026-03-01,全天,⽆,王五,⾼ 测试完成,2026-03-10,全天,⽆,赵六,中 上线发布,2026-03-15,09:00-18:00,机房,张三,⾼ ```text **OpenClaw导⼊**： 你：帮我导⼊项⽬⾥程碑 [上传 项⽬⾥程碑.csv] OpenClaw：正在读取CSV⽂件... [读取完成] OpenClaw：已识别到5个⾥程碑！ 📅 需求评审 时间：2026-02-15 14:00-16:00 负责⼈：张三 优先级：⾼ ✅ 已创建 📅 设计评审 时间：2026-02-20 10:00-12:00 负责⼈：李四 优先级：⾼ ✅ 已创建 📅 开发完成 时间：2026-03-01 全天 负责⼈：王五 优先级：⾼ ✅ 已创建 📅 测试完成 时间：2026-03-10 全天 负责⼈：赵六 优先级：中 ✅ 已创建 📅 上线发布 时间：2026-03-15 09:00-18:00 负责⼈：张三 优先级：⾼ ✅ 已创建 所有⾥程碑已同步到⽇历 ✅ 提醒设置： ⾼优先级：提前1周、3天、1天 中优先级：提前3天、1天 ### 批量创建事件 **场景**：你需要创建⼀系列会议。 **OpenClaw操作**： 你：帮我创建以下会议： 1. 每周⼀10:00，团队周会，会议室A，1⼩时 2. 每周三14:00，技术分享，会议室B，2⼩时 3. 每周五16:00，项⽬复盘，线上会议，1⼩时 从下周开始，持续12周 OpenClaw：正在批量创建会议... [创建中...] OpenClaw：已完成批量创建！ 📊 创建统计： 团队周会：12次 技术分享：12次 项⽬复盘：12次 总计：36个事件 时间范围： 开始：2026-02-17 结束：2026-05-09 提醒设置： 所有会议提前15分钟提醒 已同步到Mac和iPhone⽇历 ✅ 💡 提⽰：可以在⽇历中单独修改某次会议 ### 数据验证和错误处理 **OpenClaw的智能验证**： **验证1：时间冲突检测** OpenClaw：⚠ 检测到时间冲突！ 冲突事件： 2026-02-15 14:00 需求评审（会议室A） 2026-02-15 14:30 客⼾拜访（客⼾公司） 建议： 1. 调整需求评审到15:00 2. 调整客⼾拜访到16:00 3. 取消其中⼀个 请选择处理⽅式： **验证2：⽇期格式错误** OpenClaw：⚠ 发现⽇期格式错误！ 错误⾏： 第3⾏：⽇期"2026/02/30"⽆效（2⽉没有30⽇） 第5⾏：时间"25:00"⽆效（超过24⼩时） 已⾃动修正： 第3⾏：改为"2026-03-01" 第5⾏：改为"23:00" 请确认是否正确？ **验证3：必填字段缺失** OpenClaw：⚠ 发现必填字段缺失！ 缺失信息： 第2⾏：缺少"标题" 第4⾏：缺少"⽇期" 建议： 1. 补充缺失信息 2. 跳过这些⾏ 3. 使⽤默认值 请选择处理⽅式： --- ## 提醒设置技巧 ### 提醒类型和时机 **提醒类型**： 1. **时间提醒** - 提前X分钟/⼩时/天 - 准时提醒 - 延迟提醒 2. **位置提醒** - 到达某地时提醒 - 离开某地时提醒 3. **重复提醒** - 每天/每周/每⽉ - ⾃定义周期 **提醒时机选择**： 不同类型的事件需要不同的提醒策略，如表 6-1 所⽰。 **表 6-1 不同事件类型的推荐提醒时机** | 事件类型 | 推荐提醒时机 | 理由 | |---------|-------------|------| | 重要会议 | 提前1天、1⼩时、15分钟 | 充分准备 | | 普通会议 | 提前1⼩时、15分钟 | 及时赶到 | | 项⽬deadline | 提前1周、3天、1天 | 避免拖延 | | ⽇常任务 | 提前30分钟 | 不打断⼯作 | | 约会 | 提前2⼩时、30分钟 | 预留准备时间 | | 课程 | 提前15分钟 | 准时到达 | ### 多级提醒设置 **场景**：重要项⽬deadline。 **OpenClaw操作**： 你：帮我设置项⽬deadline的提醒： 2026年3⽉15⽇，产品上线 OpenClaw：好的，我来设置多级提醒！ 📅 事件：产品上线 ⏰ ⽇期：2026-03-15 提醒设置： 🔔 第1级提醒（提前2周） 时间：2026-03-01 09:00 内容：距离产品上线还有2周，开始最后冲刺 ⾏动：检查进度，确认资源 🔔 第2级提醒（提前1