u-claw/website/教程-OpenClaw中国区完全指南.md

OpenClaw 中国区完全指南

U-Claw 出品 · 综合整理自 OpenClaw 官方文档及社区资源

---

目录

1. 什么是 OpenClaw？
2. 安装（使用 U-Claw 一键安装）
3. 首次配置
4. 选择 AI 模型
5. 接入聊天平台
6. 日常使用场景
7. 技能系统
8. 定时任务与自动化
9. 多模型配置与成本优化
10. 常见问题与故障排除
11. 进阶：VPS 部署
12. 社区资源

---

1. 什么是 OpenClaw？

OpenClaw 是一个开源 AI 助手框架，你可以把它理解为：

• 一个能接入 QQ、飞书、Telegram、Discord 等 20+ 聊天平台的 AI 机器人
• 一个能调用 DeepSeek、Kimi、Claude、GPT 等 50+ AI 模型的智能网关
• 一个支持 52+ 技能（发邮件、管理日程、操作笔记、控制智能家居）的全能助手
• 一个可以设定定时任务、自动执行工作流的 AI Agent

一句话总结：你的私人 AI 助手，跑在你自己的设备上，连接你所有的聊天工具。

核心架构

你的聊天平台 ←→ OpenClaw Gateway ←→ AI 模型
  (QQ/飞书/TG)      (你的电脑)        (DeepSeek/Kimi/Claude)
                         ↕
                    技能 & 工具
              (邮件/笔记/日程/搜索...)

---

2. 安装（使用 U-Claw 一键安装）

方式一：U-Claw U 盘安装（推荐，免翻墙）

1. 插入 U-Claw U 盘
2. Mac: 双击「启动菜单.command」
   Linux: 运行 `bash ./运行.sh`
   Win: 双击「启动菜单.bat」
3. 选择 [1] 一键安装到电脑
4. 等待完成（约 2-3 分钟）

安装后在终端输入 openclaw 或 uclaw 即可启动。

方式二：在线安装（需联网，无需 U 盘）

💡 国内用户全程可用镜像加速，大部分情况无需翻墙。

第一步：安装 Node.js 22+

OpenClaw 需要 Node.js v22 或以上版本。国内有多种方式安装：

方法 A：官网直接下载（最简单）

• Node.js 中文网：https://nodejs.cn/download/ （国内直连，速度快）
• 官方下载页：https://nodejs.org/en/download （海外源，可能较慢）

下载 .pkg（Mac）或 .msi（Windows）安装包，双击安装即可。

方法 B：使用 nvm 版本管理器（推荐开发者）

# 1. 安装 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash

# 2. 设置 Node.js 国内镜像（⚠️ 关键！否则下载很慢）
export NVM_NODEJS_ORG_MIRROR=https://npmmirror.com/mirrors/node
# 永久生效：写入 ~/.bashrc 或 ~/.zshrc
echo 'export NVM_NODEJS_ORG_MIRROR=https://npmmirror.com/mirrors/node' >> ~/.zshrc

# 3. 安装 Node.js 22
nvm install 22
nvm use 22

# 4. 验证
node -v   # 应显示 v22.x.x

方法 C：使用 fnm（更快的版本管理器，基于 Rust）

# 1. 安装 fnm
# Mac/Linux:
curl -fsSL https://fnm.vercel.app/install | bash
# Windows (PowerShell):
winget install Schniz.fnm

# 2. 设置国内镜像
export FNM_NODE_DIST_MIRROR=https://npmmirror.com/mirrors/node
# 永久生效：
echo 'export FNM_NODE_DIST_MIRROR=https://npmmirror.com/mirrors/node' >> ~/.zshrc

# 3. 安装 Node.js 22
fnm install 22
fnm use 22

第二步：设置 npm 国内镜像源

安装完 Node.js 后，必须先换镜像源，否则后续安装 OpenClaw 会超时。

# 推荐：淘宝 npmmirror（最稳定，速度最快）
npm config set registry https://registry.npmmirror.com

# 验证是否设置成功
npm config get registry
# 应返回: https://registry.npmmirror.com/

国内可用的 npm 镜像源一览：

