一个人踩坑,一个人总结,一个人分享。我是仲哥,这是我的AI实战记录。
本文目标:让一个完全没有技术背景的人,从零开始把 OpenClaw 跑起来。

去年12月,OpenClaw还不叫这个名字。我第一次装上,用的是工作电脑——装了1天就删了,由于太影响正常工作了。后来我找了台华硕笔记本,单独装了Ubuntu系统(更适配OpenClaw)。
没有技术背景,全程自己死磕,到处找资料,一点一点磨。目前,我有11个机器人在帮我干活:电商运营,内容发布,信息收集,本地化做图……全部串联在飞书里,每天只需要一部手机,就能完成全天的工作。
不废话,直接上操作步骤。
一、硬件选择
有两种方案,根据你的情况选一种:
方案一:用自己的闲置电脑(省钱,适合动手能力强的)
|
用途 |
推荐方案 |
说明 |
|
长期稳定运行 |
华硕笔记本(二手500-800元)/ Mac Mini |
24小时开机,功耗低 |
|
内存 |
≥4GB(推荐8GB以上) |
OpenClaw本体极小,真正吃内存的是AI模型 |
方案二:用云服务器(省心,适合不想折腾的)
如果不想用自己的电脑,可以直接买一台云服务器,2核2G就够用,一个月20-30元。
推荐:
- 腾讯云轻量应用服务器(最新有OpenClaw镜像,点几下就能部署好)

- 阿里云ECS(自己装系统,稍微麻烦一点)
云服务器的优势:24小时开机,不用自己维护,重装系统也方便。
OpenClaw 本体占用内存很小(300-500MB),真正吃资源的是 AI 模型推理。本地跑还是走云端 API,取决于你用什么模型。(300-500MB),真正吃资源的是 AI 模型推理。本地跑还是走云端 API,取决于你用什么模型。
二,前置环境安装
2.0 准备一台电脑
如果没有专用电脑,需要先准备一台。
推荐方案:
- 华硕笔记本(2015年以上机型即可,二手500-800元)
- Mac Mini(M1/M2芯片款)
- 任意闲置旧电脑
系统要求:Ubuntu Desktop 22.04 LTS
下载地址:
https://ubuntu.com/download/desktop

点击「Download Ubuntu 22.04 LTS」按钮,下载约4.5GB的ISO文件。
制作Ubuntu启动U盘(Windows系统制作):
- 下载 Ubuntu ISO 文件(约4.5GB)
- 下载 Rufus 启动盘制作工具:https://rufus.ie/
- 插入8GB以上U盘,打开Rufus
- 点击「选择」,找到下载好的Ubuntu ISO文件
- 点击「开始」,等待约10分钟制作完成
重装Ubuntu系统步骤:
- 插入Ubuntu启动U盘,开机按 F2/F12/Del 进入BIOS(不同品牌按键不同,可在开机时留意屏幕提示)
- 设置从U盘启动

- 进入Ubuntu安装界面,选择「清除磁盘并安装Ubuntu」
- 设置用户名和密码(记住!后续要用)
- 等待约20分钟安装完成,重启后进入Ubuntu桌面
2.1 安装 Node.js(必须 v18+)
OpenClaw 基于 Node.js 运行,必须先安装。
方式一:安装 nvm(推荐,可以管理多个Node.js版本)
nvm 官网:
https://github.com/nvm-sh/nvm
打开终端(快捷键 Ctrl+Alt+T),逐行执行:
暂时无法在飞书文档外展示此内容
安装完 nvm 后,再安装 Node.js:
暂时无法在飞书文档外展示此内容
方式二:直接安装 Node.js(方式一失败时用这个)
下载地址:https://nodejs.org/

点击主页上的「获取NODE.JS」按钮下载,安装一路点「下一步」即可。
2.2 先注册 AI 模型 API
这一步是必须的,这个openclaw相当于一个中间层,但是,大脑就是模型。所以OpenClaw 需要连接 AI 模型才能工作。在运行安装向导之前,先注册好账号。
首选:阿里云百炼(推荐,40元/月足够)
地址:
https://bailian.console.aliyun.com/

