第一章 拥有你的第一个 QQ AI 助手

这一章带你从零开始，在自己的 QQ 上拥有一个 AI 助手。

先看看最终效果——你将拥有一个这样的 QQ AI 助手：

准备好了吗？让我们开始。

0. 最快上手：AutoClaw 一键安装（推荐新手）

什么是 AutoClaw？ AutoClaw（澳龙）是智谱推出的国内首个一键安装版 OpenClaw 桌面客户端。它把环境配置、模型接入、技能安装全部打包好了，下载即用，真正做到零门槛。

为什么推荐先用 AutoClaw？

• 一键安装：像装普通软件一样，下载 → 双击 → 完成，无需安装 Node.js、无需配置 API Key，支持 macOS 和 Windows
• 预装 50+ 热门技能：搜索、生图、浏览器操作、文档处理等开箱即用，无需单独配置各类 API
• 内置龙虾专属模型：Pony-Alpha-2 针对 OpenClaw 场景深度优化，工具调用更稳、多步任务不掉链子
• 内置浏览器操作能力：集成 AutoGLM Browser-Use，能自动完成多步骤、跨页面的复杂浏览器任务
• 一键接入飞书：点击主界面的"一键接入飞书"，扫码登录后全程自动配置，无需手动操作（详见第三章）
• 模型随意切换：默认 Pony-Alpha-2，也支持 GLM-5、DeepSeek、Kimi、MiniMax 等任意模型 API
• 免费积分：新用户限时赠送 2000 积分，零成本上手

安装步骤：

1. 访问 AutoClaw 官网，下载对应系统的安装包（macOS / Windows）
2. 双击安装，打开 AutoClaw
3. 用国内手机号注册账号
4. 阅读并确认安全与风险指南
5. 开始和你的龙虾对话！

就这么简单。打开后你会看到左侧的 Agents（智能体）、IM Channels（即时通讯渠道）、Cron Jobs（定时任务）三个标签页，中间是对话区域，底部可以选择模型（默认 Pony-Alpha-2）。左侧预置了多个智能体：AutoClaw（主助手）、沉思小助手、监控、Browser Agent 等。

几个实用提示：

• Quick Setup：首次对话前，界面中间会出现 "Quick Setup" 卡片，点击可以设置你的名字和角色，让 AutoClaw 更了解你。这个选项只在第一次对话前出现，如果错过了也没关系——直接在对话框里告诉 AutoClaw 你想要的设置，它一样会帮你配好
• 免费额度用完后：点击右上角的 Buy now 购买积分包或月度会员即可继续使用
• 预装技能覆盖：内容创作、办公自动化、代码开发、营销、金融等高频场景，安装完就能直接用

Tip AutoClaw 运行的就是完整版 OpenClaw。本教程后续章节介绍的技能安装、定时任务、外部服务集成、工作区文件配置等功能，在 AutoClaw 中同样适用。你可以先用 AutoClaw 快速体验，再按需学习进阶配置。

---

想手动安装？ 如果你更喜欢从头配置（或需要服务器部署、QQ 机器人接入等场景），继续往下走：安装环境 → 配置模型 → 创建 QQ 机器人 → 开始聊天。

1. 安装环境

OpenClaw 需要 Node.js 22+ 运行环境。如果你已经装过，跳到第 2 步。

什么是终端（Terminal）？ 本教程需要在"终端"中输入命令。终端是一个文字界面，你输入命令，电脑执行：

• Windows：按 Win + X，选择"终端"或"PowerShell"

  查看 Windows 终端截图

  

• macOS：按 Cmd + 空格，搜索"Terminal"

• Linux：按 Ctrl + Alt + T

  查看 Linux 终端截图

  

用 Trae CN 当安装助手（更省事）

如果你安装了 Trae CN（字节跳动推出的免费 AI 编程助手），可以把它当作你的“本地安装/排障助手”，你只需要描述目标与当前报错即可。

• 安装环境：帮我安装 Node.js 22，并告诉我如何验证安装是否成功（我的系统是 Windows/macOS/Linux）
• 安装 OpenClaw：帮我安装 openclaw@latest，并运行 openclaw --version 验证
• 解决问题：我执行 openclaw onboard 报错了，错误信息如下：... 请定位原因并给出修复步骤
• 修改配置：帮我打开并修改 openclaw.json，把模型 API Key 配好（Windows 路径是 C:\\Users\\用户名\\.openclaw\\openclaw.json；macOS/Linux 是 ~/.openclaw/openclaw.json）

1.1 安装 Node.js

