夜雨聆风OpenClaw 入门到精通 · 第 1 章 / 共 7 章
第一章：认识 OpenClaw：把专属 AI 助理装进口袋
01 为什么需要一个"真正的"AI 助理？
想想你现在是怎么用 AI 的：打开浏览器，进入 ChatGPT 或 Claude 网页，把问题粘贴进去，等回答，再把答案复制出来。这个过程其实叫"查询"，不叫"使用助理"。就像你想找一份文件，每次都要去图书馆借阅，而不是让助理直接从你的书架上取给你。
真正的助理是什么样的？它认识你、记得你的工作习惯，能直接帮你做事，而不只是给你建议。当你说"帮我整理今天的工作"，它知道你在用哪些工具、你的项目进展，直接帮你生成报告，而不是问你"请描述一下你今天做了什么"。
举个具体例子。假设你是一名产品经理，每周要写工作周报。如果用"查询工具"的方式：你要先手动整理本周完成的任务，打开 AI 网页，把内容粘贴进去，让它帮你润色，再复制输出，粘到文档里。每次至少花20分钟，而且每次都要重新解释"我是谁、我在做什么项目"。
用真正的助理是什么感觉？你在通讯工具里说一句"帮我把本周工作日志整理成周报，按我们公司模板格式，存到周报文件夹"。助理知道你是谁，知道你的模板在哪，直接帮你做完，你只需要审阅一遍点发送。整个过程5分钟。
这就是 OpenClaw 想解决的核心问题：让 AI 助理从"每次都要重新认识你的工具"，变成"真正了解你、能直接帮你干活的同事"。区别不只是效率，更是体验——你不再是在"使用工具"，而是在"协作"。
还有一个你可能没想到的问题：数据安全。你把工作内容、个人信息都告诉了 AI，这些数据存在哪里？大多数云端 AI 服务会把你的对话存在他们的服务器上，可能用于模型训练，可能被内部员工访问。如果你处理的是公司机密或个人隐私，这是个真实的风险。OpenClaw 的答案是：让所有数据留在你自己的设备上。
02 OpenClaw 是什么？
一句话定义：OpenClaw 是运行在你自己设备上的 AI 助理网关。它的核心工作是：连接你常用的聊天软件（飞书、钉钉、slack 等），和你选择的 AI 大脑（GPT-5.4、Claude 4.6、Gemini 3.1 等），让你在任何平台发消息，都能得到同一个"记得你是谁"的助理响应。
用一个比喻来理解：想象你雇了一个全能助理。普通的 AI 服务是这样的——这个助理住在中介公司（云服务器），你每次需要帮助都得打电话给中介，中介再派助理来。你的对话记录、你透露的个人信息，都在中介那里存着。
OpenClaw 的模式不一样：这个助理"住"在你家（你的电脑）。你在聊天软件说话，助理就在你的电脑上处理，结果发回给你。数据不经过任何中介，你的对话记录、记忆文件，都存在你自己的 ~/.openclaw/ 目录里，随时可查可删。
OpenClaw 支持的平台：飞书（最推荐，企业场景完美契合）、Telegram（国际用户常用）、Discord（社区和团队协作）、WhatsApp、钉钉。你可以同时接入多个平台，助理在所有平台里都是同一个"人"，共享同一份记忆。
运行环境：macOS（最推荐，安装最简单）、Linux（服务器党的首选）。Windows 目前需要通过 WSL2 运行。本文以 macOS 为主要演示环境。
03 / 五大核心优势
🔒 数据私有化：你的对话不上传、不被训练、不被出售
这是 OpenClaw 最根本的设计原则。所有对话历史、你的记忆文件、你的个人配置，都存储在本地 ~/.openclaw/ 目录下。OpenClaw 本身不运行任何云服务，不收集数据。你调用的 AI 模型（比如 Claude API）会处理你发送的那条消息，但历史记录和上下文管理都在本地完成。
如果你处理的是公司项目信息，或者单纯不想把自己的生活细节交给科技公司，这个特性非常重要。更实际的好处是：你随时可以看到 ~/.openclaw/workspace/MEMORY.md 里存了什么，可以编辑、删除，完全掌控。
💬 多平台统一：在飞书问、在 Telegram 问、在 Discord 问，都是同一个助理
很多人工作用飞书，下班后用 Telegram，周末用 Discord。如果每个平台配置不同的 AI，记忆就会碎片化。OpenClaw 的核心价值之一是：不管你在哪个平台说话，助理看到的是统一的上下文。你在飞书告诉它"帮我记住，我们公司的季度目标是用户增长30%"，一周后在 Telegram 说"帮我写一篇季度复盘"，助理还记得那个目标。
🧠 模型自由选：Claude Sonnet 4.6 擅长推理，GPT-5.4 工具调用强，Gemini 3.1 响应快，按需切换
没有任何一个 AI 模型在所有场景都是最好的。OpenClaw 让你可以自由配置使用哪个模型，甚至可以为不同任务配置不同的默认模型。写一篇有深度的文章？用 Claude Sonnet 4.6。处理代码和工具调用？用 GPT-5.4。高频日常问答？用 Gemini 3.1 节省成本。如果你完全追求隐私，还可以用 Ollama 跑本地模型，零数据出境。
🔧 技能可扩展：像给手机装 App，需要什么能力就装什么技能
OpenClaw 自带一套技能系统（Skills）。每个"技能"是一个 SKILL.md 文件，告诉助理在特定场景下怎么做最专业。比如飞书文档技能，会让助理知道如何精确地读写飞书文档的各种格式；PDF 技能，会让助理知道如何用自然语言编辑 PDF。你不用什么都内置，按需装载，保持轻量。第四章会详细介绍。
📝 真正的记忆：不只是"这次对话记得"，而是"永远记得你是谁、你喜欢什么"
普通 AI 对话是"一次性"的——每次开新对话，助理对你一无所知。OpenClaw 有三层记忆：
SOUL.md 定义助理的性格
USER.md 存你的基本信息
MEMORY.md 是助理积累的长期记忆。
你让助理记住的事情、它自己总结的重要信息，都会写入这些文件，下次对话自动加载。时间越长，助理越了解你。
04 安装：真的只需要 5 分钟
好了，说了这么多好处，现在来真的。安装 OpenClaw 在 macOS 上非常简单，只需要两个命令。
前置条件：
你需要安装 Homebrew（macOS 的包管理器，类似 App Store，但用命令行操作）。如果你已经有了，跳过这步。如果没有，打开终端（Terminal），运行以下命令安装：
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"这条命令会从 Homebrew 官方下载安装脚本并运行。安装过程中会问你确认几次，一路按回车就好。大约3-5分钟完成。
Homebrew 安装完成后，运行以下命令安装 OpenClaw：
brew install openclaw这条命令告诉 Homebrew："去找 OpenClaw 这个软件，下载并安装好"。Homebrew 会自动处理所有依赖，你不需要手动下载任何文件。通常1-2分钟完成。
安装完成后，运行配置向导：
openclaw configure这个向导会引导你完成三步配置：第一步，选择 AI 模型（推荐先选 GitHub Copilot 或 Claude）；第二步，填入 API Key；第三步，选择接入的聊天平台（我们选飞书）。配置向导是交互式的，按提示填写就好。
05 工作区：助理的"家"
安装完成后，OpenClaw 会在你的用户目录下创建 ~/.openclaw/workspace/ 文件夹。这是助理的"家"，所有关于"助理是谁、记得什么"的信息都在这里。
这个目录里有几个核心文件，用生活化的方式来理解它们：
SOUL.md——助理的"岗位说明书"
就像公司给新员工写的岗位说明：这个助理叫什么名字、什么性格、怎么说话。你可以在这里写："你叫小助，说话简洁有趣，优先用中文，不说废话"。修改后重启 Gateway 生效。
USER.md——你的"个人档案"
告诉助理你是谁。建议填写：你的名字、所在时区（影响日历和提醒功能）、工作职位、常用工具、语言偏好。助理会在回复时考虑这些背景，比如你说你是设计师，它解释技术概念时会从视觉类比的角度来说。
MEMORY.md——助理的"重要事项备忘录"
你让助理记住的事情都在这里。说"帮我记住，我们公司的飞书知识库地址是 xxx"，助理会自动更新这个文件。每次对话开始时自动加载，所以它永远"记得"。安全提示：这个文件只在你的私聊中加载，在群聊里不会泄露。
HEARTBEAT.md——助理的"定时检查清单"
写在这里的任务，助理会每隔约30分钟自动检查一次。比如"检查有没有紧急邮件"、"早上告诉我今天天气"。不需要你主动去问，助理会主动告诉你。第五章会详细介绍。
这些文件都是普通的 Markdown 文本文件，用任何文本编辑器都能打开和修改。你完全掌控助理的"大脑"。
06 启动，发第一条消息
配置完成后，运行以下命令启动 OpenClaw 网关：
openclaw gateway start这条命令在后台启动 OpenClaw 的核心服务（Gateway）。Gateway 是助理的"大脑中枢"，负责接收来自各平台的消息、调用 AI 模型、执行工具、返回结果。
确认服务状态正常：
openclaw gateway status如果显示 "running"，说明服务正常启动。现在去你配置的聊天平台（比如飞书），搜索你创建的机器人应用名称，发一条"你好"。
等待3-5秒。如果收到回复，恭喜你！你的专属 AI 助理正式上线了。如果没有收到回复，不用慌——下一章会详细介绍飞书接入的完整步骤，以及常见问题的排查方法。
小结
安装只需一条命令：brew install openclaw
数据留在本地，对话不上传，更安全
多平台统一体验，飞书/Telegram/Discord 都是同一个助理
SOUL.md / USER.md / MEMORY.md / HEARTBEAT.md 四个文件定义助理的一切
GitHub Copilot 订阅用户零额外成本接入 Claude Sonnet 4.6
下一章，我们来完成最关键的一步——把 AI 助理真正接入你的飞书，从创建应用到发出第一条消息，每步都有详细说明，并覆盖常见问题的排查。
你现在用 AI 最大的痛点是什么？欢迎在评论区告诉我，也许第三章就能给你答案。
— OpenClaw 系列 | 第一章，共七章
📚 OpenClaw 入门到精通系列 · 第 1 章 共 7 章公众号：码上驰骋 | 转载请注明出处
