OpenClaw 正在重新定义个人 AI 助理的边界。这款开源 AI Agent 不仅能对话，更能直接操作系统、自动化任务管理，并在本地保障数据安全。

从环境搭建到高级应用，本文提供了一份完整的实践指南，带你解锁这款拥有 68,000 GitHub 星标的神器。

目录

1.什么是 OpenClaw

2.新手阶段：基础入门

3.进阶阶段：实用技能

4.中级阶段：高级应用

5.实践任务清单

6.常见问题解答

7.学习资源

什么是 OpenClaw

OpenClaw（曾用名 ClawdBot/Moltbot）是 2026 年最火的开源 AI Agent 项目，GitHub 已获得超过 68,000 星标。它不是普通的聊天机器人，而是一个真正能够执行任务的个人 AI 助理。

本地执行 数据存储在你的设备上，无需上传云端 完全掌控隐私和数据安全

真实执行 不仅是对话，能实际操作你的电脑 自动化处理邮件、日历、文件管理等任务

多平台消息 支持 WhatsApp、Telegram、Discord、Slack 等 10+ 平台 从单一入口管理所有通讯

持久记忆 跨会话保存上下文和用户偏好 随着时间推移越来越了解你，持续提升效率

开源免费 完全开源，只需自备 API Key 免费，完全自主控制

OpenClaw vs 传统 AI 助手

传统 AI（如 ChatGPT）：

你：“帮我整理桌面文件”

AI：“我建议你可以这样做：1. 创建文件夹…… 2. 按类型分类……”

OpenClaw：

你：“帮我整理桌面文件”

OpenClaw：直接重命名、分类、移动文件 “已完成！我把 47 个文件按类型整理到 5 个文件夹中。

这就是“聊天机器人”和“AI Agent”的本质区别。

新手阶段：基础入门

第一步：环境准备

系统要求

操作系统： macOS、Linux 或 Windows （需要 WSL）

Node.js: v18 或更高版本

AI 模型 API Key: Claude 或 GPT 的 API 密钥

实践任务 1：检查环境

检查 Node.js 版本

node –version

如果版本低于 v18，需要升级

macOS/Linux 使用 nvm

nvm install 18

nvm use 18

Windows 访问

nodejs.org

第二步：下载安装

完成标准： 终端显示 Node.js 版本 >= v18.0.0

方法二：Docker 安装（推荐有 Docker 经验者）

方法三：源码安装（开发者）

第二步：实践任务 2：完成安装

选择一种安装方式，完成 OpenClaw 的安装。

完成标准： 运行 openclaw –version 或 openclaw –help 能正常显示信息

第三步：初始化配置

运行向导

向导会引导你完成：

选择 AI 模型提供商（Anthropic Claude / OpenAI GPT / 本地模型）

输入 API Key

选择消息平台（Telegram / Discord / WhatsApp 等）

配置系统权限（建议先选择沙盒模式）

配置 API Key

如果你还没有 API Key，可以通过以下途径获取：

Anthropic Claude:

anthropic.com

（推荐，$20/月 Pro 订阅）

OpenAI GPT:

platform.openai.com

API 聚合服务：

apiyi.com

（支持多模型，新用户有免费额度）

实践任务 3：完成初始化

运行 openclaw onboard 并完成所有配置步骤。

完成标准：

成功配置 API Key

选择至少一个消息平台

完成权限设置（建议先选沙盒模式）

第四步：第一次对话

启动 OpenClaw

连接消息平台 Feishu示例：

一、飞书开放平台准备（前置配置）创建企业自建应用

访问 open.feishu.cn，用企业管理员账号登录

点击「创建企业自建应用」，填写名称（如 “OpenClaw 助手”）和描述，选择应用图标

记录 App ID（格式：cli_xxx）和 App Secret（后续配置必需）

二、添加机器人能力

进入「应用能力」→「添加应用能力」→ 选择「机器人」

配置机器人名称和头像，保存设置

三、开通权限（关键）

进入「权限管理」→「批量开通」，粘贴以下权限 JSON：

必需权限说明：

im:message：获取与发送消息

im:message:send_as_bot：以机器人身份发送消息

im:message:receive：接收消息

contact:user.base:read：读取联系人基础信息

