万字实操｜OpenClaw 本地部署全流程记录，QuickStart 快速配置一步不落

OpenClaw 凭借可对接百余种大模型、内置联网检索、多平台聊天机器人、自定义技能插件等特性，成为本地自建智能代理的优质开源项目。不少小伙伴通过npm install -g openclaw@latest完成安装后，卡在openclaw onboard --install-daemon交互式配置环节：模型服务商挑选、搜索引擎配置、IM 机器人通道选择、技能与钩子设置、后台守护进程安装等数十项选项无从下手，选错配置极易出现服务启动失败、模型无法调用、Web 面板打不开等问题。

一、环境准备

部署 OpenClaw 前需要提前完成运行环境配置与大模型密钥准备两大前置工作，二者是程序正常运行的基础。

1.1. 运行环境配置

1.1.1 系统环境

OpenClaw 全平台兼容，支持 Windows、macOS、Linux 三大主流操作系统；Windows 平台优先推荐 WSL2 Linux 子系统环境部署，相比原生 CMD/PowerShell，依赖兼容性更好、后台守护进程运行稳定性更强，原生 Windows 可直接安装但部分插件容易出现适配异常。

1.1.2 Node.js 运行依赖

OpenClaw 基于 Node 生态开发，硬性版本要求：Node.js ≥22.19.0，最优选用 Node24 稳定版。终端校验版本命令：

node --version

输出版本号即代表环境就绪，未安装则前往 NodeJS 官网下载对应安装包。

1.2. 提前准备大模型 API Key

OpenClaw 是 AI 智能代理调度框架，本身不含大模型权重，需要对接第三方大模型接口作为推理底座。部署前任选一家平台注册账号并申领 API 密钥，保证账号存有免费额度或充值余额即可：

• OpenAI：通用性最强，生态完善，日常对话、工具调用适配度高；
• Anthropic (Claude)：长文本、逻辑推理场景表现突出；
• DeepSeek ：性价比高，国内访问友好，新手入门首选。

DeepSeek API 开发平台https://platform.deepseek.com/

二、npm 全局一键安装 OpenClaw

本地 Node 环境就绪后，打开终端执行全局安装命令，拉取 OpenClaw 最新正式版：

npm install -g openclaw@latest

等待依赖自动下载完成，无报错即为安装成功，可通过openclaw -v验证程序是否注册到系统全局命令。

注：安装出现网络超时可切换 npm 国内镜像源后重试。

参考下图所示 运行结果：

三：向导式初始化配置（Onboarding）

安装完成后，我们需要通过 OpenClaw 内置的智能向导来进行初始化配置。

这个向导会帮我们配置模型、绑定 API Key、建立本地 Gateway 守护进程。

在终端中输入以下命令：

openclaw onboard --install-daemon

openclaw onboard --install-daemon

参数解析：onboard：OpenClaw 环境初始化 / 装机向导，完成本地运行环境注册、容器 / 服务配置、权限初始化
--install-daemon：安装后台常驻守护进程（daemon 服务），让 OpenClaw 开机自启、后台静默运行，不用每次开新终端启动程序，是本地常驻部署必选参数
简单一句话：这条命令 = 一键初始化 OpenClaw 运行环境 + 安装系统后台服务，实现 OpenClaw 常驻本地后台。

​

3.1. 使用模式选择

I understand this is personal-by-default and shared/multi-user use requires lock-down. Continue?【默认是个人单机使用模式；如果要多用户共用，需要额外做安全加固配置，确认继续初始化吗？】
| Yes / > No

选项释义

1. 选 Yes：继续正常安装守护进程，启用个人单机模式，日常本地跑 OpenClaw 完全够用，不用复杂权限配置；
2. 选 No：终止本次 daemon 安装流程。

✅本地个人电脑自用 → 选 Yes

✅ 回车进入下一步。

3.2. 配置模型选择

* Setup mode
| > QuickStart (recommended) (Recommended local setup. Change details later with openclaw configure.)
| Manual setup
—

选项释义

1. > QuickStart (recommended)【快速安装（推荐）】默认选中，一键自动配置：工作目录、后台服务、网络、缓存全部用软件默认参数，后续不满意可以用openclaw configure命令随时修改配置，个人本地自用首选。
2. Manual setup【手动自定义配置】一步步手动填写路径、端口、权限、资源限制，适合懂配置、需要自定义目录 / 端口的进阶用户。

