OpenClaw 小龙虾养虾新手教程

很多人第一次装 OpenClaw，卡住的地方不是命令行，而是不知道装完以后该验证什么。

你以为自己只是想“养一只小龙虾”，结果一上来就碰到 Node 版本、Docker、模型 API Key、Gateway 认证、渠道接入、Skills。每个词都不算难，但堆在一起，挺烦。

这篇不做大全。OpenClaw 橙皮书 v1.4.0 有 114 页，真要展开能讲很久。这里只走一条新手最容易跑通的路径：先完成安装及配置，再用聊天测试确认链路通了，之后再加 Skills 做进阶使用。

OpenClaw 的安装入口很多，但新手不要一上来就追求“最强形态”。先选一种你能维护的方式。

如果你只是想体验，云端一键部署最省心。橙皮书里列了阿里云、腾讯云、百度云、火山引擎、扣子编程、Railway、Zeabur 等方案。国内用户想少折腾，可以优先看阿里云、火山引擎、腾讯云这类已经做了模板的方案；如果你本来就在飞书体系里，火山引擎会顺一点；如果你更在意 QQ、企微，腾讯云方案更贴近。

如果你想在本地装，先看 Node。橙皮书 v1.4.0 写的是 Node.js 22+，但当前官方安装说明已经建议 Node 24，或者至少 Node 22.16+。这类 Agent 工具更新太快，旧教程照抄命令很容易出小问题。

macOS 和 Linux 可以用安装脚本：

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

Windows 用户更稳的方式是 PowerShell 脚本，或者按官方建议走 WSL2：

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

如果你已经装好 Node，也可以用 npm：

npm install -g openclaw@latestopenclaw onboard --install-daemon

onboard 会带你做初始配置，--install-daemon 会安装守护进程，让 OpenClaw 在后台持续运行。装完以后先跑检查：

openclaw doctoropenclaw --version

这一步别省。openclaw doctor 会检查 Node 版本、系统依赖、Gateway、模型 API Key、守护进程状态和网络连通性。跑不过 doctor，就先别接微信、飞书、钉钉。后面的问题大概率会更脏。

如果你准备用 Docker 长期跑，基本路径是这样：

git clone https://github.com/openclaw/openclaw.gitcd openclawdocker-compose up -d

Docker 部署一定要挂载配置和工作区：

volumes:  - ~/.openclaw:/root/.openclaw  - ~/openclaw/workspace:/workspace

前者放配置和状态，后者放 workspace 配置文件。不挂载，容器重启后配置和会话记录可能直接没了。那种感觉很糟糕，像你养了几天的小龙虾，第二天一看缸空了。

安装完成后，配置里最关键的是三件事：Gateway 认证、模型、渠道。

Gateway 认证必须开。橙皮书里提到，v2026.3.7 之后需要显式设置 gateway.auth.mode，可以选 token 或 password。配置大概长这样：

gateway:  auth:    mode: token

模型至少配一个。国内用户可以先从百炼、腾讯云 Coding Plan、火山方舟、DeepSeek、GLM 里挑一个。你如果机器够强，也可以走 Ollama，但别低估本地模型的硬件压力，32GB 内存只是一个比较现实的起点。

模型配置后，用这几条命令确认：

openclaw models listopenclaw models status --probeopenclaw config set agents.defaults.model.primary provider/modelopenclaw gateway restart

渠道先接一个。新手别贪多，Telegram、QQ、浏览器、飞书都可以作为第一条通路。橙皮书给的入门排序很清楚：Telegram 最简单，QQ 和浏览器也很快，飞书适合国内团队，钉钉和企微配置时间会更长。

简单使用：先测聊天

OpenClaw 装好以后，第一件事不是装一堆 Skill，而是确认“聊天链路是否通了”。

先看服务有没有起来。Gateway 默认端口是 18789，Web UI 常见端口是 3000。如果你是云服务器部署，安全组要放通 Web UI 端口；Gateway 不要随手暴露到公网。尤其是认证还没配好的时候，这不是小风险，这是把操作入口递到别人手上。

最简单的测试，是先在命令行给 Agent 发一条消息：

openclaw agent --message "你好，回复一句你当前是否在线"

