企业官网建设流程全解析

1. 为什么要在本地跑 OpenClaw 并接入 QQ

OpenClaw 是一个能真正操作你电脑的 AI 智能体框架，它和普通聊天机器人的区别在于：它能读写文件、执行终端命令、操作浏览器，甚至帮你搭网站。你可以把它理解成一个住在你电脑里的 AI 员工，而不只是一个会说话的对话框。它适合谁？适合想提高工作效率的职场人、喜欢折腾 AI 行为的技术爱好者，以及想把 AI 无缝接入日常沟通工具（比如 QQ）的开发者。

我试过把 OpenClaw 装在一台备用 Windows 机器上，整个过程踩了不少坑，尤其是 Windows 下的安装权限和包管理器问题。这篇教程会聚焦三条主线：本地安装、QQ 通道对接、以及上门卸载服务（也就是彻底清理）。每一步都给出可复制的命令和配置片段，确保你一次跑通。

先说清楚场景：你有一台能上网的电脑，Windows 或 Mac 都行，建议用虚拟机或备用机，因为 OpenClaw 理论上可以执行任何终端命令，包括删除文件。不需要你会编程，但需要你愿意复制粘贴命令。整个流程大约 10 到 15 分钟，前提是网络顺畅。

安装完成后，你会得到一个能在 QQ 上对话的 AI 助手，手机发消息就能让它干活。但如果你只是尝鲜，后面我也会给出完整的卸载脚本，删得干干净净。另外，如果你想让 OpenClaw 调用大模型时更稳定、更统一地管理 Key，可以把 endpoint 改到 TaoToken，后面会给出 settings 示例。

核心检索词：OpenClaw 安装、OpenClaw 接入 QQ、OpenClaw 卸载、TaoToken 统一 Key 配置。这篇文章就是围绕这几个长尾需求展开的，每一步都有验证方法，避免你装到一半卡住。

2. 安装前的环境准备与 TaoToken 统一 Key 前置

在装 OpenClaw 之前，你需要先搞定运行环境。OpenClaw 是用 JavaScript 写的，所以需要 Node.js 作为运行环境，版本至少 22 以上，低于这个版本会直接失败。Windows 用户还需要 Git，因为安装过程中要从网上拉依赖包。Mac 和 Linux 用户可以用官方一键脚本，但 Windows 用户千万别直接跑一键命令，失败率极高，我实测过多次，下面会给出最稳的路径。

为什么要在前置阶段提 TaoToken？因为 OpenClaw 在配置大模型时需要填 API Key 和 Base URL。如果你用多个模型平台，每个平台都要单独申请 Key，管理起来很乱。TaoToken 提供统一的 Key 管理，你只需要一个 Key，就能在 OpenClaw 里切换不同模型。它的 API 地址是 https://taotoken.net/api，注意这个地址不带任何查询参数，直接填在 Base URL 里就行。

具体操作：先注册 TaoToken 账号，然后在控制台创建 API Key。创建完成后，你会得到一个以 sk- 开头的字符串，这就是你的统一 Key。后面在 OpenClaw 的 settings 里，我们会把 endpoint 指向 TaoToken，这样 OpenClaw 调用模型时就走 TaoToken 的通道，不用再单独配每个平台的 Key。

这里给出一个 settings 示例片段，你可以直接复制到 OpenClaw 的配置文件里。注意路径：Windows 下是%USERPROFILE%\.openclaw\settings.json，Mac 和 Linux 下是~/.openclaw/settings.json。如果你还没装 OpenClaw，这个文件还不存在，先记下这个路径，后面配置阶段会用到。

{ "llm": { "provider": "openai-compatible", "baseUrl": "https://taotoken.net/api", "apiKey": "sk-你的TaoTokenKey", "model": "claude-opus-4-6" } }