✅直接回车，使用默认的 QuickStart

✅ 回车进入下一步。

后续想改配置随时执行：openclaw configure

o QuickStart -------------------------+
| |
| Gateway port: 18789 |
| Gateway bind: Loopback (127.0.0.1) |
| Gateway auth: Token (default) |
| Tailscale exposure: Off |
| Direct to chat channels. |
| |
+--------------------------------------+

3.3. QuickStart 配置预览（自动快速配置）

这套默认参数个人本地自用完全没问题，不用修改。

Gateway port: 18789 → 后台网关占用端口18789 Gateway bind: Loopback(127.0.0.1) → 仅本机127.0.0.1访问，局域网/外网连不了，个人本地使用安全 Gateway auth: Token → 用令牌鉴权访问面板 Tailscale exposure: Off → 关闭内网穿透，不开公网访问

3.4.模型服务商选型

o Model/auth provider
| More…
|
* Model/auth provider
|
| Search:
| OpenAI
| Anthropic
| xAI (Grok)
| Google
| Arcee AI
| BytePlus
| Cerebras
| Chutes
| Cloudflare AI Gateway
| Codex
| Copilot
| Custom Provider
| DeepInfra
| > DeepSeek (API key)
| Fireworks
| Google Vertex
| Groq
| Hugging Face
| Kilo Gateway
| LiteLLM
| LM Studio
| Microsoft Foundry
| MiniMax
| Mistral AI
| Moonshot AI (Kimi K2.6)
| NVIDIA
| Ollama
| OpenCode
| OpenRouter
| Qianfan
| Qwen Cloud
| SGLang
| StepFun
| Synthetic
| Tencent Cloud
| Together AI
| Venice AI
| Vercel AI Gateway
| vLLM
| Volcano Engine
| Xiaomi
| Z.AI
| Back
| ↑/↓ to select • Enter: confirm • Type: to search

各个选项区分两类：
1、云端 API 类（需要去官网申请 API Key，花钱 / 免费额度调用大模型）
DeepSeek、OpenAI、Moonshot、Qwen Cloud、Google、Groq…… 全部需要填入对应平台密钥才能使用。
2、本地离线大模型（不用 API 密钥，本机跑模型）
Ollama：本机本地部署模型首选，装 Ollama 拉 Qwen/Llama 等模型，不需要任何 api-key
LM Studio /vLLM/ SGLang：也是本地模型服务

✅我们选择DeepSeek

✅ 回车进入下一步。

3.5. 模型 API Key 填写

o Model/auth provider
| DeepSeek
|
* Enter DeepSeek API key
| •••••••••••••••••••••••••••••••••

✅ 这里需要在DeepSeek开放平台申请的 DeepSeek API Key，

✅将你复制好的sk-...密钥粘贴进去

✅ 回车进入下一步

3.6. 模型配置

o Model configured --------------------------------+
| |
| Default model set to deepseek/deepseek-v4-flash |
| |
+---------------------------------------------------+
|
* Default model
| > Keep current (deepseek/deepseek-v4-flash)
| Enter model manually
| Browse all models

当前默认模型：DeepSeek V4 Flash（云端 API 调用，依赖 DeepSeek 的 API Key）

三个选项解释

1. Keep current (deepseek/deepseek-v4-flash)沿用现有配置，继续用 DeepSeek 云端接口，必须提前准备 DeepSeek API 密钥才能正常调用。
2. Enter model manually手动自定义填写模型名称，适合自己知道具体模型标识的场景。
3. Browse all models浏览该服务商全量模型列表，可切换其他 DeepSeek 系列模型。

✅我们选择默认选项 Keep current (deepseek/deepseek-v4-flash)

✅ 回车进入下一步

题外话：如果你选择Browse all models 当前你可以看到 4个模型供你选择。

| deepseek/deepseek-v4-flash
| deepseek/deepseek-v4-pro
| deepseek/deepseek-chat
| deepseek/deepseek-reasoner

3.7. 聊天渠道配置

