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

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

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

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

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

2.1 硬件要求

2.2 必装软件

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

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

• 下载地址：
• 安装方法：下载后双击安装包，一路点”下一步”即可

② Git

• 下载地址：
• 安装方法：同上，下载后双击安装，默认选项即可

验证是否安装成功：

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

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

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

• macOS / Linux 用户

  打开终端，复制粘贴以下命令，按回车：

  脚本会自动完成以下操作：

  1. 检查是否已安装 Node.js（没有会自动帮你装）
  2. 下载并安装 OpenClaw
  3. 启动配置向导
• Windows 用户
  1. 按 ，搜索
  2. 右键 选择 “以管理员身份运行”
  3. 如果提示权限问题，先执行：
  1. 然后粘贴以下命令，按回车：

  等待安装完成即可。

方式二：npm 手动安装

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

验证安装：

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

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

• 点击展开 Docker 安装步骤

  安装完成后访问 即可使用。

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

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

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

步骤 1：确认风险提示

👉 选择 Yes

步骤 2：选择配置模式

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

步骤 3：选择大模型

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

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

步骤 4：选择聊天渠道

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

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

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

步骤 5：安装技能（Skills）

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

步骤 6：是否启用 Hooks

👉 选 Skip for now

步骤 7：Gateway 服务

👉 选 Restart 重启网关服务

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

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

5.1 基础操作命令

5.2 Gateway 网关命令

5.3 模型管理命令

5.4 技能（Skills）管理命令

5.5 Hooks 与定时任务命令

5.6 后台守护进程命令

OpenClaw 的核心配置文件位于：

Windows 路径为：

6.1 查看配置文件位置

6.2 关键配置项说明

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

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

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

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

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

打开 ，直接用自然语言和它对话：

7.2 安装技能扩展能力

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

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

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

也可以用命令行安装：

查看已有技能：

7.3 配置多 Agent 协作

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

第一步：进入 Agent 配置目录

第二步：创建新的 Agent

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

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

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

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

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

7.4 接入聊天渠道

• 接入 Telegram Bot（推荐）
  1. 在 Telegram 中找到 @BotFather，发送
  2. 按提示设置 Bot 名称，获取 Bot Token
  3. 在 Telegram 中找到 @getidsbot，获取你的 数字账号 ID
  4. 回到 OpenClaw，运行配置向导或直接编辑配置文件，将 Token 和 ID 填入
  5. 重启服务：

  配置完成后，你就可以在 Telegram 中直接给 Bot 发消息，让 OpenClaw 干活了。

• 接入飞书机器人
  1. 登录 飞书开放平台 → 创建企业自建应用
  2. 添加机器人能力
  3. 在”凭证与基础信息”中获取 App ID 和 App Secret
  4. 配置回调地址为：
  5. 将 App ID 和 App Secret 填入 OpenClaw 配置文件
  6. 重启服务：
• 接入企业微信
  1. 登录企业微信管理后台 → 应用管理 → 创建应用
  2. 获取 Corp ID、Agent ID、Secret
  3. 配置接收消息的 URL 为 OpenClaw 的 Webhook 地址
  4. 填入配置文件并重启服务

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

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

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

openclaw 配置

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

8.2 云端常用操作命令

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

8.3 云端安全建议

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

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

❓ Q1：安装后 命令找不到

❓ Q2：Web 页面打不开

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

❓ Q4：上下文窗口错误

打开配置文件 ，找到模型配置中的 和 ，将其调大：

修改后重启：

❓ Q5：如何完全卸载？

• [ ] 装完先跑 诊断环境是否正常
• [ ] 用 在终端快速测试对话
• [ ] 改完任何配置一定记得
• [ ] 定期运行 保持最新版
• [ ] 重要操作前先让 OpenClaw 确认方案，再授权执行
• [ ] 善用 Skills 扩展能力，不够的技能可以随时安装
• [ ] 如果响应慢，考虑换一个速度更快的模型提供商

 💡 最后一条建议：不要怕折腾，多试试不同的指令和场景。OpenClaw 的强大之处在于，你越用它，它就越懂你的需求。遇到问题时记得查日志（），大多数问题都能在日志里找到答案。