OpenClaw 完全入门指南

1. 什么是 OpenClaw

OpenClaw 是一个开源的 AI 助手框架，让你能够构建个性化的智能助手，连接各种服务和工具，自动化日常工作流。

与其他 AI 工具不同，OpenClaw 的核心设计理念是：

• 本地优先：你的数据和配置都存储在本地，完全掌控
• 模块化扩展：通过 Skill 系统轻松扩展功能
• 多平台整合：连接 Telegram、Discord、飞书等消息平台
• 多模型支持：支持 Kimi、Claude、GPT 等多种 AI 模型

2. 为什么要用 OpenClaw

对比其他 AI 工具

适用场景

• 个人效率提升：自动化重复任务，管理日程和知识
• 团队协作：多平台消息整合，智能客服
• 开发辅助：代码生成、文档整理、PR Review
• 内容创作：SEO 优化、文章生成、多平台发布

3. OpenClaw 架构概览

理解 OpenClaw 的架构有助于更好地使用它：

┌─────────────────────────────────────────────────────────────┐
│                         OpenClaw 架构                        │
├─────────────────────────────────────────────────────────────┤
│  ┌──────────┐  ┌──────────┐  ┌──────────┐  ┌──────────┐   │
│  │ Telegram │  │ Discord  │  │  飞书    │  │  其他    │   │
│  └────┬─────┘  └────┬─────┘  └────┬─────┘  └────┬─────┘   │
│       │             │             │             │          │
│       └─────────────┴─────────────┴─────────────┘          │
│                         │                                   │
│              ┌──────────▼──────────┐                       │
│              │    Gateway 网关     │ ← WebSocket 核心      │
│              └──────────┬──────────┘                       │
│                         │                                   │
│       ┌─────────────────┼─────────────────┐                │
│       ▼                 ▼                 ▼                │
│  ┌─────────┐      ┌─────────┐      ┌─────────┐            │
│  │  Agent  │      │  Skills │      │  Models │            │
│  │  主代理  │      │  技能库 │      │  模型池 │            │
│  └─────────┘      └─────────┘      └─────────┘            │
└─────────────────────────────────────────────────────────────┘

• Gateway：WebSocket 网关，处理所有连接和消息路由
• Agent：核心 AI 代理，处理对话和任务调度
• Skills：可插拔的技能模块，扩展功能
• Models：AI 模型配置，支持多个 Provider

4. 安装 OpenClaw

环境要求

• Node.js 18+（推荐 20 LTS）
• Git
• Python 3.9+（部分 Skill 需要）

快速安装

使用 npm 全局安装：

npm install -g openclaw

验证安装：

openclaw --version # 输出类似：🦞 OpenClaw 2026.3.2

5. 首次配置

Step 1: 初始化工作空间

openclaw setup

这会创建：

• ~/.openclaw/ 配置目录
• ~/.openclaw/workspace/ 工作空间
• 初始配置文件

Step 2: 配置 AI 模型

编辑 ~/.openclaw/openclaw.json，添加你的 API Key：

{
  "models": {
    "mode": "merge",
    "providers": {
      "kimi-coding": {
        "baseUrl": "https://api.kimi.com/coding/",
        "api": "anthropic-messages",
        "models": [{
          "id": "k2p5",
          "name": "Kimi for Coding"
        }]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "kimi-coding/k2p5"
      }
    }
  }
}

Step 3: 启动 Gateway

openclaw gateway

看到类似输出表示成功：

🦞 OpenClaw Gateway running on ws://127.0.0.1:18789

6. 你的第一个 Skill

安装一个实用 Skill —— 天气查询：

# 安装 clawhub CLI npm install -g clawhub # 搜索天气 Skill clawhub search weather # 安装 clawhub install weather --workdir ~/.openclaw

现在你可以在对话中使用：

你：北京今天天气怎么样？ AI：🌤️ 北京今天多云，温度 15-22°C...

7. 常用命令

8. 下一步

恭喜！你已经完成了 OpenClaw 的基础搭建。接下来可以：

1. 深入了解配置详解
2. 配置 Pi + Kimi 编程助手
3. 开发你的第一个 Skill
4. 探索推荐 Skill