快速入门

一、环境准备

系统要求：

• Windows 10/11 或 macOS 10.15+ 或 Linux
• Node.js 18.0.0 或更高版本
• Git（可选，用于版本控制）

二、安装步骤

1. 安装 OpenClaw

打开终端或命令提示符，执行以下命令：

npm install -g openclaw

2. 验证安装

安装完成后，检查版本号确认安装成功：

openclaw --version

3. 初始化配置

运行初始化命令，创建配置文件：

openclaw init

三、启动网关

前台运行（推荐新手）：

openclaw gateway

后台运行：

openclaw gateway start

停止网关：

openclaw gateway stop

重启网关：

openclaw gateway restart

四、基本配置

1. 配置AI模型

查看可用模型：

openclaw models list

设置默认模型：

openclaw models set deepseek

2. 配置API Key

编辑配置文件（通常位于 ~/.openclaw/config.json）：

{
  "models": {
    "deepseek": {
      "apiKey": "你的DeepSeek API Key",
      "baseUrl": "https://api.deepseek.com/v1"
    }
  }
}

五、首次使用

1. 连接到聊天平台

根据你使用的平台，配置相应的连接：

• 飞书：参考飞书插件安装教程
• 微信：配置微信机器人
• Telegram：配置Telegram Bot

2. 发送第一条消息

在配置好的聊天平台中，向你的OpenClaw助手发送消息：

你好，OpenClaw！

3. 测试基本功能

尝试一些基本命令：

# 查看帮助
/help

# 查看技能列表
/skills

# 查看当前状态
/status

六、常见问题

Q: 网关启动失败怎么办？

A: 检查端口是否被占用，默认端口是3000。可以修改端口：

openclaw config set gateway.port 3001

Q: 如何更新OpenClaw？

A: 使用更新命令：

openclaw update

Q: 如何查看日志？

A: 查看网关日志：

openclaw logs

七、下一步

完成快速入门后，建议继续学习：

1. 使用指南 - 了解OpenClaw的基础概念和文件结构
2. 模型配置指南 - 配置适合你的AI模型
3. 技能安装指南 - 扩展OpenClaw的功能