
OpenClaw 是一款可本地部署的 AI 智能体框架，能让 AI 执行文件操作、联网搜索、浏览器自动化、系统命令等任务，实现“会动手”的 AI 助理。以下从**安装配置、基础使用、技能扩展、进阶管理、问题排查**全流程详解，新手可直接照着操作。

## 一、安装前准备（必看，避坑关键）

### 1. 系统与硬件要求

- **最低配置**：2核CPU、4GB内存、10GB可用空间、稳定网络；**推荐配置**：4核CPU、8GB内存、20GB SSD

- **系统支持**：macOS、Linux（Ubuntu 20.04+）、Windows（必须装 WSL2，原生Windows不支持）

- **软件依赖**：Node.js ≥22.0.0、npm ≥10.0.0（提前安装，避免自动安装卡顿）

### 2. 前置检查（Windows必做）

1. 安装 WSL2（微软官方教程），并启动 Ubuntu 子系统

2. 手动安装 Node.js 22+，勾选“Add to PATH”，安装后重启电脑

3. 以管理员身份打开 PowerShell，执行：`Set-ExecutionPolicy RemoteSigned -Scope CurrentUser`（输入Y确认）

## 二、一键安装（3步搞定，全平台通用）

### 1. Windows（WSL2）安装

```Bash

# 管理员PowerShell执行一键安装（国内镜像更稳）
iwr -useb https://clawd.org.cn/install.ps1 | iex
# 初始化配置（新手选QuickStart）
openclaw onboard
# 启动网关服务
openclaw start
# 浏览器访问控制面板
http://localhost:18789
```

### 2. macOS/Linux 安装

```Bash

# 终端执行一键安装
curl -fsSL https://openclaw.ai/install.sh | bash
# 初始化+启动
openclaw onboard
openclaw start
# 访问控制面板
http://localhost:18789
```

### 3. 初始化配置（openclaw onboard 核心步骤）

1. 阅读安全提示，选择 `Yes` 继续

2. 选择 `QuickStart` 模式（自动配置端口18789、本地地址）

