📖 智维盘完整教程

从零开始，搭建你的私人 AI 助手 —— 小白也能看懂

什么是 OpenClaw？

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

🤖 AI 机器人：接入 QQ、飞书、Telegram 等 20+ 聊天平台
🧠 智能网关：调用 DeepSeek、Kimi、Claude 等 50+ AI 模型
🔧 全能助手：52+ 技能：发邮件、管日程、操作笔记、搜索
⏰ 自动化：设定时任务、自动执行工作流

核心架构

                你的聊天平台 ←→ OpenClaw Gateway ←→ AI 模型

                (QQ/飞书/TG)    (你的电脑)       (DeepSeek/Kimi/Claude)

                ↕

                技能 & 工具

                (邮件/笔记/日程/搜索...)

智维盘是 OpenClaw 的便携版 —— 把整套系统做成 U 盘，插上就能用，还能安装到电脑。所有依赖走国内镜像，无需翻墙。

选择安装方式

方式	适合谁	需要联网	难度	耗时
A. U 盘安装	完全小白	不需要	简单	2 分钟
B. 一键脚本	会用终端的用户	需要	简单	5 分钟
C. 手工安装	想深入理解的开发者	需要	中等	15 分钟

方式 A：U 盘安装（推荐小白）

最简单的方式，不需要联网，不需要终端知识。

第一步：插入智维盘 U 盘

把智维盘 U 盘插入电脑的 USB 口。

第二步：运行启动脚本

Mac：双击 Mac-Start.command
Windows：双击 Windows-Start.bat

Mac 提示「未验证的开发者」？

右键脚本 → 打开。

第三步：首次配置

浏览器自动打开配置页面，选择 AI 模型、填入 API Key，完成！

安装到电脑（可选）

如果不想每次都插 U 盘：

Mac：双击 Mac-Install.command，安装到 ~/.zqclaw/
Windows：双击 Windows-Install.bat，安装到 %USERPROFILE%\.zqclaw\

方式 B：一键脚本安装

需要联网，通过终端一行命令完成安装。

Mac / Linux / WSL2

curl -fsSL https://zqclaw.itmsky.com/install.sh | bash

Windows (PowerShell 管理员)

irm https://zqclaw.itmsky.com/install.ps1 | iex

验证安装

                openclaw --version # 查看版本

                openclaw onboard # 启动配置向导

方式 C：完全手工安装（开发者推荐）

一步一步手动安装，理解每个组件。适合想深入学习、或网络环境特殊的用户。

第一步：安装 Node.js 22+

OpenClaw 运行在 Node.js 上，需要 v22 或更高版本。

什么是 Node.js？

Node.js 是一个 JavaScript 运行环境。你不需要会写 JavaScript，只需要安装它作为 OpenClaw 的运行基础。类似于「Java 程序需要 JDK」。

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

国内直连：nodejs.cn/download（速度快）
官网：nodejs.org/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. 设置国内镜像（关键！否则下载很慢）

                echo 'export NVM_NODEJS_ORG_MIRROR=https://npmmirror.com/mirrors/node' >> ~/.zshrc

                source ~/.zshrc

                # 3. 安装 Node.js 22

                nvm install 22

                nvm use 22

                # 4. 验证

                node -v # 应显示 v22.x.x

第二步：设置 npm 国内镜像

必须做！不换镜像的话，后续安装 OpenClaw 会超时失败。

                # 设置淘宝 npmmirror（首选，最快最稳）

                npm config set registry https://registry.npmmirror.com

                # 验证

                npm config get registry

                # 应返回: https://registry.npmmirror.com/

第三步：安装 OpenClaw

方式 A：npm 安装（通用）

                # 全局安装

                npm install -g openclaw@latest

                # 如果超时，手动指定镜像

                npm install -g openclaw@latest --registry=https://registry.npmmirror.com

                # 验证

                openclaw --version

方式 B：pnpm 安装（更快）

                # 如果没有 pnpm，先安装

                npm install -g pnpm

                # 用 pnpm 安装 OpenClaw

                pnpm add -g openclaw@latest

                pnpm approve-builds -g

                openclaw onboard --install-daemon