镜像源	地址	说明
淘宝 npmmirror	https://registry.npmmirror.com	⭐ 首选，最快最稳
腾讯云	https://mirrors.cloud.tencent.com/npm/	腾讯云加速
华为云	https://mirrors.huaweicloud.com/repository/npm/	华为云加速
阿里云	https://npm.aliyun.com	阿里云加速
中科大	https://mirrors.ustc.edu.cn/	高校镜像
清华大学	https://mirrors.tuna.tsinghua.edu.cn/	高校镜像

⚠️ 旧域名 registry.npm.taobao.org 已于 2024 年 1 月停止服务，请务必使用新域名 registry.npmmirror.com。

快速切换镜像源的方法：

# 方法 1：直接设置（推荐）
npm config set registry https://registry.npmmirror.com

# 方法 2：安装 nrm 镜像源管理工具
npm install -g nrm
nrm ls          # 查看所有可用镜像源
nrm use taobao  # 一键切换淘宝源
nrm test        # 测速，看哪个最快

# 方法 3：单次使用（不改全局配置）
npm install -g openclaw@latest --registry=https://registry.npmmirror.com

第三步：安装 OpenClaw

# 安装 OpenClaw（全局安装）
npm install -g openclaw@latest

# 如果上面超时，手动指定镜像：
npm install -g openclaw@latest --registry=https://registry.npmmirror.com

# 验证安装
openclaw --version

第四步：启动配置向导

# 启动引导向导 + 安装后台守护进程（推荐）
openclaw onboard --install-daemon

# 或只启动引导向导
openclaw onboard

---

3. 首次配置向导（详细）

参考：hello-claw 教程、菜鸟教程 OpenClaw 配置、openclaw-docs

安装完成后，运行 openclaw 或 openclaw onboard，会自动进入交互式引导向导。首次用户推荐选择 QuickStart 模式（最小配置，最快上手）。

3.1 选择配置模式

? Choose setup mode:
  > QuickStart     ← 推荐首次用户，跳过非必要配置
    Full Setup     ← 完整配置，逐项设置
    Import         ← 从已有配置文件导入

3.2 选择 AI 模型提供商

? Select your AI provider:
  > DeepSeek        ← 国内推荐，便宜好用
    Moonshot (Kimi) ← 256K 长上下文
    Qwen            ← 免费额度大
    Anthropic (Claude)
    OpenAI (GPT)
    Custom/Relay    ← 自定义 API 地址（SophNet，中转站、OpenRouter 等）
    ...

💡 **国内用户建议先选 1、SophNet，模型种类丰富，提供DS，GLM，Qwen，MiniMax，Kimi等多家开源大模型，可以做多模型之间的切换。 2、DeepSeek，注册即送免费额度，API 无需翻墙。

3.3 输入 API Key

每个模型都需要一个 API Key，去对应平台注册获取：

模型	注册地址	获取方式
DeepSeek	https://platform.deepseek.com/	注册 → API Keys → 创建
Kimi	https://platform.moonshot.cn/	注册 → 开发者 → 创建密钥
Qwen	https://dashscope.console.aliyun.com/	注册阿里云 → 开通 DashScope → 创建 API Key
Claude	https://console.anthropic.com/	注册 → API Keys（需海外手机号或信用卡）
OpenAI	https://platform.openai.com/	注册 → API Keys（需海外手机号或信用卡）
SophNet	https://www.sophnet.com/#?code=4T6VKY	注册 → API Keys https://www.sophnet.com/docs/component/keySetting.html

? Enter your API key:
  sk-xxxxxxxxxxxxxxxxxxxxxxxx

? Enter API base URL (press Enter for default):
  https://api.deepseek.com/v1    ← DeepSeek 用户填这个
  https://api.moonshot.cn/v1     ← Kimi 用户填这个
  (留空)                          ← OpenAI/Claude 用默认值
  https://www.sophnet.com/api/open-apis/v1  ← SophonNet用户填这个

