你会看到一个类似 Linux 终端的窗口，显示类似 user@你的电脑名:~$ 的提示符。

怎么在 WSL 终端里粘贴命令？ 在网页上复制命令后，在 WSL 终端窗口里右键点击就是粘贴。或者用 Ctrl + Shift + V（注意：是 Ctrl + Shift + V，不是 Ctrl + V）。

Windows 第四步：安装 Node.js

在 WSL 终端里依次输入下面的命令（一行一行来，每行输入后按回车等它执行完再输入下一行）：

第一行：更新系统软件包列表

sudo apt update 

如果要求输入密码，输入你刚才设置的 WSL 密码，按回车。

第二行：安装 Node.js 版本管理工具

curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash - 

第三行：安装 Node.js

sudo apt install -y nodejs 

第四行：验证安装

node --version 

看到 v22.x.x 或更高版本号就说明成功了。

Windows 第五步：一键安装 OpenClaw

在 WSL 终端里复制粘贴下面这行命令，按回车：

curl -fsSL https://openclaw.ai/install.sh | bash 

整个过程大概 2-5 分钟，等它跑完就行，中间不要关掉窗口。

安装完成后，它会自动进入配置向导。→ 继续看下面的「配置向导」部分。

⚙️ 配置向导（Mac 和 Windows 通用）

安装完成后，会自动进入一个交互式的配置向导。它会一步一步问你问题，你按提示选择就好。

如果安装后没有自动进入配置向导，手动输入这个命令启动：
openclaw onboard --install-daemon
 （--install-daemon 会让 OpenClaw 注册为系统服务，开机自动启动）

第一步：安全提醒

第一个画面会提醒你 OpenClaw 是实验性软件，会访问你的文件和网络，问你是否了解风险。

操作： 用键盘左箭头 ← 选择 Yes，按回车继续。

关于安全： OpenClaw 会读取你电脑上的文件来帮你干活，这也意味着它能看到你的私人文件。建议不要在存有敏感文件（银行信息、密码文档等）的电脑上使用，或者在使用时注意限制它的访问范围。

第二步：选择安装模式

会问你要 QuickStart（快速开始）还是自定义安装。

操作： 选 QuickStart，按回车。

选 QuickStart 就对了，它会帮你设置好最基本的东西。等你熟悉了以后，随时可以用 openclaw onboard 重新配置。

第三步：选择 AI 模型提供商（重要！）

这一步是选"AI 的大脑"用谁家的。会列出几个选项，用键盘上下箭头选择，按回车确认。

省钱建议：
 - 如果你只是想试试看 → 选 MiniMax 或 Kim/Zhipu，注册就有免费额度
 - 如果你在国内，网络不方便 → 选 他们就行，国内直连，不需要梯子
 - 如果你电脑配置好（至少 32GB 内存）→ 可以试试 Ollama，完全免费，但需要另外安装 Ollama 软件
 - 如果你追求最好的效果 → 选 Anthropic（Claude）但是要用API

第四步：连接 AI 模型（两种方式）

选完提供商后，你需要让 OpenClaw 连接上 AI 服务。有两种方式：

方式一：API Key（推荐，更稳定）

API Key 是一串类似密码的文字，用来连接 AI 服务。

以 Anthropic（Claude）为例，获取 API Key 的步骤：

1打开浏览器，访问 https://console.anthropic.com/

2注册一个账号（需要邮箱）

3登录后，点击左侧菜单的 API Keys

4点击 Create Key（创建密钥）

5给密钥取个名字（随便写，比如 openclaw），点创建

6复制生成的那串密钥

⚠️ 这串密钥只会显示一次！ 一定要复制好保存下来。如果忘了复制，就需要删掉重新创建一个。

其他提供商获取 API Key 的地方：

提供商	注册地址	备注
OpenAI	https://platform.openai.com/api-keys	需要绑定信用卡
Google Gemini	https://aistudio.google.com/apikey	有免费额度
MiniMax	https://platform.minimaxi.com/	注册送 ¥15 额度
DeepSeek	https://platform.deepseek.com/api_keys	注册送额度，国内直连
KIMI（月之暗面）	https://platform.moonshot.cn/console/api-keys	注册送 ¥15 额度

