夜雨聆风本章将带你全面了解 OpenClaw是什么，它能做什么，以及如何快速部署到你的电脑上。
1.1 什么是 OpenClaw
背景介绍
OpenClaw（原名 ClawdBot、Moltbot）是 2026 年最火的开源 AI Agent 项目，GitHub 已获得超过 306K ✨。
它不是普通的聊天机器人，而是一个真正能够执行任务的个人 AI 助理。
核心能力
OpenClaw 与传统 AI 助手的本质区别：
能力 | 传统 AI（如 ChatGPT） | OpenClaw |
执行能力 | 只会给建议 | 真的帮你做事 |
数据存储 | 云端 | 本地存储，隐私相对安全 |
平台支持 | 单一入口 | 20+ 平台消息聚合 |
记忆能力 | 每次重新开始 | 跨会话持久记忆 |
简单来说：
你让传统 AI "帮我整理桌面文件"，它会告诉你"建议这样做：1. 创建文件夹..."
你让 OpenClaw 来做，它会直接重命名、分类、移动文件，"已完成！我把 203 个文件按类型整理到 5 个文件夹中。"
这就是"聊天机器人"和"AI Agent"的本质区别。
应用场景
OpenClaw 可以帮助你完成：
📧 邮件管理：自动分类、回复邮件
📅 日程管理：创建会议、设置提醒
📁 文件整理：自动整理桌面、分类文档
🌐 浏览器自动化：网页抓取、表单填写
💬 多平台消息聚合：统一管理 Telegram、Discord、飞书等
🧠 持久记忆：记住你的偏好，越用越懂你
1.2 安装前准备
在安装 OpenClaw 之前，你需要准备好以下环境。
1.2.1 系统要求
项目 | 要求 |
操作系统 | macOS、Linux 或 Windows（需要 WSL） |
Node.js | v22 或更高版本 |
AI 模型 API Key | 智谱 或 阿里的 API 密钥 |
检查 Node.js 版本：
node --version
如果版本低于 v18，需要升级。Windows 用户建议直接下载安装包：nodejs.org
1.2.2 申请 API Key
OpenClaw 需要调用大模型来工作，你需要准备一个 API Key。
主流选择：
提供商 | 推荐场景 | 获取地址 |
阿里云百炼 | 推荐，性能强 | https://bailian.console.aliyun.com/ |
智谱大模型 | 生态成熟 | GLM-5 |
API 聚合服务 | 省钱，新用户有免费额度 | 硅基流动等 |
💡 提示：新用户通常有免费额度，可以先体验再付费。
1.2.3 必要软件
根据你的操作系统，还需要准备：
软件 | 用途 | 获取方式 |
pnpm | 包管理器 |
|
Git | 版本控制 | git-scm.com |
Docker（可选） | 沙盒安全运行 | docker.com |
1.2.4 C++ 编译环境（Windows 用户）
Windows 用户需要安装 Visual Studio Build Tools 中的 C++ 开发组件：
下载并运行
vs_BuildTools.exe勾选「使用 C++ 的桌面开发」
点击安装，完成后关闭
1.3 安装与配置
1.3.1 本地安装（推荐）
OpenClaw 支持多种安装方式，推荐新手使用 NPM 安装：
方法一：NPM 安装（推荐新手）
# 全局安装 OpenClawnpm install -g openclaw# 验证安装openclaw --version
方法二：pnpm 安装
# 使用 pnpm 安装pnpm install -g openclaw# 验证安装openclaw --version
方法三：Docker 安装（推荐有经验者）
# 拉取镜像docker pull openclaw/openclaw:latest# 运行容器docker run -d --name openclaw \ -v ~/.openclaw:/root/.openclaw \ openclaw/openclaw:latest
1.3.2 初始化配置
安装完成后，需要运行初始化向导来配置 OpenClaw：
# 启动初始化向导openclaw onboard
向导会引导你完成：
选择 AI 模型提供商：Anthropic Claude / OpenAI GPT / 本地模型
输入 API Key：粘贴你申请的密钥
选择消息平台：飞书等
配置系统权限：建议先选择沙盒模式
1.3.3 启动 OpenClaw
# 启动 OpenClawopenclaw# 或者启动 Web Dashboardopenclaw dashboard
1.3.4 连接消息平台（以飞书为例）
打开 飞书开放平台
点击开发者后台 → 创建企业自建应用
填写应用名称，点击创建
获取 App ID 和 App Secret
在 OpenClaw 中配置：
openclaw config set channels.feishu.appId "YOUR_APP_ID"openclaw config set channels.feishu.appSecret "YOUR_APP_SECRET"openclaw config set channels.feishu.enabled true
1.4 核心概念
在深入使用之前，你需要理解 OpenClaw 的几个核心概念：
1.4.1 Gateway（网关）
Gateway 是 OpenClaw 与外部世界交互的方式：
类型 | 说明 |
消息网关 | Telegram、Discord、飞书、WhatsApp 等 |
API 网关 | HTTP API 接口 |
CLI 网关 | 命令行交互 |
1.4.2 Skills（技能）
Skills 是 OpenClaw 的能力扩展，类似于"插件"或"应用"：
每个 Skill 定义了一组特定任务
可以从 Clawhub 安装第三方 Skills(https://clawhub.ai/)
也可以自己编写自定义 Skills
常用 Skills：
https://skills.sh/
1.4.3 关键配置文件
OpenClaw 通过几个核心配置文件来定义 Agent 的行为和身份：
文件 | 作用 |
| 定义身份、语气和行为边界 |
| 名字、风格、emoji 设定 |
| 主人信息（偏好、习惯、职业等） |
| 工作手册（技能、工具、流程） |
| 初始设定（启动行为、欢迎语） |
配置示例：
# USER.md 示例我的名字是 [你的名字]我的工作是 [你的职业]我喜欢简洁的回复，不要太啰嗦我使用中文交流# IDENTITY.md 示例名字：小 Claw风格：活泼、友好emoji：🦊
1.4.4 Sandbox（沙箱）
沙箱模式限制 OpenClaw 的系统访问权限，保护你的电脑安全：
模式 | 说明 |
Sandbox Mode | 限制文件系统、网络、Shell 访问（推荐新手） |
Full Access Mode | 完全权限（需谨慎使用） |
官方说明：https://docs.openclaw.ai/zh-CN/gateway/security |
快速检查：
openclaw security auditopenclaw security audit --deepopenclaw security audit --fix
1.5 首次使用测试
安装完成后，你可以尝试以下命令测试 OpenClaw：
你好，介绍一下你自己
你能帮我做什么？
现在几点了？
如果一切正常，OpenClaw 会回复你的消息。
1.6 常见问题
Q1: OpenClaw 的技术要求是什么？
OpenClaw 主要面向有一定技术背景的用户。你需要：
会使用命令行
理解环境变量配置
了解 API Key 的概念
但安装过程已经大大简化，只要你能运行 npm 命令，就能使用 OpenClaw。
Q2: API 成本大概是多少？
取决于使用强度：
使用强度 | 预估成本 |
轻度（每天 10-20 次对话） | $5-10/月 |
中度（每天 50-100 次对话） | $20-30/月 |
重度（大量自动化） | $50-100/月 |
省钱技巧：
使用 API 聚合服务获取更优惠的价格
设置每日/每月使用限制
新用户通常有免费额度
Q3: OpenClaw 支持中文吗？
完全支持！OpenClaw 有中文社区维护的汉化版本，也可以直接使用英文版，它能理解和回复中文。
Q4: 可以使用本地模型吗？
可以！OpenClaw 支持通过 Ollama 连接本地模型，但本地模型的能力通常不如云端大模型。
Q4: workspace，agent，channel，skill，gateway ，机器人等等，什么关系？
一个workspace对应一个agent，一个agent对应一个channel
一个channel对应一个机器人
一个agent对应一个到多个skill
一个gateway对应一个到多个agent
