想要了解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_KEY

Auth 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

连接步骤：

1. 浏览器打开 http://<本机 IP>:18789/
2. WebSocket URL 设为 ws://<本机 IP>:18789
3. 「网关令牌」在是在 openclaw.json 设置的，可以直接通过这条命令获取， grep '"token"' ~/.openclaw/openclaw.json
4. 点 连接，进入聊天界面即 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的部署。