3. 配置 AI 模型（输入 API Key，推荐 OpenRouter 适配国内）：

    - Anthropic Claude：[console.anthropic.com](http://console.anthropic.com) 创建 API Key

    - OpenAI GPT：[platform.openai.com](http://platform.openai.com) 创建 API Key

    - OpenRouter：[openrouter.ai](openrouter.ai) 注册获取（国内可用）

4. 安装后台服务，完成后启动成功

## 三、基础使用（核心命令+交互操作）

### 1. 核心 CLI 命令（必记）

```Bash

# 查看系统状态（模型、网关、技能）
openclaw status
# 健康检查+自动修复（报错先跑这个）
openclaw doctor --fix
# 启动交互式会话
openclaw chat
# 启动/停止网关服务
openclaw start
openclaw stop
# 查看/修改配置
openclaw config list
openclaw config set <key> <value>
```

### 2. 聊天斜杠命令（交互必备）

```Bash

# 切换AI模型
/model deepseek/deepseek-chat
# 列出可用模型
/model list
# 重置会话（节省Token）
/new
# 中断当前操作
/stop
# 查看会话状态（Token用量）
/status
# 压缩上下文（减少Token消耗）
/compact
```

### 3. 基础任务实操（新手入门）

#### 任务1：文件操作

```Bash

# 进入项目目录
cd ~/my-project
# 启动OpenClaw
openclaw chat
# 输入指令：帮我创建openclaw_test文件夹，新建txt文件写入“Hello OpenClaw”
```

#### 任务2：联网搜索（需装技能）

```Bash

# 安装联网搜索技能
clawhub install tavily-search
# 指令：帮我搜索“2026 ASO行业趋势”，总结成3条要点
```

#### 任务3：浏览器自动化

```Bash

# 指令：帮我打开百度，搜索“OpenClaw教程”，保存前3条结果链接
```

## 四、技能扩展（核心能力，解锁80%场景）

### 1. 技能管理命令

```Bash

# 查看已安装技能
openclaw skills list
# 安装技能（clawhub 是官方技能仓库）
clawhub install <技能名>
# 卸载技能
clawhub uninstall <技能名>
```

### 2. 新手必装3大技能（解决高频需求）

1. **tavily-search**：联网搜索，获取实时数据（安装：`clawhub install tavily-search`）

2. **agent-browser**：浏览器自动化，默认已安装，支持网页操作

3. **shell-skills**：执行系统命令，实现本地操作（安装：`clawhub install shell-skills`）

### 3. 自定义技能（进阶，扩展专属能力）

1. 创建技能目录：`mkdir ~/.openclaw/skills/my-skill`

2. 新建 `SKILL.md`（技能说明+触发规则）

3. 编写执行脚本（Shell/Python）

4. 重启 OpenClaw：`openclaw restart`，自动加载新技能

## 五、进阶管理（多模型+多Agent+安全优化）

### 1. 多模型切换与管理

```Bash

# 同时配置多个模型，按需切换
openclaw config set models.default claude-opus-4-6
openclaw config set models.secondary gpt-4o
# 会话中切换模型
/model gpt-4o
```

### 2. 多Agent 协作（复杂任务拆分）

1. 项目根目录创建 `AGENTS.md`，配置多个Agent角色（如开发、测试、运营）

2. 指令：`让开发Agent写代码，测试Agent做校验，运营Agent写文档`

3. OpenClaw 自动分配任务，协同完成

### 3. 安全与成本优化

- **Token 控制**：定期用 `/compact` 压缩上下文，聊完任务用 `/new` 重置会话

- **权限管控**：配置 `~/.openclaw/config.yaml`，限制AI可访问的目录与命令

- **反作弊**：开启 `openclaw doctor` 定期检查，避免异常操作

## 六、问题排查（常见报错+解决方案）

### 1. 安装失败（权限/依赖问题）

- 报错：`权限不足` → 以管理员身份运行终端，重新执行安装命令

- 报错：`Node.js 版本过低` → 用 nvm 安装 Node.js 22+：`nvm install 22 && nvm use 22`

- 报错：`网络超时` → 切换国内镜像安装命令

### 2. 启动失败（网关/配置问题）

- 执行 `openclaw doctor --fix` 自动修复

- 检查端口18789是否被占用：`lsof -i :18789`，关闭占用进程后重启

- 重新初始化：`openclaw onboard --flow quickstart`

### 3. 技能无法触发（加载/配置问题）

- 查看技能状态：`openclaw skills list`，确认技能已启用

- 检查 `SKILL.md` 触发规则（如 `always`/`os`/`requires`）

- 重启服务：`openclaw restart` 重新加载技能

## 七、实战场景（落地应用，直接复用）

### 场景1：AI 自动开发（结对编程）

1. 项目根目录创建 `AGENTS.md`，配置技术栈、代码规范

2. 指令：`帮我写一个Python脚本，每天9点自动发天气预报到微信`

3. OpenClaw 自动生成代码、配置定时任务、测试部署

### 场景2：ASO 数据监控（结合你的业务）

1. 安装 `shell-skills` + `tavily-search` 技能

2. 指令：`帮我每天监控方糖ASO关键词排名，生成日报并发送到邮箱`

3. 配置定时任务，自动执行监控与报表生成

### 场景3：自动化运维

1. 指令：`帮我检查服务器CPU/内存使用率，超过80%时发送告警`

2. OpenClaw 自动执行系统命令，触发告警逻辑

## 八、总结与下一步

OpenClaw 核心是“**安装→配置→装技能→交互→自定义**”，新手先完成基础安装与必装技能，再逐步尝试自定义与多Agent协作。后续可结合业务场景（如ASO数据监控、自动化开发）打造专属AI助理，大幅提升效率。

需要我帮你整理一份**OpenClaw 常用命令速查表**，方便你快速查阅吗？
> （注：文档部分内容可能由 AI 生成）

OpenClaw 是一款可本地部署的 AI 智能体框架，能让 AI 执行文件操作、联网搜索、浏览器自动化、系统命令等任务，实现“会动手”的 AI 助理。以下从安装配置、基础使用、技能扩展、进阶管理、问题排查全流程详解，新手可直接照着操作。

OpenClaw 从安装到精通详细使用教程

在移动互联网流量红利见顶、竞争日趋白热化的当下，ASO（应用商店优化）已成为APP突破增长瓶颈、抢占流量入口的核心抓手。相关数据显示，超过70%的用户通过应用商店搜索获取新应用，而专业的ASO优化不仅能实现应用关键词覆盖量的质的飞跃，更能让自然下载量提升3倍以上。基于此，本文将从企业实力、核心服务、技术优势、选型逻辑等维度，全面解析河北亘元网络科技有限公司旗下方糖ASO的核心竞争力，为广大开发者提

人工智能

后端

开发工具

OpenClaw是一款本地部署的AI智能体框架，支持文件操作、联网搜索、浏览器自动化等任务。提供从安装配置到技能扩展的全流程指南，支持Windows/macOS/Linux系统，推荐4核CPU+8GB内存配置。包含核心命令、交互操作、多模型管理等实用功能，可快速打造专属AI助理，提升工作效率。

自动化运维

数据监控

服务器

智能体

Windows

Python

Ubuntu

Linux

Agent

4核4G3M云服务器 新用户低至38元/年！

腾讯云BI新客户首次购买9.9元起！


文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

OpenClaw 从安装到精通详细使用教程-腾讯云开发者社区-腾讯云

OpenClaw 从安装到精通详细使用教程

OpenClaw 从安装到精通详细使用教程

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