从零开始配置你的小龙虾：把 OpenClaw 养成一个能用的个人 AI 助手

我第一次看 OpenClaw 的时候，最容易被它的名字带偏。小龙虾听起来像一个玩具，但它真正想做的事情其实很朴素：把一个 AI 助手放在你自己的设备或服务器上，让它通过你常用的聊天工具、命令行、网页界面帮你处理事情。

如果只把它理解成“另一个 ChatGPT 客户端”，就会有点可惜。OpenClaw 更像是一只可以长期待命的小助手。它有一个网关负责接收消息，有模型负责思考，有渠道负责和你聊天，有 Skills 负责学会具体工作。刚开始不用追求复杂，先把它装起来、能说话、能稳定运行，就已经完成了第一步。

这篇不是给老手看的部署手册，而是给完全没接触过的人看的入门笔记。目标只有一个：从零开始，把你的小龙虾养到“能被你叫醒、能回答你、能继续往后扩展”。

1. 先理解小龙虾在做什么

OpenClaw 可以简单拆成四层：

你发消息
  ↓
聊天渠道 / 命令行 / Web 界面
  ↓
OpenClaw Gateway
  ↓
大模型 + Skills + 本地工具

这里最重要的是 Gateway。你可以把它理解成小龙虾的“虾壳”，所有消息先进到这里，再由它决定要不要调用模型、工具或技能。

所以配置 OpenClaw，不是一上来就写复杂脚本，而是依次确认几件事：

1. 电脑或服务器能运行 Node
2. OpenClaw CLI 能安装成功
3. Gateway 能启动
4. 模型 API 能接上
5. 至少有一个入口可以和它说话

只要这五件事跑通，小龙虾就算领养成功。后面的 Telegram、飞书、微信、Skills、定时任务，都只是继续加能力。

2. 准备一块“虾池”

你可以把 OpenClaw 装在自己的电脑上，也可以装在云服务器上。

如果只是想试试看，电脑就够了。如果希望它 24 小时在线，最好准备一台云服务器。新手不用买很贵的机器，普通 1 核 1G 或 2G 的 Linux VPS 就能开始。

我建议新手先选这三种环境之一：

macOS：适合本地体验，安装最省心
Linux VPS：适合长期在线，后续接聊天平台更方便
Windows：也可以用，但命令行和后台运行会稍微多一点步骤

不建议一开始就同时折腾 Docker、反向代理、多个聊天渠道和一堆 Skills。新手最容易失败的地方不是 OpenClaw 难，而是第一天就想把它做成全自动管家。

先让它活着，再让它聪明。

3. 安装 Node

OpenClaw 需要 Node 环境。官方建议使用 Node 24，或者至少 Node 22.19 以上。

如果你在 Linux VPS 上，可以先检查：

node -v
npm -v

如果提示没有这个命令，说明还没安装 Node。新手可以用 nvm 安装，比较不容易污染系统环境。

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/master/install.sh | bash

安装完以后，重新打开终端，或者执行：

source ~/.bashrc

然后安装 Node 24：

nvm install 24
nvm use 24

再确认一次：

node -v
npm -v

看到版本号，就说明这一步完成了。

这一段看起来普通，但很重要。很多安装失败不是 OpenClaw 的问题，而是 Node 版本太旧，或者 npm 没装好。

4. 安装 OpenClaw

Node 准备好以后，就可以安装 OpenClaw CLI。

npm install -g openclaw@latest

装完以后检查：

openclaw --version

如果能看到版本号，说明 CLI 已经装好了。

接下来不要急着自己改配置文件，先用官方的引导命令：

openclaw onboard --install-daemon

这个命令会一步一步带你配置 Gateway、工作区、模型和基础入口。--install-daemon 的意思是顺便把 Gateway 安装成后台服务，这样它不需要你一直开着终端。

你可以把这一步理解成给小龙虾办入住：

安装 CLI：把小龙虾带回家
onboard：给它安排房间、钥匙和联系方式
install-daemon：让它能自己待在后台

如果只是想临时测试，也可以不装后台服务。但对新手来说，直接按官方推荐走，少一点自由发挥，成功率更高。

5. 检查 Gateway 有没有跑起来

配置完成后，先不要急着接 Telegram 或飞书。第一件事是看 Gateway 状态。

openclaw gateway status

如果状态是 running，说明网关已经起来了。

如果没有起来，可以用前台调试模式看日志：

openclaw gateway --port 18789 --verbose

前台模式的好处是错误会直接显示出来。比如端口被占用、配置文件错误、模型 key 没填对，都能看到。

我自己排查这类工具时有一个习惯：不要看到失败就重装。先看日志。因为后台服务失败时，真正的原因往往只藏在一两行错误里。

常见问题大概有三类：

端口被占用：换端口，或者停掉占用端口的程序
Node 版本不对：升级到 Node 24 或 22.19+
模型 API 配错：检查 provider、base_url、api_key、model 名称

新手只要记住一点：Gateway 跑起来之前，不要继续接复杂渠道。否则你会同时面对很多错误，不知道是哪一层坏了。

6. 接上大模型

OpenClaw 自己不是大模型，它需要接一个模型提供商。你可以理解成：小龙虾有身体，但还需要一个大脑。

通常你需要准备：

API Key
模型名称
服务地址 base_url，如果是兼容 OpenAI 格式的服务

不同提供商的配置方式会有差异，所以这里不建议硬背某一份配置。更稳妥的做法是跟着 onboard 的提示填。

如果你用的是 OpenAI 兼容接口，核心信息一般长这样：

Provider: openai-compatible
Base URL: https://你的服务地址/v1
API Key: sk-xxxx
Model: 你要使用的模型名

填完以后，一定要做一次最小测试。不要一上来问它复杂问题，先问：

