从0开始打造一个属于自己的小龙虾助理
想要了解OpenClaw,最直接的方式就是先安装一个，然后用起来，在用的过程中逐渐的熟悉跟了解。
俗称，干中学。下面就让我们一起把环境配置好。
1. 运行环境介绍
我这边准备了一个 Linux 环境，理论上来说，如果你是买的云厂商的 OpenClaw,它也是跑在Linux环境上的。
下面是我的一些配置规划。
- 配置目录：
~/.openclaw/（含openclaw.json、凭证等） - 工作区：Agent 读写文件的家目录，默认
~/.openclaw/workspace/；路径可在openclaw.json的agents.defaults.workspace调整；安装向导会生成SOUL.md、AGENTS.md等引导文件 - 安装与自启：用官方安装脚本装 OpenClaw；向导里选择「安装守护进程」，Gateway 在后台运行，Linux 重启后会自动启动
- Control UI：端口 18789，须 Gateway token 鉴权
- 谁能连上：Gateway 监听 18789；向导可选 loopback 或 LAN（局域网访问见步骤 4.4）
Node 环境要求
OpenClaw 运行在 Node 之上。版本要求：
- 推荐 Node 24
- 最低 Node 22.19+
所以在开始之前，可以先执行下面这条命令检查自己的环境是否齐全了。
node --version
LLM API 要求
这个没什么要求。支持线上API也支持本地Ollama，本篇文章以 DeepSeek 为例。
2. 安装
为了快速安装好，这边我选择先安装后改配置的形式。
步骤 1：安装 OpenClaw
下面提供两个方式进行安装。
方式一：
curl -fsSL https://openclaw.ai/install.sh | bash
方式二：
npm i -g openclaw@latest
安装完成后确认 CLI 可用：
openclaw --version
步骤 2：运行安装向导
通过方式一进行安装的话，默认会自动进入向导，如果是通过其它方式安装没有进入配置向导的话，可以通过下面的命令手动进入。
openclaw onboard --install-daemon
进入向导页面后，模型，渠道，Skills,插件 这些可以跳过的步骤都先跳过,安装 Gateway 守护进程选 Yes，
注意，界面上出现 Hatch 出现 auth ... failed 时直接 Ctrl+C 退出即可，这是因为我们没有配置模型。
向导选择记录（节选）：
步骤 3：安装 DeepSeek 插件
OpenClaw 通过 provider 插件 连接 DeepSeek，需先安装官方插件：
openclaw plugins install @openclaw/deepseek-provider
openclaw gateway restart
安装完成后可以通过这条命令查看支持的模型
openclaw models list --all --provider deepseek
如下：
deepseek/deepseek-v4-flash
deepseek/deepseek-v4-pro
deepseek/deepseek-chat
deepseek/deepseek-reasoner
步骤 4：编辑配置文件
4.1 写入 API Key（~/.openclaw/.env）
vim ~/.openclaw/.env
chmod 600 ~/.openclaw/.env
DEEPSEEK_API_KEY=sk-你的密钥
4.2 设置默认模型
打开配置文件 openclaw.json, 一般在 ~/.openclaw/openclaw.json 这个路径下 。
把 agents.defaults.model.primary 设为 DeepSeek 模型：
{agents: {defaults: {model: { primary: "deepseek/deepseek-v4-flash" },workspace: "~/.openclaw/workspace",},},
}
4.3 校验并重启
配置改完后，先校验文件格式，再重启 Gateway，最后探测模型鉴权：
openclaw config validate
openclaw gateway restart
下面这个命令是用来检测我们的模型设置是否正常：
openclaw models status --probe
预期输出：
Default : deepseek/deepseek-v4-flash
Providers : deepseek effective=env:sk-0c02b...b8f114 | source=env: DEEPSEEK_API_KEYAuth probes
│ deepseek/deepseek-v4-flash │ env (api_key) │ ok · 2.7s │
Probed 1 target in 6.6s
- Default 应为
deepseek/deepseek-v4-flash - Auth probes … ok 表示 Key 有效、模型可调
4.4 Control UI
向导若选 bind=LAN，可从同一局域网内的浏览器访问 http://<本机 IP>:18789。
如果不是，直接根据下面的配置调整配置文件也可以。
注意，用 HTTP 非 localhost 时访问页面时，浏览器无法生成设备身份，页面会报「需要安全浏览器上下文」。
如果你的OpenClaw 不对公网暴露时，可以打开dangerouslyDisableDeviceAuth这个配置。
完整的配置如下：
{gateway: {controlUi: {allowInsecureAuth: true,dangerouslyDisableDeviceAuth: true,allowedOrigins: ["http://localhost:18789","http://127.0.0.1:18789","http://<本机局域网 IP>:18789",],},},
}
字段说明：
| 字段 | 作用 |
|---|---|
allowInsecureAuth |
允许在 HTTP 下用 Gateway token 鉴权 |
dangerouslyDisableDeviceAuth |
关闭 Control UI 设备配对；仅可信局域网，公网/VPS 禁止 |
allowedOrigins |
允许连入的浏览器 Origin；<本机局域网 IP> 换成 ip addr 看到的地址 |
调整完配置后都需要校验配置并重启。
openclaw config validate
openclaw gateway restart
连接步骤：
- 浏览器打开
http://<本机 IP>:18789/ - WebSocket URL 设为
ws://<本机 IP>:18789 - 「网关令牌」在是在
openclaw.json设置的，可以直接通过这条命令获取，grep '"token"' ~/.openclaw/openclaw.json - 点 连接，进入聊天界面即 Control UI 可用
3. 验证
通过Cli进行测试：
openclaw agent --agent main --message "你好，请确认你能收到这条消息"
示例回复：
收到！我是 OpenClaw 的一个全新实例，刚上线，还没有名字和身份。……
（模型：deepseek/deepseek-v4-flash）
4. 卸载
这块如果不需要可以直接跳过。
一键卸载（推荐）：
openclaw uninstall --all --yes --non-interactive
会停止 Gateway 服务、删除 systemd 单元，并清除 ~/.openclaw/（含配置、工作区、会话、插件等）。
分步卸载（需逐步确认时）：
openclaw gateway stop
openclaw gateway uninstall
npm rm -g openclaw
rm -rf ~/.openclaw
卸载后检查：
which openclaw # 应无输出
test -d ~/.openclaw && echo "仍有 ~/.openclaw" || echo "已清除"
systemctl --user status openclaw-gateway.service # 应提示 unit 不存在
总结
至此，我们算是完成了部署OpenClaw的部署。