OpenClaw 中文教程

外观

快速开始

约 1937 字大约 6 分钟

2026-03-02

🎁 新手福利

夸克网盘资源包：包含完整的安装包、配置文件、视频教程、常用技能等资源，帮助你快速上手！

👉 立即下载资源包 👈

包含内容：

  • ✅ 完整安装包（Windows/Mac/Linux）
  • ✅ 配置文件模板和示例
  • ✅ 视频教程（从安装到使用）
  • ✅ 常用技能包合集
  • ✅ 常见问题解决方案

前提条件

在开始之前，请确保你已经：

  • 完成了 OpenClaw 安装
  • 准备好至少一个 AI 模型的 API Key（如 MiniMax、Kimi、Claude 等）
  • 有一个常用的聊天平台账号（Telegram、Discord、飞书等）

第一步：运行引导向导

启动配置向导

在终端执行以下命令：

openclaw onboard --install-daemon

这个命令会：

  • 启动交互式配置向导
  • 安装守护进程（可选）
  • 创建必要的配置文件和目录

配置流程详解

1. 选择配置模式

? 选择配置模式:
  ❯ QuickStart - 快速开始（推荐新手）
    Custom - 自定义配置（高级用户）

推荐选择 QuickStart，它会引导你完成最基础的配置。

2. 配置 AI 模型

选择你要使用的 AI 模型供应商：

? 选择 AI 模型供应商:
  ❯ MiniMax M2.5(CN) - 国内可用，中文支持好
    Kimi - 月之暗面，长文本处理强
    DeepSeek - 推理能力强，代码能力出色
    Claude - Anthropic 出品（需国际网络）
    OpenAI GPT - 经典选择（需国际网络）
    Gemini - Google 出品（需国际网络）
    Ollama - 本地模型，完全离线

国内用户推荐：MiniMax 或 Kimi（无需翻墙，响应快）

3. 输入 API Key

根据选择的模型供应商，输入对应的 API Key：

? 输入 API Key: [粘贴你的 API Key]
✓ 正在验证 API Key...
✓ 认证成功！

如何获取 API Key

4. 跳过可选配置

首次配置时，建议跳过以下配置，稍后单独设置：

? 是否现在配置 Channel（渠道）? 
  ❯ 跳过，稍后配置

? 是否现在安装 Skills（技能）?
  ❯ 跳过，稍后安装

? 是否现在配置 Hooks（钩子）?
  ❯ 跳过，稍后配置

5. 打开 Web UI

? 是否打开 Web Dashboard?
  ❯ 是

✓ 正在启动 Gateway...
✓ Gateway 已启动在端口 18789
✓ 正在打开浏览器...
✓ Dashboard 地址: http://127.0.0.1:18789

浏览器会自动打开 OpenClaw 的 Web 管理界面。

第二步：连接聊天平台

建议先连接一个常用聊天平台进行测试。以下是推荐的平台：

推荐平台对比

平台难度国内可用推荐场景
Telegram⭐ 简单✓个人使用、快速测试
Discord⭐⭐ 中等✓开发者社区、团队协作
飞书⭐⭐ 中等✓企业团队、工作协作
微信⭐⭐⭐ 复杂✓国内用户、日常沟通
WhatsApp⭐⭐ 中等需翻墙国际用户

快速接入 Telegram（推荐）

Telegram 是最容易配置的平台，适合快速测试：

  1. 在 Telegram 中搜索 @BotFather
  2. 发送 /newbot 创建新机器人
  3. 按提示设置机器人名称和用户名
  4. 复制获得的 Bot Token

然后在终端执行：

openclaw channels add

选择 Telegram，输入 Token 即可。

详细步骤请参考：Telegram 接入指南

接入其他平台

第三步：测试你的第一个对话

在聊天平台中测试

  1. 打开你配置的聊天平台（如 Telegram）
  2. 找到你创建的机器人
  3. 发送一条测试消息：
你好，OpenClaw！
  1. 如果机器人正常回复，说明配置成功！

使用命令行测试

你也可以直接在终端与 Agent 对话：

openclaw agent --message "你好，介绍一下你自己" --thinking high

第四步：安装你的第一个 Skill

Skills 是 OpenClaw 的能力扩展模块。让我们安装一个实用的 Skill：

安装 ClawHub CLI

npm install -g clawhub

搜索 Skills

clawhub search browser

安装 Browser Skill