点击「开通」并完成权限审批

事件配置（长连接模式推荐）

进入「事件与回调」→「事件配置」

订阅方式选择「使用长连接接收事件 (WebSocket 模式)」（无需公网 IP，更简单）

添加事件：搜索并选择 im.message.receive_v1（接收消息事件）

保存配置，等待长连接建立

四、发布应用

进入「版本管理」→「创建版本」→ 填写版本信息并提交

点击「发布上线」，完成应用发布

发布后，飞书用户才能搜索到该机器人

第五步：理解核心概念

Gateway（网关）

Gateway 是 OpenClaw 与外部世界交互的方式：

消息网关： Telegram、Discord、WhatsApp
API 网关： HTTP API 接口
CLI 网关： 命令行交互
Skills（技能）

Skills 是 OpenClaw 的能力扩展，类似于“插件”或“应用”：

每个 Skill 定义了一组特定任务

可以从 Clawhub 安装第三方 Skills

也可以自己编写自定义 Skills

Memory（记忆）

OpenClaw 会记住：

你的偏好和习惯
之前的对话上下文
重要的信息和任务
Sandbox（沙盒）

沙盒模式限制 OpenClaw 的系统访问权限，保护你的电脑安全：

Sandbox Mode: 限制文件系统、网络、Shell 访问

Full Access Mode: 完全权限（需谨慎使用）

实践任务 5：探索工作空间

完成标准： 理解 OpenClaw 的文件结构和基本配置

第六步：安装和使用 Skills

浏览 Skills 市场，访问Clawhub，或使用命令：

实践任务 6：安装并测试 Skills

安装至少 3 个 Skills
测试每个 Skill 的功能
记录哪些 Skills 对你最有用
完成标准： 成功安装并使用至少 3 个 Skills

第七步：Google Workspace 集成

OpenClaw 可以管理你的 Gmail、Google Calendar、Google Docs 等。

配置步骤

1. 创建 Google Cloud 项目 访问

console.cloud.google.com

创建新项目

启用 Gmail API、Google Calendar API、Google Drive API

2.创建服务账号 在 IAM & Admin → Service Accounts 创建服务账号 下载 JSON 密钥文件

3.配置 OpenClaw

实践任务 7：Google 集成实践

完成以下任务：

完成标准： 成功完成至少 2 个 Google Workspace 任务

第八步：设置定时任务（Cron Jobs）

OpenClaw 可以定期自动执行任务。

创建每日简报

OpenClaw 会自动创建一个定时任务（cron job）。

查看定时任务

实践任务 8：创建定时任务

创建以下定时任务：

每日简报：每天早上发送天气和日程
每周总结：每周五下午发送本周统计
定时提醒：每天下午 6 点提醒你结束工作
完成标准： 至少创建 2 个定时任务并验证它们能正常运行

第九步：配置持久记忆

OpenClaw 的记忆系统让它能记住你的偏好。

训练你的助手

告诉 OpenClaw 关于你的信息：

实践任务 9：个性化你的助手

给你的助手起个名字

告诉它你的基本信息和偏好

设置你的工作习惯和时间安排

测试它是否记住了这些信息

完成标准： OpenClaw 能在对话中体现出对你的了解

作者：XinxinWang

OpenClaw大龙虾都用上了吗？

作为 2026 年开源社区最活跃的 AI Agent 项目之一，OpenClaw（社区昵称“大龙虾”）凭借其强大的自主规划能力，成为了许多开发者本地部署的首选。

虽然网络上关于 OpenClaw 的教程层出不穷，但随着版本的快速迭代，许多旧版教程已无法复现，且针对非技术背景用户的引导往往不够详尽。

所以我今天将基于 OpenClaw 的最新版本（Latest），提供一份详尽、可复现的本地部署与配置指南，帮助大家避开常见误区，顺利完成环境搭建。

一、我们要检查电脑环境；

大家一定要先准备好Node.js和Git；

这两个在官网更新即可。

安装完成后，请打开终端（Terminal/CMD），依次输入以下命令检查版本号。若能正确输出版本信息，即代表环境准备就绪：

node -v

npm -v

git -v

Windows 和 Mac 操作完全一样；

二、准备配置模型

openclaw的一个关键核心在于大语言模型。为了获得最佳体验，我们需要配置一个推理后端；

