1. 先搞清楚 OpenClaw 到底能帮你干什么OpenClaw 是一个开源、本地优先的 AI 智能体框架你可以把它理解成一个能真正接管电脑干活的数字员工。它和 ChatGPT、Kimi 这类纯聊天工具最大的区别在于普通大模型只告诉你“怎么做”OpenClaw 会直接打开软件、读写文件、跑脚本、发消息把事做完。它支持部署在个人电脑、云服务器、NAS 或迷你主机上服务跑在你自己的机器里文件、日志、配置默认都存在本地数据可控。适合谁用完全不会敲代码的小白只要会复制粘贴命令就能在自己电脑上养一只会干活的“小龙虾”。它能做的事包括按规则整理文件夹、批量重命名、跑命令行任务、清理收件箱生成摘要、通过 QQ/飞书/钉钉等聊天工具对话、安装社区 Skills 扩展新能力。官方名字叫 OpenClaw因为 Logo 是一只红色小龙虾加上 Claw 是“钳子”的意思大家就亲切地叫它“小龙虾”部署配置的过程也就成了“养虾”。这篇教程面向零基础用户聚焦 OpenClaw 在 Docker 与 Node.js 环境下的完整安装流程并演示如何通过 TaoToken 统一 Key/API 通道完成 onboard 配置。我会交付可复制的 config.toml 骨架、Docker 启动命令与 QQ 接入验证动作帮你独立养好自己的小龙虾。整个过程分九步确认机器配置、安装基础环境、获取并安装 OpenClaw、启动服务、运行 onboard 向导、接入大模型、装技能、配置对话入口、发测试指令验证。2. 养虾前的前置准备TaoToken 统一 Key 与机器自检在动手装 OpenClaw 之前有两件事要先搞定一是确认机器够不够格二是准备好大模型的统一接入通道。硬件方面只玩 Gateway 模式大模型推理在云端本地只负责收消息、调 API、跑脚本的话2 GB 内存加一点 SSD 空间就够了要浏览器自动化、多通道聊天至少 4 到 8 GB 内存想在本地跑大模型16 到 32 GB 内存起步最好有带 8 到 24 GB 显存的显卡。操作系统推荐 Ubuntu 22.04、Debian 12 或 macOS 原生Windows 用户建议通过 WSL2 跑 Ubuntu。Node.js 版本必须 ≥ 22Docker 可选但推荐。模型接入这块新手最容易卡在“每个模型厂商都要单独申请 Key、单独配 endpoint”上。我试过用 TaoToken 做统一通道它把多家模型的 API 收敛成一个 Key 和一个兼容 OpenAI 协议的入口OpenClaw 的 onboard 里只要填一次就能切换模型省去反复改配置的麻烦。TaoToken 官网是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 入口是 https://taotoken.net/api 注意 API 地址不带 UTM 参数。你需要提前准备的东西一个 TaoToken 账号和对应的 API Key在控制台里生成一台满足上面配置的机器以及稳定的网络。如果你打算用 Docker 部署确认docker --version能正常输出且版本在 24.0 以上如果用 Node.js 直接跑确认node -v输出 v22 及以上。Windows 用户先在管理员模式 PowerShell 里执行wsl --install -d Ubuntu-24.04重启后在 Ubuntu 终端里操作记住 OpenClaw 的所有安装都在 WSL 的 Linux 环境里进行不是在 Windows 的 CMD 里。自检清单可以这样跑一遍node -v看版本、npm -v看包管理器、git --version看版本控制工具、free -h看内存、df -h /看磁盘空余、lscpu | grep CPU(s)看核心数。如果内存不足 4 GB先跑最基础的 Gateway 模式体验控制并发和任务复杂度如果磁盘空间紧张至少留 10 GB 给系统和 OpenClaw如果 Windows 不想折腾 WSL2直接租一台 2 vCPU 4 GB RAM 40 GB SSD 的云服务器照着 Linux 教程走。3. 可复制配置Node.js 环境、Docker 部署与 config.toml 骨架3.1 安装 Node.js 22 与 GitLinuxUbuntu/Debian和 WSL2 里用 NodeSource 源最省事# 添加 NodeSource 官方源 curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash - # 安装 Node.js Git sudo apt update sudo apt install -y nodejs git # 验证版本 node -v npm -v git --version如果node -v输出小于 22说明源没配好重新执行上面步骤。macOS 用户用 Homebrewbrew update brew install node git。想在同一台机器跑多版本 Node用 nvmcurl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash然后source ~/.bashrc再nvm install 22 nvm use 22 nvm alias default 22。3.2 安装 OpenClaw 主程序官方一键脚本适合大多数新手会自动检测 Node 版本、用 npm 全局安装最新稳定版并默认拉起一次 onboard# 标准安装包含自动 onboard curl -fsSL https://openclaw.ai/install.sh | bash如果只想先装好不配置加参数跳过 onboardcurl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard。已经装好 Node 22 的话也可以手动装# 全局安装 OpenClaw npm install -g openclawlatest # 第一次初始化 安装守护进程 openclaw onboard --install-daemon如果安装时 sharp 报错加环境变量再装SHARP_IGNORE_GLOBAL_LIBVIPS1 npm install -g openclawlatest。用 pnpm 的话pnpm add -g openclawlatest然后pnpm approve-builds -g批准构建脚本再openclaw onboard --install-daemon。3.3 Docker 部署云服务器、NAS、迷你主机用户想环境隔离直接用官方 Docker 镜像# 拉取最新稳定版镜像 docker pull openclaw/openclaw:latest # 启动容器 docker run -d \ --name openclaw \ -p 8080:8080 \ -v $HOME/.openclaw:/root/.openclaw \ -v $HOME/openclaw-data:/root/openclaw-data \ openclaw/openclaw:latest-p 8080:8080把容器内 8080 端口映射到宿主机后面可以通过http://服务器IP:8080打开 Web 控制台。-v把配置和数据挂载到宿主机目录方便备份迁移。进容器跑 onboarddocker exec -it openclaw /bin/bash然后openclaw onboard --install-daemon。3.4 config.toml 骨架与 TaoToken 统一 Key 配置OpenClaw 的配置文件默认在~/.openclaw/openclaw.json但很多部署场景也支持config.toml格式。下面是一份可复制的骨架把模型 provider 指向 TaoToken 的统一入口你只需要替换api_key为自己的 Key# ~/.openclaw/config.toml mode gateway [model] provider openai-compatible model gpt-4o-mini api_key 你的TaoToken_API_Key api_endpoint https://taotoken.net/api temperature 0.3 [gateway] port 8080 host 0.0.0.0 [skills] enabled [file-manager, shell-runner]如果你更习惯 JSON 格式对应的openclaw.json写法是{ mode: gateway, model: { provider: openai-compatible, model: gpt-4o-mini, api_key: 你的TaoToken_API_Key, api_endpoint: https://taotoken.net/api, temperature: 0.3 } }TaoToken 的 API 入口是 https://taotoken.net/api 它兼容 OpenAI 协议所以 provider 填openai-compatible就能对接。Key 在控制台的 API Keys 页面生成地址是 https://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。如果你后面想换模型只改model字段就行不用动 endpoint 和 Key。4. 验证请求onboard 向导、健康检查与 QQ 接入4.1 跑通 onboard 配置向导openclaw onboard --install-daemon是 OpenClaw 自带的交互式新手引导会一步步问几个关键问题然后自动生成完整可用的配置文件顺带把服务拉起来。执行后终端会出现一连串提问用方向键选择或直接回车接受默认值个别地方粘贴 API Key。标准流程大致是这样先确认个人使用条款选 QuickStart 模式Config handling 选 Use existing values然后到 Model/auth provider 这一步。如果你用 TaoToken 统一通道选OpenAI或OpenAI-compatible这类选项然后把 API Key 填成 TaoToken 的 Keyendpoint 填https://taotoken.net/api。接着选默认模型、选 channel可以先 Skip for now、选 search providerSkip、Configure skills 可以先选 NoEnable hooks 选 Skip。最后 Gateway service 选 Restart看到Onboarding complete就成功了。跑完后用命令确认链路openclaw --version # 看版本号有输出就行 openclaw doctor # 环境自检有 WARN 正常别出现 FATAL openclaw status # 看守护进程/网关是否 running如果openclaw doctor里模型连通性检查通过说明 TaoToken 的 Key 和 endpoint 都配对了。想进一步验证模型对话可以打开模型对话页面 https://taotoken.net/model-chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 发一条测试消息确认 Key 有额度、模型能正常返回。4.2 打开 Web 控制台openclaw dashboard会自动打开浏览器或手动访问http://localhost:8080Docker 部署换成服务器 IP。能看到 Web 界面就说明网关起来了。4.3 QQ 接入验证浏览器打开 QQ 开放平台QQ 扫码登录创建机器人。创建完成后按页面指引复制配置信息到终端# 安装 QQ 机器人插件 openclaw plugins install sliverp/qqbotlatest # 添加 QQ 频道替换为你的 AppID 和 AppSecret openclaw channels add --channel qqbot --token 你的AppID:你的AppSecret # 重启网关 openclaw gateway restart然后点“扫码聊天”把机器人添加到 QQ 上。之后在 QQ 里给 OpenClaw 发一条指令比如“帮我看看当前目录有哪些文件”如果它能正确响应说明整条链路——从 QQ 消息到 OpenClaw 网关、再到 TaoToken 模型通道——全部打通了。5. 本篇常见错排查openclaw: command not foundnpm 全局安装路径不在 PATH 里。先跑npm prefix -g看全局路径如果$(npm prefix -g)/bin没在echo $PATH里手动加一行到~/.bashrc或~/.zshrcexport PATH$(npm prefix -g)/bin:$PATH然后source ~/.bashrc。sharp 或 node-gyp 编译错误优先用官方推荐的环境变量走预编译包SHARP_IGNORE_GLOBAL_LIBVIPS1 npm install -g openclawlatest。如果还报错检查系统有没有装 build-essential 和 python3。Docker 里服务起不来先sudo systemctl status docker确认 Docker 在运行再看容器日志docker logs -f openclaw。如果是 8080 端口被占用改映射端口docker run -d --name openclaw -p 18080:8080 ...然后用http://localhost:18080访问。onboard 里模型认证失败检查 TaoToken 的 API Key 有没有复制完整、有没有多余空格endpoint 是不是https://taotoken.net/api注意不要带 UTM 参数。如果返回 401去控制台确认 Key 状态和额度如果返回 404检查 endpoint 路径有没有写错。WSL2 里 node 找不到但 Windows 能跑说明 Node 装在 Windows 系统里了WSL 是另一套环境。记住 OpenClaw 的所有安装都在 WSL 的 Linux 里进行重新在 Ubuntu 终端里按 Linux 方式装 Node.js。QQ 机器人不响应先openclaw status看网关是否 running再openclaw channels list确认 qqbot 通道已添加。如果通道在但消息没反应检查 AppID 和 AppSecret 有没有拼错格式是AppID:AppSecret中间用冒号。重启网关后再试。6. 后续怎么玩从能跑到好用到这里你已经完成了搭好运行环境、安装 OpenClaw 主程序、通过 onboard 配好基本网关、接上 TaoToken 统一模型通道和一个 QQ 聊天入口。这只小龙虾已经可以帮你整理桌面和文件夹、每天定时发日报草稿、把邮箱未读整理成摘要、自动从网页抓数据整理成表格。后面想进一步折腾有几个方向。一是装更多 Skills在 onboard 里选 Configure skills 或者手动openclaw plugins install装社区技能让它会操作文件、跑命令、发邮件。二是多通道融合除了 QQ 还能接飞书、钉钉、企业微信一个网关调度不同通道。三是长期编码和 Agent 场景如果你打算让 OpenClaw 长时间跑自动化任务、写代码、做 CI 集成可以看看 Coding Plan https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 它针对高频编码场景做了额度优化。接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 遇到配置问题可以对照查。踩过的坑里最值得提醒的一条onboard 第一次跑的时候别急着把所有通道和技能都配上先把模型接通、网关跑起来、发一条测试指令确认能干活再回头补聊天入口和 Skills。这样出问题的时候排查范围小不会一上来就被一堆配置项绕晕。