你好，你现在能正常回复吗？

如果它能回，说明模型链路通了。如果不能回，优先检查三件事：

1. API Key 有没有复制完整
2. 模型名是不是服务商真实支持的名字
3. base_url 后面要不要带 /v1

这一步像给小龙虾喂第一口食物。它能吃下去，后面才能工作。

7. 先用命令行和它说话

很多人一开始会急着接微信、QQ、Telegram。我的建议相反：先用最简单的入口说一句话。

如果 CLI 已经配置好，可以先从本地对话开始。目标不是体验有多完整，而是确认整条链路能跑通：

你 → OpenClaw → 模型 → OpenClaw → 你

这一条链路没问题，再去接聊天平台。

如果你先接聊天平台，问题会变成：

是平台 webhook 没通？
是 Gateway 没跑？
是模型没回？
是权限不够？
是网络被挡？

新手最怕这种错误堆在一起。所以第一天的原则很简单：入口越少越好，变量越少越好。

8. 再接一个你真正会用的聊天渠道

等命令行能正常回复后，再接一个你平时真的会打开的渠道。不要为了“支持 20 多个平台”而全部接一遍。

你可以先选一个：

Telegram：适合个人远程使用
Discord：适合开发和社群场景
飞书 / 钉钉：适合团队协作
WebChat：适合先本地体验

接渠道时，新手最需要注意的是“消息从哪里进来”。很多聊天平台都要配置 bot token、webhook、回调地址或扫码登录。它们不是 OpenClaw 的核心难点，但每个平台都有自己的小脾气。

我的建议是只接一个，并且写下三件事：

渠道名称：
凭据放在哪里：
如何测试一条消息：

例如：

渠道名称：Telegram
凭据：Bot Token
测试方式：给 bot 发“你好”

这张小卡片以后很有用。等你半年后迁移服务器、换模型或排查问题时，不用重新从聊天记录里翻配置。

9. Skills 不要第一天就装太多

OpenClaw 真正有意思的地方是 Skills。Skills 可以让它学会更具体的工作，比如读文件、查网页、管理日程、写报告、调用脚本。

但新手第一天不要装太多 Skills。

我会先准备三个层级：

第一层：聊天能用
第二层：能读取有限目录
第三层：能执行明确工具

比如你想让它帮你整理资料，可以先只开放一个测试目录：

claw-workspace/
  inbox/
  notes/
  outputs/

不要一上来把整个主目录、浏览器配置、密钥目录都给它。AI 助手越强，边界越要清楚。

我更喜欢这种保守配置：

可以读：指定资料目录
可以写：指定输出目录
不能碰：密钥、浏览器登录态、系统配置、私人文件

这不是不信任 AI，而是给系统留出可恢复的空间。一个好用的小龙虾，不应该第一天就拥有你电脑里的全部钥匙。

10. 给小龙虾准备一个工作区

比起复杂配置，我更建议新手先建一个清楚的工作目录。

claw-workspace/
  inbox/        临时放输入材料
  notes/        放长期说明和规则
  outputs/      放小龙虾生成的结果
  logs/         放你自己想保留的运行记录
  skills/       后续自定义技能

这个目录不是必须的，但它能减少很多混乱。

你以后可以对小龙虾说：

请只读取 inbox 和 notes。
结果写到 outputs。
不确定的地方先问我，不要直接覆盖原文件。

这句话看起来很啰嗦，但它会让 AI 助手从“随便发挥”变成“在一个小工作台上干活”。

我越来越觉得，AI 工具的稳定性不只来自模型，也来自人给它准备的工作环境。桌面越乱，助手越容易乱。

11. 第一次配置完成后，做一张检查清单

配置 OpenClaw 最后不要只凭感觉说“应该好了”。最好留一张检查清单。

[ ] node -v 能看到 Node 22.19+ 或 24
[ ] openclaw --version 能显示版本
[ ] openclaw gateway status 是 running
[ ] 模型 API 能正常回复
[ ] 至少一个入口可以发消息
[ ] 工作区目录已经建好
[ ] 敏感目录没有开放给工具
[ ] 知道如何停止 Gateway

其中最后一项很容易被忽略。你至少要知道怎么停掉它：

openclaw gateway stop

会启动，也要会停止。这和养宠物有点像，不能只知道怎么喂，也要知道怎么关笼门、怎么清理环境。

12. 先别急着自动化一切

很多人装完 OpenClaw 后，会立刻想做这些事：

让它自动读消息
让它自动发日报
让它自动整理文件
让它自动执行命令
让它自动控制服务器

这些都可以做，但不应该第一天做。

第一天最好的结果其实很简单：

我能叫醒它。
它能回答我。
我知道它在哪里运行。
我知道它能访问什么。
我知道它出错时去哪看。

只要做到这五点，小龙虾就已经不是玩具了。它已经变成一个可以继续训练、继续加技能的个人助手。

自动化不是越早越好。边界没画好之前，自动化只会把错误放大。

13. 复盘

从零配置 OpenClaw，最难的不是命令，而是顺序。

新手很容易一上来就被各种名词吸引：Gateway、Channels、Skills、MCP、Webhook、Daemon、Provider。其实第一轮只需要按最小路径走：

装 Node
装 OpenClaw
跑 onboard
启动 Gateway
接模型
发一句话

我会把这条路径称为“先让小龙虾活过来”。等它能稳定回应，再接聊天平台；等聊天平台稳定，再加 Skills；等 Skills 稳定，再考虑定时任务和自动化。

好的个人 AI 助手，不是一开始就全能，而是每一步都知道自己能做什么、不能做什么。OpenClaw 的价值也在这里：它把 AI 从一个网页对话框，慢慢变成你自己的工作流入口。

但入口越多，越需要边界。先养活，再训练。先能说话，再让它办事。