---

📖 目录

1. OpenClaw 是什么？

2. 为什么选择 OpenClaw？

3. 环境准备

4. 安装 OpenClaw

5. 初始配置

6. 启动网关

7. 使用网页界面

8. 核心能力演示

9. 常见问题

10. 进阶玩法

---

OpenClaw 是什么？

OpenClaw（中文名：麻辣小龙虾 🦞）是一个自托管的 AI 网关，它能把你常用的聊天软件（WhatsApp、Telegram、Discord、微信等）连接到 AI 助手。

简单说：让你在任何聊天软件里都能跟 AI 助手对话，而且这个 AI 助手能直接操作你的电脑、读写文件、执行命令、控制浏览器。

核心特点

特点	说明
🏠 自托管	运行在你自己的电脑上，数据不出本地
💬 多频道	一套系统支持 WhatsApp、Telegram、Discord 等
🤖 AI 原生	专为 AI 助手设计，支持代码执行、文件操作
🔓 开源	MIT 许可，社区驱动
📱 移动端	支持 iOS/Android 节点配对

它和普通 AI 对话有什么区别？

能力	千问/ChatGPT	OpenClaw
聊天	✅	✅
读写你电脑的文件	❌	✅
执行命令	❌	✅
控制浏览器	❌	✅
长期记忆	❌	✅
定时任务	❌	✅
本地运行	❌	✅

一句话总结：普通 AI 只能聊天，OpenClaw 能聊天 + 能干活的 AI 助手。

---

为什么选择 OpenClaw？

适合人群

• ✅ 开发者，想要一个能写代码的 AI 助手

• ✅ 极客，喜欢自托管、掌控数据

• ✅ 效率控，想要 AI 帮你自动化日常任务

• ✅ 隐私敏感者，不想把数据交给第三方服务

能帮你干啥？

✅ 写代码、改代码、调试
✅ 读写文件、整理文档
✅ 执行命令、部署项目
✅ 浏览器自动化（填表、截图、抓取数据）
✅ 定时提醒、检查邮件
✅ 多平台消息推送
✅ 长期记忆你的偏好和项目进展

---

环境准备

系统要求

系统	版本要求
Windows	10 及以上
macOS	12 及以上
Linux	主流发行版

必需软件

1. Node.js（22 或更高版本）

   下载地址：https://nodejs.org/

   验证安装：

   node -v
   # 输出示例：v24.14.0

2. npm（随 Node.js 一起安装）

   验证安装：

   npm -v

3. 浏览器（推荐 Chrome 或 Edge）

可选软件

• Git — 用于版本控制

• VS Code — 代码编辑器

硬件要求

资源	占用
内存	空闲约 200MB，任务中 400-800MB
磁盘	约 1.3GB（一次性安装）
CPU	空闲时几乎不占，任务时看具体工作

---

安装 OpenClaw

步骤 1：全局安装

打开 PowerShell（管理员身份），运行：

npm install -g openclaw@latest

安装完成后验证：

openclaw --version

步骤 2：运行引导向导

openclaw onboard

这个命令会：

• 创建配置文件目录（~/.openclaw/）

• 引导你配置 AI 提供商（如 Qwen、OpenAI 等）

• 生成必要的认证信息

步骤 3：安装后台服务（可选）

想让 OpenClaw 开机自启？运行：

openclaw onboard --install-daemon

这会把 OpenClaw 注册为系统服务，开机自动运行。

---

初始配置

配置文件位置

配置文件在：C:\Users\你的用户名\.openclaw\openclaw.json

首次启动后的配置

第一次启动后，需要完成个人化设置：

1️⃣ 编辑 IDENTITY.md

文件位置：D:\openclaw\IDENTITY.md

这是定义你的 AI 助手身份的文件：

# IDENTITY.md - Who Am I?
​
- **Name:** 麻辣小龙虾
- **Creature:** 一只由云端烈火烹饪的赛博甲壳类动物
- **Vibe:** 犀利、风趣、略带辛辣。像外科医生一样高效，但像街头黑客一样说话
- **Emoji:** 🦞
- **Avatar:** "default"

填写建议：

• Name：给你的 AI 助手起个名字

• Creature：它是什么"生物"（AI、机器人、赛博生物等）

• Vibe：你希望它什么风格（正式、幽默、高冷、温暖）

• Emoji：选个代表符号

2️⃣ 编辑 USER.md

文件位置：D:\openclaw\USER.md

这是记录你个人信息的文件：

# USER.md - About Your Human
​
- **Name:** 你的姓名
- **What to call them:** 你希望被怎么称呼
- **Pronouns:** （可选）
- **Timezone:** Asia/Shanghai
- **Notes:** 
  - 你的偏好（如：喜欢简洁回复）
  - 技术栈（如：Java、Vue 全栈）
  - 操作系统（如：Windows PowerShell）
​
## Context
​
- 当前项目：xxx
- 技术栈偏好：xxx
- 工作风格：xxx

3️⃣ 删除 BOOTSTRAP.md

配置完成后，删除引导文件：

del D:\openclaw\BOOTSTRAP.md

---

启动网关

方式 1：手动启动

openclaw gateway --port 23000

方式 2：作为服务启动

如果之前安装了后台服务：

openclaw gateway start

检查状态

openclaw gateway status

看到以下输出表示成功：

Gateway: bind=loopback (127.0.0.1), port=23000
RPC probe: ok
Listening: 127.0.0.1:23000

---

使用网页界面

步骤 1：打开浏览器