💡 用中转站/代理平台的用户：选择 Custom/Relay，填入你的中转站地址和 Key。 常用中转： 1、SophonNet：https://www.sophnet.com/#?code=4T6VKY Model包括： "DeepSeek-V3.2-Fast" "DeepSeek-V3.2" "MiniMax-M2.7" "GLM-5" "Kimi-K2.5" "Qwen3.5-397B-A17B" "Qwen3-VL-235B-A22B-Instruct" 等，具体参考SophonNet平台说明。 2、OpenRouter (https://openrouter.ai)、API2D 等。

3.4 选择聊天平台

? Which channels do you want to connect?
  > Telegram       ← 需翻墙
    Discord        ← 需翻墙
    Feishu (飞书)  ← 国内企业推荐
    QQ Bot         ← 国内首选，无需翻墙
    WhatsApp
    Slack
    (Skip for now) ← 可以之后再配置

💡 可以先跳过，之后随时通过 openclaw configure 或启动菜单添加。

3.5 安装守护进程（后台运行）

? Install as background service? (Y/n)

选 Y，OpenClaw 会安装为系统守护进程，开机自启、后台运行。选 N 则每次需手动启动。

3.6 配置完成

向导完成后：

• 配置文件保存在 ~/.openclaw/openclaw.json
• Gateway 自动启动，默认端口 18789
• 浏览器自动打开控制台 http://127.0.0.1:18789

# 常用管理命令
openclaw gateway status    # 查看运行状态
openclaw gateway restart   # 重启网关
openclaw gateway stop      # 停止网关
openclaw configure         # 重新进入配置向导
openclaw doctor --repair   # 诊断修复

3.7 配置文件说明

配置文件位于 ~/.openclaw/openclaw.json，支持热重载（修改后自动生效，无需重启）：

{
  "gateway": {
    "mode": "local",
    "port": 18789,
    "bind": "127.0.0.1",
    "auth": {
      "token": "你的Token"
    }
  },
  "models": {
    "default": "deepseek-v3"
  },
  "channels": {
    "telegram": { "token": "xxx" },
    "qqbot": { "appId": "xxx", "appSecret": "xxx" }
  }
}

💡 U-Claw 用户：如果你是通过 U-Claw 安装的，配置文件在 U-Claw/data/.openclaw/openclaw.json，首次配置通过浏览器打开的 Config.html 页面完成，更加直观。

---

4. 选择 AI 模型

国产模型推荐（国内直接可用，无需翻墙）

🏆 DeepSeek（推荐首选）

• 价格：极便宜（约 1 元 / 百万 tokens）
• 特长：编程、逻辑推理
• 注册：https://platform.deepseek.com/
• 配置：

  # .env 文件
  OPENAI_API_KEY=sk-xxxxxxxx
  OPENAI_BASE_URL=https://api.deepseek.com/v1
  

📚 Kimi / 月之暗面

• 价格：中等
• 特长：256K 超长上下文，适合长文档分析
• 注册：https://platform.moonshot.cn/
• 配置：

  OPENAI_API_KEY=sk-xxxxxxxx
  OPENAI_BASE_URL=https://api.moonshot.cn/v1
  

🆓 通义千问 Qwen（免费额度最大）

• 价格：有大量免费额度
• 特长：中文理解好，多模态
• 注册：https://dashscope.console.aliyun.com/
• 配置：启动菜单 [5] 选择 Qwen

🎓 智谱 GLM

• 特长：学术场景，中文 NLP
• 注册：https://open.bigmodel.cn/

🎙️ MiniMax

• 特长：语音合成，多模态
• 注册：https://platform.minimaxi.com/

🔥 豆包 Doubao（字节跳动）

• 特长：火山引擎生态整合
• 注册：https://console.volcengine.com/ark

国际模型（需要翻墙或用 OpenRouter）

模型	特长	注册
Claude 4	最强综合，编程最好	anthropic.com
GPT-4.1	广泛兼容	platform.openai.com
Gemini 3	免费额度	ai.google.dev

💡 省钱技巧

1. 日常用 DeepSeek，复杂任务切 Claude
2. 用 OpenRouter 统一管理多个模型：https://openrouter.ai
3. 在 OpenClaw 中可以为不同聊天平台配置不同模型

---

5. 接入聊天平台

5.1 QQ（腾讯官方接入，推荐！）