注意 model 字段可以换成你需要的模型 ID，比如gemini-2.5-flash-lite或qwen-max。TaoToken 的模型对话页面可以查看当前支持的模型列表，地址是 https://taotoken.net/models?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=model_chat 。如果你只是快速上手，也可以先用 OpenClaw 引导程序里的 Qwen OAuth 免费授权，后面再换成 TaoToken 统一 Key。

环境准备清单：Node.js 22+、Git（Windows）、PowerShell 管理员权限（Windows）、一个 TaoToken API Key。Mac 用户还需要终端，按 Command + 空格搜索“终端”打开即可。Linux 用户直接用系统终端。所有命令都会在下面给出，你只需要按顺序复制执行。

3. 可复制配置：Windows 与 Mac 安装 OpenClaw 及 QQ 接入片段

这一章是核心操作部分，我会给出完整的命令和配置片段。先讲 Windows 安装，再讲 Mac/Linux，然后是 QQ 接入的三条命令，最后是 TaoToken settings 的完整配置。

Windows 安装步骤：

第一步，安装 Node.js。打开 Node.js 官网，下载 22 以上的 LTS 版本，运行安装包，一路下一步，默认配置即可。安装完成后，npm 会自动附带安装。

第二步，安装 Git。打开 Git 官网，下载 Windows 版本，运行安装包，同样一路下一步。

第三步，以管理员身份打开 PowerShell。在搜索栏输入 PowerShell，右键选择“以管理员身份运行”。先执行权限设置命令：

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

弹出确认时输入 A 回车。然后尝试官方一键安装：

iwr -useb https://openclaw.ai/install.ps1 | iex

如果报错提示 npm 安装失败，不要慌，换 pnpm。先全局安装 pnpm：

npm install -g pnpm

然后执行 pnpm setup，注意执行完后必须关闭当前 PowerShell，重新以管理员身份打开一个新的窗口，让环境变量生效。在新窗口中执行：

pnpm add -g openclaw@latest

安装完成后，可能会提示忽略了一些构建脚本，执行pnpm approve-builds -g批准，如果这条命令报错，可以忽略，不影响使用。最后验证：

openclaw -v

能看到版本号就成功了。

Mac/Linux 安装步骤：

打开终端，直接执行官方一键脚本：

curl -fsSL https://openclaw.ai/install.sh | bash

这一步会自动安装所有依赖和 OpenClaw 本体，装完直接跳到配置阶段。

配置 OpenClaw：

执行新手引导命令：

openclaw onboard --install-daemon

--install-daemon表示顺便安装后台服务，关掉终端也不会停。引导程序会依次问你：同意协议、选择 Quickstart、配置大模型、配置聊天渠道、安装 Skills、启动网关。大模型这一步，如果你已经准备好 TaoToken Key，可以选择“其他”或“OpenAI Compatible”，然后填入 Base URLhttps://taotoken.net/api和你的 Key。如果选 Qwen OAuth，会弹出网页扫码授权，免费但可能限流。

QQ 接入配置片段：

打开 QQ 机器人 OpenClaw 接入页面，用 QQ 扫码登录，点击“创建机器人”。创建完成后，页面上会显示三条配置命令，依次复制到 PowerShell 或终端执行。命令中包含你的密钥信息，不要泄露。执行完后，在 OpenClaw 网页控制台的“频道”板块能看到 QQ 机器人渠道已接入。

如果你需要手动写配置，QQ 通道的 settings 片段如下，路径同样是~/.openclaw/settings.json或 Windows 下的%USERPROFILE%\.openclaw\settings.json：

{ "channels": { "qq": { "enabled": true, "botId": "你的QQ机器人ID", "token": "你的QQ机器人Token", "secret": "你的QQ机器人Secret" } }, "llm": { "provider": "openai-compatible", "baseUrl": "https://taotoken.net/api", "apiKey": "sk-你的TaoTokenKey", "model": "claude-opus-4-6" } }

