OpenClaw（麻辣小龙虾）安装使用教程

1. OpenClaw 是什么？
2. 为什么选择 OpenClaw？
3. 环境准备
4. 安装 OpenClaw
5. 初始配置
6. 启动网关
7. 使用网页界面
8. 核心能力演示
9. 常见问题
10. 进阶玩法

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

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

核心特点

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

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

适合人群

• ✅ 开发者，想要一个能写代码的 AI 助手
• ✅ 极客，喜欢自托管、掌控数据
• ✅ 效率控，想要 AI 帮你自动化日常任务
• ✅ 隐私敏感者，不想把数据交给第三方服务

能帮你干啥？

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

系统要求

必需软件

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

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

   验证安装：

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

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

   验证安装：

   npm -v

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

可选软件

• Git — 用于版本控制
• VS Code — 代码编辑器

硬件要求

步骤 1：全局安装

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

npm install -g openclaw@latest

安装完成后验证：

openclaw --version

步骤 2：运行引导向导

openclaw onboard

这个命令会：

• 创建配置文件目录（）
• 引导你配置 AI 提供商（如 Qwen、OpenAI 等）
• 生成必要的认证信息

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

想让 OpenClaw 开机自启？运行：

openclaw onboard --install-daemon

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

配置文件位置

配置文件在：

首次启动后的配置

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

1️⃣ 编辑

文件位置：

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

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

填写建议：

• Name：给你的 AI 助手起个名字
• Creature：它是什么”生物”（AI、机器人、赛博生物等）
• Vibe：你希望它什么风格（正式、幽默、高冷、温暖）
• Emoji：选个代表符号

2️⃣ 编辑

文件位置：

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

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

3️⃣ 删除

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

del D:openclawBOOTSTRAP.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：打开浏览器

访问：

步骤 2：输入网关令牌

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

文件位置：

找到 字段，复制那串字符：

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

步骤 3：开始聊天

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

💡 让网页更好用的小技巧

1. 添加到桌面（像 App 一样）
   • Chrome/Edge：菜单 → 更多工具 → 创建快捷方式 → 勾选”在窗口中打开”
2. 暗黑模式
   • 安装 Dark Reader 扩展，瞬间变酷炫黑
3. 全屏使用
   • 按 全屏，更沉浸

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 会记住：

• 你的偏好（简洁回复、技术栈等）
• 项目进展
• 重要决定

记忆文件位置：

6️⃣ 定时任务

可以设置 cron 任务：

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

7️⃣ 多平台消息

可以接入：

• WhatsApp
• Telegram
• Discord
• iMessage
• 更多（通过插件）

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

解决方法：

1. 确认网关已启动：
2. 强制刷新浏览器：
3. 重启网关：
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）：

文件位置：

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

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