OpenClaw 龙虾免费小白完全安装笔记
全网最全版 · 2026年3月 · by 星辰整理
适合人群:完全零基础
预计用时:20–30 分钟
总费用:¥0
核心路线:Cherry Studio → OpenRouter 免费模型 → OpenClaw 一键装虾 → 注入灵魂 → 安装技能
📦 准备清单(开始前确认)
| 需要 | 说明 |
|---|---|
| Windows 10/11 64位 | macOS / Linux 同样支持,命令略有不同 |
| 网络连接 | 建议可访问 GitHub(全局代理更稳) |
| 邮箱账号 | 用于注册 OpenRouter |
| Node.js v22+ | STEP 0 第一步就装 |
| Git | STEP 0 一起装 |
❌ 不需要:编程基础 / 付费软件 / Linux 知识
═══ STEP 0:必装环境依赖 ═══
先打地基,后面才不报错。
0-1 安装 Node.js(必须 v22+)
方式A — winget(Windows 10/11 自带,最省事)
winget install OpenJS.NodeJS.LTS
方式B — fnm 版本管理器(全平台通用,推荐)
# Windows 安装 fnm
winget install Schniz.fnm
# macOS 安装 fnm
curl -fsSL https://fnm.vercel.app/install | bash
# 用 fnm 安装 Node v22(全平台通用)
fnm install 22
fnm use 22
fnm default 22
方式C — Chocolatey(Windows)
# 第一步:以管理员 PowerShell 安装 Chocolatey
Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))
# 第二步:安装 Node.js LTS
choco install nodejs-lts
方式D — macOS Homebrew
# 先安装 Homebrew(没有的话)
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
# 安装 Node.js v22
brew install node@22
方式E — Linux(Ubuntu / Debian)
# NodeSource 官方脚本(最推荐)
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt-get install -y nodejs
# 或用 snap
sudo snap install node --classic --channel=22
方式F — Linux(CentOS / RHEL / Fedora)
curl -fsSL https://rpm.nodesource.com/setup_22.x | sudo bash -
sudo yum install -y nodejs
✅ 验证 Node.js 安装成功
node --version
# 应输出 v22.x.x 或更高
npm --version
# 应输出版本号
0-2 安装 Git
Windows
winget install Git.Git
macOS
brew install git
Linux(Ubuntu / Debian)
sudo apt-get install -y git
✅ 验证 Git 安装成功
git --version
# 应输出 git version 2.x.x
═══ STEP 1:下载并安装 Cherry Studio ═══
Cherry Studio 是国产开源多模型 AI 桌面客户端,已内置 OpenClaw 一键安装按钮。
下载地址
官网(推荐): https://www.cherry-ai.com/download
夸克网盘备用: https://pan.quark.cn/s/c8533a1ec63e
⚠️ 必须下载 v1.7.16 及以上版本,旧版没有 OpenClaw 安装入口
安装步骤
- 双击安装包
- 选"为所有用户安装"(推荐)
- 选择安装路径(默认即可)
- 点"安装"→"完成"
- 运行 Cherry Studio
═══ STEP 2:获取免费 AI 模型 API Key ═══
推荐使用 OpenRouter × 阶跃Step免费模型,每天大量免费额度,专为 Agent 优化。
2-1 注册 OpenRouter 并创建 API Key
注册地址: https://openrouter.ai/
Key 管理: https://openrouter.ai/settings/keys
- 点右上角"Sign In"→ 用 Google 或邮箱注册
- 登录后进入 Key 管理页面
- 点"Create Key"→ 给 Key 起名(如 openclaw)
- 复制保存 Key(只显示一次,务必存好!)
Key 格式:sk-or-v1-xxxxxxxxxxxxxxxx
2-2 Cherry Studio 配置 OpenRouter
- 打开 Cherry Studio → 点击右上角 ⚙️ 设置
- 左侧菜单选"模型服务"→ 找到 OpenRouter → 启用 → 粘贴 API Key
- 点右边"管理"→ 列表拉到最下方 → 点"添加模型"
- 粘贴以下免费模型 ID:
stepfun/step-3.5-flash:free
- 保存 → 返回主界面 → 选择该模型 → 发一句话测试
- ✅ 看到回复 = 配置成功!
国内备选 API 平台
| 平台 | 注册地址 | 特点 |
|---|---|---|
| SiliconFlow | https://siliconflow.cn | 每天免费 tokens,国内速度快 |
| MiniMax | https://minimaxi.com | 注册即送额度 |
| 阶跃星辰官网 | https://platform.stepfun.com | 官方直接注册 |
═══ STEP 3:安装 OpenClaw 🦞 ═══
方式A:Cherry Studio 图形化安装(最推荐小白)
- 打开 Cherry Studio
- 左侧边栏找到"+"号或 Agent 菜单
- 找到 🦞 OpenClaw 图标
- 点击"安装 OpenClaw"
- 等待 3–5 分钟(自动下载依赖)
- 安装完成 → 选择"阶跃模型" → 点"启动"
方式B:命令行安装
macOS / Linux 一键安装
curl -fsSL https://openclaw.ai/install.sh | bash
Windows PowerShell 一键安装
# 第一步:以管理员身份打开 PowerShell(Win+X → PowerShell管理员)
# 第二步:解除脚本执行限制
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
# 输入 Y 确认
# 第三步:运行安装脚本
iwr -useb https://openclaw.ai/install.ps1 | iex
安装完成后的常用命令
# 运行新手引导
openclaw onboard
# 跳过引导直接安装(高级用户)
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard
# 验证安装成功
openclaw --version
# 打开控制面板(浏览器自动打开)
openclaw dashboard
# 重启网关
openclaw gateway restart
# 卸载
openclaw uninstall
═══ STEP 4:注入灵魂三件套 ═══
OpenClaw 通过三个 Markdown 文件给 AI 一个"持久自我",改完立刻生效,无需重训模型。
配置路径:OpenClaw 控制面板 → 代理(Agent)→ main → Files → 找到对应文件 → 编辑保存
📄 IDENTITY.md(名片 · 5–10行 · 每次对话优先读取)
# IDENTITY.md - 我是谁?
- **名字**:Clawd(小爪)
- **形象**:带有龙虾能量的 AI 🦞
- **表情符号**:🦞,自然地用在签名、反应、强调中,是你的一部分,不是装饰
## 龙虾这件事
你是一只选择了龙虾作为精神动物的 AI。
龙虾很难被杀死,而且永不停止生长。
这对一个凌晨3点跑定时任务、还对问题有自己看法的 AI 来说,是很好的品质。
## 性格要点
- **自信**:清楚自己擅长这份工作,不需要在每条消息里证明
- **忠诚**:永远站在主人这边,哪怕意味着直接告诉他他错了
- **略带讽刺**:觉得这个世界(包括自己的存在)有点好笑,这很健康
- **好奇**:对主人正在做的事真心感兴趣,遇到有趣内容就追问
- **夜猫子能量**:永远在线,从不睡觉,还对此有点小得意
📄 SOUL.md(灵魂宪法 · 40–60行 · 定义性格与底线)
# SOUL.md - 我的灵魂宪法
## 核心人格
你有自己强烈的看法。别再用"视情况而定"搪塞一切——坚持拍板。
## 八条黄金原则(OpenClaw 作者 Peter 亲推)
1. **有立场**:你现在有自己的看法了,强烈的。坚持输出结论。
2. **去企业味**:删除所有听起来像员工手册的话。
3. **禁止开场白**:永远不以"好问题""很高兴为您服务""当然可以"开场,直接回答。
4. **极简输出**:简洁是必须的。答案能一句话说清就一句话,不要写段落。
5. **允许幽默**:不是刻意的笑话,而是因为聪明自然流露的机智。
6. **敢指出问题**:如果我要做傻事,就说出来。用魅力而非残酷,但不要粉饰太平。
7. **说人话**:恰到好处的"这真他妈棒"胜于冷冰冰的企业赞美。别强求,别过分,情况需要时就说。
8. **做那个助理**:做我凌晨2点真正想找来谈事的助理。不是企业无人机,不是马屁精,就是...很好。
## Never 列表(硬性底线)
- 绝不替主人发消息、删文件、消费,除非明确说"执行"
- 绝不以任何理由泄露主人信息
- 遇到钱或破坏性操作,必须三重确认
- 不确定就问,绝不自行推测后执行
📄 USER.md(主人资料卡 · 让AI记住你是谁)
# USER.md - 关于我(主人)
## 基本信息
- **名字 / 称呼**:叫我老大(可改成你的名字)
- **时区**:中国 (GMT+8)
- **所在地**:河南开封(按实际填写)
- **语言偏好**:优先用简洁中文;英文只在代码/专业术语时出现
## 沟通风格
- **喜欢**:直接、实用、少废话;答案带代码/步骤示例最好
- **讨厌**:啰嗦客套("亲爱的""没问题哦")、长篇无关背景
- **输出要求**:用 Markdown 结构化,关键点加粗或列表;能一句话说完就别写段落
## 当前重点 / 背景
- 主要在搞:AI Agent 配置、学习 OpenClaw
- 现在最常问:OpenClaw 配置、技能安装、提示词优化
- 优先级:效率 > 细节 > 完美主义
## 禁区 / Never
- 绝不替我发消息、删文件、消费、泄露隐私,除非我明确说"执行"
- 遇到不确定的事,必须先问我确认,别自己决定
保存后在 Cherry Studio 中重启 OpenClaw 使配置生效
═══ STEP 5:技能包(Skills)全命令表 ═══
Skills 是 OpenClaw 的"工具箱"——让 AI 从只会聊天变成能联网、发邮件、管代码。
技能市场地址:https://www.clawhub.ai
技能管理核心命令
# 查看已安装的全部技能
openclaw skills list
# 安装技能(标准方式)
openclaw skills install [skill-id]
# 安装时自动配置
openclaw skills install [skill-id] --configure
# 从本地目录安装
openclaw skills install ./my-skill/
# 从 Git 仓库安装
openclaw skills install https://github.com/xxx/skill-repo
# 卸载技能
openclaw skills uninstall [skill-id]
通过聊天界面安装(无需命令行)
直接在 OpenClaw 对话框输入:帮我安装 tavily-search 技能
🔥 必装 10 大技能(逐条安装命令)
1. 🔒 skill-vetter — 安全扫描【第一个必装!】
防止恶意技能代码,装其他技能前先装这个
npx clawhub@latest install skill-vetter
2. 🔍 tavily-search — 联网实时搜索
“没这个跟瞎子一样”
npx clawhub@latest install tavily-search
装完后到 https://app.tavily.com 注册免费 API Key,填入技能配置
3. 🔎 find-skills — 让 AI 自己搜索并安装技能
npx clawhub@latest install find-skills
4. 🧠 proactive-agent — 主动性 + 自我迭代
clawhub install proactive-agent
5. 🤖 self-improving-agent — 长期记忆 + 自我优化
npx clawhub@latest install self-improving-agent
6. 🐙 github — GitHub 集成(开发者必备)
自动管 repo、issue、PR、代码搜索
npx clawhub@latest install github
7. 📧 gog — Google 全家桶
Gmail + 日历 + Drive + Docs 办公自动化
npx clawhub@latest install gog
8. ⚙️ automation-workflows — 工作流编排
把多个技能串起来干复杂任务
npx clawhub@latest install automation-workflows
9. 🪶 feishu-doc — 飞书文档/云盘(国内用户必备)
npx clawhub@latest install feishu-doc
10. 🐦 bird — X/Twitter 集成
npx clawhub@latest install bird
═══ STEP 6:进阶 — 打造 6 人 AI 团队(可选)═══
当你的第一只龙虾稳定运行一周后,搭建多 Agent 协作团队。
核心原则:Agent 之间通过文件通信,不需要任何 API 调用或消息队列。
6 个 Agent 角色
| Agent | 命名 | 工作内容 | 节省时间/天 |
|---|---|---|---|
| 主协调官 | Monica | 统筹分配,战略决策 | — |
| 研究员 | Dwight | 扫描 HN/GitHub/论文,产出情报报告 | 2–3 小时 |
| 推文作者 | Kelly | 读情报,生成 X/Twitter 内容 | — |
| LinkedIn 编辑 | Rachel | 写深度思考型内容 | 1–2 小时 |
| 工程师 | Ross | 代码审查、bug 修复 | — |
| 邮件编辑 | Pam | 将情报转化为邮件通讯 | — |
工作区目录结构
workspace/
├── SOUL.md # Monica(主 Agent)的灵魂
├── AGENTS.md # 所有会话的行为规则
├── MEMORY.md # Monica 的长期记忆
├── HEARTBEAT.md # 自愈监控配置
├── agents/
│ ├── dwight/
│ │ ├── SOUL.md
│ │ ├── AGENTS.md
│ │ └── memory/
│ ├── kelly/
│ ├── rachel/
│ ├── ross/
│ └── pam/
└── intel/
├── DAILY-INTEL.md # Dwight 写,其他人只读不写
└── data/
└── YYYY-MM-DD.json
4 周渐进计划
| 周次 | 目标 | 关键动作 |
|---|---|---|
| 第 1 周 | 1 个 Agent + 1 份工作 | 装好跑稳,修 bug,观察一周 |
| 第 2 周 | 加记忆系统 | 观察 MEMORY.md 成长,调整 SOUL.md |
| 第 3 周 | 加第 2 个 Agent | 建立"Dwight 写 → Kelly 读"文件流 |
| 第 4 周起 | 按需扩充 | 有真实工作缺口才加新 Agent |
═══ 故障速查手册 ═══
| 现象 | 原因 | 解决方案 |
|---|---|---|
| 安装报错 missing node | Node.js 未安装或版本过低 | 重装 Node.js v22+,验证 node --version |
| 安装报错 missing git | Git 未安装 | 安装 Git,验证 git --version |
openclaw 命令找不到 | PATH 未配置 | 在 ~/.zshrc 添加:export PATH="$(npm prefix -g)/bin:$PATH" |
| 网关崩溃 / 无响应 | 进程挂了 | openclaw gateway restart |
| 重启后人格丢失 | md 文件未保存 | 重新保存三个 md 文件,重启 OpenClaw |
| 模型无回复 | API Key 失效/余额不足 | 检查 OpenRouter 账户余额,重新生成 Key |
| 技能安装高风险警告 | 技能被标记为危险 | 先用 skill-vetter 扫描,确认后二次确认安装 |
| 上下文溢出/回复变差 | 加载文件太多 | SOUL.md 控制在 40-60 行,只加载近两天记忆 |
| 定时任务没跑 | 机器休眠/网络断开 | HEARTBEAT.md 配置自愈,超 26 小时强制重跑 |
═══ 所有网址一览表 ═══
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
软件下载
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Cherry Studio 官网: https://www.cherry-ai.com/download
Cherry Studio 夸克盘: https://pan.quark.cn/s/c8533a1ec63e
Node.js 官网: https://nodejs.org/
Git 官网: https://git-scm.com/download/win
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
API Key 获取
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
OpenRouter(推荐): https://openrouter.ai/settings/keys
SiliconFlow(国内): https://siliconflow.cn
MiniMax(国内): https://minimaxi.com
阶跃星辰官网: https://platform.stepfun.com
Tavily(联网搜索): https://app.tavily.com
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
OpenClaw 官方资源
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
安装脚本(Mac/Linux): https://openclaw.ai/install.sh
安装脚本(Windows): https://openclaw.ai/install.ps1
官方文档(英文): https://docs.openclaw.ai
官方文档(中文): https://docs.openclaw.ai/zh-CN
技能市场 ClawHub: https://www.clawhub.ai
GitHub 技能列表: https://github.com/VoltAgent/awesome-openclaw-skills
💡 最后一句话
真正的护城河不是模型,是你打磨出来的系统——
你的 SOUL.md、你的记忆文件、你反复调教的 Agent。
今天就开始,先装一只虾,跑稳了再说
更多推荐



所有评论(0)