从零开始——小白也能看懂的OpenClaw 详细实操指南

🦞OpenClaw 是一款开源的本地优先 AI 智能体网关，能让 AI 从"只会聊天"变成"能动手干活"——自动操作文件、执行命令、管理日程、抓取网页数据等。本指南从零开始，手把手带你完成安装、配置、日常使用和 Agent 调教，如果你不是个极客高手也没关系，本篇文章手把手的教你，照着做就行。

tommychian

7933人浏览 · 2026-03-14 11:04:20

tommychian · 2026-03-14 11:04:20 发布

🦞OpenClaw 是一款开源的本地优先 AI 智能体网关，能让 AI 从"只会聊天"变成"能动手干活"——自动操作文件、执行命令、管理日程、抓取网页数据等。本指南从零开始，手把手带你完成安装、配置、日常使用和 Agent 调教，如果你不是个极客高手也没关系，本篇文章手把手的教你，照着做就行。

一、OpenClaw 是什么？能干什么？

OpenClaw（原名 Clawdbot / Moltbot）是运行在你自己设备上的 AI 私人助理，通过自然语言下达指令，它可以：

📁 文件操作：整理文件夹、批量重命名、读取和生成文档
💻 执行命令：在你的电脑上运行 Shell 命令、写代码并执行
🌐 网页抓取：搜索网页、提取信息、监控数据变化
📅 日程管理：安排提醒、创建定时任务
💬 多渠道接入：通过 Telegram、微信、飞书、Slack、Discord 等下达指令
🧠 持久记忆：记住你之前说过的内容，越用越懂你

简单来说：传统 AI 只能回答问题，OpenClaw 能替你动手做事。

二、安装前准备

2.1 硬件要求

项目	最低要求	推荐配置
操作系统	Windows 10 / macOS 12 / Ubuntu 20.04	Windows 11 / macOS 14 / Ubuntu 22.04
内存	4GB	8GB 及以上
磁盘空间	1GB	5GB 及以上
网络	能访问外网	稳定的宽带连接

2.2 必装软件

在安装 OpenClaw 之前，你的电脑需要先装好以下两个软件：

① Node.js（22.0 及以上版本）

下载地址：https://nodejs.org/zh-cn
安装方法：下载后双击安装包，一路点"下一步"即可

② Git

下载地址：https://git-scm.com/downloads
安装方法：同上，下载后双击安装，默认选项即可

验证是否安装成功：

打开终端（Windows 用 PowerShell，Mac 用 Terminal），输入以下命令：

node -v
npm -v
git --version

如果都能显示版本号，说明安装成功，可以继续下一步。

三、安装 OpenClaw（三种方式任选）

方式一：一键脚本安装 ⭐ 推荐小白使用

macOS / Linux 用户

打开终端，复制粘贴以下命令，按回车：
```
curl -fsSL <https://openclaw.ai/install.sh> | bash
```
脚本会自动完成以下操作：
1. 检查是否已安装 Node.js（没有会自动帮你装）
2. 下载并安装 OpenClaw
3. 启动配置向导
Windows 用户
1. 按 Win 键，搜索 PowerShell
2. 右键选择 "以管理员身份运行"
3. 如果提示权限问题，先执行：
```
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
```
1. 然后粘贴以下命令，按回车：
```
iwr -useb <https://openclaw.ai/install.ps1> | iex
```
等待安装完成即可。

方式二：npm 手动安装

如果一键脚本有问题，可以用 npm 手动安装：

npm install -g openclaw@latest

验证安装：

openclaw --version

看到类似 2026.x.x 的版本号就表示安装成功。

方式三：Docker 安装（适合有经验的用户）

点击展开 Docker 安装步骤
```
# 第 1 步：克隆代码
git clone <https://github.com/openclaw/openclaw.git>

# 第 2 步：进入目录
cd openclaw

# 第 3 步：一键启动
./docker-setup.sh
```
安装完成后访问 http://127.0.0.1:18789/ 即可使用。

Docker 的好处是：AI 的操作被限制在容器里，更安全，也更容易管理和卸载。

四、首次配置（Onboard 向导）

安装完成后，运行以下命令启动配置向导：

openclaw onboard

向导会一步步引导你完成配置，按顺序操作即可：

步骤 1：确认风险提示

I understand this is powerful and inherently risky. Continue?

👉 选择 Yes

步骤 2：选择配置模式

👉 选择 QuickStart（快速开始，小白推荐）

步骤 3：选择大模型

这里选择你要用的 AI 模型提供商，常用选项：