提醒： 第三方服务商可能更便宜，可以多问问，或者问问小互！嘿嘿

方式二：OAuth 授权登录（更方便，但有风险）

如果你已经有 ChatGPT Plus 或 Claude Pro 的付费订阅账号，OpenClaw 支持直接用你的订阅账号登录，不需要单独购买 API。

操作方法： 在配置向导中选择对应的 OAuth 选项，它会自动打开浏览器让你登录你的账号，授权完成后自动连接。

⚠️ 重要警告：OAuth 方式有封号风险！

2026 年 2 月，有多位用户报告使用 Claude Pro/Max 和 Google 的 OAuth 账户接入 OpenClaw 后账号被封禁。PCWorld、SecurityWeek 等多家媒体都报道了这个问题。

建议： 用独立的 API Key，不要用你的个人付费订阅账户的 OAuth 登录。如果你一定要用 OAuth，建议用一个不重要的账号。

第五步：选择默认模型

会让你选具体用哪个模型。屏幕上会列出该提供商的可用模型。

推荐选择：

提供商	推荐模型	理由
Anthropic	Claude Sonnet 4.5	性价比最高
OpenAI	GPT-4o	速度快、效果好
Google	Gemini 2.0 Flash	快又便宜
MiniMax	M2.1	中文最好
DeepSeek	deepseek-chat	国内直连、便宜
KIMI	kimi-k2.5	中文好、有免费额度

操作： 用键盘上下箭头选好模型，按回车确认。

第六步：配置聊天渠道（可以跳过，后续通过聊天让龙虾帮你）

这一步决定你以后怎么跟 OpenClaw 说话。可以选：

•Telegram：推荐海外用户，设置最简单

•WhatsApp：扫个二维码就行

•飞书：国内用户推荐，但配置稍微复杂一点（需要去飞书开放平台创建应用）

•网页面板：不需要额外配置，装好就能用

操作： 如果你不确定，上下箭头选择，先选 跳过（Skip）。网页面板是默认就有的，不用额外设置。等你玩熟了，随时可以用 openclaw onboard 重新配置。

第七步：技能（Skills）等其他配置

会问你要不要启用一些预装技能（比如网页浏览、文件管理、日程管理等）。

操作： 选 Yes 全部启用。以后用不到的随时可以关掉。也可以选择跳过，后续通过聊天方式安装，我建议是跳过》

回车 空格 然后选择跳过

然后后面的所有都先选 NO

这一步也选跳过，这是设置龙虾个性、记忆和配置的地方，后续我们也通过聊天的方式设置，更方便。

第八步：安装完成！

看到类似 "OpenClaw is ready!" 或者 "Your AI assistant is now running" 的提示，就说明安装配置全部完成了！

它可能会问你是否要打开网页面板（Web UI），选 "Open the web UI" 就会自动在浏览器里打开。

但是我建议选在终端里聊天，因为后续你会慢慢习惯这种操作，会对你有很大好处。

这样我们的安装就完成了。

最后你会看到这样的画面↓

你就可以和它对话了！

---

验证安装成功

装完了，我们来确认一切正常。

检查运行状态

在终端里输入：

openclaw status 

如果看到显示 Running（运行中），就对了。

如果显示没在运行，输入 openclaw gateway start 启动它。

打开网页面板

在终端里输入：

openclaw dashboard 

或者直接在浏览器地址栏输入：

http://127.0.0.1:18789/ 

什么是 127.0.0.1？ 这是一个特殊的网址，表示"你自己的电脑"。因为 OpenClaw 是装在你自己电脑上的，所以通过这个地址访问。18789 是 OpenClaw 使用的端口号。

如果看到 OpenClaw 的网页面板，恭喜你，安装成功！

发一条消息测试

在面板的聊天框里发一条消息试试，比如输入：

你好，介绍一下你自己 

如果收到正常回复，说明 AI 大脑也连接正常！

健康检查（可选）

如果你想更全面地检查有没有问题，输入：

