推荐教程福利

(可点击筛选)

OpenClaw 安装与运行教程_OpenClaw中文教程

2026-03-07 / 0 评论 / 6 阅读 /0 赞

首页 › 教程福利 ›

🎁 新手福利

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

👉 立即下载资源包 👈

包含内容：

✅ 完整安装包（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

MiniMax：访问 MiniMax 开放平台
Kimi：访问月之暗面开放平台
DeepSeek：访问 DeepSeek 开放平台
Claude：访问 Anthropic Console
OpenAI：访问 OpenAI Platform

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 是最容易配置的平台，适合快速测试：

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

然后在终端执行：

openclaw channels add

选择 Telegram，输入 Token 即可。

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

在聊天平台中测试

打开你配置的聊天平台（如 Telegram）
找到你创建的机器人
发送一条测试消息：

你好，OpenClaw！

如果机器人正常回复，说明配置成功！

使用命令行测试

你也可以直接在终端与 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 执行搜索。

模型与授权最佳实践

配置多个模型

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

常用操作

启动和停止服务

# 启动 Gatewayopenclaw gateway# 后台运行openclaw gateway --daemon# 停止服务openclaw stop# 重启服务openclaw restart

查看状态和日志

# 查看运行状态openclaw status# 查看实时日志openclaw logs --follow# 查看特定 Agent 的日志openclaw logs --agent main# 查看错误日志openclaw logs --level error

管理 Agents

# 列出所有 Agentsopenclaw agents list# 创建新 Agentopenclaw agents add coder# 编辑 Agent 的 SOULopenclaw agents edit coder --soul# 删除 Agentopenclaw agents remove coder

更新与版本管理

切换版本通道

# 稳定版（推荐）openclaw update --channel stable# 测试版（新功能）openclaw update --channel beta# 开发版（最新，可能不稳定）openclaw update --channel dev

从源码更新

如果你是从源码安装的：

cd openclawgit pullpnpm installpnpm buildpnpm gateway:watch

下一步

恭喜！你已经完成了 OpenClaw 的基础配置。

常见问题

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

检查以下几点：

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

Q: 如何更换模型？

# 重新运行配置向导openclaw onboard# 或直接添加新模型openclaw models add

Q: 忘记了 Dashboard 地址？

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

openclaw dashboard

Q: 如何备份配置？

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

# Linux/macOScp -r ~/.openclaw ~/.openclaw.backup# Windowsxcopy %USERPROFILE%\.openclaw %USERPROFILE%\.openclaw.backup /E /I

2026-03-07进行了更新

资源获取方式: 点击打开夸克网盘 https://pan.quark.cn/s/6d90e5e83108

本文来自投稿，不代表本站立场，如若转载，请注明出处：https://mqzyz.com/jiaochenggongju/12661.html
有问题可以点击右下角反馈