OpenClaw全网最细教学：从安装部署到Skills实战与多Agent协作，1小时全精通

一、OpenClaw 是什么？

OpenClaw 是一个开源的个人 AI Agent 运行时。你可以把它理解为：

一个部署在你服务器上的 AI 大脑，通过微信、Telegram、Discord、WhatsApp 等多个渠道与你对话，并且可以执行代码、操作文件、自动化任务。

一句话总结：OpenClaw = 自建的、全平台的、可编程的 AI 助手。

二、安装（10分钟）

2.1 环境要求

服务器：任意 VPS（推荐 2C4G 起步，Debian/Ubuntu）

Node.js：v22.19+ 或 v24（推荐 v24）

API Key：至少一个模型供应商的 Key（OpenAI、Anthropic、Google Gemini 等）

2.2 一键安装

Linux / macOS：

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

Docker 方式（推荐服务器部署）：

docker pull openclaw/openclaw:latest
docker run -d --name openclaw \
  -v ~/.openclaw:/root/.openclaw \
  -p 18789:18789 \
  openclaw/openclaw:latest

2.3 初始化配置

openclaw onboard --install-daemon

向导会引导你选择模型供应商、填写 API Key、配置 Gateway，约 2 分钟即可完成。

2.4 连接第一个聊天渠道

最快接入 Telegram（只需一个 Bot Token）：

# 找 @BotFather 创建Bot，拿到Token
openclaw channels login --channel telegram

支持 Telegram、Discord、WhatsApp、Signal、Slack、微信、飞书、iMessage 等 20 多个平台。

三、核心概念（5分钟）

Gateway（网关）

Gateway 是 OpenClaw 的大脑中枢，负责维护所有渠道连接、处理消息路由、管理 Agent 生命周期。一个服务器只需运行一个 Gateway。

Agent（智能体）

Agent 是一个完整的 AI 人格，包含工作区、独立认证、独立会话。默认只有一个 main，但你可以创建多个 Agent。

Skills（技能）

Skills 是教会 Agent 使用特定工具的方式。每个 Skill 是一个目录，里面有 SKILL.md 告诉 Agent 什么时候触发、怎么使用。

Workspace（工作区）

Agent 的“家目录”，存放 AGENTS.md（行为）、SOUL.md（人格）、USER.md（用户）、MEMORY.md（记忆）。

四、Skills实战（20分钟）

4.1 创建第一个Skill：服务器健康检查

第一步：创建目录

mkdir -p ~/.openclaw/workspace/skills/healthcheck

第二步：编写 SKILL.md

---
name: healthcheck
description: 检查服务器健康状态
---

# 服务器健康检查

当用户要求检查服务器状态时：

1. 系统信息：uname -a
2. CPU使用率：top -bn1 | head -20
3. 内存使用：free -h
4. 磁盘使用：df -h
5. Docker容器：docker ps
6. 系统负载：uptime

用中文整理，超过80%标红提示。

第三步：对 Agent 说“帮我做服务器健康检查”，它就会自动执行并生成报告。

4.2 Skill 存放位置

<workspace>/skills/ — 最高优先级

~/.openclaw/skills/ — 所有 Agent 共享

内置 Skills — OpenClaw 自带

4.3 条件加载

---
name: docker-manager
metadata:
  openclaw:
    requires:
      bins: [docker]
---

该 Skill 只在有 Docker 的服务器上加载。

4.4 Agent级技能控制

{
  "agents": {
    "defaults": { "skills": ["healthcheck"] },
    "list": [
      { "id": "main" },
      { "id": "writer", "skills": ["wp-publish"] },
      { "id": "locked", "skills": [] }
    ]
  }
}

五、多Agent协作（15分钟）

5.1 为什么需要多Agent？

日常助手：使用便宜模型，负责闲聊、查天气

深度工作 Agent：使用强力模型，负责代码、写作

家庭 Agent：权限受限，只查信息

客服 Agent：接入客户群，自动回答

多 Agent 共享一台服务器，但人格、记忆、权限完全隔离。

5.2 创建多Agent

openclaw agents add work
openclaw agents add family

5.3 独立人格

工作 Agent：直接高效，不废话，优先给命令

家庭 Agent：温暖耐心，解释清楚，适合非技术人员

5.4 消息路由（Bindings）

{
  "bindings": [
    { "agentId": "work", "match": { "channel": "telegram" } },
    { "agentId": "main", "match": { "channel": "openclaw-weixin" } },
    { "agentId": "family",
      "match": { "channel": "whatsapp",
        "peer": { "kind": "group", "id": "[email protected]" } } }
  ]
}

优先级：精确匹配 → 父级匹配 → Guild → Account → Channel → 默认

5.5 实战架构

{
  "agents": { "list": [
    { "id": "main", "model": "openai/gpt-5.5" },
    { "id": "coder", "model": "anthropic/claude-opus-4-6" },
    { "id": "seo", "model": "google/gemini-2.5-pro" }
  ]},
  "bindings": [
    { "agentId": "main", "match": { "channel": "openclaw-weixin" } },
    { "agentId": "coder", "match": { "channel": "telegram" } },
    { "agentId": "seo", "match": { "channel": "telegram" } }
  ]
}

三个 Agent 共享一台服务器，各司其职，互不干扰。

六、常用命令速查

# Gateway 管理
openclaw gateway status    # 查看状态
openclaw gateway restart   # 重启
openclaw gateway logs      # 日志

# Agent 管理
openclaw agents list --bindings
openclaw agents add <id>
openclaw skills list

# 聊天内命令
/new       开新会话
/compact   压缩上下文
/status    会话状态

OpenClaw 官方文档：docs.openclaw.ai

GitHub：github.com/openclaw/openclaw