第一章 拥有你的第一个 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. 硅基流动官网 にアクセスし、携帯電話番号を登録します。
2. ログイン後、控制台を入力し、APIキー(sk-で始まる)を作成します。

ウィザードに入力します:

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

◇  API Key
│  sk-你的密钥

◇  Model ID
│  deepseek-ai/DeepSeek-V3

コスト参考: DeepSeek V3 モデル、16 元は約 800 ～ 1500 の会話を保持できます。

他のプロバイダーから API キーを取得する方法

• StepFun: https://platform.stepfun.com にアクセスして、公式 API キーを取得します。または、stepfun/step-3.5-flash:free OpenRouter を直接使用して、無料モデル、ゼロコストのエントリを使用します (推奨)
• DeepSeek: https://platform.deepseek.com にアクセスし、Alipay リチャージをサポートします
• Tongyi Qianwen (Qwen): Alibaba Cloud の子会社である https://dashscope.console.aliyun.com にアクセスしてください
• ダークサイド オブ ザ ムーン (ムーンショット/キミ): https://platform.moonshot.cn にアクセスしてください。
• Doubao: https://console.volcengine.com/ark、火山箱舟プラットフォームにアクセスしてください
• Hunyuan: https://cloud.tencent.com/product/tclm にアクセスしてください。hunyuan-lite は無料で無制限です
• MiniMax: https://platform.minimaxi.com にアクセスしてください
• GLM: https://open.bigmodel.cn にアクセスしてください
• 文心一言（ERNIE）: https://console.bce.baidu.com/qianfan にアクセスしてください
• OpenAI (GPT): https://platform.openai.com にアクセスするには、国際クレジット カードが必要です
• 人類 (クロード): https://console.anthropic.com にアクセスしてください。国際クレジット カードが必要です
• Google (Gemini): https://aistudio.google.com にアクセスしてください。無料の割り当てがあります。
• xAI (Grok): https://console.x.ai にアクセスしてください。国際クレジット カードが必要です

トークン消費リマインダー

対話ラウンドの数が増加するにつれて、コンテキストはますます長くなり、トークンの消費も大幅に増加します。無料モデルであっても、長時間会話するとレート制限が適用される場合があります。提案:

• 安価なモデルを使用する（stepfun/step-3.5-flash:free などの無料モデル）
• 複雑なタスクの場合は、コーディング プラン モードの使用を検討してください。
• 予期せぬ料金が発生しないように、一定期間使用した後は API オーバーヘッドを確認するように注意してください

詳細: ウィザードをスキップして構成ファイルを手動で編集します

直接編集 ~/.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. QQ ロボットの作成

Tencent QQ は、2026 年 3 月 7 日に OpenClaw への公式ネイティブ アクセスを正式にオープンしました。個人は無料で、ワンクリックで作成でき、コードを記述する必要はありません。

3.1 ロボットの登録と作成

QQ 开放平台 OpenClaw 接入页面 を開き、携帯電話で QQ を使用して QR コードをスキャンし、登録とログインを完了します。

ログイン後、「ロボットの作成」をクリックし、ロボット名とアバターを設定します。作成後、システムは AppID と AppSecret を生成し、展開ガイドを表示します。

重要: セキュリティ上の理由から、AppSecret はクリア テキストでの保存をサポートしていません。 2 番目のビューでは強制的にリセットされます。すぐにコピーして適切に保存してください。

3.2 インストール構成

デプロイメント ページの指示に従い、ターミナルで 3 つのコマンドを実行します。

QQBot プラグインをインストールします:

openclaw plugins install @sliverp/qqbot@latest

バインディング QQ ロボットの構成:

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

トークンの形式は AppID:AppSecret で、英語のコロンで区切られます。例: "1903127255:tqkcPCOnbQCuclyY"

ゲートウェイを再起動します:

openclaw gateway restart

実行が完了すると、端末に構成成功メッセージが表示されます。

ターミナル出力のスクリーンショットを表示

3.3 チャットを開始する

ブラウザの導入ページに戻り、「スキャンしてチャット」ボタンをクリックし、携帯電話の QQ を使用して QR コードをスキャンし、ロボットを見つけます。メッセージを送信してみてください:

おめでとうございます！あなたはすでに独自の QQ AI アシスタントを持っています。

携帯電話の QQ でロボット名を直接検索して見つけることもできます。

4. 検証と管理

QQ チャットに加えて、Web コントロール パネルから OpenClaw を管理することもできます。

openclaw status

ステータス出力のスクリーンショットを表示

openclaw dashboard

ブラウザによりコントロール パネル http://localhost:18789 が自動的に開きます。

**ローカルホストとは何ですか? ** localhost は「ローカル」を意味します。このページを開くことができるのはあなただけです。

共通コマンドクイックチェック

# 查看状态
openclaw status

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

# 系统诊断和修复
openclaw doctor

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

# 查看日志
openclaw logs --follow

# 重新配置
openclaw configure

OpenClaw をアンインストールする方法

方法 1: 組み込みのアンインストール コマンドを使用する (推奨)

# 交互式卸载
openclaw uninstall

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

方法 2: 手動アンインストール

CLI が削除されてもサービスがまだ実行されている場合は、次の手順に従って手動でクリーンアップします。

1.ゲートウェイ サービスを停止します:

openclaw gateway stop

2.システム サービスをアンインストールします:

openclaw gateway uninstall

3.構成およびステータス データを削除します:

rm -rf ~/.openclaw

4. CLI を削除します (インストール方法に基づいて選択):

# npm 安装
npm rm -g openclaw

# pnpm 安装
pnpm remove -g openclaw

# bun 安装
bun remove -g openclaw

注意: アンインストールする前に、重要なデータが含まれるワークスペース ディレクトリ (~/.openclaw/workspace) をバックアップすることをお勧めします。

5. よくある質問

**Q: 「API キーが見つかりません」というメッセージが表示された場合はどうすればよいですか? **

A: ~/.openclaw/openclaw.json (Windows では C:\Users\你的用户名\.openclaw\openclaw.json) を編集して、API キーが正しく構成されていることを確認します。 第 2 步の設定例を参照してください。

**Q: QQ ロボットが応答しませんか? **

A：以下の点をご確認ください。

1. ゲートウェイは実行されていますか: openclaw status
2. QQ チャネルが正常に構成されているかどうか: openclaw channels status
3. トークンの形式は正しいですか (AppID:AppSecret)
4. 再起動してみます: openclaw gateway restart

**Q: ロボットの応答が遅い、またはタイムアウトしますか? **

A: 機種の反応が遅い可能性があります。より高速なモデル (deepseek-ai/DeepSeek-V3 など) に変更してみるか、ネットワーク接続を確認してください。

---

次のステップ:

• OpenClaw の構成とその他のゲームプレイについて詳しく知りたいですか? → 第二章 命令行与配置详解
• Feishu または Telegram にアクセスしたいですか? → 第三章 移动端接入
• OpenClaw でタスクを定期的に実行したいですか? → 第四章 自动化任务入门