OpenClaw是一个开源AI代理框架由奥地利开发者Peter Steinberger创建专注于构建自主AI代理能够执行实际任务如写代码、管理文件、浏览网页等而非仅限于聊天。它从一个简单原型迅速演变为GitHub历史上增长最快的开源项目之一涉及多次重命名、病毒式传播、商标纠纷和收购整合。下面我根据公开信息梳理其主要发展轨迹按时间顺序整理成时间线便于理解。整个过程体现了AI代理领域的快速迭代和社区驱动。OpenClaw 安装安装最简单的方式是用官方一键脚本推荐大多数用户整个过程5-15分钟就能跑起来。下面是基于 Manual 模式从零到跑通的最简指南重点避坑 配图。前置要求避坑第一步• 操作系统macOS / Linux推荐 /Windows用WSL或PowerShell•Node.jsv20脚本会自动检测安装但最好提前检查node -v• 硬件至少8GB内存本地模型跑得顺GPU可选但推荐• 网络首次onboarding需要联网获取模型/密钥• 常见坑别用root运行Windows别直接cmd用PowerShell或Git Bash防火墙别挡 18789 端口步骤 1一键安装最推荐方式打开终端macOS/Linux或PowerShellWindows直接粘贴运行• macOS / Linux代码语言javascriptAI代码解释# macOS / Linux curl -fsSL https://openclaw.ai/install.sh | bash• Windows代码语言javascriptAI代码解释# Windows (PowerShell) iwr -useb https://openclaw.ai/install.ps1 | iex脚本会自动• 检测/安装Node.js• 全局安装openclaw CLI• 启动onboarding向导常见报错处理•curl/wget不存在 → 先brew install curl或apt install curl• 权限问题 → 加sudo但不推荐长期用root• 网络慢 → 换个网络或用V**中国用户常见网上 499、599 上门安装估计大多数送一个 1 个月的V**哈哈安装脚本运行中自动检测Node并安装CLI的典型终端输出image-20260310142402866继续回车执行下一步可以看到环境检查的一些具体步骤执行情况接着是安装OpenClawimage-20260310142617832如果看到OpenClaw installed successfully (OpenClaw 2026.3.8 (3caab92))!说明已经安装成功了。image-20260310142826057它还和我卖了个萌步骤 2运行 Onboarding 向导核心配置image-20260310143044426选择Yes然后下一步开始选择Onboarding mode包括两种•QuickStart就是先使用默认的后面自己配置•Manual手动模式可以做一些定制化image-20260310143214772因为我之前在跑过这个目前估计大多数文章或者视频都是走QuickStart这里我们选择走Manual模式。image-20260310143740569设置工作目录image-20260310144029120下面是选择模型和模型提供商image-20260310144133812考虑到大多数读者是国内的因为这里以我评测下来的Z.AI的GLM模型为例各位可以按照 官方文档 来申请api-key。接着开始配置Z.AI提供商选择Z.AI作为Model/auth provider后选Coding-Plan-CN系统会提示您输入API Key。粘贴你的智谱API Key并按Enter键然后选择您想要使用的模型例如:zai/glm-5有的订阅模式可能不支持GLM-5后面对话的时候日志里面会出现HTTP 429: 当前订阅套餐暂未开放GLM-5权限类似的提醒image-20260310144704787注意: 支持 2026.2.22-2 及以上版本目前在编程套餐中支持的模型有GLM-5 GLM-4.7 GLM-4.5-Air GLM-4.6 GLM-4.5 GLM-4.5V GLM-4.6V请勿选择其它模型Flash FlashX以免造成扣费。image-20260310145044241配置model provider之后选择主模型这里我就用默认的GLM-5image-20260310145139306下面的都选择默认的即可image-20260310145330274网关鉴权使用推荐的token鉴权的方式其他的配置如下image-20260310145500532下面是进行channel配置image-20260310145557444国内的话推荐大家使用飞书Feishuimage-20260310150805654飞书开放平台-- 开发者后台 --- 创建应用 ---- 开通权限这里后门配置也行这里主要获取凭证与基础信息中的appId和app secret两个流程历程需要image-20260310150340480配置上appid和appsecret之后一路继续即可参考如下截图image-20260310152954734后面是web search相关的配置可以直接跳过image-20260310153154701接着是skills相关的配置这里我只安装了一个clawhub其他的后面按需install即可image-20260310153302448配置网关服务image-20260310153346441这里的报错是因为飞书平台那边我没有创建 bot 所以出现这个提示报错。image-20260310153610755配置机器人这里写的也算比较清楚。image-20260310153704692最后在版本管理和发布那里创建一个版本之后机器人就可以使用了你打开飞书会看到你的小助手了。另外还有个配对如果你的飞书小助手返回的信息是pairing code approve的话那你可以通过如下命令另一个tab或者新 窗口都行代码语言javascriptAI代码解释openclaw pairing approve feishu {your_code}步骤 3启动 检查 打开 Dashboard启动Gateway后台运行代码语言javascriptAI代码解释openclaw gateway start # 或 openclaw gateway restart检查状态代码语言javascriptAI代码解释openclaw status --probe openclaw doctor打开控制面板最直观的地方浏览器访问向导给的链接带token的那个如http://127.0.0.1:18789/#token你的tokenimage-20260310153941972这里能聊天、查看日志、加技能、监控任务大概如下image-20260310153913370到这里你的 应该已经 OK 了。Workspace 下有什么按照前面我选择的路径可以看看默认配置完之后都有什么文件代码语言javascriptAI代码解释workspace git:(main) ✗ ll total 64 -rw-r--r-- 1 glmapper staff 7.7K Mar 10 15:13 AGENTS.md -rw-r--r-- 1 glmapper staff 1.4K Mar 10 15:13 BOOTSTRAP.md -rw-r--r-- 1 glmapper staff 168B Mar 10 15:13 HEARTBEAT.md -rw-r--r-- 1 glmapper staff 636B Mar 10 15:13 IDENTITY.md -rw-r--r-- 1 glmapper staff 1.6K Mar 10 15:13 SOUL.md -rw-r--r-- 1 glmapper staff 860B Mar 10 15:13 TOOLS.md -rw-r--r-- 1 glmapper staff 477B Mar 10 15:13 USER.md简单解释下文件作用一句话理解AGENTS.md总控说明、全局规则入口相当于这个 Agent 工作区的“总说明书”BOOTSTRAP.md首次启动初始化第一次运行时要先执行的引导文件HEARTBEAT.md周期性自检/心跳提示给定时巡检看的简短检查项IDENTITY.mdAgent 身份设定定义“我是谁、扮演什么角色”SOUL.md底层原则与风格定义 Agent 的价值观和行为方式TOOLS.md工具使用边界说明“能用什么工具、怎么用”USER.md用户画像与偏好说明“服务对象是谁、偏好是什么”配置 Memory通过openclaw memory status命令查看 memory 的基本情况信息如下image-20260310162435731image-20260310162435731GitHub 上最近还有一个相关 issue Feature Request: Configurable MEMORY.md injection mode (full / core-only / recall-only)专门讨论MEMORY.md注入与 session 行为说明这部分目前确实是通过 workspace 文件参与上下文的。如果你是刚开始玩建议“先能用”其实不用先折腾向量库也不用额外上数据库。直接这样就够了代码语言javascriptAI代码解释cd {your_openclaw_basedir}/workspace touch MEMORY.md mkdir -p memory默认工作空间布局使用两个记忆层•memory/YYYY-MM-DD.md• 每日日志仅追加。• 在会话开始时读取今天和昨天的内容。•MEMORY.md可选• 精心整理的长期记忆。•仅在主要的私人会话中加载绝不在群组上下文中加载。这里来试一下先安装官方文档把文件和目录创建出来。image-20260310162916033记忆的写入机制是将需要长期保留的决策、偏好和事实写入MEMORY.md将日常笔记和运行过程写入memory/YYYY-MM-DD.md凡是明确要求 “记住” 的内容都应落盘保存而不是仅保留在上下文中。另外关于索引存储每个智能体的 SQLite 位于~/.openclaw/memory/agentId.sqlite可通过agents.defaults.memorySearch.store.path配置支持{agentId}令牌。配置多个 model/自定义模型这里我从配置文件的角度来配置一个是自定义的一个是 Z.AI 的这个前面已经配置了这里主要讲自定义配置文件默认路径/Users/glmapper/.openclaw/openclaw.json下面先直观看下和模型相关的配置展开自定义的 provider配置到 agent 中时主要 id 要保持一致否则会出现一些报错。总结网上的配置太多零碎不都系统而且大多是通过QuickStart方式安装的。本文通过一堆截图零帧起手完成了 openclaw manual 模式的配置让整个安装过程更加具体。也增加了一些简单的关于memory、多模型的配置说明。下一篇将会介绍多agent配置以及如何调用本地的命令等进阶技能