o How channels work -----------------------------------------------------------------------+
| |
| Inbound DM safety defaults to pairing: unknown senders get a pairing code first. |
| Approve with: openclaw pairing approve <channel> <code> |
| Open/public DMs require dmPolicy="open" plus allowFrom=["*"]. |
| For multi-user DMs, isolate sessions with: openclaw config set session.dmScope |
| "per-channel-peer" (or "per-account-channel-peer" for multi-account channels). |
| Docs: channels/pairing |
| |
| Feishu: 飞书/Lark enterprise messaging with doc/wiki/drive tools. |
| Google Chat: Google Workspace Chat app with HTTP webhook. |
| Nostr: Decentralized protocol; encrypted DMs via NIP-04. |
| Microsoft Teams: Teams SDK; enterprise support. |
| Mattermost: self-hosted Slack-style chat; install the plugin to enable. |
| Nextcloud Talk: Self-hosted chat via Nextcloud Talk webhook bots. |
| Matrix: open protocol; install the plugin to enable. |
| LINE: LINE Messaging API webhook bot. |
| Zalo: Vietnam-focused messaging platform with Bot API. |
| ClickClack: self-hosted chat via first-class ClickClack bot tokens. |
| Zalo Personal: Zalo personal account via QR code login. |
| Synology Chat: Connect your Synology NAS Chat to OpenClaw with full agent capabilities. |
| Tlon: decentralized messaging on Urbit; install the plugin to enable. |
| Discord: very well supported right now. |
| iMessage: Local iMessage/SMS through the imsg bridge, including private API message |
| actions when enabled. |
| IRC: classic IRC networks with DM/channel routing and pairing controls. |
| QQ Bot: connect to QQ via official QQ Bot API with group chat and direct message |
| support. |
| Signal: signal-cli linked device; more setup (David Reagans: "Hop on Discord."). |
| Slack: supported (Socket Mode). |
| Telegram: simplest way to get started — register a bot with @BotFather and get going. |
| Twitch: Twitch chat integration |
| WhatsApp: works with your own number; recommend a separate phone + eSIM. |
| WeCom: Enterprise messaging and documents, scheduling, task tools. |
| Weixin: Personal WeChat messaging via QR-code login. |
| Yuanbao: Tencent Yuanbao AI assistant conversation channel. |
| |
+-------------------------------------------------------------------------------------------+
|
* Select channel (QuickStart)
|
| Search: _
| ClickClack
| Discord (Bot API)
| Feishu/Lark (飞书)
| Google Chat (Chat API)
| iMessage (imsg)
| IRC (Server + Nick)
| LINE (Messaging API)
| Matrix (plugin)
| Mattermost (plugin)
| Microsoft Teams (Teams SDK)
| Nextcloud Talk (self-hosted)
| Nostr (NIP-04 DMs)
| QQ Bot (Official API)
| Signal (signal-cli)
| Slack (Socket Mode)
| Synology Chat (Webhook)
| Telegram (Bot API)
| Tlon (Urbit)
| Twitch (Chat)
| WeCom（企业微信）
| Weixin（微信）
| WhatsApp (QR link)
| Yuanbao (元宝)
| Zalo (Bot API)
| Zalo (Personal Account)
| > Skip for now
| ↑/↓ to select • Enter: confirm • Type: to search

这一步是选择要对接的聊天渠道（机器人收发消息平台）

列表是各类 IM 软件，OpenClaw 可以绑定后在聊天框调用大模型。

开头说明：

陌生私聊默认需要配对码授权，后续用 openclaw pairing approve 放行好友接入。

选项说明：
各个软件（飞书、QQ、TG、微信、Discord 等）：绑定对应平台做聊天机器人，需要对应平台的机器人 Token / 扫码

✅选中 Skip for now【暂时跳过】
✅ 自用本地测试首选，回车进入下一步

操作建议
你现在只是先把 OpenClaw 后台装好、暂时不搭建聊天机器人：
光标下移选中 Skip for now → 回车，直接跳过渠道绑定，进入守护进程安装收尾。
后续哪天要做微信 / 飞书机器人，随时执行：

openclaw configure

重新配置聊天渠道即可。

3.8. 配置联网搜索能力