注意 Base URL、API Key、Model ID 这三件套必须同时填对，缺一个都会报错。TaoToken 的 API Key 在控制台创建，地址是 https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=api_keys 。接入文档在 https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=doc 。

4. 验证请求与成功结果：从终端到 QQ 的完整链路

配置完成后，必须验证整条链路是否跑通。验证分三步：先验证 OpenClaw 本体能启动，再验证大模型能调用，最后验证 QQ 通道能收发消息。

第一步，启动网关服务。在终端执行：

openclaw gateway start

如果 Windows 弹出防火墙提示，一定要点“允许”，否则网关无法工作。启动成功后，执行：

openclaw gateway status

看到 running 状态就说明网关正常。

第二步，验证大模型调用。打开 OpenClaw 的网页控制面板，默认地址是 http://localhost:3000 。在对话框里输入“你是谁”，如果配置正确，会返回模型信息。如果报错，看终端输出，常见的是 401 或 local proxy failed。401 通常是 API Key 填错，local proxy failed 通常是 Base URL 写错或网络不通。

你也可以用 curl 直接验证 TaoToken 的接口是否通：

curl -X POST https://taotoken.net/api/v1/chat/completions \ -H "Authorization: Bearer sk-你的TaoTokenKey" \ -H "Content-Type: application/json" \ -d '{"model":"claude-opus-4-6","messages":[{"role":"user","content":"你好"}]}'

如果返回 JSON 里有 choices 字段，说明 Key 和 Base URL 都正确。如果返回 401，检查 Key 是否复制完整；如果返回 reading choices 相关错误，检查 model ID 是否拼写正确。

第三步，验证 QQ 通道。在手机 QQ 上给刚创建的机器人发一条消息，比如“查看电脑配置”。如果 OpenClaw 网页控制台的“频道”里能看到消息记录，并且手机收到回复，说明整条链路跑通。回复支持 Markdown 格式，阅读体验不错。

成功结果示例：手机 QQ 发送“帮我读取下载目录里的文件列表”，OpenClaw 会调用终端命令，把结果返回给你。你可以在网页控制台看到完整的对话记录和工具调用日志。如果这一步成功，说明 OpenClaw 安装、QQ 接入、TaoToken 统一 Key 配置全部生效。

注意：如果你在 QQ 接入时遇到 OAuth 授权失败，检查 QQ 机器人页面的回调地址是否填对。OpenClaw 的 QQ 接入用的是腾讯官方快捷通道，一般不需要手动填回调，但如果你改了配置，需要确保回调地址和 OpenClaw 的网关地址一致。

5. 本篇常见错排查：401、local proxy failed、reading choices、OAuth

这一章列出我踩过的坑和对应的解决方案。每个报错都给出真实场景和修复命令。

报错一：401 Unauthorized。现象：OpenClaw 调用模型时返回 401，终端日志显示 authentication failed。原因：API Key 填错、过期或复制时带了空格。解决：重新在 TaoToken 控制台创建一个 Key，复制时注意不要带前后空格。然后更新 settings.json 里的 apiKey 字段，重启网关：

openclaw gateway restart

报错二：local proxy failed。现象：OpenClaw 启动后，网页控制台无法连接，终端显示 local proxy failed 或 connection refused。原因：Base URL 写错，或者网关端口被占用。解决：检查 settings.json 里的 baseUrl 是否为https://taotoken.net/api，注意不要加/v1后缀，TaoToken 的接口路径已经包含在内部。如果端口被占用，执行：

openclaw gateway stop openclaw gateway start --port 3001

报错三：reading choices 相关错误。现象：调用模型后返回 JSON 解析失败，日志显示 cannot read property 'choices' of undefined。原因：model ID 拼写错误，或者 TaoToken 不支持该模型。解决：在 TaoToken 模型对话页面确认模型 ID，比如claude-opus-4-6或gemini-2.5-flash-lite。更新 settings.json 里的 model 字段，重启网关。