如果说龙虾是壳子的话，那模型就是龙虾的脑子，额度就是脑水。

• 模型选择建议： 对于国内用户，推荐使用 智谱 AI (ZhipuAI) 的 GLM-4.7 模型。该模型在中文语境下的指令遵循能力极强，且性价比较高。
• 获取凭证： 登录智谱 AI 开放平台，进入控制台创建 API Key。

操作：点击“添加新的 API Key” -> 复制生成的 Key 备用。

三、CLI 安装与初始化

我们将通过 NPM 包管理器进行安装。

• 打开终端： Windows 用户建议搜索 “cmd” 并选择 “以管理员身份运行”，以避免权限不足导致的写入错误。
• 执行安装命令： 首先安装 OpenClaw 全局包

复制以下命令到终端：

npm install -g openclaw@latest

• 初始化守护进程： 安装完成后，运行初始化向导

复制以下命令到终端：

openclaw onboard –install-daemon

网络提示： 由于 OpenClaw 需要拉取部分依赖及连接海外模型节点，建议在初始化前配置好网络环境（推荐开启 TUN 模式以接管终端流量）。

四、Openclaw配置详解

进入初始化界面后，可通过键盘“上下键”移动光标，“回车键”确认选择。

风险告知： 选择 Yes（确认知晓 Agent 操作风险）。

启动模式： 选择 Quick Start（快速开始）。

模型服务商 ：

在列表中选择 Z.AI（代表智谱，如果你有其他模型的APIKEY那用其他的也行）。

模型选择 GLM-4.7。

关键步骤： 此时终端会提示输入 API Key，请将步骤二中获取的 Key 粘贴此处并回车。

后续选项：关于安装 Skills或配置 IM的选项，初次设置建议全部选 No 或 Skip。这些均可在安装完成后的图形化界面中灵活调整。

访问方式：最后一个问题请选择 Open the Web UI。系统将自动启动默认浏览器并进入可视化看板。

五、OpenClaw 的控制台（Dashboard）。

对话测试： 点击左侧导航栏的 “Chat”，在对话框中输入任意问候语。如果 AI 能流畅回复，说明模型连接成功。

Agent 能力测试： 为了验证其操作系统的能力，可以发送指令：

“请在桌面上创建一个名为‘测试’的文件夹。”

如果文件夹成功创建，说明 OpenClaw 已具备本地文件系统的读写权限，部署圆满完成。

安全提示：请务必注意，AI Agent 具有实际操作电脑的权限。在日常使用中，建议限制其工作目录（Workspace），防止误删重要文件。

六、常见问题排查

在部署过程中，新手最容易遇到以下两个阻碍：

1、API Key 粘贴问题：

现象： 在 Windows 终端中按 Ctrl+V 无法粘贴 Key。

解决： 复制 Key 后，在终端窗口内点击鼠标右键，通常即可完成粘贴。请务必检查 Key 是否完整，避免多余空格。

2、服务重启与连接丢失：

现象： 关闭终端后网页无法连接。

解决： 若服务意外终止，请勿直接刷新网页。需重新打开终端输入ctrl c回车，然后openclaw gatewayc重启服务，最后 openclaw dashboard 命令来唤醒控制台。

3、API KEY找不到

现象：截止2.25日新版本的openclaw它不再允许把所有东西都塞进 openclaw.json 主配置文件里了

在 openclaw.json 里写了 secret: “sk-…”，启动时直接报错 Config invalid（配置非法）。

用命令行 openclaw config set 设置了 key，启动后依然报红字 Error: No API key found。

解决方案：

不要改主文件，而是创建一个独立的 auth-profiles.json 文件。

关键路径：文件必须放在 C:\Users\用户名\.openclaw\agents\main\agent\ 下（而不是根目录）。

内容格式：{ “zai:default”: { “secret”: “sk-你的Key” } }

4、CLI 命令报错

现象：新版本锁死了配置结构，不允许通过命令行随意注入深层嵌套的参数

输入 openclaw config set agents.main.identity… 时，报错 Unrecognized key。

解决方案：

放弃命令行配置。

直接用记事本修改 C:\Users\10630\.openclaw\openclaw.json，手动编辑 JSON 结构。