o Web search -----------------------------------------------------------------+
| |
| Web search lets your agent look things up online. |
| Choose a provider. Some providers need an API key, and some work key-free. |
| Docs: https://docs.openclaw.ai/tools/web |
| |
+------------------------------------------------------------------------------+
|
* Search provider
|
| Search: _
| Brave Search
| > DuckDuckGo Search (experimental) (Free web search fallback with no API key required · key-free)
| Exa Search
| Firecrawl Search
| Gemini (Google Search)
| Grok (xAI)
| Kimi (Moonshot)
| MiniMax Search
| Ollama Web Search
| Perplexity Search
| SearXNG Search
| Tavily Search
| Skip for now
| ↑/↓ to select • Enter: confirm • Type: to search

现在光标已经在 DuckDuckGo Search (experimental) 上，直接回车确认就行。
为什么选它

• key‑free：不用注册、不用 API 密钥，直接能用
• 完全免费，个人测试 / 日常使用足够
• 隐私友好

我们注意到DuckDuckGo Search 标了（experimental）⚠️ ：

• 不能按时间（今天 / 本周）过滤
• 大量频繁搜索可能被临时限制
• 但个人正常用完全没问题

其他选项对比（简单版）

1. Brave Search：要注册拿 key，有免费额度，更稳、支持时间过滤
2. Tavily：质量好，有免费额度，也要 key
3. Skip for now：先不联网搜索，以后再加

我们现在是 QuickStart 本地搭建、先跑通为主：
直接按回车 → 用 DuckDuckGo，最省事、零配置。

3.9. Skills状态开关配置

|
o Skills status -------------+
| |
| Eligible: 15 |
| Missing requirements: 35 |
| Unsupported on this OS: 8 |
| Blocked by allowlist: 0 |
| |
+-----------------------------+
|
* Configure skills now? (recommended)
| > Yes / No
—

Configure skills now?：现在配置插件技能？推荐开启

• Yes：自动安装可用的 15 项 AI 工具技能（联网查资料、文件解析、代码运行等）
• No：跳过配置，后续手动配置

选择：默认光标 Yes，直接回车

装好之后 OpenClaw 才有联网、文件读写、工具调用能力，缺的依赖后面缺啥再单独装就行。

3.10. Skills工具安装

o Configure skills now? (recommended)
| Yes
|
* Install missing skill dependencies
| [•] Skip for now (Continue without installing dependencies)
| [ ] 🔐 1password
| [ ] 📰 blogwatcher
| [ ] 🫐 blucli
| [ ] 📸 camsnap
| [ ] 🧩 clawhub
| [ ] 🛌 eightctl
| [ ] ✨ gemini
| [ ] 🧩 gh-issues
| [ ] 🧲 gifgrep
| [ ] 🐙 github
| [ ] 🎮 gog
| [ ] 📍 goplaces
| [ ] 📧 himalaya
| [ ] 📦 mcporter
| [ ] 📄 nano-pdf
| [ ] 🎤 openai-whisper
| [ ] 💡 openhue
| [ ] 🧿 oracle
| [ ] 🛵 ordercli
| [ ] 🔊 sag
| [ ] 📜 session-logs
| [ ] 🌊 songsee
| [ ] 🔊 sonoscli
| [ ] 🧾 summarize
| [ ] 📋 trello
| [ ] 📱 wacli
| [ ] 🐦 xurl
—

操作说明

当前默认勾选：Skip for now（暂时跳过安装依赖）

选项解释

1. Skip for now：跳过所有缺失组件安装，先把 OpenClaw 主服务装好，后续要用对应技能再单独装依赖，本地快速部署首选
2. 下面一堆带图标的都是各类扩展技能（语音转写 Whisper、PDF 解析、GitHub 对接、摄像头截图等），全装会下载大量依赖、耗时久，大部分你暂时用不上。

保持 Skip 勾选，先按下空格键选中 然后回车键

后续需要某个功能（比如 whisper 语音）再用命令单独安装：

openclaw skills install openai-whisper

题外话：前后步骤是否矛盾？

这一步操作 前后是不是矛盾，上一步我们选择Configure skills now? (recommended)
| > Yes
后面这一步我们又不选择安装任何skill。？？？

其实不矛盾，两段含义分开：

1. Configure skills now → Yes=启用技能配置模块、注册全部可用技能清单，把 15 个可用技能载入配置，软件知道有这些功能。

2. Install missing skill dependencies → Skip for now=不当下下载安装各个技能的运行依赖包。