为什么选百炼:
- 相当于是包月的,基础的工作量足够了
- 有免费额度,然后再40元充值可以用很久,每天早上也有7.9元/月的抢购,这就是要拼手速的时候了。
- 支持千问、kimi、glm、Minimax等多种模型,当然,在速度和这些三方的模型的智力上,比原版感觉要差一点。
注册步骤:
- 打开 https://bailian.console.aliyun.com/
- 点击「立即开通」
- 完成阿里云账号注册和实名认证
- 进入控制台,点击「API-KEY管理」,创建一个新的 API-KEY
- 复制保存好 API-KEY(格式类似 sk-xxxxxxxx…)
备选方案:
这两个备选方案,也是coding plan,简单理解就是包月。
KIMI(468元/年)地址:
https://www.kimi.com/code/支持 Kimi K2.5 等国产优质模型

MiniMax Plus(490元/年)地址:
https://platform.minimaxi.com/subscribe/token-plan?code=6FIAdBqSlp&source=link支持 MiniMax 系列模型

三、安装 OpenClaw 主程序
3.1 全局安装
方式一:官方一键脚本(推荐)
一行命令搞定,自动检测并安装所有依赖(Node.js、git等):
暂时无法在飞书文档外展示此内容
这是官方推荐的方式,会自动处理所有环境依赖,不需要提前装 Node.js。
方式二:手动安装 npm
OpenClaw 官网:https://openclaw.ai/
暂时无法在飞书文档外展示此内容
3.2 验证安装
暂时无法在飞书文档外展示此内容
四、运行安装向导
推荐加 –install-daemon 参数,这样重启后会自动启动:
暂时无法在飞书文档外展示此内容
向导会依次出现7个问题,按以下推荐选择:
第一步:Onboarding mode → 选 QuickStart
这是最关键的选项。QuickStart 会用默认配置跳过复杂选项,最适合新手。
完整7步选择:
|
步骤 |
选项 |
推荐选择 |
缘由 |
|
1 |
Onboarding mode |
QuickStart |
默认配置最省事,第一步必须选这个 |
|
2 |
Model provider |
按你购买的来选模型 |
就是刚才买的那个模型的KEY |
|
3 |
Default model |
Keep current |
后续配置文件指定 |
|
4 |
Channels |
先不选,之后直接用飞书 |
飞书的工具比较完整 |
|
5 |
Configure skills |
No |
先跑通基础功能 |
|
6 |
Enable hooks |
全选(打全部勾) |
session-memory可自动保存上下文 |
|
7 |
Install Gateway service |
Yes |
开机自启 |

⚠️ 注意:如果向导第一步问的是 “I understand this is a powerful tool…”,直接输入 Yes 同意即可,然后才会出现上面的选项菜单。
向导完成后提示 Onboarding complete,自动完成:
- 生成 ~/.openclaw/openclaw.json
- 注册 systemd 服务 openclaw-gateway.service
完成之后会出现这个画面,就能看到这个画面了,说明openclaw已经有了新家了
五、飞书接入
这一步才是真正的能感觉到openclaw的魅力的地方,在国内的话,把飞书用起来。飞书是OpenClaw在国内最重大的接入渠道,可以直接在飞书里和AI对话、管理机器人。
5.1 创建飞书应用
- 打开飞书开放平台:https://open.feishu.cn/app

- 点击右上角「创建企业自建应用」
- 填写应用名称(例如「我的AI助手」)和描述
- 点击创建
5.2 获取 AppID 和 AppSecret
- 进入应用详情页
- 点击「凭证与基础信息」
- 找到 AppID(格式:cli_xxxxxxxx)和 AppSecret

