乐于分享
好东西不私藏

【OpenClaw 入门到精通】第1章:认识OpenClaw:把专属AI助理装进口袋

【OpenClaw 入门到精通】第1章:认识OpenClaw:把专属AI助理装进口袋

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 章公众号:码上驰骋 | 转载请注明出处