Skip to content

bitroboticslab/OpenClaw-Guide-for-Beginners

Repository files navigation

OpenClaw 新手完全指南

从零开始,手把手教你部署属于自己的 24 小时在线 AI 助手

⚠️ 最新安全提示:Windows用户优先推荐使用WSL安装,避免本地安装可能带来的误操作安全风险,查看 安全运行重要提示

OpenClaw License 更新时间

📖 项目简介

OpenClaw 是一个开源的自托管 AI Agent 网关平台,支持 Discord、飞书、Telegram、WhatsApp、Signal、Slack、iMessage 等 10+ 消息渠道,247,000+ GitHub Stars。

核心特性:

  • 🤖 真正的 AI Agent —— 不只是聊天,还能执行操作、操控浏览器、生成图片/视频
  • 🔒 安全沙箱 —— 新版本默认开启沙箱模式,限制文件系统访问,避免误操作风险
  • 🏠 自托管 —— 数据完全由你掌控,本地或云服务器部署
  • 🌐 多平台对接 —— 内置支持10+消息平台,飞书支持官方一键对接,5分钟完成配置
  • ⚡ 24小时在线 —— 云服务器部署全天候待命
  • 🛠️ 1500+ Skills —— 丰富的技能扩展库 (ClawHub)
  • 🎬 多媒体支持 —— 图片/视频/语音生成、语音转写、TTS
  • 📱 移动节点 —— iOS/Android 配对,随时随地对话

🚀 快速开始

根据你的平台选择对应教程:

💡 Windows用户特别提示:新手优先推荐使用 WSL(Windows子系统Linux) 安装,稳定性和兼容性更好,后续维护更方便,是Windows平台的首选安装方式。

直接Windows本地安装适合有经验的用户,新手请优先选择WSL安装。

平台 难度 推荐指数 适用人群 教程链接
WSL ⭐⭐ ⭐⭐⭐⭐⭐ 🔥 Windows新手首选 WSL 安装教程
Windows ⭐⭐ ⭐⭐⭐ Windows有经验用户 Windows 安装指南
macOS ⭐⭐ ⭐⭐⭐⭐⭐ macOS用户 macOS 安装指南
Linux ⭐⭐⭐⭐⭐ Linux用户 Linux 安装指南
Docker ⭐⭐⭐ ⭐⭐⭐⭐ 熟悉Docker的用户 Docker 部署教程
云服务器 ⭐⭐⭐ ⭐⭐⭐⭐⭐ 需要24小时在线的用户 云服务器部署指南
Android ⭐⭐⭐⭐ ⭐⭐⭐ 移动部署用户 Android 部署指南

💰 API 平台推荐

OpenClaw 需要接入大模型 API 才能运行。以下是各平台的优惠信息,使用我的邀请链接注册可以获得代金券或折扣优惠,我也能得代金券,欢迎尝试,谢谢各位朋友支持!

平台(链接直达) 基本情况 价格信息 注册奖励 推荐指数
硅基流动 注册送 2000万 Tokens 注册+活动可得70元代金券 受邀16元代金券 ⭐⭐⭐⭐⭐
火山引擎方舟 数亿token, 支持Doubao/MiniMax/GLM/DeepSeek/Kimi旗舰 lite套餐首月9.9元 受邀9折 ⭐⭐⭐⭐⭐
阿里百炼套餐 量大管饱, 已限量,需准点抢购 lite套餐首月7.9元 邀请活动结束 ⭐⭐⭐⭐
智谱 GLM Coding 量大管饱,Claude Code、Cline等20+工具无缝支持 lite套餐折后44元/月 受邀95折 ⭐⭐⭐⭐
MiniMax 注册送百万token体验 lite套餐29元/月 受邀9折 ⭐⭐⭐

💡 新手建议:先注册硅基流动体验免费额度,再根据需求选择其他平台。

👉 查看详细 API 配置教程 | 模型选择指南 | 成本优化

我个人正在使用以下两个API平台,性价比都很高,感兴趣可以试试:

硅基流动邀请码:lva59yow

2026-03-15 火山引擎方舟邀请码(Coding Plan):XCWPZTHW, 也限量了,每天早上十点半抢购。

2026-03-15 智谱Coding Plan更新了,从9折变成了95折!有需要也可以每天上午十点限量抢购,可以配置MCP。

☁️ 云服务器推荐

想要 24 小时在线的 AI 助手?推荐使用云服务器部署:

阿里云(推荐)

OpenClaw 专属活动页,通过我的链接注册享受独家优惠:

🔗 立即部署 - 半小时搞定

专属福利:

  • 🎁 普惠套餐(2核2G不限流量,99元/年,新用户 68元/年 起)
  • 🔗 阿里百炼 AI 大模型 88% 折扣
  • 💎 建站三件套(域名+服务器+AI建站,百元搞定)
  • ⏰ 半小时内完成部署

云服务商对比

云服务商 套餐价格 OpenClaw 支持 推荐指数
阿里云 68元/年起 一键镜像部署 ⭐⭐⭐⭐⭐
腾讯云 79元起 官方教程支持 ⭐⭐⭐⭐
百度智能云 多种套餐 一键部署教程 ⭐⭐⭐