腾讯官方已为 OpenClaw 开放 QQ 机器人能力。全程 1 分钟，完全免费，无需翻墙。

这可能是国内 AI 助手最强入口——Telegram 要翻墙，Discord 要翻墙，QQ 不用。

步骤（仅需 3 条命令）：

1. 扫码注册 QQ 机器人：
   http://q.qq.com/qqbot/openclaw/login.html

2. 点击「创建机器人」，获取 AppID 和 AppSecret

3. 终端执行：
   openclaw plugins install @sliverp/qqbot@latest
   openclaw channels add --channel qqbot --token "你的AppID:你的AppSecret"
   openclaw gateway restart

⚠️ 安全提醒：默认 allowFrom 是 *，任何人都能访问你的机器人。接入后务必改成自己的 QQ 号或限定白名单：

openclaw config set channels.qqbot.allowFrom "你的QQ号"

效果：在 QQ 中 @机器人 或私聊，AI 就会回复。

5.1b QQ（备选方案：NapCatQQ）

如果官方接入有问题，可以用 NapCatQQ (OneBot v11 协议) 作为备选：

1. 下载 NapCatQQ: https://github.com/NapNeko/NapCatQQ/releases
2. 安装并启动，用 QQ 扫码登录
3. 在 NapCat 中启用 HTTP 服务，端口 3000
4. 在 OpenClaw .env 中添加：
   ONEBOT_HTTP_URL=http://localhost:3000

5.2 飞书 Feishu

飞书是 OpenClaw 内置支持最全的中国平台：

步骤：
1. 访问 https://open.feishu.cn/app
2. 创建企业自建应用
3. 获取 App ID 和 App Secret
4. 在「事件订阅」中配置 Webhook URL
5. 在「权限管理」中开启消息相关权限
6. 运行: openclaw onboard → 选择 Feishu

支持：文字/图片/文件/群组/@提及/飞书文档/多维表格

5.3 微信

# 安装社区插件
openclaw plugins install @icesword760/openclaw-wechat

# 支持：文字/图片/文件/关键词触发
# 基于 iPad 协议

5.4 Telegram

步骤：
1. 在 Telegram 找 @BotFather
2. 发送 /newbot，按提示创建机器人
3. 获取 Bot Token
4. 运行: openclaw onboard → 选择 Telegram
5. 输入 Token

5.5 Discord

步骤：
1. 访问 https://discord.com/developers/applications
2. 创建 Application → Bot
3. 获取 Bot Token
4. 在 OAuth2 中生成邀请链接，邀请到服务器
5. 运行: openclaw onboard → 选择 Discord

---

6. 日常使用场景

编程助手

你: 帮我写一个 Python 爬虫，抓取豆瓣电影 Top250
AI: [生成完整代码 + 使用说明]

你: 这段代码有 bug，帮我看看 [粘贴代码]
AI: [分析 bug + 修复方案]

内容创作

你: 帮我写一篇关于 AI 发展趋势的文章，1000 字
AI: [生成文章]

你: 帮我总结这个链接的内容: https://...
AI: [总结要点]

日常办公

你: 帮我发邮件给 zhang@example.com，主题是项目进度，内容是...
AI: [通过 himalaya 技能发送邮件]

你: 提醒我明天下午 3 点开会
AI: [通过 apple-reminders 技能设置提醒]

你: 帮我在 Notion 创建一个新页面，标题是...
AI: [通过 notion 技能创建页面]

信息查询

你: 今天深圳天气怎么样？
AI: [通过 weather 技能查询]

你: 搜索 GitHub 上最新的 AI 开源项目
AI: [通过 github 技能搜索]

---

7. 技能系统

已预装的 52 个技能

U-Claw 已预装所有官方技能，无需联网下载。在启动菜单选 [13] 可以浏览完整列表。

常用技能速查