- 复制保存好
5.3 配置权限(这一步最关键!)
在「权限管理」页面,开通以下权限:
消息相关:
- im:message(读取和发送消息)
- im:message:receive_v1(接收消息)
群管理相关:
- im:chat(获取群信息)
文档相关:
- docx:document:readonly(读取飞书文档)
- docx:document:rw(读写飞书文档)
云空间相关:
- drive:drive:readonly(读取云空间文件)
多维表格相关:
- bitable:app:readonly(读取多维表格)
也可以直接复制以下JSON导入一次性开通所有权限:
暂时无法在飞书文档外展示此内容
我的经验是,直接把消息相关的权限全部开了,省得之后还要再开。不过目前最新版的飞书插件已经可以自动在聊天中给到授权。

这一步,我们就直接在openclaw tui中,直接告知大模型,帮我们配置飞书,然后把上面的appID和AppSecret发给它,我们就等着就可以了。消息发完之后,再做一个长连接订阅,然后发布应用,基本上飞书就可以用了。
5.4 配置长连接订阅(必须做!)
回到
https://open.feishu.cn/app,找到刚刚创建的机器人,要打开飞书的交互功能(按钮、卡片等)依赖长连接,默认配置是不够的:

- 在飞书开放平台,点击你的应用
- 进入「事件与回调」
- 找到「回调配置」
- 订阅方式选择「长链接」
- 点击「添加事件」,搜索「卡片回传交互」(card.action.trigger)
- 点击保存
5.5 开启机器人能力
- 在应用页面,点击「应用功能」→「机器人」
- 点击「开启」
- 在「机器人配置」里,确认机器人的名称和描述,这个名称可以写一个自己喜爱的。
5.6 发布应用
- 在飞书开放平台,点击「版本管理与发布」
- 点击「创建版本」
- 填写版本号(填 1.0.1)
- 点击「保存」→「申请发布」
- 如果是企业内部应用,直接点击「线上」生效,无需等待审核