👉 查看云服务器部署教程 | 阿里云专属教程 | 腾讯云专属教程

📱 平台对接

OpenClaw 支持对接多种消息平台:

平台 对接难度 教程链接
飞书 飞书对接教程(官方一键对接,5分钟完成)
钉钉 ⭐⭐ 钉钉对接教程
Telegram Telegram对接教程
Discord Discord Developer Portal 创建 Bot
WhatsApp ⭐⭐ 内置支持
Signal ⭐⭐ 内置支持
QQ ⭐⭐ 内置 QQ Bot 插件
LINE ⭐⭐ 内置 LINE 插件
微信 ⭐⭐⭐ 微信对接教程
Matrix ⭐⭐ 内置 Matrix 插件

🎯 学习路径

根据你的经验选择合适的学习路径:

🌱 新手入门路径

  1. 阅读 5分钟快速上手
  2. 根据系统选择安装教程(Windows/macOS/Linux)
  3. 配置 API (API配置详解)
  4. 对接第一个平台(推荐钉钉或飞书)
  5. 遇到问题查看 FAQ

🚀 服务器部署路径

  1. 阅读 云服务器部署指南
  2. 选择云服务商(推荐阿里云
  3. 配置服务器和域名
  4. 部署 OpenClaw
  5. 对接消息平台

🔧 进阶开发路径

  1. 熟悉基础配置
  2. 学习 技能开发
  3. 研究 安全配置
  4. 掌握 故障排查

📚 目录结构

OpenClaw-Guide-for-Beginners/
├── README.md                    # 项目首页(本文件)
├── CHANGELOG.md                 # 版本更新日志
├── CONTRIBUTING.md              # 贡献指南
├── RELEASING.md                 # 发布流程规范
├── AUTHORS.md                   # 作者信息
├── FAQ.md                       # 常见问题解答
├── RESOURCES.md                 # 资源汇总
├── docs/                        # 教程文档目录
│   ├── getting-started/         # 快速入门
│   │   ├── quickstart.md        # 5分钟快速上手
│   │   ├── security-notice.md   # 安全运行重要提示
│   │   └── version-selection.md # 版本选择说明
│   ├── installation/            # 安装教程
│   │   ├── windows/             # Windows 相关
│   │   │   └── windows-install-guide.md
│   │   ├── wsl/                 # WSL 相关
│   │   │   ├── wsl-setup.md     # WSL 安装配置
│   │   │   ├── wsl-troubleshooting.md
│   │   │   └── wsl-advanced.md  # WSL 高级配置
│   │   ├── macos/               # macOS 相关
│   │   │   └── macos-install-guide.md
│   │   ├── linux/               # Linux 相关
│   │   │   └── linux-install-guide.md
│   │   ├── docker/              # Docker 部署教程
│   │   │   ├── docker-deployment.md      # Docker 基础部署
│   │   │   ├── docker-production.md      # Docker 生产部署
│   │   │   ├── docker-cloud-deployment.md # Docker 云部署
│   │   │   └── docker-troubleshooting.md
│   │   ├── cloud/               # 云服务器相关
│   │   │   ├── cloud-deployment-guide.md
│   │   │   ├── aliyun-guide.md  # 阿里云专属教程
│   │   │   └── tencent-guide.md # 腾讯云教程
│   │   └── android/             # Android 相关
│   │       └── android-deployment-guide.md
│   ├── configuration/           # 配置教程
│   │   ├── api-configuration.md # API 配置教程
│   │   ├── model-comparison.md  # 模型选择指南
│   │   └── cost-optimization.md # 成本优化指南
│   ├── integration/             # 平台对接教程
│   │   ├── platform-integration-overview.md
│   │   ├── feishu-integration.md
│   │   ├── dingtalk-integration.md
│   │   ├── telegram-integration.md
│   │   └── wechat-integration.md
│   ├── advanced/                # 进阶主题
│   │   ├── security.md          # 安全配置指南
│   │   ├── skills.md            # 技能开发与使用
│   │   └── troubleshooting.md   # 故障排除
│   ├── internal/                # 内部规范
│   │   └── workflow.md          # 项目工作流规范
│   └── version-changes/         # OpenClaw 版本变更记录
│       ├── README.md            # 版本说明索引
│       ├── 2026.3.1.md          # v2026.3.1 变更说明
│       ├── 2026.4.1.md          # v2026.4.1 变更说明
│       └── 2026.4.14.md         # v2026.4.14 变更说明
├── scripts/                     # 安装脚本
│   ├── install-windows.bat      # Windows 安装脚本
│   ├── install-wsl.ps1          # WSL 安装脚本
│   ├── install-linux.sh         # Linux 安装脚本
│   ├── install-macos.sh         # macOS 安装脚本
│   └── install-docker.sh        # Docker 安装脚本
├── images/                      # 教程图片
└── templates/                   # 配置模板
    ├── README.md                # 模板使用指南
    ├── openclaw-template.json   # 主配置模板
    └── env-template.txt         # 环境变量模板

⚙️ 配置模板和脚本

⚠️ 重要: 模板文件仅供参考,请勿直接覆盖你的配置文件!!!


📋 配置模板

项目提供了配置模板供参考,适用于理解配置结构粘贴局部内容不推荐直接覆盖使用

模板文件 说明 用途
templates/openclaw-template.json 主配置参考模板 了解配置结构,提取配置片段
templates/env-template.txt 环境变量模板 参考环境变量配置格式

⚠️ 为什么不能直接覆盖?

模板文件缺少系统配置(metawizardbrowserauth),直接覆盖会导致:

  • openclaw doctor 报错
  • ❌ Gateway 启动失败
  • ❌ 丢失浏览器和认证配置

✅ 推荐的使用方法:

  1. 使用配置向导(推荐新手)

    openclaw onboard --install-daemon
  2. 使用命令行配置

    openclaw config set provider siliconflow
    openclaw config set api_key sk-xxxxxxxx
  3. 手动编辑配置文件

    nano ~/.openclaw/openclaw.json
    # 只修改需要的字段,不要删除系统字段!

详细使用指南: 查看模板使用指南


🛠️ 一键安装脚本

⚠️ 慎重使用: 适用于全新安装,不适用于已有Open

Claw环境的用户

脚本 平台 下载方式
install-windows.bat Windows 下载
install-wsl.ps1 WSL 下载
install-linux.sh Linux 下载
install-macos.sh macOS 下载
install-docker.sh Docker 下载

使用方法(以Linux为例):

# 下载并运行
curl -fsSL https://raw.githubusercontent.com/bitroboticslab/OpenClaw-Guide-for-Beginners/main/scripts/install-linux.sh | bash

# 或分步执行
curl -O https://raw.githubusercontent.com/bitroboticslab/OpenClaw-Guide-for-Beginners/main/scripts/install-linux.sh
chmod +x install-linux.sh
./install-linux.sh

脚本功能:

  • ✅ 自动检测系统环境
  • ✅ 安装 Node.js(如未安装)
  • ✅ 安装 OpenClaw
  • ✅ 运行配置向导
  • ✅ 提供后续配置指导

🔐 配置验证

无论使用哪种方法配置,最后都要验证:

# 运行诊断
openclaw doctor

# 检查模型配置
openclaw models list

# 检查 Gateway 状态
openclaw gateway status

预期输出:

✅ OpenClaw v2026.4.14+
✅ Node.js: 已安装 v24.x
✅ Gateway: 运行中
✅ 模型配置: 正常

详细教程: API配置 | 快速上手

❓ 常见问题

Q: 哪个 API 平台最推荐?

A: 推荐根据你的需求选择:

  • 新手入门:硅基流动(免费额度多,上手简单)
  • 性价比优先:火山方舟 Coding Plan(首月仅8.91元)
  • 长期使用:智谱 GLM Coding Plan(年付优惠力度大)
  • 阿里生态用户:阿里百炼(与阿里云整合好)

Q: 配置文件在哪里?

A:

  • 主配置: ~/.openclaw/openclaw.json
  • 环境变量: ~/.openclaw/.env
  • 工作空间: ~/.openclaw/workspace

Q: 如何重置配置?

A:

# 删除配置文件(⚠️ 慎重操作)
rm ~/.openclaw/openclaw.json

# 重新运行配置向导
openclaw onboard --install-daemon

Q: 如何备份配置?

A:

# 备份到当前目录
cp ~/.openclaw/openclaw.json ./openclaw-backup.json
cp ~/.openclaw/.env ./env-backup.txt 2>/dev/null || true

# 或创建备份目录
mkdir -p ~/openclaw-backup
cp -r ~/.openclaw/* ~/openclaw-backup/

Q: 配置文件格式错误怎么办?

A:

# 1. 使用 openclaw doctor 诊断
openclaw doctor

# 2. 使用 JSON 验证工具
cat ~/.openclaw/openclaw.json | python3 -m json.tool

# 3. 如果无法修复,备份并重新初始化
cp ~/.openclaw/openclaw.json ~/.openclaw/openclaw.json.broken
openclaw onboard --install-daemon

详细使用说明: 查看模板使用指南 | API配置教程

🤝 贡献指南

欢迎提交 Issue 和 Pull Request 帮助完善教程!

📄 许可证

本项目采用 MIT 许可证。

👨‍💻 作者信息

作者: junhang lai

微信公众号二维码


⭐ 创作不易,如果这个教程对你有帮助,请给个 Star 支持一下!


本教程包含推荐链接,通过链接注册可享受额外优惠,同时也支持作者持续产出优质内容。

作者: junhang lai | 最后更新: 2026-04-09

About

🚀 OpenClaw 新手完全指南 - 手把手教你部署属于自己的24小时在线AI助手 | 全平台部署教程 + API配置 + 平台对接 | Complete guide for deploying OpenClaw AI assistant

Topics

Resources

License

Contributing

Security policy

Stars

Watchers

Forks

Packages

 
 
 

Contributors