报错四：OAuth 授权失败。现象：选择 Qwen OAuth 时，浏览器弹出授权页面，但回调后 OpenClaw 提示 OAuth failed。原因：浏览器缓存或回调地址不匹配。解决：清除浏览器缓存，重新执行openclaw onboard，选择 Manual 模式，手动填入 TaoToken 的 Base URL 和 Key，跳过 OAuth。这样更稳定，也方便统一管理。

报错五：QQ 机器人无响应。现象：手机 QQ 发消息后，机器人不回复，网页控制台也没有记录。原因：QQ 通道的 token 或 secret 填错，或者网关未启动。解决：检查 settings.json 里的 qq 配置，确保 botId、token、secret 三件套完整。然后执行：

openclaw gateway restart openclaw channels list

看到 qq 通道状态为 active 即可。如果还是不行，重新在 QQ 机器人页面生成 token 和 secret，更新配置。

报错六：pnpm approve-builds 报错。现象：Windows 下执行pnpm approve-builds -g报错，提示找不到命令或权限不足。原因：pnpm 版本问题或全局路径未配置。解决：这条命令不执行也几乎不影响使用，直接忽略。如果 OpenClaw 启动正常，就不用管它。

排障通用思路：先看终端日志，再检查 settings.json 的三件套（Base URL、Key、Model ID），最后重启网关。如果还不行，用 curl 直接测 TaoToken 接口，确认 Key 和网络没问题。接入文档在 https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=doc ，里面有完整的接口说明。

6. 卸载脚本与 TaoToken 统一 Key 的长期使用建议

如果你折腾完发现 OpenClaw 不适合自己，或者只是想尝鲜，这一章给出完整的卸载脚本，删得干干净净。卸载分两步：先执行官方卸载命令，再手动清理残留文件。

官方卸载命令：

openclaw uninstall

执行后注意观察输出，有些内容不会自动删除。为了确保彻底清理，直接复制下面对应你操作系统的所有命令，一把执行。

Mac/Linux 用户：

openclaw gateway stop openclaw gateway uninstall rm -rf "${OPENCLAW_STATE_DIR:-$HOME/.openclaw}" npm rm -g openclaw || pnpm remove -g openclaw rm -rf /Applications/OpenClaw.app

Windows 用户（在 PowerShell 中执行）：

openclaw gateway stop openclaw gateway uninstall schtasks /Delete /F /TN "OpenClaw Gateway" Remove-Item -Recurse -Force "$env:USERPROFILE\.openclaw" Remove-Item -Force "$env:USERPROFILE\.openclaw\gateway.cmd" -ErrorAction SilentlyContinue npm rm -g openclaw # 如果你是用 pnpm 安装的，改为执行： pnpm remove -g openclaw

执行完后，OpenClaw 的网关服务、状态目录、全局包都会被删除。如果你还装了 Node.js 和 Git，可以保留，它们不影响其他开发工具。QQ 机器人可以在 QQ 机器人页面手动删除，或者保留，不影响。

关于 TaoToken 统一 Key 的长期使用建议：如果你决定继续用 OpenClaw，建议把 TaoToken 的 Key 作为默认配置，这样切换模型时只需要改 model 字段，不用重新申请 Key。TaoToken 的 Coding Plan 适合长期编码和 Agent 场景，地址是 https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=coding_plan 。如果你只是偶尔用，模型对话页面就够，地址是 https://taotoken.net/models?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=model_chat 。

最后说一个实用技巧：OpenClaw 的 settings.json 可以备份，下次重装时直接复制回去，省去重新配置的麻烦。但注意 Key 不要泄露，不要提交到 Git 仓库。如果你在团队里用，建议每个人用自己的 TaoToken Key，方便审计和限额。

卸载不是失败，而是知道自己不需要什么。如果你决定继续养虾，记得定期检查网关状态和 Key 余额，避免任务跑到一半断掉。