OpenClaw 是 2026 年开源社区爆火的 AI 执行网关，核心是本地优先、模型无关、自主执行，区别于传统聊天 AI，它能直接调用系统权限、操作文件、运行脚本、对接 50 + 通讯工具，真正实现 “一句话让 AI 替你干活”。本文帮你快速入门这款现象级 AI 工具。

一、OpenClaw 核心认知（新手必看）

1.1 核心定位与优势

OpenClaw 是自托管的 AI 执行中枢，连接大模型、通讯渠道与本地系统，实现无代码 / 低代码本地自动化，核心优势如下：

• 本地优先，隐私可控：所有数据、执行、记忆全在本地，AES-256 加密存储，不强制上传云端，支持断网使用。
• 模型无关：兼容 GPT、Claude、通义千问、Ollama 本地模型等，可自由切换甚至混搭。
• 全场景执行：能操作文件、运行终端命令、编写脚本、对接微信 / 飞书 / Discord 等，实现跨应用自动化。
• 持久记忆：以 Markdown 存储会话与偏好，跨会话记忆，越用越贴合你的习惯。

1.2 与传统 AI 的核心区别

表格

对比维度	传统聊天 AI（ChatGPT 等）	OpenClaw
运行模式	云端对话，仅输出文本	本地运行，拥有系统执行权限
能力边界	局限在 APP / 浏览器内	打通 50 + 工具，全场景联动
隐私安全	数据上传云端，不可控	本地存储，密钥用户自主保管
核心价值	提供建议与回答	直接完成真实操作，自动化任务

二、前置准备（环境搭建，零门槛）

2.1 系统与依赖要求

• 系统支持：Windows、macOS、Linux（含树莓派、NAS），推荐 macOS/Linux（部署更顺畅）。
• 基础依赖：
  • Python 3.10+（OpenClaw 官方推荐，避免版本冲突）
  • Node.js 18+（部分技能依赖）
  • Git（用于克隆项目）

2.2 安装基础依赖（终端一键执行）

# 1. 安装Python（已安装可跳过）
# macOS：brew install python@3.11
# Windows：官网下载 https://www.python.org/downloads/ 勾选Add to PATH

# 2. 安装Node.js
# macOS：brew install node@18
# Windows：官网下载 https://nodejs.org/ 选择LTS版本

# 3. 安装Git
# macOS：brew install git
# Windows：官网下载 https://git-scm.com/

2.3 验证依赖安装

python3 --version  # 输出3.10+
node --version     # 输出18+
git --version      # 输出Git版本

三、实战部署：本地安装 OpenClaw

3.1 克隆官方仓库

# 克隆OpenClaw主仓库
git clone https://github.com/openclaw/openclaw.git
# 进入项目目录
cd openclaw

3.2 一键安装

# macOS/Linux
./install.sh

# Windows（PowerShell以管理员身份运行）
.\install.ps1

3.3 初始化配置

安装完成后，执行初始化命令，按提示配置：

openclaw init

配置核心项：

1. 选择大模型提供商：输入你使用的模型（如 openai、anthropic、ollama）。
2. 填写 API Key：输入对应模型的 API Key（本地 Ollama 可跳过）。
3. 设置通讯渠道：选择你常用的工具（如 telegram、wechat，新手先选 none，后续再配置）。
4. 设置本地存储路径：默认~/.openclaw/，直接回车即可。

3.4 启动 OpenClaw 服务

# 启动网关服务（后台运行）
openclaw gateway start

# 查看服务状态
openclaw gateway status

出现 “Gateway is running” 即启动成功，此时 OpenClaw 已在本地运行。

四、基础使用：让 AI 替你干活（新手入门指令）

4.1 命令行交互（最基础方式）

终端输入openclaw chat进入交互模式，直接发送自然语言指令：

openclaw chat

示例指令（直接复制使用）

• 文件管理：帮我把 Downloads 文件夹里的所有 PDF 文件移动到 Documents/PDF 目录
• 系统操作：查看当前系统的 CPU 和内存使用情况
• 脚本编写：写一个 Python 脚本，批量重命名当前目录下的图片文件
• 信息查询：查询今天重庆的天气，并保存到本地 txt 文件

4.2 技能安装（扩展能力）

OpenClaw 通过 “技能（Skill）” 扩展功能，官方 ClawHub 有海量社区技能：

# 查看可用技能
openclaw skill list

# 安装常用技能（如浏览器自动化）
openclaw skill install browser

# 安装完成后重启服务
openclaw gateway restart

4.3 验证功能（新手必测）

安装浏览器技能后，测试网页操作：

openclaw chat
> 帮我打开CSDN，搜索Python爬虫教程，并截取首页截图保存到桌面

执行成功后，桌面会生成截图，证明 OpenClaw 已具备本地执行能力。

五、常见踩坑点及解决方案（新手避坑）

踩坑点 1：启动报错，提示依赖缺失

• 原因：Python/Node.js 版本不兼容，或安装过程中断
• 解决方案：
  1. 确认 Python≥3.10、Node.js≥18
  2. 重新执行安装脚本：./install.sh --force
  3. 手动安装缺失依赖：pip install -r requirements.txt

踩坑点 2：API Key 配置错误，无法调用模型

• 原因：Key 填写错误，或模型提供商选择错误
• 解决方案：
  1. 重新配置：openclaw config edit
  2. 核对 Key 与提供商（如 OpenAI 对应 openai，通义千问对应 tongyi）
  3. 本地 Ollama 模型：配置models.providers.ollama.base_url为http://localhost:11434

踩坑点 3：执行系统操作无响应

• 原因：权限不足，或技能未安装
• 解决方案：
  1. macOS/Linux：用sudo openclaw gateway start提升权限
  2. Windows：以管理员身份运行终端
  3. 确认所需技能已安装：openclaw skill list查看

踩坑点 4：通讯渠道（如微信）无法连接

• 原因：渠道配置错误，或需要额外授权
• 解决方案：
  1. 重新配置渠道：openclaw config edit，按官方文档填写参数
  2. 新手先从命令行交互入手，熟悉后再配置通讯渠道
  3. 参考官方文档：https://docs.openclaw.ai/channels

七、总结

本文从零开始，带你完成 OpenClaw 的本地部署、基础配置与功能验证，全程可复制、可复现，新手也能快速上手这款能 “动手干活” 的 AI 智能体。OpenClaw 的核心价值是让 AI 从对话走向执行，本地部署既保障隐私，又能深度整合你的工作流，是个人与团队自动化的利器。