• Yes：登记技能列表（配置写入配置文件）
• Skip：不下载 whisper、pdf 工具、github 客户端等一堆第三方程序

举个通俗例子

勾选 Yes = 在菜单里装上所有功能按钮；Skip = 暂时不下载按钮对应的运行程序，想用哪个再单独装。

3.11. 谷歌地图地点查询技能

* Set GOOGLE_PLACES_API_KEY for goplaces?
| Yes / > No
—

含义

Set GOOGLE_PLACES_API_KEY for goplaces?goplaces 是谷歌地图地点查询技能，需要谷歌地图 API 密钥，你没有密钥。

选择

默认光标在No，直接回车，跳过密钥配置。

3.12. 语音转文字接口配置

* Set OPENAI_API_KEY for openai-whisper-api?
| Yes / > No
—

释义

openai-whisper-api 是云端 OpenAI 语音转文字接口，需要 OpenAI 密钥。

选择

默认No，直接回车跳过，后续要用再单独配置密钥。

3.13. 文本转语音接口配置

* Set ELEVENLABS_API_KEY for sag?
| Yes / > No
—

含义

sag= ElevenLabs 云端文本转语音（TTS）技能

• 需要ELEVENLABS_API_KEY（ ElevenLabs 官网注册获取）
• 作用：生成高质感、带情感的英文 / 中文语音

现在的情况

• 没有 ElevenLabs 密钥
• 暂时用不到云端 TTS

选择

保持默认No→ 直接回车，跳过配置。

后面想用再配：

openclaw skills install sag # 然后设置环境变量 export ELEVENLABS_API_KEY=你的密钥

3.14.事件钩子自动化脚本

|o Hooks ------------------------------------------------------------------+
| |
| Hooks let you automate actions when agent commands are issued. |
| Example: Save session context to memory when you issue /new or /reset. |
| |
| Learn more: https://docs.openclaw.ai/automation/hooks |
| |
+--------------------------------------------------------------------------+
|
* Enable hooks?
| [•] Skip for now
| [ ] 🚀 boot-md
| [ ] 📎 bootstrap-extra-files
| [ ] 📝 command-logger
| [ ] 🧹 compaction-notifier
| [ ] 💾 session-memory

说明

Hooks 是事件钩子自动化脚本：触发新建会话、重置会话等指令时自动执行附加动作（日志留存、记忆持久化等）。

• Skip for now：暂时全部不启用钩子，后续需要自动化再配置。

操作

默认已经选中 Skip for now，先按下空格键选中，然后按下回车键进入下一步。

后续想开某个钩子示例：

openclaw hooks enable session-memory

3.15. 安装完成，如何唤醒您的Agent？

|
o Hooks ------------------------------------------------------------------+
| |
| Hooks let you automate actions when agent commands are issued. |
| Example: Save session context to memory when you issue /new or /reset. |
| |
| Learn more: https://docs.openclaw.ai/automation/hooks |
| |
+--------------------------------------------------------------------------+
|
o Enable hooks?
| Skip for now
|
o Gateway service runtime --------------------------------------------+
| |
| QuickStart uses Node for the Gateway service (stable + supported). |
| |
+----------------------------------------------------------------------+
|
0 Installing Gateway service......
Installed Scheduled Task: OpenClaw Gateway
Task script: C:\Users\XIAOM\.openclaw\gateway.cmd
o Gateway service installed.
Gateway event loop: degraded reasons=event_loop_delay,event_loop_utilization,cpu max=1790ms p99=1790ms util=1 cpu=1.077
Agents: main (default)
Heartbeat interval: 30m (main)
Session store (main): C:\Users\XIAOM\.openclaw\agents\main\sessions\sessions.json (0 entries)
|
o Optional apps ------------------------+
| |
| Add nodes for extra features: |
| - macOS app (system + notifications) |
| - iOS app (camera/canvas) |
| - Android app (camera/canvas) |
| |
+----------------------------------------+
|
o Control UI ---------------------------------------------------------------------+
| |
| Web UI: http://127.0.0.1:18789/ |
| Web UI (with token): |
| http://127.0.0.1:18789/#token=a87b6cb776e1eca395f4489a0b3cc0e66214022de97d9bfd |
| Gateway WS: ws://127.0.0.1:18789 |
| Gateway: reachable |
| Docs: https://docs.openclaw.ai/web/control-ui |
| |
+----------------------------------------------------------------------------------+
|
o Hatch your agent ---------------------------------------------------+
| |
| Your workspace is ready. |
| The first Terminal chat run will send: "Wake up, my friend!" |
| Edit BOOTSTRAP.md later to change how the agent introduces itself. |
| |
+----------------------------------------------------------------------+
|
o Token ------------------------------------------------------------------------------------+
| |
| Gateway token: shared auth for the Gateway + Control UI. |
| Stored in: $OPENCLAW_CONFIG_PATH (default: ~/.openclaw/openclaw.json) under |
| gateway.auth.token, or in OPENCLAW_GATEWAY_TOKEN. |
| View token: openclaw config get gateway.auth.token |
| Generate token: openclaw doctor --generate-gateway-token |
| Web UI keeps dashboard URL tokens in memory for the current tab and strips them from the |
| URL after load. |
| Open the dashboard anytime: openclaw dashboard --no-open |
| If prompted: paste the token into Control UI settings (or use the tokenized dashboard |
| URL). |
| |
+--------------------------------------------------------------------------------------------+
|
* How do you want to hatch your agent?
| > Hatch in Terminal (recommended)
| Hatch in Browser
| Hatch later
—