技能	用途	使用示例
github	GitHub 操作	"帮我看 #123 这个 Issue"
summarize	内容总结	"总结这个网页"
weather	天气	"今天北京天气"
himalaya	邮件	"帮我发邮件"
apple-notes	备忘录	"帮我记一下..."
obsidian	Obsidian 笔记	"在 Obsidian 创建笔记"
notion	Notion	"在 Notion 创建页面"
coding-agent	编程委派	"帮我重构这个函数"
nano-pdf	PDF 编辑	"修改这个 PDF"
openai-image-gen	AI 绘图	"画一只猫"
peekaboo	屏幕截图	"截个屏"
tmux	远程终端	"看一下服务器状态"

安装更多技能

# 搜索社区技能
openclaw skills search 翻译

# 安装技能
openclaw skills install @xxx/skill-name

# 通过 ClawHub
openclaw clawhub search

---

8. 定时任务与自动化

OpenClaw 支持 Cron 定时任务：

# 每天早上 8 点发送天气预报
openclaw cron add "0 8 * * *" "查看今天深圳天气并发送到飞书"

# 每小时检查邮件
openclaw cron add "0 * * * *" "检查新邮件，有重要的通知我"

# 每天下午 6 点总结今日工作
openclaw cron add "0 18 * * *" "总结今天的工作进度"

---

9. 多模型配置与成本优化

为不同场景配置不同模型

在 openclaw.json 中：

{
  "models": {
    "default": "deepseek-v3",
    "coding": "deepseek-coder",
    "creative": "kimi-k2.5",
    "complex": "claude-opus-4"
  }
}

成本控制建议

1. 日常对话：DeepSeek V3（约 1元/百万 tokens）
2. 长文档：Kimi K2.5（256K 上下文）
3. 复杂推理：Claude（按需切换）
4. 图片生成：用 MiniMax 或 OpenAI DALL-E
5. 语音：Sherpa-ONNX（本地免费）或 ElevenLabs

---

10. 常见问题与故障排除

Q: 启动报错 "Node.js v22+ is required"

# 使用 U-Claw 自带的 Node.js
# Mac: 运行 "启动菜单.command" 而不是直接运行 openclaw
# 或安装到电脑后重新打开终端

Q: npm install 超时

# 设置淘宝镜像
npm config set registry https://registry.npmmirror.com
# 或使用启动菜单 [7] 一键设置

Q: AI 不回复消息

# 1. 检查 API Key 是否正确
# 2. 检查网络是否能访问 AI 服务
# 3. 运行诊断
openclaw doctor --repair
# 或使用启动菜单 [8]

Q: 飞书机器人收不到消息

1. 检查事件订阅 URL 是否正确
2. 检查应用权限是否开启
3. 检查是否在飞书管理后台审核通过
4. 查看 OpenClaw 日志: tail -f ~/.openclaw/logs/gateway.log

Q: QQ 机器人掉线

1. 检查 NapCatQQ 是否在运行
2. 重新扫码登录
3. 检查 NapCat 的 HTTP 端口配置

Q: 如何完全重置？

# 方式1: 使用启动菜单 [11]
# 方式2: 命令行
openclaw reset --scope full

---

11. 进阶：VPS 部署

如果你想让 AI 助手 24/7 在线运行：

推荐配置

• 最低：1核 2GB 内存（轻量云服务器即可）
• 推荐：2核 4GB 内存
• 存储：20GB+

国内云服务商推荐

• 腾讯云轻量：最低 50元/月
• 阿里云 ECS：学生价更便宜
• 华为云：同上

Docker 部署

# 使用 Docker 一键部署
git clone https://github.com/openclaw/openclaw.git
cd openclaw
cp .env.example .env
# 编辑 .env，填入你的 API Key 和 Bot Token

docker compose up -d

---

12. 社区资源

U-Claw（本项目）

项目	说明
U-Claw 官网	下载、文档、技能市场
U-Claw GitHub	源码、Issue、Release

上游 & 官方

项目	说明
OpenClaw 官方	OpenClaw 上游仓库
OpenClaw ClawHub	官方技能市场

推荐阅读

项目	说明
hello-claw	Datawhale 体系化入门教程
openclaw-docs	276 篇源码级深度文档
awesome-openclaw-skills	社区精选技能合集

工具

项目	说明
NapCatQQ	QQ 机器人框架
openclaw-wechat	微信接入插件

---

本教程由 U-Claw 社区维护，欢迎 PR 完善内容。