如果能正常返回，说明模型、Agent、基础运行环境基本通了。然后再测模型状态：

openclaw models status --probe

这一步能帮你区分两个问题：到底是模型 API 不通，还是消息渠道不通。很多新手一看到飞书或 QQ 没回复，就开始重装 OpenClaw。其实可能只是模型 Key 写错了，或者主力模型没有设置。

接下来测试渠道。比如你接的是 Telegram，就给 bot 发一条私信；接的是飞书，就在飞书里给机器人发一句“现在几点”；接的是浏览器 Relay，就让它打开一个普通网页。第一次测试不要让它做复杂任务，别上来就“帮我整理 20 个网页并生成 Excel”。先问一句能不能回，再让它做一个小动作。

我建议按这个顺序测：

openclaw doctoropenclaw models status --probeopenclaw agent --message "请用一句话回复：测试通过"openclaw gateway restart

如果命令行能回，渠道不能回，问题通常在渠道配置、配对码、权限或网络。如果命令行也不能回，先查模型 Key、模型名、网络连通性和守护进程。

简单使用阶段只做三类任务就够：问答、网页浏览、文件读取。问答用来测模型，网页浏览用来测工具调用，文件读取用来测权限边界。

比如你可以这样测试：

openclaw agent --message "读取当前工作区里的 README 文件，并用三句话概括"

能通就行。别急着追求“全自动工作流”。OpenClaw 的价值不是第一天就替你干完所有事，而是先让你确认它能稳定接收指令、调用模型、执行工具、把结果发回来。

说白了，先跑通，再谈聪明。

进阶使用：再补 Skill

简单聊天通了以后，才进入进阶使用。这个阶段的核心不是“多接几个群”，而是给 OpenClaw 装能力。

OpenClaw 的扩展能力主要靠 Skills 和插件。橙皮书里提到，ClawHub 上已经有大量 Skills，官方也内置了一批基础能力。你可以把 Skill 理解成给 Agent 加工具包：有的负责浏览器，有的负责文件处理，有的负责连接国内 IM，有的负责桥接 Claude Code。

常用命令大概是这几类：

openclaw plugins listopenclaw plugins install <name>openclaw plugins enable <name>

国内用户经常会用到 openclaw-china 这类插件套件，用来接 QQ、钉钉、企微、微信等渠道：

openclaw plugins install @openclaw-china/channelsopenclaw china setup

如果你想把 OpenClaw 和 Claude Code 串起来，可以看社区里的 openclaw-claude-code-skill。它的意义很简单：OpenClaw 负责消息入口和自动化调度，Claude Code 负责代码任务。一个管“从哪里来”，一个管“怎么改代码”。这个组合会比单独把 Claude Code 当聊天窗口更像工作流。

但进阶使用最容易出事的地方，也在 Skills。

橙皮书里列过 ClawHub 相关安全问题，包括恶意 Skill、低质量 Skill、供应链攻击。第三方 Skill 本质上就是给你的 Agent 加能力。能力越大，出事时越麻烦。别在 ClawHub 里看到顺眼就装，至少看三件事：来源是否可信、仓库是否活跃、代码有没有明显读取密钥或上传文件的逻辑。

升级或改配置前，先备份：

openclaw backup createopenclaw backup verify

成本也要管。OpenClaw 本身开源免费，不代表使用免费。服务器可能只要几十块一年，模型 API 才是长期账单。多轮工具调用会吃 Token，尤其是你让它连续查网页、写文件、跑浏览器的时候，账单涨得很快。

我的建议是，进阶阶段按顺序加能力：先加浏览器自动化，再加国内渠道，再加文件和办公类 Skill，再考虑代码类 Skill。每加一个，单独测一次，不要一口气装十几个。

OpenClaw 的吸引力，不在于它又多了一个聊天入口，而在于它把“对话”往“执行”推了一步。你发一句话，它可以去调工具、开浏览器、查文件、写脚本、回消息。

但也正因为它能执行，新手最该追求的不是功能全，而是边界清楚。

一条更稳的新手路线是：安装及配置先跑稳，简单使用确认聊天和模型通路，进阶使用再加 Skills。能跑起来只是入门。敢让它长期跑，才算真的养上了。