clawhub install browser

验证安装

openclaw skills list

你应该能看到 browser skill 的状态为 ready（绿色）。

测试 Browser Skill

在聊天平台中发送：

打开浏览器，搜索 OpenClaw 是什么

OpenClaw 会自动调用 Browser Skill 执行搜索。

模型与授权最佳实践

推荐模型配置

根据不同场景选择合适的模型：

日常对话和任务处理

  • MiniMax M2.5：国内可用，中文支持好，性价比高
  • Kimi：长文本处理能力强，适合文档分析

代码相关任务

  • DeepSeek：代码能力出色，推理能力强
  • Claude Sonnet：代码理解和生成能力强

复杂推理和长上下文

  • Claude Opus 4.6：最强的长上下文处理能力
  • Anthropic Pro/Max：更强的防注入能力

本地部署

  • Ollama：完全离线，隐私保护最好
  • 推荐模型：Llama 3、Mistral、Qwen

配置多个模型

OpenClaw 支持配置多个模型并自动回退：

# 添加备用模型
openclaw models add

# 查看已配置的模型
openclaw models list

# 设置默认模型
openclaw models set-default <model-name>

OAuth 与 API 密钥管理

  • 支持 OAuth 授权（如 Google、GitHub）
  • 支持 API 密钥轮换
  • 自动回退到备选模型

安全默认配置

OpenClaw 默认启用了多项安全机制：

私信配对机制

未知联系人默认不执行命令，需要先配对：

# 查看待配对的联系人
openclaw pairing list

# 批准配对请求
openclaw pairing approve <contact-id>

白名单策略

建议为生产环境启用白名单：

# 在配置文件中设置
{
  "channels": {
    "telegram": {
      "groupPolicy": "allowlist",
      "allowedUsers": [
        "user_id_1",
        "user_id_2"
      ]
    }
  }
}

定期安全检查

# 运行诊断工具
openclaw doctor

# 检查配置安全性
openclaw security check

# 查看审计日志
openclaw logs --filter security

常用操作

启动和停止服务

# 启动 Gateway
openclaw gateway

# 后台运行
openclaw gateway --daemon

# 停止服务
openclaw stop

# 重启服务
openclaw restart

查看状态和日志

# 查看运行状态
openclaw status

# 查看实时日志
openclaw logs --follow

# 查看特定 Agent 的日志
openclaw logs --agent main

# 查看错误日志
openclaw logs --level error

管理 Agents

# 列出所有 Agents
openclaw agents list

# 创建新 Agent
openclaw agents add coder

# 编辑 Agent 的 SOUL
openclaw agents edit coder --soul

# 删除 Agent
openclaw agents remove coder

更新与版本管理

切换版本通道

# 稳定版（推荐）
openclaw update --channel stable

# 测试版（新功能）
openclaw update --channel beta

# 开发版（最新，可能不稳定）
openclaw update --channel dev

从源码更新

如果你是从源码安装的：

cd openclaw
git pull
pnpm install
pnpm build
pnpm gateway:watch

下一步

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

  1. 探索更多渠道：渠道配置指南
  2. 安装更多 Skills：Skills 市场
  3. 配置多 Agent：多 Agent 配置
  4. 学习高级功能：配置指南
  5. 查看实战案例：使用案例

💡 需要更多帮助？

夸克网盘资源包提供了完整的视频教程和实战案例，帮助你深入学习 OpenClaw！

👉 下载完整教程资源 👈

包含：

  • 📹 完整视频教程系列
  • 📚 实战案例代码
  • 🛠️ 常用技能包
  • 📖 进阶配置指南

常见问题

Q: 配置完成后机器人不响应？

检查以下几点：

  1. Gateway 是否正在运行：openclaw status
  2. Channel 状态是否为 Running：openclaw channels list
  3. 查看日志排查问题：openclaw logs

Q: 如何更换模型？

# 重新运行配置向导
openclaw onboard

# 或直接添加新模型
openclaw models add

Q: 忘记了 Dashboard 地址？

默认地址是 http://127.0.0.1:18789，或运行：

openclaw dashboard

Q: 如何备份配置？

配置文件位于 ~/.openclaw/，直接备份该目录即可：

# Linux/macOS
cp -r ~/.openclaw ~/.openclaw.backup

# Windows
xcopy %USERPROFILE%\.openclaw %USERPROFILE%\.openclaw.backup /E /I