模型	说明	推荐指数
Qwen（通义千问）	国内速度快，免费额度多	⭐⭐⭐⭐⭐
MiniMax	国内可用，效果不错	⭐⭐⭐⭐
DeepSeek	性价比高	⭐⭐⭐⭐
Claude / OpenAI	效果好但需要境外网络	⭐⭐⭐

选择后需要填入对应的 API Key，到对应平台官网注册获取。

步骤 4：选择聊天渠道

选择你要通过什么方式和 OpenClaw 对话：

Web 界面（默认，安装后直接用浏览器访问）
Telegram Bot（推荐，安全性较好）
飞书 / 企业微信 / Slack 等

如果暂时不确定，选 Skip for now，后续随时可以配置。

步骤 5：安装技能（Skills）

Configure skills now? (recommended)

👉 新手建议先选 No，等熟悉了再安装。

步骤 6：是否启用 Hooks

Enable hooks?

👉 选 Skip for now

步骤 7：Gateway 服务

Gateway service already installed

👉 选 Restart 重启网关服务

配置完成后，浏览器会自动打开 http://127.0.0.1:18789/chat，你就可以开始和 OpenClaw 对话了 🎉

五、常用命令速查表

📋以下是你日常使用中最常用的命令，建议收藏备用。

5.1 基础操作命令

命令	作用	使用场景
`openclaw onboard`	初始化配置向导	首次安装 / 重新配置
`openclaw tui`	打开终端聊天界面	在命令行里直接对话
`openclaw dashboard`	打开 Web 控制面板	在浏览器中聊天和管理
`openclaw status`	查看运行状态	检查服务是否正常
`openclaw doctor`	诊断系统环境	遇到问题时排查
`openclaw update`	更新到最新版本	定期更新保持最新
`openclaw logs`	查看运行日志	排查错误信息
`openclaw configure`	修改配置	更换 API Key、模型等

5.2 Gateway 网关命令

命令	作用
`openclaw gateway start`	启动网关服务
`openclaw gateway stop`	停止网关服务
`openclaw gateway restart`	重启网关服务（改完配置后必做）
`openclaw gateway status`	查看网关运行状态
`openclaw gateway --port 18789 --verbose`	前台运行并显示详细日志（调试用）

5.3 模型管理命令

命令	作用
`openclaw models list`	查看当前可用的模型列表
`openclaw models test <模型名>`	测试某个模型是否能正常连接

5.4 技能（Skills）管理命令

命令	作用
`openclaw skills list`	查看已安装的技能
`openclaw skills install <技能名>`	安装指定技能
`openclaw skills uninstall <技能名>`	卸载指定技能

5.5 Hooks 与定时任务命令

命令	作用
`openclaw hooks list`	查看所有 Hooks
`openclaw hooks enable <Hook名>`	启用指定 Hook
`openclaw hooks disable <Hook名>`	禁用指定 Hook

5.6 后台守护进程命令

命令	作用
`openclaw daemon install`	安装后台守护进程（让 OpenClaw 开机自动运行）
`openclaw daemon uninstall`	卸载后台守护进程
`openclaw security audit --deep`	深度安全审计

六、配置文件详解

OpenClaw 的核心配置文件位于：

~/.openclaw/openclaw.json

Windows 路径为：C:\\Users\\你的用户名\\.openclaw\\openclaw.json

6.1 查看配置文件位置

openclaw config file

6.2 关键配置项说明

用记事本或 VS Code 打开 openclaw.json，常见配置如下：

{
  "models": {
    "providers": {
      "你的模型提供商": {
        "apiKey": "你的 API Key",
        "baseUrl": "模型 API 地址",
        "models": [
          {
            "id": "模型名称",
            "contextWindow": 32768,
            "maxTokens": 32768
          }
        ]
      }
    }
  }
}

6.3 修改配置后，必须重启服务

openclaw gateway restart

⚠️ 注意：每次修改配置文件后，都需要运行 openclaw gateway restart 才能生效！

七、Agent 调教实操指南

这是很多人最想了解的部分——安装好了，怎么让它干活？

7.1 基础对话（Web 聊天界面）

打开 http://127.0.0.1:18789/chat，直接用自然语言和它对话：

你说的话	OpenClaw 会做什么
帮我看一下当前目录有哪些文件	自动执行 `ls` 或 `dir` 命令，返回文件列表
把桌面上所有 .jpg 文件移到"照片"文件夹里	自动创建文件夹（如不存在）并移动文件
帮我写一个 Python 脚本，批量重命名文件	自动创建脚本文件，询问是否执行
搜索一下今天的科技新闻	调用网页搜索技能，返回摘要
每天早上 9 点提醒我喝水	创建 Cron 定时任务，到时间自动推送

7.2 安装技能扩展能力