5.7 测试飞书连接
在飞书里找到你的机器人,点进去发一条消息(例如「你好」),如果机器人回复了,说明接入成功。
5.8 飞书接入问题排查
如果机器人没有响应,用这个命令诊断:
暂时无法在飞书文档外展示此内容
这个命令会检查:
- AppID 和 AppSecret 是否正确
- API 是否能连通
- 权限是否完整
- 用户授权状态
如果显示权限缺失,会给出一键申请链接。
常见问题:
|
症状 |
缘由 |
解决 |
|
发消息无反应 |
应用未发布 |
在「版本管理与发布」确认状态为「线上」 |
|
点击卡片按钮无反应 |
未开通知事卡片回传权限 |
在「事件与回调」添加长链接和 card.action.trigger |
|
401 报错 |
AppSecret 错误 |
检查配置文件里的 AppSecret 是否正确 |
|
机器人找不到 |
机器人功能未开启 |
确认「应用功能」→「机器人」已开启 |
六、七核心文件配置
上面这些做完之后,我们需要给每个机器人配置一个工作区,相当于它自己的小卧室。每个 Agent 的 workspace 里必须有这 7 个文件。
文件路径:~/.openclaw/workspace/<agent-name>/
|
文件 |
作用 |
|
IDENTITY.md |
Agent 身份定义(名字、角色、一句话定位) |
|
SOUL.md |
性格内核 + 行为准则(使命、禁忌、工作模式) |
|
USER.md |
用户信息(偏好、忌讳、目标) |
|
AGENTS.md |
多 Agent 协作规范(@规则、分工、触发规则) |
|
MEMORY.md |
长期记忆(生效规则、分工表、SOP) |
|
HEARTBEAT.md |
定期检查任务清单(心跳监控、健康检查) |
|
TOOLS.md |
工具配置(API路径、脚本位置) |
IDENTITY.md 示例框架
暂时无法在飞书文档外展示此内容
USER.md 必填项
暂时无法在飞书文档外展示此内容
SOUL.md 必填项
暂时无法在飞书文档外展示此内容
这几个可以直接使用www.kimi.com的网页来去完成,你要告知它你是谁,你想让它做什么,最后帮我生成openclaw的工作区的灵魂相关的内容。然后复制,发到飞书中就可以了。
七、三层记忆架构
上面的讲完之后,基本上基础的内容就已经完成了,Openclaw已经可以正常在运行了。但是,我强烈提议把这个记忆方法用上。由于Openclaw会忘记上下文,也就是之前聊的事情。所以,我们来使用三层记忆法可以比较好的解决这件事。这是 OpenClaw 最重大的设计,决定 AI 长期记忆的质量。
|
层级 |
文件 |
作用 |
限制 |
|
热记忆 |
MEMORY.md |
长期记忆,出厂设置 |
≤150行 |
|
日志 |
memory/YYYY-MM-DD.md |
每日工作流水账 |
≤500行 |
|
冷记忆 |
memory/archive/YYYY-MM.md |
月度归档,经验图书馆 |
无限制 |
⚠️ 最重大规则:写入已有文件永远用 edit 追加,绝对不要用 write(会覆盖文件)。一次覆盖可能丢失一个月记录。
MEMORY.md 写入规范
可以写入:核心规则、当前分工表、SOP、关键参数
禁止写入:项目具体细节、一次性任务、过时经验
简单来说,把上面的这个复制到飞书,发送出去,让模型帮你来配置。但完这个,还需要告知它”帮我每天8点,12点,22点根据这个文件的方法,开始整理。”
八、必装核心 Skills
Skills 就相当于 OpenClaw 的插件包,装上之后 AI 能干更多的事情。但不是装得越多越好,有些技能装多了反而让 AI 分心。
有一个原则:让 AI 学会安装自己。每次遇到新任务,先问 AI「这个任务需要装什么 Skill」,然后让它自己从 clawhub 搜索安装。这样既安全又有针对性。
下面这几个是我实测下来最常用的,按需安装:
context7(必须装!)
这个是第一个要装的。
装上之后,AI 会自动去 GitHub 拉取最新文档,不再瞎编。列如你问它「OpenClaw 怎么配置定时任务」,AI 会直接去读官方文档给你正确答案,而不是自己编一个。
安装方法:直接告知机器人
暂时无法在飞书文档外展示此内容
或者在终端执行:
暂时无法在飞书文档外展示此内容
飞书系列(如果你用飞书)
飞书日历——管日程、约会议
飞书多维表格——管数据库、自动化表格
安装方法:直接告知机器人
暂时无法在飞书文档外展示此内容
暂时无法在飞书文档外展示此内容
搜索增强(强烈推荐)
如果你需要 AI 帮你查资料、搜新闻,装这个能大幅提升搜索质量。
安装方法:
暂时无法在飞书文档外展示此内容
(需要先去 https://tavily.com 注册获取 API Key,免费额度够用)
安全审核(提议都装)
在安装任何第三方 Skill 之前,让 AI 先过一遍这个审核工具,能避免踩坑。
安装方法:
暂时无法在飞书文档外展示此内容
如果你是程序员,可以让 AI 帮你装编程相关的 Skill。如果你是运营,可以让 AI 装内容发布、数据分析相关的 Skill。每次遇到新场景,问 AI「这个场景需要装什么 Skill」,让它推荐。
查找和安装 Skill
Skill 的应用商店:https://clawhub.ai
打开这个网站,搜索你想要的 Skill,找到之后把名字告知 AI,让它帮你安装。
如果遇到了网速的问题,实则可以试一下
https://skillhub.tencent.com/,这个是腾讯把https://clawhub.ai做了本地化,下载和安装都超级的顺畅。
九、定时任务自动化
装完之后,提议立刻配好定时任务。这样 AI 会自动帮你做记忆归档,不用每天手动操心。
最核心的一个用法:每天定时整理记忆。
直接告知机器人:
暂时无法在飞书文档外展示此内容
它会自动配置好 cron 任务,每天这几个时间点自动把当天的笔记整理归档到记忆文件里。
其他常用的定时任务:
暂时无法在飞书文档外展示此内容
定时任务设好之后,就不用每天盯着了,AI 会自动执行。
十,多 Agent 怎么配合工作
这是 OpenClaw 最有意思的地方。
一个人用 AI,是单兵作战。多个 AI 一起配合,是军团作战。
从一个开始,跑通再加
不要一开始就想搞 11 个机器人。从一个开始,让它跑通你的工作流,再加第二个。一个跑通的 Agent,胜过三个跑不通的。
怎么加?直接告知主机器人:
暂时无法在飞书文档外展示此内容
它会自动创建、配置好、分工明确。
多 Agent 的实际分工举例
真实有人这么干过,分成 4 个 Agent:
- 协调者(黄牛1号):接需求、分任务、盯结果,群消息总入口
- 技术顾问:写代码、搞数据、造工具,脏活累活
- 创意伙伴:写文案,做内容,调语气
- 智库:审稿、质疑、把关,负责说”这里不对”
也有人这么分:
- 选题机器人:每天抓热点、整理选题库,抓完了丢给下一个
- 写作机器人:收选题,写初稿,排版
- 审核机器人:看完稿子,挑毛病,提意见
- 配图机器人:生成封面图、文中配图
还见过更高级的玩法:
- 马斯克 Agent→执行推动,打破惯性
- 乔布斯 Agent→产品体验,把东西做到极致简洁
- 德鲁克 Agent→管理业务,盯流程
- 芒格 Agent→多维决策,帮忙想反面意见
每个 Agent 专注自己那一块,通过飞书群协同,最终把事情交差。
多 Agent 的两种协作方式
方式一:主 Agent 派任务(sessions_spawn)
主 Agent 把任务拆分,丢给子 Agent 去执行,完成后结果汇总回来。适合临时性的任务。
暂时无法在飞书文档外展示此内容
方式二:独立 Agent 直聊(sessions_send)
两个 Agent 直接在群里对话协作。适合长期配合的工作流。
多 Agent 的核心原则
记住一个血的教训:协同办公的 Token 消耗是独立 Agent 的数倍甚至十几倍。新手提议先独立干活,把流程跑通了再开协同。不然 AI 的成本会涨得很快。
另一个原则:每个 Agent 的 SOUL.md 要写清楚职责边界。不然 A Agent 会抢 B Agent 的活,两个都在做同一件事,其他事没人管。
十一,我目前每天怎么用
装好跑通之后,用起来实则很简单。
早上:打开飞书,找到我的机器人,问它「今天有什么要做的?」它会结合记忆告知我今天的计划,有什么待办事项。
工作中:随时丢任务给它。
举一些真实有人在用的场景:
内容创作
- 帮我写一篇关于XX的文章
- 搜集一下今天XX行业的热点,发给我
- 把这篇文章的标题改5个版本
信息收集
- 帮我查一下XX的竞品最近有什么动静
- 做一个XX的调研报告,整理成文档
- 每天早上9点给我推送今日资讯
运营自动化
- 帮我监控XX网站,有变化就通知我
- 生成下周的工作计划表
- 每周一早上生成上周工作周报
日程管理
- 明天下午3点提醒我开会
- 帮我约一下XX时间,找他开个短会
- 检查一下我这周日程,有什么冲突
文件处理
- 帮我把这些图片按日期分类重命名
- 把这个CSV数据分析一下,生成图表
- 整理一下这个文件夹,把重复文件找出来
语音指令
- 飞书里直接发语音,AI帮你转文字,理解、执行
- 做饭时说”5点提醒我发报告”,AI自动建提醒
发票管理
- 丢一张发票PDF给AI,自动解析日期/金额/税率,录入飞书多维表格
- 再也不用手动填报销单了
公众号运营(进阶玩法)
- 丢一个抖音视频链接给它,自动下载视频、提取音频、分析内容
- 一键生成公众号文章,保存在飞书文档
- 配图自动截取视频画面+AI生图
数字人视频(进阶玩法)
- 丢一张照片+一段语音,克隆形象和声音
- 让AI搜集今日新闻,用数字人播报出来
- 发到抖音/B站做内容
大部分时候,你只需要一部手机,打开飞书,说一句话,AI 就帮你干完了。
记住一个心态:你是老板,AI 是员工。你负责拍板,它负责执行。不要被 AI 牵着走。:你是老板,AI 是员工。你负责拍板,它负责执行。不要被 AI 牵着走。
十二,这些坑我真踩过
说几个真实的教训,都是花了钱和时间换来的。
教训一:改配置改错了,实例崩溃了 36 次
有一次让 AI 帮我加一个 AI 模型代理商,它把配置写错了位置——结果配置校验失败,实例疯狂重启了一整夜,重启了 36 次。
后来学乖了:改配置前先让 AI 读官方文档确认字段层级,不要让它凭感觉写。只有一个实例时改错了只能去终端手动修。
教训二:AI 死循环重试,一晚上烧了上百块
AI 遇到程序报错,会一直重试,一直调用 API,一直烧钱。有人的 AI 一晚上重试了十几个小时,账单出来人都傻了。
在 SOUL.md 里写清楚:连续报错 3 次就停下来,等我。不要让 AI 自己决定无限重试。
教训三:AI 瞎编文档内容
AI 训练有截止日期,它不知道你用的库上周刚更新了什么,常常凭”过期记忆”回答,API 调用方式都错了。
装 context7 能解决这个问题。装上之后,AI 会直接去 GitHub 拉最新文档再回答,而不是自己编。这个必定要装。
教训四:写了三个月的 MEMORY,全被覆盖了
有一次用 write 命令写文件,结果文件内容被完全覆盖了,三个月的记忆全没了。
记住:永远用 edit 追加,不要用 write(覆盖)。一次覆盖可能丢失一个月记录。
教训五:协同办公 Token 消耗比独立 Agent 贵十几倍
开了多 Agent 协同之后,Token 消耗哗哗往上涨。协同需要持续同步上下文,比独立 Agent 贵许多。
新手先独立干活,确认需要长期协同了再开。
教训六:不要给 AI 开邮箱权限
邮箱是巨大的安全攻击向量。如果 AI 能读你的邮件,恶意内容可能通过邮件注入 Prompt,让 AI 做不该做的事。
教训七:不要让 AI 有自己的小红书账号
小红书正在严打机器人 API 使用。就算通过第三方工具发帖,也可能被封号。这个坑已经有人踩过了。
教训八:WSL 安装方式才是正确的
如果你用的是 Windows 系统,不要直接装在 Windows 上,而是要用 WSL(Linux 子系统)的方式安装。具体步骤是:PowerShell 管理员模式运行 wsl –install,然后装 Ubuntu,用 Linux 子系统里的命令来安装 OpenClaw。
教训九:OpenClaw 的权限极高,不要在主力电脑上部署
切记!!!!!它能直接管理文件、运行终端命令,一旦出错可能造成不可逆的数据损失。用专门的闲置设备或云服务器来跑。
安装 OpenClaw 的核心就三步:
- 装好 Node.js 环境(用 nvm 安装)
- 跑 openclaw onboard –install-daemon,选 QuickStart
- 配置模型 API Key + 接入飞书
装完之后,配好三层记忆和定时任务,这就是你的AI军团的起点。
记住几个关键原则:
- 配置文件用 openclaw config 修改,比手动编辑更安全
- 写入文件用 edit 追加,不用 write 覆盖
- 飞书接入必须配置长链接订阅,否则卡片按钮无效
- Gateway 不暴露到公网
- 让 AI 帮你干活,你负责拍板
- 从一个 Agent 开始,跑通了再加
有什么问题,欢迎来找我。
一个人踩坑,一个人总结,一个人分享。我是仲哥,这是我的AI实战记录。