什么是 Node.js？ OpenClaw 是用 JavaScript 编写的，Node.js 让它能在你的电脑上运行。你不需要学 JavaScript，装好就行。

根据你的操作系统选择安装方式：

Windows 用户：打开 PowerShell（管理员模式），运行一键安装脚本：

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
iwr -useb https://openclaw.ai/install.ps1 | iex

这个脚本会自动安装 Node.js 和 OpenClaw，装完可以直接跳到第 2 步。

macOS 用户：

brew install node@22

没有 Homebrew？先运行：/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Linux 用户（含 WSL2）：

curl -fsSL https://deb.nodesource.com/setup_22.x | sudo bash -
sudo apt install -y nodejs

验证安装：

node --version

看到 v22.x.x 说明成功。

查看验证截图

Windows 用户：什么是 WSL2？如何安装？

WSL2（Windows Subsystem for Linux 2）让你在 Windows 上运行完整的 Linux 环境。如果你不想折腾，直接用 PowerShell 即可，跳过此步骤。

1. 以管理员身份打开 PowerShell
2. 运行：wsl --install
3. 重启电脑，按提示设置用户名和密码

之后在开始菜单搜索"Ubuntu"即可打开 WSL2 终端，按上面 Linux 的步骤安装 Node.js。

国内镜像加速（下载太慢时使用）

Linux / macOS / WSL2：

# nvm 镜像
export NVM_NODEJS_ORG_MIRROR=https://npmmirror.com/mirrors/node
echo 'export NVM_NODEJS_ORG_MIRROR=https://npmmirror.com/mirrors/node' >> ~/.bashrc

# npm 镜像
npm config set registry https://registry.npmmirror.com

Windows：

nvm node_mirror https://npmmirror.com/mirrors/node
npm config set registry https://registry.npmmirror.com

1.2 安装 OpenClaw

Windows 一键脚本已包含此步骤，如果你用了一键脚本可以跳过。

npm install -g openclaw@latest

什么是 npm？ npm 是 Node.js 自带的"软件安装器"，-g 表示全局安装。

验证：

openclaw --version

查看验证截图

2. 配置 AI 模型

OpenClaw 本身不包含 AI 大脑，需要连接一个"模型提供商"来获得智能。运行配置向导：

openclaw onboard --install-daemon

向导会引导你完成所有配置。关键步骤：

安全确认 → 选 Yes配置模式 → 选 QuickStart模型提供商 → 选 Custom Provider

然后输入以下信息（以 OpenRouter 免费模型为例）：

◇  API Base URL
│  https://openrouter.ai/api/v1

◇  API Key
│  sk-or-v1-你的密钥

◇  Endpoint compatibility
│  OpenAI-compatible

◇  Model ID
│  stepfun/step-3.5-flash:free

推荐 OpenRouter——注册即可使用免费模型（如 Step 3.5 Flash），无需充值，零成本完成全部教程练习。

向导后续会询问渠道、技能等配置，建议都先跳过——QQ 机器人我们手动配置更快。

还没有 API Key？ 展开下方指南获取。

获取 API Key：注册 OpenRouter（免费模型，零成本入门）

第一步：注册账号

1. 访问 OpenRouter 官网
2. 点击右上角 Sign In，支持 Google、GitHub、邮箱等多种方式快速注册

第二步：创建 API 密钥

1. 注册登录后，点击右上角头像 → 选择 Settings
2. 在左侧菜单选择 API Keys
3. 点击 Create 创建一个新的 API Key
4. 复制生成的密钥（以 sk-or-v1- 开头）

重要：API 密钥只会显示一次，请立即复制保存。丢失需重新创建。

第三步：充值（可选）

OpenRouter 上带 :free 后缀的模型完全免费，如 stepfun/step-3.5-flash:free，日常学习足够使用。如果你想使用更强的付费模型：

1. 点击左侧菜单的 Credits 进入充值页面
2. 点击 Add Credits 进行充值
3. OpenRouter 支持银联、VISA 等常见卡型，甚至还支持虚拟货币支付，非常方便
4. 建议第一次充值最低限额 5 美金，够练手了

省心提示：如果后期使用量较大，可以在充值页面开启 Auto Top Up（自动充值），余额不足时自动补充，避免使用中断。

备选方案：使用硅基流动（SiliconFlow）

如果你更倾向使用国内提供商，推荐硅基流动——新注册送 16 元免费算力券，支持支付宝/微信充值。

注册与获取 API Key：

1. Truy cập 硅基流动官网 và đăng ký bằng số điện thoại di động của bạn
2. Sau khi đăng nhập, hãy nhập 控制台 và tạo khóa API (bắt đầu bằng sk-)