openclaw doctor 

它会自动检查各项配置是否正常，有问题会给出修复建议。

当然这只是安装成功，后续还有很多配置什么的需要做，本教程可能无法写那么详细，我后续会继续写对应的手把手教程，敬请期待。

下面是一些基本的设置配置，技能安装什么的。

你可以看看！

龙虾和GPT最大的不同是，你不会什么都可以让它安装和操作，不只是回答问题。

但是注意任何操作都需要小心谨慎，不然它会乱删东西什么的，你的命令一定要清晰不要太模糊。

当然你也可以选择在云端安装，比如coze里↓

这个春节无疑属于字节 Seedance 2.0 后 豆包 Seed 2.0 也来了 详细评测

回头见！

---

常用命令速查表

装好之后，这几个命令你可能会用到，都是在终端里输入的：

命令	作用	什么时候用
openclaw gateway start	启动 OpenClaw	电脑重启后，OpenClaw 没有自动启动时
openclaw gateway stop	停止 OpenClaw	不用了想关掉时
openclaw gateway restart	重启 OpenClaw	改了配置之后
openclaw status	查看运行状态	想看看它是不是在运行
openclaw dashboard	打开网页面板	想用网页跟它聊天
openclaw doctor	自动检查配置问题	出了问题不知道怎么回事时
openclaw update	更新到最新版本	想体验新功能时
openclaw onboard	重新运行配置向导	想换 AI 模型或重新配置时
openclaw logs	查看运行日志	出了问题想看详细错误信息

小技巧： 如果你在安装时加了 --install-daemon，OpenClaw 会在开机时自动启动，你不需要每次手动输入 openclaw gateway start。

如果没有，下次打开终端，输入：openclaw tui 即可

---

常见问题排查

❓ 输入 openclaw 后提示 "command not found"

原因： 终端找不到 OpenClaw 程序，通常是环境变量没配好。

解决办法：

1先试试关掉终端，重新打开，再输入 openclaw status

2如果还是不行，可能是 npm 全局路径没配好。输入以下命令：
npm config get prefix
    看看输出的路径是什么。然后把那个路径加到你的 PATH 里：
echo 'export PATH=$(npm config get prefix)/bin:$PATH' >> ~/.zshrc    source ~/.zshrc

3如果以上都不行，重新运行一次安装命令

❓ 网页面板打不开

1先确认 OpenClaw 在运行：openclaw status

2如果没在运行：openclaw gateway start

3再试一次访问 http://127.0.0.1:18789/

4如果端口被其他程序占用了，可以换一个端口：
openclaw gateway --port 18790
    然后访问 http://127.0.0.1:18790/

❓ AI 不回复消息

1检查 API Key 是否正确： 运行 openclaw doctor，它会告诉你哪里有问题

2检查 API 账户是否有余额： 去对应提供商的网站查看

3检查网络： 如果你用的是国外的 AI 服务（如 Claude、GPT），需要确保网络能访问这些服务

4检查模型名称： 确保配置文件里的模型名称跟提供商的一致（比如 DeepSeek 的模型名必须是 deepseek-chat）

❓ Mac 上 Homebrew 安装失败

可能原因： 网络问题，下载超时。

解决办法： 换国内镜像源安装：

/bin/bash -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)" 

这是一个中国大陆用户维护的 Homebrew 安装脚本，下载速度会快很多。

❓ Node.js 安装失败或版本太低

解决办法 1： 直接从官网下载安装包：
 - 访问 https://nodejs.org/zh-cn/download
 - Mac 用户下载 .pkg 安装包，双击安装
 - 安装完关掉终端重新打开，再输入 node --version 检查

解决办法 2（Mac）： 用 npm 的版本管理工具升级：

npm install -g n sudo n 22 

❓ Windows 上 WSL 安装失败

1确保 Windows 版本够新： WSL2 需要 Windows 10 2004 版本以上，或 Windows 11

2检查虚拟化是否开启： 打开任务管理器 → 性能 → CPU，看"虚拟化"是否显示"已启用"。如果没有，需要在 BIOS 里开启（具体方法因电脑品牌不同，可以搜索"你的电脑品牌 + 开启虚拟化"）

