新版的OpenClaw使用教程

📋 目录

1. 简介
2. 系统要求
3. 快速安装
4. 首次设置
5. 核心功能
6. 通道配置
7. 网关配置
8. 工具和技能
9. 高级功能
10. 故障排除

📖 简介

OpenClaw 是一个强大的 AI 助手平台，可以连接到各种聊天平台，提供丰富的工具和技能，帮助您自动化工作流程。本教程将帮助您快速掌握 OpenClaw 的核心功能和使用方法。

🖥️ 系统要求

• Node.js 22.22.3+, 24.15+, 或 25.9+ (Node 24 是推荐默认版本)
• macOS, Linux, 或 Windows (Windows 用户可以使用原生 Windows Hub 应用、PowerShell CLI 安装器或 WSL2 Gateway)
• API 密钥（来自 Anthropic、OpenAI、Google 等模型提供商）

⚡ 快速安装

macOS / Linux / WSL2

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

Windows (PowerShell)

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

验证安装

openclaw --version      # 确认 CLI 可用
openclaw doctor         # 检查配置问题
openclaw gateway status # 验证网关正在运行

🚀 首次设置

运行引导程序

openclaw onboard --install-daemon

引导程序会引导您选择模型提供商、设置 API 密钥，并配置网关。快速启动通常只需几分钟，但提供商登录、通道配对、守护程序安装、网络下载、技能或可选插件可能会使完整引导程序花费更长时间。

验证网关状态

openclaw gateway status

您应该看到网关在端口 18789 上监听。

打开仪表板

openclaw dashboard

这会在浏览器中打开控制 UI。如果加载成功，一切正常。

发送第一条消息

在控制 UI 聊天中输入消息，您应该会收到 AI 回复。

🔧 核心功能

1. 通道连接

OpenClaw 可以连接到您已经使用的任何聊天应用：

• Telegram（最快设置，只需简单的机器人令牌）
• WhatsApp（需要 QR 配对，在磁盘上存储更多状态）
• Discord
• Feishu
• iMessage（内置在核心中）
• Telegram（内置在核心中）
• 以及更多...

2. 模型配置

设置主要模型和可选回退：

{
  agents: {
    defaults: {
      model: {
        primary: "anthropic/claude-sonnet-4-6",
        fallbacks: ["openai/gpt-5.4"],
      },
      models: {
        "anthropic/claude-sonnet-4-6": { alias: "Sonnet" },
        "openai/gpt-5.4": { alias: "GPT" },
      },
    },
  },
}

3. 消息控制

控制谁可以给机器人发消息：

• pairing：未知发件人获得一次性配对代码进行批准
• allowlist：只有 allowFrom 中的发件人（或配对的允许存储）
• open：允许所有入站 DM（需要 allowFrom: ["*"]）
• disabled：忽略所有 DM

📡 通道配置

OpenClaw 支持多种聊天平台：

• Discord - Discord Bot API + 网关；支持服务器、频道和 DM
• Feishu - Feishu/Lark 机器人通过 WebSocket
• Telegram - 内置在核心中。Bot API 通过 grammY；支持群组
• WhatsApp - 最受欢迎；使用 Baileys 并需要 QR 配对
• iMessage - 内置在核心中。原生 macOS 集成
• Slack - Bolt SDK；工作区应用
• Microsoft Teams - Bot Framework；企业支持
• Signal - signal-cli；注重隐私
• Matrix - Matrix 协议
• IRC - 经典 IRC 服务器
• LINE - LINE Messaging API 机器人
• Mattermost - Bot API + WebSocket；频道、群组和 DM

每个通道都有其自己的配置部分：channels.<provider>

⚙️ 网关配置

OpenClaw 从 ~/.openclaw/openclaw.json 读取可选的 JSON5 配置文件。如果文件缺失，OpenClaw 使用安全默认值。

常见配置任务

设置通道

{
  channels: {
    telegram: {
      enabled: true,
      botToken: "123:abc",
      dmPolicy: "pairing",
      allowFrom: ["tg:123"],
    },
  },
}

配置会话和重置

{
  session: {
    dmScope: "per-channel-peer",
    threadBindings: {
      enabled: true,
      idleHours: 24,
      maxAgeHours: 0,
    },
    reset: {
      mode: "daily",
      atHour: 4,
      idleMinutes: 120,
    },
  },
}

启用沙箱

{
  agents: {
    defaults: {
      sandbox: {
        mode: "non-main",
        scope: "agent",
      },
    },
  },
}

🛠️ 工具和技能

内置工具类别

选择工具、技能或插件

• 工具：当代理需要执行操作时使用（如 exec, browser, web_search）
• 技能：当代理需要指令时使用（如工作流、审查标准）
• 插件：当 OpenClaw 需要新功能时使用（如工具、技能、通道、模型提供商）

🔍 高级功能

1. 心跳（定期检查）

{
  agents: {
    defaults: {
      heartbeat: {
        every: "30m",
        target: "last",
      },
    },
  },
}

2. Cron 作业

{
  cron: {
    enabled: true,
    maxConcurrentRuns: 8,
    sessionRetention: "24h",
  },
}

3. Webhooks

{
  hooks: {
    enabled: true,
    token: "shared-secret",
    path: "/hooks",
  },
}

4. 子代理

sessions_spawn(task="处理复杂任务", taskName="subagent-task")

🛠️ 故障排除

常见问题

1. openclaw 未找到：通常是 PATH 问题

   node -v           # Node 已安装？
   npm prefix -g     # 全局包在哪里？
   echo "$PATH"      # 全局 bin 目录在 PATH 中吗？

2. 网关无法启动：检查配置验证

   openclaw doctor   # 查看确切问题
   openclaw doctor --fix  # 应用修复

3. 通道问题：检查通道特定配置和权限

获取帮助

• 查看官方文档：https://docs.openclaw.ai
• 使用 openclaw doctor 进行诊断
• 检查日志：openclaw logs

📚 相关资源

• 官方文档
• 安装指南
• 通道配置
• 网关配置
• 工具和技能

祝您使用 OpenClaw 愉快！如有任何问题，请随时咨询。