Điền vào trình hướng dẫn:

◇  API Base URL
│  https://api.siliconflow.cn/v1

◇  API Key
│  sk-你的密钥

◇  Model ID
│  deepseek-ai/DeepSeek-V3

Chi phí tham khảo: Mẫu DeepSeek V3, 16 nhân dân tệ có thể thực hiện khoảng 800-1500 cuộc hội thoại.

Cách lấy API Key từ nhiều nhà cung cấp hơn

• StepFun: Truy cập https://platform.stepfun.com để nhận Khóa API chính thức; hoặc sử dụng trực tiếp stepfun/step-3.5-flash:free tại OpenRouter để có mô hình miễn phí, nhập cảnh không mất phí (khuyến nghị)
• DeepSeek: Truy cập https://platform.deepseek.com, hỗ trợ nạp tiền Alipay
• Tongyi Qianwen (Qwen): truy cập https://dashscope.console.aliyun.com, một công ty con của Alibaba Cloud
• Mặt tối của Mặt trăng (Moonshot/Kimi): Truy cập https://platform.moonshot.cn
• Doubao: Truy cập https://console.volcengine.com/ark, Nền tảng Volcano Ark
• Hunyuan: Truy cập https://cloud.tencent.com/product/tclm, hunyuan-lite miễn phí và không giới hạn
• MiniMax: Truy cập https://platform.minimaxi.com
• GLM: Truy cập https://open.bigmodel.cn
• 文心一言（ERNIE): Truy cập https://console.bce.baidu.com/qianfan
• OpenAI (GPT): truy cập https://platform.openai.com, cần có thẻ tín dụng quốc tế
• Anthropic (Claude): Truy cập https://console.anthropic.com, cần có thẻ tín dụng quốc tế
• Google (Gemini): Truy cập https://aistudio.google.com, có hạn ngạch miễn phí
• xAI (Grok): Truy cập https://console.x.ai, cần có thẻ tín dụng quốc tế

::: thông tin Nhắc nhở tiêu thụ mã thông báo Khi số vòng đối thoại tăng lên, bối cảnh sẽ ngày càng dài hơn và mức tiêu thụ mã thông báo cũng sẽ tăng lên đáng kể. Ngay cả với các mô hình miễn phí, giới hạn tốc độ có thể được kích hoạt sau các cuộc trò chuyện dài. Gợi ý:

• Sử dụng các mẫu rẻ hơn (các mẫu miễn phí như stepfun/step-3.5-flash:free, v.v.)
• Đối với các tác vụ phức tạp, hãy cân nhắc sử dụng chế độ lập kế hoạch mã hóa
• Chú ý kiểm tra chi phí API sau khi sử dụng một thời gian để tránh phát sinh phí ngoài ý muốn :::

Advanced: Bỏ qua trình hướng dẫn và chỉnh sửa tệp cấu hình theo cách thủ công

Chỉnh sửa trực tiếp ~/.openclaw/openclaw.json:

{
  "env": {
    "OPENROUTER_API_KEY": "sk-or-v1-你的密钥"
  },
  "models": {
    "mode": "merge",
    "providers": {
      "openrouter": {
        "baseUrl": "https://openrouter.ai/api/v1",
        "apiKey": "${OPENROUTER_API_KEY}",
        "api": "openai-completions",
        "models": [
          { "id": "stepfun/step-3.5-flash:free", "name": "Step 3.5 Flash (Free)" }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": { "primary": "openrouter/stepfun/step-3.5-flash:free" }
    }
  }
}

3. Tạo robot QQ

Tencent QQ chính thức mở quyền truy cập gốc chính thức vào OpenClaw vào ngày 7 tháng 3 năm 2026 - miễn phí cho cá nhân, tạo bằng một cú nhấp chuột, không cần viết mã.

3.1 Đăng ký và tạo robot

Mở QQ 开放平台 OpenClaw 接入页面 và sử dụng QQ trên điện thoại di động của bạn để quét mã QR để hoàn tất đăng ký và đăng nhập:

Sau khi đăng nhập, nhấp vào "Tạo Robot" và đặt tên và hình đại diện cho robot. Sau khi tạo, hệ thống sẽ tạo AppID và AppSecret và hiển thị hướng dẫn triển khai:

Quan trọng: Vì lý do bảo mật, AppSecret không hỗ trợ lưu văn bản rõ ràng. Chế độ xem thứ hai sẽ buộc thiết lập lại. Hãy sao chép nó ngay lập tức và lưu nó đúng cách.

3.2 Cấu hình cài đặt

Làm theo hướng dẫn trên trang triển khai và thực hiện ba lệnh trong thiết bị đầu cuối:

Cài đặt plugin QQBot:

openclaw plugins install @sliverp/qqbot@latest

配置绑定 QQ 机器人:

openclaw channels add --channel qqbot --token "你的AppID:你的AppSecret"

Định dạng mã thông báo là AppID:AppSecret, được phân tách bằng dấu hai chấm tiếng Anh. Ví dụ: "1903127255:tqkcPCOnbQCuclyY"

Khởi động lại cổng:

openclaw gateway restart

Sau khi thực hiện xong, terminal sẽ hiển thị thông báo cấu hình thành công.

Xem ảnh chụp màn hình đầu ra của thiết bị đầu cuối

3.3 Bắt đầu trò chuyện

Quay lại trang triển khai của trình duyệt, nhấp vào nút "Quét để trò chuyện" và sử dụng QQ trên điện thoại di động của bạn để quét mã QR để tìm robot của bạn. Hãy thử gửi tin nhắn:

Xin chúc mừng! Bạn đã có trợ lý QQ AI của riêng mình.

Bạn cũng có thể trực tiếp tìm kiếm tên robot trong QQ trên điện thoại di động của mình để tìm.

4. Xác minh và quản lý

Ngoài trò chuyện QQ, bạn cũng có thể quản lý OpenClaw thông qua bảng điều khiển web:

openclaw status

Xem ảnh chụp màn hình đầu ra trạng thái

openclaw dashboard

Trình duyệt sẽ tự động mở control panel http://localhost:18789:

**localhost là gì? ** localhost có nghĩa là "địa phương". Chỉ có bạn mới có thể mở trang này.

Lệnh chung kiểm tra nhanh

# 查看状态
openclaw status

# 深度健康检查
openclaw status --deep

# 系统诊断和修复
openclaw doctor

# 重启 Gateway（修改配置后执行）
openclaw gateway restart

# 查看日志
openclaw logs --follow

# 重新配置
openclaw configure

Cách gỡ cài đặt OpenClaw

Cách 1: Sử dụng lệnh gỡ cài đặt tích hợp (khuyến nghị)

# 交互式卸载
openclaw uninstall

# 完全卸载（非交互式，适用于自动化）
openclaw uninstall --all --yes

方式二: 手动卸载

Nếu CLI đã bị xóa nhưng dịch vụ vẫn chạy, hãy làm theo các bước sau để dọn dẹp theo cách thủ công:

1. Dừng dịch vụ cổng:

openclaw gateway stop

2. Gỡ cài đặt dịch vụ hệ thống:

openclaw gateway uninstall

3. Xóa dữ liệu cấu hình và trạng thái:

rm -rf ~/.openclaw

4. Xóa CLI (chọn dựa trên phương pháp cài đặt):

# npm 安装
npm rm -g openclaw

# pnpm 安装
pnpm remove -g openclaw

# bun 安装
bun remove -g openclaw

Lưu ý: Bạn nên sao lưu thư mục không gian làm việc (~/.openclaw/workspace) trước khi gỡ cài đặt vì thư mục này chứa dữ liệu quan trọng.

5. Câu hỏi thường gặp

**Hỏi: Tôi nên làm gì nếu nó nhắc "Không tìm thấy khóa API"? **

Đáp: Chỉnh sửa ~/.openclaw/openclaw.json (C:\Users\你的用户名\.openclaw\openclaw.json trên Windows) để đảm bảo khóa API được định cấu hình chính xác. Tham khảo ví dụ cấu hình của 第 2 步.

**Q: Robot QQ không phản hồi? **

Trả lời: Kiểm tra các điểm sau:

1. Gateway có đang chạy không: openclaw status
2. Kênh QQ có được cấu hình thành công hay không: openclaw channels status
3. Định dạng Token có đúng không (AppID:AppSecret)
4. Thử khởi động lại: openclaw gateway restart

**Q: Robot trả lời chậm hoặc hết thời gian chờ? **

Đáp: Có thể mô hình phản hồi chậm. Hãy thử thay đổi sang model nhanh hơn (chẳng hạn như deepseek-ai/DeepSeek-V3) hoặc kiểm tra kết nối mạng.

---

Bước tiếp theo:

• Bạn muốn tìm hiểu thêm về cấu hình OpenClaw và cách chơi khác? → 第二章 命令行与配置详解
• Bạn muốn truy cập Feishu hoặc Telegram? → 第三章 移动端接入
• Muốn OpenClaw thực hiện nhiệm vụ thường xuyên? → 第四章 自动化任务入门