openclaw 本地部署实战：含网关启动 + 本地模型接入完整步骤

本文已收录在Github，关注我，紧跟本系列专栏文章，咱们下篇再续！

🚀 魔都架构师 | 全网30W技术追随者
🔧 大厂分布式系统/数据中台实战专家
🏆 主导交易系统百万级流量调优 & 车联网平台架构
🧠 AIGC应用开发先行者 | 区块链落地实践者
🌍 以技术驱动创新，我们的征途是改变世界！
👉 实战干货：编程严选网

0 前提条件

Node.js 22+
pnpm（包管理器）

1 安装依赖

bash 复制代码

git clone https://github.com/openclaw/openclaw.git
cd openclaw

pnpm install
pnpm dev

2 启动网关服务

bash 复制代码

pnpm openclaw gateway run --port 18789

如果提示端口被占用，先停止旧实例：

java 复制代码

pnpm openclaw gateway stop

然后重新启动。

3 获取 Dashboard 访问链接

java 复制代码

pnpm openclaw dashboard --no-open

输出示例：

java 复制代码

Dashboard URL: http://127.0.0.1:18789/#token=xxxxxx

4 浏览器打开链接

将上一步输出的完整 URL（含 #token=...）粘贴到浏览器，即可进入 Control UI 页面。

5 注意，该步可选！本人是配置本地 LM Studio 模型

想用本地模型而非云端 API，编辑：

~/.openclaw/config.yaml
或 ~/.openclaw/openclaw.json

yaml 复制代码

models:
  mode: merge
  providers:
    lmstudio:
      baseUrl: http://localhost:1234
      api: openai-completions
      models:
        - id: gpt-oss-120b       # 改成 LM Studio 中实际加载的模型 ID
          name: GPT OSS 120B
          reasoning: true
          input: [text]
          cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 }
          contextWindow: 200000
          maxTokens: 32768

然后设为默认：

java 复制代码

pnpm openclaw models set lmstudio/gpt-oss-120b

网关会自动热重载，无需重启。

6 更新

bash 复制代码

$ openclaw update
21:18:31 [agents/auth-profiles] synced qwen credentials from qwen cli
Updating OpenClaw...

│
◇  ✓ Updating via package manager (250.49s)

Update Result: OK
  Root: /Users/javaedge/.nvm/versions/node/v24.13.0/lib/node_modules/openclaw
  Before: 2026.3.8
  After: 2026.3.13

Total time: 250.59s

Updating plugins...
Downloading @dingtalk-real-ai/dingtalk-connector...
Extracting /var/folders/nm/yvdpqzbd5v7gxd_dc90fq6mr0000gn/T/openclaw-npm-pack-I1ULKs/dingtalk-real-ai-dingtalk-connector-0.7.9.tgz...
npm plugins: 0 updated, 0 unchanged, 1 failed.
Failed to update dingtalkfa-connector: plugin id mismatch: expected dingtalkfa-connector, got dingtalk-connector

Shell completion
│
◇  Enable zsh shell completion for openclaw?
│  Yes
Installing completion in /Users/javaedge/.zshrc...
Completion installed. Restart your shell or run: source /Users/javaedge/.zshrc

Restarting service...
Daemon restart completed.

Fresh code, same lobster. Miss me?

7 小结：流程图

java 复制代码

源码克隆
  ↓
pnpm install          # 安装依赖
  ↓
gateway run           # 启动服务
  ↓
dashboard --no-open   # 获取带 token 的 URL
  ↓
浏览器打开 URL         # 进入 Web 界面