夜雨聆风关于 OpenClaw
OpenClaw 由 Peter Steinberger 开发，现由开源基金会管理，遵循 MIT 协议免费开放。截至 2026 年 3 月，GitHub 获得超过 247,000 Stars，ClawHub 技能市场已收录 16,000+ 社区技能，是目前增长最快的开源 AI Agent 项目之一。
第一章 OpenClaw 是什么：人人都能拥有的 AI 常驻助手
摘要 现有的 AI 聊天工具存在两个根本缺陷：没有记忆、无法自主行动。OpenClaw 是一个免费开源的 AI 智能体（Agent）平台，专门解决这两个问题——它运行在你自己的设备上，持续记忆、主动行动，让任何人都能拥有一个真正的"AI 常驻助手"。
1.1 当前 AI 工具的两个根本局限
ChatGPT、豆包、kimi等对话工具已经很好用，但有一个共同的模式：你问，它答；你关页面，它消失。
这背后是两个根本缺陷：
• 没有记忆：每次打开新对话，AI 记忆清空，用户必须反复交代背景，无法积累对你的了解 • 只能被动应答：AI 等你开口才工作，无法定时触发、主动通知，无法嵌入真实工作流
一种新的 AI 形态正在兴起——AI Agent（AI 智能体）——它能自主规划、主动执行、持续记忆：
2025 年，国务院《关于深入实施"人工智能+"行动的意见》明确提出：到 2027 年，智能体等 AI 应用的普及率超过 70%。掌握 AI Agent，已不再是技术人员的专属议题，而是每位公民和机构都需要面对的时代课题。
1.2 OpenClaw 是什么
OpenClaw 是一个运行在你自己设备上的 AI 助手平台。
你可以把它想象成一个"智能管家"——它住在你的电脑或云服务器里，连接着微信、钉钉、飞书、Telegram 等你平时用的通讯工具，随时待命，能够主动干活，并且记得你告诉过它的一切。
OpenClaw 由奥地利软件工程师 Peter Steinberger 开发，2026 年 1 月正式走红全球，截至 2026 年 3 月已获得超过 24.7 万 GitHub Stars、4.77 万次分支复制。2026 年 2 月 14 日，项目正式移交开源基金会管理，遵循 MIT 协议永久免费——没有任何商业公司能垄断或关闭这个项目，全球开发者共同维护。
1.3 核心架构：网关（Gateway）是什么
理解 OpenClaw，最重要的概念是它的**"网关"（Gateway）**设计。
网关是 OpenClaw 的"大脑中枢"，在你的设备后台安静地运行，负责三件事：
1. 接收消息 你通过微信、钉钉等通讯工具发送的指令，由网关接收进来 2. 调度 AI 网关把指令交给 AI 大模型（如 Claude、DeepSeek 等）理解和处理 3. 执行任务 AI 给出指令后，网关实际执行——发邮件、整理文件、抓取网页数据……
用一个比喻：网关就像一位随时在岗的秘书，既能接听电话（接收消息），又能联系专家顾问（调用 AI），还能亲自去办事（执行任务），最后把结果汇报给你。
你的消息（微信/钉钉/飞书）
↓
网关接收
↓
AI 理解分析
↓
网关执行具体操作
↓
结果回复给你
这个架构带来一个关键优势：所有数据和操作都在你自己的设备上进行，不需要把隐私数据上传到陌生的云端服务器。
1.4 四大核心特性
特性一：本地优先，数据自主
OpenClaw 默认运行在你自己的设备上。你的文件、对话记录、个人信息，全部保存在本地，而不是某家科技公司的服务器上。这对注重隐私的个人用户和政府机关尤为重要。
特性二：消息驱动，操作习惯零改变
OpenClaw 不要求你学习新的软件界面。你只需在熟悉的钉钉、飞书、微信等软件里，用自然语言发消息，就能指挥 AI 助手完成任务——就像给助理发微信，而不是学一套新系统。
国内主要支持的通讯渠道：
特性三：持久记忆，越用越懂你
OpenClaw 有两个特殊的"记忆文件"：
• SOUL.md（灵魂文件）：你的基本信息、工作偏好、角色设定——告诉 OpenClaw "你是谁" • MEMORY.md（记忆文件）：随着对话自动积累的记忆——OpenClaw 会记住你说过的话、做过的决定、交代过的事项
这两个文件让 OpenClaw 拥有真正的"记忆"：下次打开对话，它仍然认识你，知道你的习惯，了解你的偏好。
特性四：技能可扩展，16,000+ 社区技能
OpenClaw 有一个类似"应用商店"的技能市场——ClawHub（clawhub.ai），截至 2026 年 3 月已收录超过 16,000 个社区贡献的技能。
这些"技能"是教 OpenClaw 做特定工作的说明书，例如：每天定时发送新闻摘要、自动整理邮件并分类、监控某个网页的价格变化……安装一个技能，就像给 OpenClaw 培训一项新本领，无需编写代码。
1.5 开源免费：为什么这很重要
OpenClaw 遵循 MIT 开源协议（一种永久免费、代码完全公开、任何人都可使用的授权方式），意味着：
• 永久免费：无订阅费用，无使用限制 • 代码透明：任何人可以查看、审计代码，没有隐藏功能 • 社区共建：全球开发者共同维护，不依赖单一公司，不会因为某家公司倒闭而消失 • 可二次开发：机构或企业可根据自身需求进行定制化改造
1.6 Claw 生态：一个原版，百花齐放
OpenClaw 开源后，社区基于其核心代码孵化出一批专项优化的变体项目，共同构成了"Claw 生态"。OpenClaw 是生态的原版和核心，各变体针对不同场景进行了专项优化：
| OpenClaw | ||
| EasyClaw | ||
| MaxClaw | ||
| NanoClaw | ||
| ZeroClaw |
1.7 场景全景：OpenClaw 的应用版图
以下是 OpenClaw 典型应用场景的全景概览：
1.8 小结
OpenClaw 是一个免费开源、本地优先、消息驱动的 AI Agent 平台。它以"网关"为核心，连接你熟悉的通讯工具，让 AI 能够持续运行、记住你、主动替你完成工作。使用方式简单到只需发一条消息，技术基础来自全球开发者的共同努力，整个生态已孵化出面向不同人群的多个变体产品。
第二章 桌面安装Openclaw (偏点技术）
前置概念
1. 什么是终端/命令行？
终端就像你给电脑发微信，你打字发指令，电脑收到后执行。
Mac打开方式：
• 按 Command + 空格，输入"终端"，回车• 或在"应用程序 → 实用工具"里找到
Windows打开方式：
• 按 Win + R，输入powershell，回车• 或在搜索栏搜"PowerShell"
2. 什么是Node.js？
Node.js是一个"翻译官"，OpenClaw是用JavaScript写的，需要Node.js才能在电脑上运行。
版本要求： Node.js >= 22
3. 什么是API Key？
API Key是调用AI大模型的"会员卡"。OpenClaw本身免费，但需要接入AI大模型（如MiniMax、Claude等）才能思考。
Mac部署篇
第一步：安装Homebrew
Homebrew是Mac系统的"命令行应用商店"。
验证是否已安装：
brew --version如果显示版本号（如 Homebrew 4.x.x），直接跳到第二步。
如果未安装，复制粘贴以下命令：
curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh注意： 输入密码时屏幕上不会显示任何字符（没有星号、没有圆点），这是正常的，直接打完回车即可。
安装卡住怎么办？ 如果卡在"Downloading"不动，使用国内镜像：
/bin/zsh -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"看到 Installation successful! 即安装成功。
第二步：安装Node.js
有了Homebrew，安装Node.js只需一行命令：
brew install node验证安装：
node -v应显示 v22.x.x 或更高版本。
再验证npm：
npm -v如果版本低于22：
brew upgrade node第三步：安装OpenClaw
推荐方式（官方一键脚本）：
curl -fsSL https://clawd.org.cn/install.sh | bash如果报权限错误（EACCES）：
sudo curl -fsSL https://clawd.org.cn/install.sh | bash验证安装：
openclaw-cn --version看到版本号（如 openclaw-cn/2026.2.23）即安装成功。
Mac常见问题排查
sudo | |
brew upgrade node | |
lsof -i :18789kill -9 <PID> |
Windows部署篇
第一步：安装Node.js
Windows不需要Homebrew，直接从官网下载安装：
1. 访问：https://nodejs.org/en/download 2. 找到 "Windows Installer (.msi)"，选 64-bit 版本 3. 确保版本号 >= 22（如 v22.14.0 LTS） 4. 点击下载（约100MB） 5. 双击安装包，一路Next
关键步骤： 在"Custom Setup"页面，确保 "Add to PATH" 被勾选！
验证安装（按 Win+R，输入 powershell）：
node -v
npm -v如果提示"'node'不是内部或外部命令"，卸载重装并确认"Add to PATH"已勾选。
第二步：安装OpenClaw
极其重要：以管理员身份打开PowerShell
方法：搜索"PowerShell" → 右键 → "以管理员身份运行"
安装命令：
iwr -useb https://clawd.org.cn/install.ps1 | iex验证安装：
openclaw-cn --version如果遇到ExecutionPolicy报错（禁止运行脚本）：
Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned输入 Y 确认，然后重新执行安装命令。
如果命令找不到： 关掉PowerShell，重新以管理员身份打开新窗口再试。
Windows常见问题排查
Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned | |
netstat -ano | findstr 18789taskkill /PID <PID> /F | |
通用配置篇（Mac & Windows相同）
运行配置向导
openclaw-cn onboard --install-daemon这行命令会：
1. 启动配置向导 2. 安装守护进程（让OpenClaw后台运行）
配置步骤：
1. 选择工作区路径 → 直接回车用默认 2. 选择AI模型提供商 → 推荐选 deepseek 3. 输入API Key → 从 https://platform.deepseek.com/ 获取 4. 配置网关端口 → 默认18789，直接回车 5. 通信通道配置 → 选"跳过"，后面再配置 6. 安装守护进程 → 输入 Y7. 确认配置摘要 → 回车完成
获取deepseek API Key
1. 访问：https://platform.deepseek.com/ 2. 注册/登录账号/认证 3. 左侧菜单 → "API Keys" 4. 点击"创建API Key" 5. 复制生成的Key（格式如 sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx）6. 重要： Key只显示一次，务必保存好！
首次运行
启动网关：
openclaw-cn gateway --port 18789当看到 Gateway is running on port 18789 或 Server started at http://127.0.0.1:18789 说明运行成功。
打开控制台（另开终端执行）：
openclaw-cn dashboard或浏览器访问：http://127.0.0.1:18789/
看到聊天界面后，输入测试：
你好，介绍一下你自己常用命令备忘
openclaw-cn gateway --port 18789 | |
openclaw-cn gateway status | |
openclaw-cn dashboard | |
openclaw-cn configure | |
openclaw-cn doctor | |
openclaw-cn --version | |
openclaw-cn tui |
更新OpenClaw
Mac/Linux：
curl -fsSL https://clawd.org.cn/install.sh | bashWindows：
iwr -useb https://clawd.org.cn/install.ps1 | iex安装流程总结
总计：约30-45分钟
提示：
• 黄色WARN不用管，只有红色ERROR才需要处理 • 配置国内npm镜像可大幅提升下载速度 • Mac 实在不好配置环境就下载trea，安装好直接就告诉ta安装openclaw
来源：1.《2万字OpenClaw最细部署指南》
原文链接：https://mp.weixin.qq.com/s/s4zCjnhZ-qBB_hSI3hfxhg
来源: 2 《OpenClaw 蓝皮书》
原文链接：https://github.com/xue160709/OpenClaw-CookBook/blob/main/README.md
