安装指南

安装 OpenClaw

5 分钟完成安装，立刻用 AI 对话驾驭链上世界。按照以下步骤在你的机器上运行 OpenClaw。

安装进度0/6 步

系统要求

操作系统	macOS 12+、Windows 10/11、Linux (Ubuntu 20.04+)
Node.js	v20 或更高（推荐 v22 LTS）
npm	v9+（随 Node.js 一起安装）
磁盘空间	至少 500 MB 可用空间
网络	需要访问 npm 仓库和 AI API 服务

安装步骤

安装 Node.js

OpenClaw 基于 Node.js 运行，请先确保已安装 v20 或更高版本。如果已安装，可跳过此步。

bash

# 方式一：使用 Homebrew 安装（推荐）
brew install node@22

# 方式二：从官网下载安装包
# 前往 https://nodejs.org 下载 macOS 安装包，双击安装

# 验证安装
node --version   # 应显示 v20.x 或更高
npm --version

Tip:没装 Homebrew？先执行：/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

安装 OpenClaw

提供三种安装方式，根据你的熟悉程度选择。

bash

# macOS / Linux
curl -fsSL https://openclaw.ai/install.sh | bash

# Windows（以管理员身份打开 PowerShell）
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
irm https://openclaw.ai/install.ps1 | iex

Tip:一键脚本会自动检测系统环境并完成所有配置，全程无需手动操作。

初始化配置

运行引导程序，OpenClaw 会以对话方式逐步引导你完成鉴权、AI 模型、通信渠道等所有配置，全程无需手动编辑文件。

bash

# 运行初始化向导（推荐加 --install-daemon 实现开机自启）
openclaw onboard --install-daemon

# 向导会依次引导你完成以下配置：
#
# ① 鉴权设置
#    设置 Gateway Token 或 Password，保护你的 API 接口
#    → 新手建议选择 Password，设置一个容易记住的密码即可
#
# ② AI 模型提供商
#    选择并配置你的 LLM 服务，支持：
#    - Anthropic (Claude)
#    - OpenAI (GPT)
#    - 智谱 AI (GLM)
#    - DeepSeek
#    - 其他兼容 OpenAI 格式的服务
#    → 输入对应的 API Key 即可完成配置
#
# ③ 通信渠道（可选，新手可跳过）
#    连接 Telegram、WhatsApp 等平台
#    → 新手直接回车跳过，后续可随时添加
#
# ④ 系统服务
#    --install-daemon 会自动注册为系统服务
#    → 电脑重启后 OpenClaw 会自动运行

Tips

-Anthropic：console.anthropic.com → API Keys → Create Key
-OpenAI：platform.openai.com → API Keys → Create new secret key
-智谱 AI：open.bigmodel.cn → API Keys（国内访问友好，无需翻墙）
-DeepSeek：platform.deepseek.com → API Keys（高性价比）
-配置完成后可随时通过 openclaw onboard 重新进入向导修改

API Key 会加密保存在本地，不会上传到任何服务器。请勿将 Key 分享给他人。

初始化项目（可选）

如果你想在特定项目中使用 OpenClaw，可以在项目目录运行 init 生成配置文件，让 AI 更了解你的项目上下文。

bash

# 进入你的工作目录
cd ~/my-project

# 初始化项目配置（会创建 CLAUDE.md 文件）
openclaw init

Tips

-CLAUDE.md 是项目的"说明书"，OpenClaw 每次启动时都会读取
-可以在其中写入项目结构、编码规范、常用命令等信息
-不初始化也能使用 OpenClaw，只是 AI 不了解你的项目上下文

安装 Skills（可选）

Skills 是 OpenClaw 的能力扩展包，让 AI 能调用外部 API、执行链上操作等。新手可以先跳过，熟悉后再按需安装。

bash

# 安装一个 Skill（传入 GitHub 仓库地址）
npx skills add https://github.com/owner/skill-repo

# 查看已安装的 Skills
openclaw skills list

# 更新所有 Skills
openclaw skills update

# 移除一个 Skill
openclaw skills remove skill-name

每个 Skill 包含一个 SKILL.md 文件，定义了 AI 的行为规范和可调用的 API 接口。浏览 Skills 目录了解更多。

启动 OpenClaw

一切就绪！启动 OpenClaw，通过 Web 控制台或终端界面与 AI 对话。

bash

# 方式一：后台启动网关（推荐，不占用终端）
openclaw gateway start

# 方式二：前台启动（适合调试，可看到实时日志）
openclaw gateway --port 18789

# 打开 Web 控制台
openclaw dashboard
# 或直接在浏览器访问：http://127.0.0.1:18789/

# 查看网关运行状态
openclaw gateway status

# 停止网关
openclaw gateway stop

Tip:如果初始化时加了 --install-daemon，网关已自动在后台运行，直接访问 http://127.0.0.1:18789/ 即可。

Tips

-默认端口为 18789，打开 http://127.0.0.1:18789/ 即可使用
-打开控制台后可以直接开始聊天，无需额外配置
-在对话框中输入 /help 查看所有可用命令
-对话记录会自动保存，刷新页面不会丢失

常见问题

下一步

📦

浏览 Skills 目录

探索可用的 Skills，为 OpenClaw 扩展新能力

ℹ️

关于

了解 OpenClaw 的设计理念与项目愿景