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，但你可以创建多个。

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]
---

只在有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：接入客户群，自动回答

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

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": "xxx@g.us" } } }
  ]
}

优先级：精确匹配 → 父级匹配 → 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    会话状态