OpenClaw 新手入门完全指南：从零开始的AI助手配置教程-openclaw AI

# OpenClaw 新手入门完全指南：从零开始的AI助手配置教程

你好！欢迎来到 OpenClaw 的世界！咱们今天来聊聊怎么把这个”龙虾AI助手”给装好配好，让它真正成为你工作生活中的得力干将。

可能你之前听说过 Clawdbot、Moltbot 这些名字——其实都是同一个项目，只是中间因为一些版权原因改了几次名。现在官方统一叫 OpenClaw，logo 是一只超萌的小龙虾 🦞

这篇教程咱们不整虚的，手把手带你从零开始，把 OpenClaw 跑起来！

## 一、OpenClaw 是什么，能干啥？

咱们先搞清楚一件事——OpenClaw 不只是一个聊天机器人。它是一个真正能执行任务的 AI 智能体。

啥意思呢？普通 AI 你问它”帮我查下天气”，它给你输出一段文字告诉你天气怎么样。但 OpenClaw 不一样——你让它查天气，它真的能联网查到天气信息，然后告诉你该不该带伞。

再比如，你说”帮我把这个月的邮件整理一下”，普通 AI 只能给你一堆建议，但 OpenClaw 真的能操作你的邮箱，把邮件分类好、发个总结给你。

总结一下 OpenClaw 的核心能力：

🔍 访问网页、获取页面内容

📧 管理邮件（收件、发件、附件处理）

📁 整理文件（移动、复制、分类）

⏰ 设置定时提醒和任务

💻 自动编写和执行代码

📝 操作各种办公文档

简单说，OpenClaw 就是把你的 AI 从”动嘴皮子的”升级成了”能动手干的”。这个差别可就大了去了！

## 二、系统要求——你的电脑能跑吗？

放心，OpenClaw 的硬件要求相当亲民：

| 配置项 | 最低要求 | 推荐配置 |
|——–|———-|———-|
| 内存 | 2GB | 4GB+ |
| 系统 | macOS / Windows / Linux | 任意主流系统 |
| 网络 | 需要联网 | 稳定的网络连接 |

其实绝大部分电脑都能跑起来，包括 Mac Mini、NUC 小主机、甚至一些性能还行的平板电脑。

⚠️ **但有一点必须要有：Node.js 环境**。OpenClaw 本质上是一个 Node.js 应用，所以系统里需要安装 Node.js（版本 ≥22）。

## 三、安装方法——三种方式任你选

### 方式一：一键脚本安装（推荐新手）

这是最省事的方案，脚本会自动检测你的系统、安装 Node.js、配置运行环境。

**macOS / Linux 系统**，打开终端，执行：

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

**Windows 系统**，用 PowerShell（管理员模式）执行：

iwr -useb https://openclaw.ai/install.ps1 | iex

或者用 CMD：

curl -fsSL https://openclaw.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

脚本会自动搞定一切，包括安装 Node.js 环境。整个过程大概需要 3-5 分钟，中间可能需要你确认几次，直接按回车就行。

### 方式二：手动 npm 安装

如果你已经装了 Node.js（版本 ≥22），可以用 npm 或 pnpm 直接安装。

# 用 npm 安装
npm i -g openclaw

# 如果下载慢，可以用国内镜像
npm i -g openclaw --registry=https://registry.npmmirror.com

# 或者用 pnpm
pnpm add -g openclaw

装完之后，还需要初始化：

openclaw onboard

这个命令会启动配置向导，帮你把各项设置配好。

### 方式三：从源码安装（适合开发者）

如果你想看源码、改源码，或者想参与贡献代码，可以从 GitHub 拉取源码：

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm ui:build
pnpm build

# 初始化并安装为系统服务（开机自启）
pnpm openclaw onboard --install-daemon

# 开发模式：监听代码变更自动重载
pnpm gateway:watch

⚠️ **注意：** 如果是新 Mac 或 Linux 系统，首次执行 `pnpm` 命令时会提示安装 pnpm，照着提示操作就行。

## 四、初始化配置——跟着向导走

安装完成后，咱们来走一遍配置向导。这个过程其实很简单，向导会一步步带你完成设置。

### 第一步：启动向导

openclaw onboard --install-daemon

执行之后，系统会提醒你：这个龙虾助手能力很强，但风险也很大——这里选 **yes** 继续安装。

### 第二步：选择快速启动

向导会给出几个选项，选 **QuickStart（快速启动）** 就好，这个最省事。

### 第三步：配置大模型

这里需要你提供一个 AI 模型的身份认证信息。国内用户可以用这些服务：

– **阿里云 Qwen（通义千问）**
– **智谱 AI（GLM）**
– **MiniMax**
– **硅基流动**
– OpenAI / Anthropic / Google 等国外服务也支持