方式 C：从源码构建（开发者）

                git clone https://github.com/openclaw/openclaw.git

                cd openclaw && pnpm install && pnpm ui:build && pnpm build

                pnpm link --global

                openclaw --version

第四步：启动配置向导

                # 推荐：启动向导 + 安装后台服务

                openclaw onboard --install-daemon

                # 或只启动向导

                openclaw onboard

第五步：验证一切正常

                openclaw status # 查看运行状态

                openclaw doctor --repair # 诊断并修复问题

                openclaw dashboard # 打开网页控制台

模型选择指南

模型	特长	价格	需翻墙	推荐场景
DeepSeek	编程、逻辑	~1元/百万token	不需要	⭐ 日常首选
Kimi	长文档 256K	中等	不需要	长文分析
通义千问	中文理解好	大量免费额度	不需要	免费体验
智谱 GLM	学术 NLP	有免费额度	不需要	学术场景
Claude	最强综合	较贵	需要	复杂推理
GPT-4	广泛兼容	较贵	需要	通用

QQ 机器人配置（国内首选）

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

第一步：创建机器人

前往 QQ 开放平台，点击「创建机器人」→ 填写基本信息 → 获得 AppID 和 AppSecret。

第二步：安装 QQ 插件并配置

                    # 安装 QQ 插件（智维盘用户已预装，跳过此步）

                    openclaw plugins install @sliverp/qqbot@latest

                    # 绑定 QQ 机器人

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

                    # 设置白名单（重要！否则任何人都能用你的机器人）

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

                    # 重启生效

                    openclaw gateway restart

⚠️ 安全提醒：

一定要设置 allowFrom 白名单！默认是 *（任何人都能用），会消耗你的 API 额度。

飞书机器人配置（企业推荐）

第一步：获取凭证

在应用的「凭证与基础信息」页面，复制 App ID 和 App Secret。

第二步：配置权限

进入「权限管理」，开启消息相关权限（接收消息、发送消息、获取用户信息等）。

第三步：绑定到 OpenClaw

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

                    openclaw gateway restart

技能系统

智维盘已预装 52 个技能，开箱即用。

技能	用途	示例
github	GitHub 操作	「帮我看 #123 这个 Issue」
summarize	内容总结	「总结这个网页」
weather	天气查询	「今天北京天气」
himalaya	邮件管理	「帮我发邮件」
obsidian	笔记操作	「在 Obsidian 创建笔记」
coding-agent	编程委派	「帮我重构这个函数」

                # 搜索更多技能

                openclaw skills search 翻译

                # 安装新技能

                openclaw skills install @xxx/skill-name

故障排除

"Node.js v22+ is required"

                # 检查当前版本

                node -v

                # 如果低于 v22，升级

                nvm install 22 # 如果用 nvm

                fnm install 22 # 如果用 fnm

npm install 超时

                # 设置淘宝镜像

                npm config set registry https://registry.npmmirror.com

                # 清除缓存重试

                npm cache clean --force

                npm install -g openclaw@latest

AI 不回复消息

检查 API Key 是否正确：openclaw configure
检查网关是否在运行：openclaw status
查看错误日志：openclaw logs --follow
运行诊断：openclaw doctor --repair

端口被占用

                # Mac/Linux:

                lsof -i :18789

                # Windows:

                netstat -ano | findstr ":18789"

                # 杀死进程后重启

                openclaw gateway restart

命令速查

命令	用途
`openclaw status`	查看运行状态
`openclaw dashboard`	打开网页控制台
`openclaw tui`	终端对话模式
`openclaw gateway restart`	重启网关
`openclaw gateway stop`	停止网关
`openclaw doctor --repair`	诊断并修复
`openclaw configure`	重新配置
`openclaw logs --follow`	实时查看日志
`openclaw plugins list`	列出已安装插件
`openclaw cron list`	查看定时任务

多模型与省钱技巧

日常对话用 DeepSeek（~1元/百万 token），复杂任务切 Claude
用 OpenRouter 统一管理多个模型，一个 Key 用所有
为不同聊天平台配置不同模型（QQ 用便宜的，工作飞书用好的）
善用免费额度：通义千问、Gemini 都有大量免费额度