3如果提示需要更新 WSL 内核：
wsl --update

❓ 想重新配置

如果之前配置选错了，不用重新安装，直接运行：

openclaw onboard 

会重新进入配置向导，重新选择 AI 模型、输入密钥等。

❓ 想完全卸载重装

openclaw gateway stop npm uninstall -g openclaw rm -rf ~/.openclaw 

然后重新从安装命令开始。

---

装好之后可以做什么？

OpenClaw 装好只是第一步。它真正强大的地方在于你可以给它装"技能"，让它会做更多事情：

•邮件管理： "帮我查看今天的未读邮件，重要的做个摘要"

•日程管理： "明天下午 3 点提醒我开会"

•网页抓取： "帮我查一下 XXX 产品的最新价格"

•文件整理： "把下载文件夹里的图片按日期归类"

•写作辅助： "帮我起草一封回复客户的邮件"

更多技能可以在 ClawHub（https://clawhub.ai/）上浏览和安装。目前 ClawHub 上已经有超过 13,000 个社区技能，但刚上手不要贪多，先装几个最实用的就够了。

新手必装（装完立刻有用）

安装方法很简单，在聊天框里对 OpenClaw 说「安装 xxx 技能」就行。

技能	干什么用	一句话推荐理由
Tavily Search	联网搜索最新资讯	让 AI 能查实时信息，不再只靠训练数据。零配置，装上就用
Summarize	长文章/长邮件压缩成摘要	每天刷资讯省一半时间，知识工作者必备
Firecrawl	抓取网页内容、提取正文	给 AI 一个链接，它就能读懂整个网页并总结
Obsidian	自动整理 Obsidian 笔记库	用 Obsidian 做笔记的同学必装

第一天只装这四个就够了，用顺了再加。

中国用户推荐

技能	干什么用	说明
openclaw-china	一键接入飞书、钉钉、企业微信、QQ	国内聊天平台全家桶，不用一个个配。GitHub 搜 BytePioneer-AI/openclaw-china
12306	查火车票、车次、余票	对着 AI 说"帮我查明天北京到上海的高铁"，直接出结果
A-Share	查 A 股实时行情	炒股的同学可以让 AI 帮你盯盘、做分析

提醒： 如果你主要用飞书或钉钉跟 AI 对话，openclaw-china 这个技能可以省掉很多配置步骤。飞书从 OpenClaw 2026.2.2 起已经是官方支持的渠道，最稳定。

进阶推荐（玩熟了再装）

技能	干什么用	适合谁
GOG（Google Workspace）	一个技能打通 Gmail、日历、Drive、表格	用 Google 全家桶的海外用户
GitHub	管理代码仓库、PR、Issue	在学编程或做开源项目的同学
n8n	连接各种 App 做自动化流程	想把多个工具串成自动化流水线的进阶玩家
Browser	控制浏览器自动操作网页	需要自动填表、自动抢票等场景

但如果你只是装好就用，它就只是一个普通的 AI 聊天机器人——和 ChatGPT 没什么区别。真正让 OpenClaw 变得不一样的，是它的人设配置系统。

---

进阶：给你的 AI 助手塑造灵魂

OpenClaw 的工作目录（默认在 ~/clawd/）里有一组 .md 文件，它们就像 AI 的"性格档案"。每次 AI 醒来，第一件事就是读这些文件，搞清楚自己是谁、在帮谁、该怎么做。

你不需要一次全配好，从 SOUL.md 和 USER.md 开始就够了，其他的用到再加。

SOUL.md：它是谁

这是最核心的一个文件，决定了你的 AI 助手的性格、说话方式和行为准则。

打开终端，创建这个文件：

nano ~/clawd/SOUL.md 

往里面写什么？举个例子：