配置信息会保存在 `~/.openclaw/agents//agent/auth-profiles.json` 这个文件里，后期想改的话直接编辑这个文件就行。

### 第四步：选择聊天工具

向导会列出一些聊天工具选项。如果你用的是国内工具，这里可能没有对应选项——没关系，选最后一个跳过就好，后面一样可以通过网页界面使用。

### 第五步：基础设置

剩下的就是一些基础配置：

– **Gateway Port（网关端口）**：默认 `18789`，直接回车用默认就行
– **Skills 选择**：按空格勾选你想要的技能，可以跳过以后再装
– **API Key**：没有的话直接选 no 跳过

### 第六步：钩子设置

最后会有三个钩子选项，建议都开启：

这些钩子主要做两件事：
– 内容引导日志
– 会话记录

用空格勾选，然后继续。

### 第七步：打开 Web UI

配置完成后，选择 **Open the Web UI**，浏览器会自动打开 `http://127.0.0.1:18789/chat`，这就是 OpenClaw 的主界面了！

## 五、基础使用——让 OpenClaw 真正跑起来

装好配好之后，咱们来看看怎么用。

### 检查状态

# 查看整体状态
openclaw status

# 检查网关是否在运行
openclaw gateway status

# 详细的健康检查
openclaw health

如果网关没有运行，手动启动：

openclaw gateway --port 18789 --verbose

### 打开控制面板

openclaw dashboard

这个命令会打开一个图形化的控制面板，可以查看和管理各种配置。

### 让它帮你干活

现在就可以在网页界面或者终端里和 OpenClaw 对话了！试试这些：

– **”帮我搜索一下最新的 AI 新闻”** → OpenClaw 会联网搜索并给你整理
– **”把桌面上的文件按类型分类整理一下”** → OpenClaw 会操作你的文件系统
– **”20分钟后提醒我开会”** → OpenClaw 会设置定时提醒
– **”帮我写一个 Python 脚本来处理这个 CSV 文件”** → OpenClaw 会写代码并执行

💡 小技巧：指令越具体，OpenClaw 执行效果越好。比如”帮我整理文件”和”帮我把桌面上的图片文件移到 D:图片文件夹，文档移到 D:文档文件夹”，后者的效果肯定比前者好很多。

## 六、常用命令一览

为了方便大家查阅，这里把常用命令整理成表：

## 七、常见问题解答

### Q1：安装脚本报错了怎么办？

首先确认你的网络是否正常，有些地区可能需要设置代理。另外确保你有管理员/管理员权限。

如果 Node.js 安装失败，可以先去 [nodejs.org](https://nodejs.org) 手动下载安装，然后再运行 OpenClaw 安装脚本。

### Q2：网关启动失败？

试试先运行诊断命令：

openclaw doctor

这个命令会检查各种依赖和环境问题，通常能告诉你哪里出了问题。常见的原因是端口 18789 被占用了——可以在配置里改成其他端口。

### Q3：想换一个大模型怎么办？

直接编辑配置文件：

# 找到配置文件
~/.openclaw/agents//agent/auth-profiles.json

在文件里修改对应模型的 API Key 和配置，然后重启网关：

openclaw gateway restart

### Q4：怎么更新 OpenClaw？

# 更新到最新版本
npm update -g openclaw

# 或者
pnpm update -g openclaw

### Q5：不小心删错了文件怎么办？

OpenClaw 有安全保护机制，默认不会直接删除文件，而是先移到回收站。如果真的误删了，去回收站找找看。

## 八、卸载方法

如果哪天不想用了，卸载也很简单：

# 交互式卸载
openclaw uninstall

# 非交互式卸载（自动化脚本用这个）
npx -y openclaw uninstall --all --yes --non-interactive

卸载会清除所有配置和插件，干净利落。

## 九、写在最后

好了，今天的入门教程就到这里！咱们一起走完了：

– ✅ 搞清楚了 OpenClaw 是什么、能干啥
– ✅ 三种安装方式（全自动、手动、源码）
– ✅ 跟着向导完成了初始化配置
– ✅ 学会了基础使用和常用命令
– ✅ 了解了常见问题的解决办法

OpenClaw 这个工具，一旦你用顺手了，真的会感觉离不开它——它就像一个全年无休的私人助理，帮你处理各种琐碎的事情。

下一步建议你去看看咱们的 **OpenClaw 命令大全**，里面整理了所有常用命令的详细说明。也可以去 **技能商店** 看看有什么好用的插件，给你的 OpenClaw 装上更多能力！

有问题欢迎留言，咱们一起交流！

外部链接： OpenClaw 官网 / 中文文档

文章版权归作者所有，未经允许请勿转载。

THE END

未分类

OpenClaw 新手入门完全指南：从零开始的AI助手配置教程

请登录后发表评论