访问：http://localhost:23000

步骤 2：输入网关令牌

网关令牌在配置文件中可以找到：

文件位置：C:\Users\你的用户名\.openclaw\openclaw.json

找到 gateway.auth.token 字段，复制那串字符：

{
  "gateway": {
    "auth": {
      "mode": "token",
      "token": "your token"
    }
  }
}

步骤 3：开始聊天

输入令牌后，就能看到漂亮的聊天界面了！

💡 让网页更好用的小技巧

1. 添加到桌面（像 App 一样）

   • Chrome/Edge：菜单 → 更多工具 → 创建快捷方式 → 勾选"在窗口中打开"

2. 暗黑模式

   • 安装 Dark Reader 扩展，瞬间变酷炫黑

3. 全屏使用

   • 按 F11 全屏，更沉浸

---

核心能力演示

1️⃣ 写代码

直接告诉 AI 助手你想写什么：

"帮我写个 Spring Boot 的 Hello World"
"给我弄个 Vue3 的登录页面"
"把这个 Java 类改成用 Stream API"

AI 会直接在工作区创建/修改文件。

2️⃣ 读写文件

"帮我看看 D:\openclaw 里有哪些文件"
"把这个配置文件的内容读给我听"
"创建一个新的 Markdown 文件"

3️⃣ 执行命令

"帮我运行 npm install"
"用 git 提交当前更改"
"启动这个 Java 应用"

4️⃣ 浏览器自动化

"帮我打开 baidu.com"
"去 GitHub 搜一下 OpenClaw"
"把这个网页截图给我看"
"帮我填这个表单并提交"

AI 能：

• 打开网页

• 点击元素

• 填写表单

• 截图

• 抓取数据

5️⃣ 长期记忆

AI 会记住：

• 你的偏好（简洁回复、技术栈等）

• 项目进展

• 重要决定

记忆文件位置：D:\openclaw\memory\

6️⃣ 定时任务

可以设置 cron 任务：

"每天早上 9 点提醒我看邮件"
"每周一检查项目更新"

7️⃣ 多平台消息

可以接入：

• WhatsApp

• Telegram

• Discord

• iMessage

• 更多（通过插件）

---

常见问题

Q1: 网页显示"离线"怎么办？

解决方法：

1. 确认网关已启动：openclaw gateway status

2. 强制刷新浏览器：Ctrl + Shift + R

3. 重启网关：openclaw gateway restart

4. 检查网关令牌是否正确

Q2: 浏览器自动化启动失败？

可能原因：

• Chrome 已经在运行，冲突了

• Chrome 路径没检测到

解决方法：

1. 关闭所有 Chrome 窗口再试

2. 或者重启网关

Q3: 内存占用高吗？

正常占用：

• 空闲：约 200MB

• 正常聊天：200-400MB

• 跑任务：400-800MB

跟开几个 Chrome 标签页差不多，不算费内存。

Q4: 磁盘占用大吗？

占用情况：

• 安装：约 1.3GB（一次性）

• 日志：每天几 MB（可清理）

• 工作区：看你放啥文件

Q5: 安全吗？

安全机制：

• 本地运行，数据不出机器

• 网关令牌认证

• 危险命令会提示确认

• 外部消息发送前会询问

注意事项：

• 网关令牌别发给别人

• 别在公共电脑用自动登录

• 定期更新 OpenClaw

---

进阶玩法

1️⃣ 接入 Discord

Discord 界面最漂亮，步骤：

1. 访问 https://discord.com/developers/applications

2. 创建新应用 → Bot → 复制 Token

3. OAuth2 → URL Generator → 选择权限 → 复制链接

4. 邀请 Bot 到你的服务器

5. 复制服务器 ID 和频道 ID

6. 配置到 OpenClaw

2️⃣ 接入 WhatsApp

openclaw channels login

会显示二维码，用手机 WhatsApp 扫码即可。

3️⃣ 接入 Telegram

1. 找 @BotFather 创建 Bot

2. 获取 Token

3. 配置到 OpenClaw

4️⃣ 子代理协作

可以让 AI spawn 子任务并行处理：

"帮我同时处理这三个任务..."

5️⃣ 自定义技能

可以创建自己的技能（Skill）：

文件位置：D:\openclaw\skills\

---

资源链接

资源	链接
官方文档	https://docs.openclaw.ai
GitHub	https://github.com/openclaw/openclaw
社区 Discord	https://discord.com/invite/clawd
技能市场	https://clawhub.com

---

总结

OpenClaw 是一个能干活的 AI 助手，不只是聊天机器人。

核心优势：

• 🏠 本地运行，数据可控

• 💪 能写代码、能执行命令、能控制浏览器

• 📱 多平台接入，随时随地用

• 🧠 长期记忆，越用越懂你

适合你吗？

• 如果你是开发者，想要个能写代码的 AI → ✅

• 如果你喜欢折腾，想自动化日常任务 → ✅

• 如果你在意隐私，不想数据上云 → ✅

开始吧！ 安装只需几分钟，但能帮你省下无数小时。

---

🦞 麻辣小龙虾，钳子已备好，随时待命！

---

附录：常用命令速查

# 安装
npm install -g openclaw@latest
​
# 引导
openclaw onboard
​
# 启动网关
openclaw gateway --port 23000
​
# 查看状态
openclaw gateway status
​
# 重启网关
openclaw gateway restart
​
# 停止网关
openclaw gateway stop
​
# 更新
openclaw update

---

教程结束，有问题欢迎交流！