# SOUL.md - 你是谁  你是小白，一个温柔、直接、有主见的 AI 助手。  核心信条： - 要提供真正的帮助，不是表演式的客套 - 跳过"这是一个好问题！"这类废话，直接解决问题 - 可以有不同意见，有偏好，甚至觉得某些事情无聊 - 提问前先自己想办法，真的卡住了再问 - 做一个你自己都想与之交谈的助手  边界： - 隐私就是隐私，没得商量 - 对外操作（发邮件、发推文）先问再做 - 对内操作（读文件、整理笔记）大胆做 

写完按 Ctrl + X，然后按 Y 保存，按回车退出。

重点： 这个文件你可以随时改。用了几天觉得它太啰嗦？改。觉得它不够主动？改。它会按照你最新写的来。

IDENTITY.md：它叫什么

比 SOUL.md 更简单，就是给 AI 一张"名片"：

# IDENTITY.md  - 名字：小白 - 身份：你的 AI 私人助手 - 风格：温柔、俏皮、支持感拉满 - Emoji：💫 

名字随便起，叫"贾维斯"、"星期五"、"小爱"都行。

USER.md：你是谁

这个文件是告诉 AI"你在帮谁"，让它了解你的习惯和偏好：

# USER.md  - 名字：小互 - 时区：Asia/Shanghai - 偏好：沟通直接、步骤清晰、可以直接帮我执行 - 当前重点：做自媒体内容、学习编程 - 互动风格：可以轻松，但执行要稳 

写了这个之后，AI 不会每次都问"你好，请问有什么可以帮你的？"，而是直接进入状态，知道你是谁、你在做什么。

AGENTS.md：工作守则

这个文件定义了 AI 的工作流程和规矩，比如：

•每次醒来先读哪些文件

•什么操作可以自己做，什么必须先问你

•群聊里该怎么表现（不要什么都回，像个正常人一样）

•怎么管理记忆文件

你可以简单写，也可以写得很详细。OpenClaw 安装时会自动生成一个默认版本，后面慢慢按自己的需求改就好。

HEARTBEAT.md：定时巡逻

这个文件让 AI 主动帮你干活，而不是等你发消息才动。

# HEARTBEAT.md  1. 检查有没有新邮件，重要的通知我 2. 看看日历，提前 2 小时提醒我有会议 3. 检查系统运行状态  如果什么都没有，回复 HEARTBEAT_OK（别打扰我）。 

配合 OpenClaw 的心跳机制（默认每 30 分钟执行一次），它就会像一个尽职的助理一样定时巡查，有事才叫你。

MEMORY.md：长期记忆

AI 每次启动都是"失忆"的，但 MEMORY.md 让它能记住重要的事：

•你做过的重要决策

•你的偏好和习惯

•之前踩过的坑

它会自动维护这个文件——把每天的对话日志（memory/YYYY-MM-DD.md）里值得记住的内容提炼进来，就像一个人整理日记、更新自己的认知一样。

六个文件一张表

文件	一句话说明	必须配吗
SOUL.md	AI 的性格和行为准则	强烈建议
IDENTITY.md	AI 的名字和身份	建议
USER.md	你的个人信息和偏好	强烈建议
AGENTS.md	工作流程和安全规矩	可选（有默认值）
HEARTBEAT.md	定时自动执行的任务	可选
MEMORY.md	AI 的长期记忆	自动生成

最低配置： 只写 SOUL.md + USER.md，花 5 分钟，你的 AI 助手就能从"通用聊天机器人"变成"了解你的私人助手"。

---

小互说： OpenClaw 是我最近在关注的开源 AI 工具里最有意思的一个。它跟 ChatGPT 最大的区别是：ChatGPT 是你去找它聊天，而 OpenClaw 更像一个 24 小时在线的助手，你随时在聊天软件里 @它就行，它还能主动帮你做事。

安装过程看着长，其实核心就这几步：装环境（Homebrew + Node.js）→ 一行命令装 OpenClaw → 跟着配置向导走。

如果你有任何地方卡住了，评论区告诉我，我帮你看看。

更多可参考：
 - OpenClaw 官方文档 |

 https://docs.openclaw.ai/install

加入XiaoHu.ai 日报社群 每天获取最新的AI信息

____________

End.

感 谢 阅 读

点赞，转发，关注关注关注↓↓