选项说明

1. Hatch in Terminal（默认选中、推荐）：在当前终端直接启动 AI 对话，装好立刻就能聊天
2. Hatch in Browser：自动打开浏览器http://127.0.0.1:18789网页面板聊天
3. Hatch later：暂时不启动，后续手动输命令启动

操作：直接回车，选用默认Hatch in Terminal

回车后终端唤醒 Agent，发送预设开场白：Wake up, my friend!

关键信息留存（备用）

• 后台面板地址：http://127.0.0.1:18789/
• 带免密令牌直达链接：http://127.0.0.1:18789/#token=a87b6cb776e1eca395f4489a0b3cc0e66214022de97d9bfd
• 以后打开网页面板命令：

openclaw dashboard

四、启动与运行验证

搞定配置后，我们来验证 OpenClaw 是否成功跑了起来。

4.1. 检查网关状态

输入以下命令查看后台守护进程是否正常：

openclaw gateway status

如果看到running或active的绿字提示，说明网关已经成功在后台常驻！

​

4.2. 打开控制台面板（Dashboard）

OpenClaw 提供了炫酷的 Web 端控制台。在终端输入：

openclaw dashboard

程序会自动在浏览器中打开管理页面。在这里你可以直观地看到 AI 的运行状态、日志、以及大名鼎鼎的Live Canvas（画布）。

​

​

4.3. 进行第一次 AI 对话

测试一下你的本地 AI 助手是否能正常思考：

# 尝试让它进入思考模式并回答 /think level=max 你好 OpenClaw，请问你现在已经准备好了吗？

如果收到了 AI 聪明的回复，恭喜你，OpenClaw 已经彻底安装成功并成功运行！

​

五、安全提醒（避坑必看）

由于 OpenClaw 是一个具备高权限执行能力的 Agent（它可以操作你的文件、浏览器等），在享受便利的同时，请务必注意以下几点安全规范：

1. 切勿暴露公网：确保配置文件中的"bind"选项为"loopback"（即仅监听127.0.0.1）。千万不要改成0.0.0.0，否则全世界都能通过网络控制你的电脑！如果需要远程访问，请使用SSH Tunneling（隧道）。

2. 开启 Token 认证：确保"auth": { "mode": "token" }处于开启状态。

3. 合理配置权限：在生产使用前，可以在denyCommands列表中限制 AI 访问你的敏感硬件（如摄像头、特定私密文件夹等）。

六、后续精彩玩法

现在你的 OpenClaw 已经跑起来了，接下来你可以去官方文档探索：

• 接入社交渠道：把你的 OpenClaw 接入到飞书、企业微信或 Discord 中。

• ClawHub 技能库：去安装各种封装好的专业技能（Skills），让它帮你自动报税、查机票、写代码。

有任何安装问题，欢迎在评论区留言交流，我们一起调教这只强大的“机械螃蟹”！🦞

觉得有用的话，记得点赞、收藏、关注三连哦！