OpenClaw 的能力通过 Skills（技能） 来扩展。你可以直接在对话中让它安装：

你说：帮我安装搜索网页的技能

OpenClaw：好的，正在安装 web-search skill...

也可以用命令行安装：

openclaw skills install web-search
openclaw skills install file-manager
openclaw skills install code-runner

查看已有技能：

openclaw skills list

7.3 配置多 Agent 协作

你可以创建多个 Agent，让它们各司其职：

第一步：进入 Agent 配置目录

cd ~/.openclaw/agents/

第二步：创建新的 Agent

你可以通过对话的方式让主 Agent 帮你创建 Sub-Agent：

你说：帮我创建一个专门负责写代码的 Agent，叫 "CodeBot"

OpenClaw：好的，我来创建一个 SubAgent...

第三步：在对话中调用指定 Agent

你说：让 CodeBot 帮我写一个爬虫脚本

7.4 接入聊天渠道

接入 Telegram Bot（推荐）
1. 在 Telegram 中找到 @BotFather，发送 /newbot
2. 按提示设置 Bot 名称，获取 Bot Token
3. 在 Telegram 中找到 @getidsbot，获取你的 数字账号 ID
4. 回到 OpenClaw，运行配置向导或直接编辑配置文件，将 Token 和 ID 填入
5. 重启服务：openclaw gateway restart
配置完成后，你就可以在 Telegram 中直接给 Bot 发消息，让 OpenClaw 干活了。
接入飞书机器人
1. 登录飞书开放平台 → 创建企业自建应用
2. 添加机器人能力
3. 在"凭证与基础信息"中获取 App ID 和 App Secret
4. 配置回调地址为：http://你的服务器IP:18789/webhook/feishu
5. 将 App ID 和 App Secret 填入 OpenClaw 配置文件
6. 重启服务：openclaw gateway restart
接入企业微信
1. 登录企业微信管理后台 → 应用管理 → 创建应用
2. 获取 Corp ID、Agent ID、Secret
3. 配置接收消息的 URL 为 OpenClaw 的 Webhook 地址
4. 填入配置文件并重启服务

八、云端部署指南

如果不想在自己电脑上运行，可以部署到云服务器。

8.1 一键云端部署（最省心）

目前各大云平台都支持 OpenClaw 镜像一键部署：

平台	入口地址
阿里云	`https://www.aliyun.com/activity/ecs/clawdbot`
腾讯云	`https://cloud.tencent.com/developer/article/2624973`
火山引擎	在控制台搜索"OpenClaw"镜像

一键部署的好处是不用自己配环境，购买服务器后选择 OpenClaw 镜像，几分钟就能用。

8.2 云端常用操作命令

通过 SSH 连接到你的云服务器后，以下命令你会经常用到：

# 查看 OpenClaw 状态
openclaw status

# 重启服务
openclaw gateway restart

# 查看日志（排查问题）
openclaw logs

# 更新到最新版本
openclaw update

# 设置开机自启
openclaw daemon install

# 查看配置文件位置
openclaw config file

8.3 云端安全建议

🔒 安全提醒：OpenClaw 具备系统级操作权限，部署在云端请注意以下几点：

使用强密码并开启 SSH 密钥登录
配置防火墙，只开放必要端口（18789）
不要在存有重要数据的服务器上部署
定期运行 openclaw security audit --deep 进行安全审计
遵循最小权限原则，只安装必要的 Skills

九、常见问题排查

❓ Q1：安装后 `openclaw` 命令找不到

# 检查 npm 全局路径
npm config get prefix

# 确认路径在系统 PATH 中，或手动添加
# Windows 用户可在"环境变量"中手动添加

❓ Q2：Web 页面打不开

# 先检查服务状态
openclaw status
openclaw gateway status

# 如果不正常，前台运行查看详细日志
openclaw gateway --port 18789 --verbose

❓ Q3：模型连接失败 / 回复报错

# 查看模型列表
openclaw models list

# 测试模型连接
openclaw models test 你的模型名

# 检查 API Key 是否正确
openclaw config file
# 然后打开配置文件检查 apiKey 字段

❓ Q4：上下文窗口错误

打开配置文件 ~/.openclaw/openclaw.json，找到模型配置中的 contextWindow 和 maxTokens，将其调大：

{
  "id": "你的模型名",
  "contextWindow": 32768,
  "maxTokens": 32768
}

修改后重启：openclaw gateway restart

❓ Q5：如何完全卸载？

# 停止服务
openclaw gateway stop

# 卸载 OpenClaw
npm uninstall -g openclaw

# 删除配置文件（可选）
rm -rf ~/.openclaw

# 验证卸载
openclaw --version
# 提示 command not found 就说明卸载成功