关于 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. 1. 接收消息　你通过微信、钉钉等通讯工具发送的指令，由网关接收进来
2. 2. 调度 AI　网关把指令交给 AI 大模型（如 Claude、DeepSeek 等）理解和处理
3. 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 是生态的原版和核心，各变体针对不同场景进行了专项优化：

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常见问题排查

Windows部署篇

第一步：安装Node.js

Windows不需要Homebrew，直接从官网下载安装：

1. 1. 访问：https://nodejs.org/en/download
2. 2. 找到 "Windows Installer (.msi)"，选 64-bit 版本
3. 3. 确保版本号 >= 22（如 v22.14.0 LTS）
4. 4. 点击下载（约100MB）
5. 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常见问题排查

通用配置篇（Mac & Windows相同）

运行配置向导

openclaw-cn onboard --install-daemon

这行命令会：

1. 1. 启动配置向导
2. 2. 安装守护进程（让OpenClaw后台运行）

配置步骤：

1. 1. 选择工作区路径 → 直接回车用默认
2. 2. 选择AI模型提供商 → 推荐选 deepseek
3. 3. 输入API Key → 从 https://platform.deepseek.com/ 获取
4. 4. 配置网关端口 → 默认18789，直接回车
5. 5. 通信通道配置 → 选"跳过"，后面再配置
6. 6. 安装守护进程 → 输入 Y
7. 7. 确认配置摘要 → 回车完成

获取deepseek API Key

1. 1. 访问：https://platform.deepseek.com/
2. 2. 注册/登录账号/认证
3. 3. 左侧菜单 → "API Keys"
4. 4. 点击"创建API Key"
5. 5. 复制生成的Key（格式如 sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx）
6. 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

Mac/Linux：

curl -fsSL https://clawd.org.cn/install.sh | bash

Windows：

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