OpenClaw 快速开始指南

1

系统要求检查

💡 硬件要求

CPU: 双核以上（推荐 4 核+）
内存：4GB 最低（推荐 8GB+）
磁盘：10GB 可用空间
网络：稳定的互联网连接

💡 软件要求

Node.js 22 或更高版本
npm 9+ 或 pnpm 8+
Git（用于克隆技能）
Chrome/Chromium（浏览器自动化）


# 检查 Node.js 版本

node --version

v22.11.0 ✓



# 检查 npm 版本

npm --version

10.9.0 ✓

2

安装 OpenClaw


# 方法 1: 官方安装脚本（推荐）

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



# 方法 2: npm 全局安装

npm install -g openclaw@latest



# 或使用 pnpm（更快更节省空间）

pnpm add -g openclaw@latest


# PowerShell 安装脚本

iwr -useb https://openclaw.ai/install.ps1 | iex



# 或使用 npm

npm install -g openclaw@latest


# 拉取镜像

docker pull openclaw/gateway:latest



# 运行容器

docker run -d \

  --name openclaw \

  -p 18789:18789 \

  -v ~/.openclaw:/root/.openclaw \

  -e OPENCLAW_PASSWORD="your-password" \

  -e OPENAI_API_KEY="sk-xxx" \

  openclaw/gateway:latest

✅ 验证安装


openclaw --version

v2026.3.13 ✓

3

配置模型和渠道


# 运行交互式配置向导

openclaw onboard

该向导会引导你完成以下配置：

选择 AI 模型提供商（OpenAI/Claude/Google/阿里云等）
配置 API 密钥
选择消息渠道（命令行/钉钉/飞书/Telegram 等）
设置安全选项

⚠️ 安全提示

切勿在个人主力电脑上直接部署 OpenClaw！它具有高文件系统和命令执行权限。建议使用云服务器（如阿里云 ECS）进行部署，与本地环境隔离。

💡 手动配置 API Key


# 设置环境变量

export OPENAI_API_KEY="sk-..."

export ANTHROPIC_API_KEY="sk-ant-..."



# 或写入配置文件

echo '{"models": {"openai": {"apiKey": "sk-..."}}}' > ~/.openclaw/models.json

4

启动 Gateway


# 启动 Gateway 服务

openclaw gateway start



✓ Gateway started on port 18789

✓ Loaded 47 skills

✓ Connected to model: gpt-4o

💡 启用调试模式


# 详细日志输出

openclaw gateway --verbose



# 或设置环境变量

export OPENCLAW_LOG_LEVEL=debug

openclaw gateway

5

运行健康检查


openclaw doctor


✓ Node.js version: v22.11.0

✓ npm version: 10.9.0

✓ OpenClaw version: v2026.3.13

✓ Configuration directory: ~/.openclaw

✓ Gateway status: running (port 18789)

✓ Model connection: OK (latency: 120ms)

✓ Browser engine: Chrome 122.0.6261.94

✓ Skills loaded: 47 (bundled: 35, local: 12)

✓ Plugins enabled: 8

6

执行第一个任务


# 打开终端 UI

openclaw tui

然后在聊天界面输入：


帮我创建一个 Python 脚本，计算斐波那契数列的前 20 项，并保存到 fibonacci.py


✅ 任务完成！


我已创建 fibonacci.py 文件，内容如下：


```python

def fibonacci(n):

    """生成斐波那契数列的前 n 项"""

    if n <= 0:

        return []

    elif n == 1:

        return [0]

    

    sequence = [0, 1]

    for i in range(2, n):

        sequence.append(sequence[-1] + sequence[-2])

    return sequence



# 计算前 20 项

result = fibonacci(20)

print(result)

```



运行结果：

[0, 1, 1, 2, 3, 5, 8, 13, 21, 34, 55, 89, 144, 233, 377, 610, 987, 1597, 2584, 4181]



文件已保存到：/home/user/fibonacci.py

7

探索 ClawHub 技能市场


# 搜索技能

clawhub search github



# 安装技能

clawhub install github-advanced



# 查看已安装技能

clawhub list



# 更新所有技能

clawhub update --all

🌟 热门技能推荐

github-advanced: GitHub 全功能操作
weather-query: 实时天气查询
data-analysis: Pandas 数据分析
browser-automation: 高级浏览器控制
email-manager: 邮件自动管理

🦞 OpenClaw 快速开始

系统要求检查

安装 OpenClaw

配置模型和渠道

启动 Gateway

运行健康检查

执行第一个任务

探索 ClawHub 技能市场

🎉 恭喜！