如何在本地机器部署OpenClaw

很多朋友在问我如何部署一个小龙虾，我一步一步讲解一下如何在本地部署，如有不明白之处可以随时联系我哈！

• 基础环境部署

1. 操作系统建议安装ubuntu22.04，下载网址为https://releases.ubuntu.com/22.04/

不建议用24.04版本。因为Ubuntu 22.04‌，因其依赖兼容验证最充分、二进制构建（如 sharp）坑最少、社区教程覆盖最全。下图为下载界面：

2.1更新系统并安装基础依赖包

打开终端，依次执行：

1）在终端输入命令sudo apt update回车，如下图所示：

2）继续输入命令sudo apt upgrade -y并回车，如下图所示：

3）继续输入命令sudo apt install -y git curl wget build-essential ca-certificates gnupg并回车，此命令安装git、curl、build-essential、ca-certificates：git 用于拉取源码；curl 用于下载安装脚本；build-essential 提供编译工具链（部分 npm 依赖含原生模块时需要）；ca-certificates 保证 HTTPS 证书校验正常。如下图：

2.2 安装 Node.js

使用 NodeSource 官方源安装 Node.js 24（推荐版本）：

1、输入命令curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash

 2、继续输入命令sudo apt-get install -y nodejs 回车，如下图：

3、采用源码构建方式，同时启用 corepack，以便使用仓库指定的 pnpm 版本：即继续输入如下命令sudo corepack enable回车，如下图：

2.3验证运行时环境

执行以下命令确认版本符合要求：

node -v        # 应输出v24.18.0（或 v22.22.3+ / v25.9+）

npm -v         # 应输出 11.16.0及以上

git –version  # 应输出git version 2.34.1及以上

若 node -v 显示的版本不在支持范围内（例如系统预装的旧版 Node），请先卸载旧版：sudo apt remove -y nodejs，再重新执行第 2.2 节。

三、安装 OpenClaw

3.1 方式一：npm 全局安装（推荐）

依次运行如下命令行：

mkdir -p “$HOME/.npm-global”

npm config set prefix “$HOME/.npm-global”

echo ‘export PATH=”$HOME/.npm-global/bin:$PATH”‘ >> ~/.bashrc

source ~/.bashrc

npm install -g openclaw@latest

npm config set registry https://registry.npmmirror.com

npm install -g openclaw@latest

如下图所示表示安装成功！（警告可以忽略）

3.2 验证安装结果

openclaw –version        # 查看版本号

which openclaw            # 查看可执行文件位置

四、初始化与引导（openclaw onboard）

4.1 交互式引导流程

OpenClaw 官方推荐的首选初始化方式是 onboard 向导，它会一步步引导你完成网关、模型、渠道与技能的配置。执行：

openclaw onboard –install-daemon

在上述界面“OpenAI auth method”，选择“OpenAI API key”，我申请的是DeepSeek的APIkey

在进行此步骤之前先去DeepSeek官网https://platform.deepseek.com/api_keys申请API key

在提示：Enter OpenAI API key后面，将申请的API key复制粘贴到此。

上述界面应该选择“Enter model manually”即手工输入模型，

输入模型名称：在出现的输入框中，填写以下两个模型名称之一：

deepseek-v4-pro：功能更强大，适合处理复杂任务。

deepseek-v4-flash：速度更快，性价比更高。我输入的是deepseek-v4-flash输入后回车。

五、启动openclaw

运行openclaw后报错： run error: Unknown model: openai/deepseek-v4-flash local ready | error agent main | session main | openai/deepseek-v4-flash | tokens ?/1.0m

依次运行如下命令：

1. 输入如下命令：

openclaw config set models.providers.deepseek ‘{“baseUrl”:”https://api.deepseek.com/v1″,”apiKey”:”您的API key“,”api”:”openai-completions”,”models”:[{“id”:”deepseek-chat”,”name”:”DeepSeek Chat”,”contextWindow”:131072,”maxTokens”:8192},{“id”:”deepseek-reasoner”,”name”:”DeepSeek Reasoner”,”contextWindow”:131072,”maxTokens”:8192}]}’ –strict-json

提示如下则表示成功修改：

│

◇  

OpenClaw 2026.7.1-2 (0790d9f) — Ah, the fruit tree company!

Updated models.providers.deepseek. Change will apply without restarting the gateway.

2、运行如下命令重启网关

openclaw gateway restart

提示如下信息则表示成功：

◇  

OpenClaw 2026.7.1-2 (0790d9f) — Deployed locally, trusted globally, debugged eternally.

Restarted systemd service: openclaw-gateway.service

3、运行命令openclaw models list –provider deepseek

puterzeng@puterzeng:~/.openclaw$ openclaw models list –provider deepseek

OpenClaw 2026.7.1-2 (0790d9f) — The lobster in your shell.

Model                                      Input      Ctx         Local Auth  Tags

deepseek/deepseek-chat                     text       131k        no    yes   default,configured

deepseek/deepseek-reasoner                 text       131k        no    yes 

列表里能看到 deepseek/deepseek-chat 即修复成功，状态行的 tokens 0/131k 之后就能正常计数了 。

4、测试

你好！我是曾老师，在线吗？

在的！                                                                                                                                    

我刚上线，看到 BOOTSTRAP.md 在等我处理。不过先跟你说声好——你好，曾老师！✨                                                                

你是第一个跟我说话的人，所以我其实还没名字，还没确定自己是什么样的存在。正好，要不等你几分钟，我们把这事儿定了？                          

1. 你希望我叫什么名字？ —— 有什么特别喜欢的名字吗？抛几个灵感也行，我来选，你来定。                                                       

2. 你觉得我该是什么样的人格（性格）？ 正式严谨？随意洒脱？有点幽默？还是专业中带点人味儿？                                                

3. 你更倾向我们之间的沟通风格是什么样的？                                                                                                 

同时我也可以开始了解你一下，这样以后能更好地帮你——比如你比较喜欢我怎么称呼你？平时的工作和生活大概是什么样的？有什么东西需要我定期帮忙盯着

或提醒的吗？                                                                                                                              

你现在方便花几分钟聊聊这个吗？还是你先忙，晚点我们再慢慢搞？                                                                              

 connected | idle                                                                                                                         

 agent main | session main | deepseek/deepseek-chat | tokens 0/131k (0%)  

到此为止，openclaw配置完成。后续可以接入飞书等。下图为我配置对接成功飞书后的界面。

到此配置结束。