OpenClaw 凭借可对接百余种大模型、内置联网检索、多平台聊天机器人、自定义技能插件等特性成为本地自建智能代理的优质开源项目。不少小伙伴通过npm install -g openclawlatest完成安装后卡在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 KeyOpenClaw 是 AI 智能代理调度框架本身不含大模型权重需要对接第三方大模型接口作为推理底座。部署前任选一家平台注册账号并申领 API 密钥保证账号存有免费额度或充值余额即可OpenAI通用性最强生态完善日常对话、工具调用适配度高Anthropic (Claude)长文本、逻辑推理场景表现突出DeepSeek 性价比高国内访问友好新手入门首选。DeepSeek API 开发平台https://platform.deepseek.com/二、npm 全局一键安装 OpenClaw本地 Node 环境就绪后打开终端执行全局安装命令拉取 OpenClaw 最新正式版npm install -g openclawlatest等待依赖自动下载完成无报错即为安装成功可通过openclaw -v验证程序是否注册到系统全局命令。注安装出现网络超时可切换 npm 国内镜像源后重试。参考下图所示 运行结果​三向导式初始化配置Onboarding安装完成后我们需要通过 OpenClaw 内置的智能向导来进行初始化配置。这个向导会帮我们配置模型、绑定 API Key、建立本地 Gateway 守护进程。在终端中输入以下命令openclaw onboard --install-daemonopenclaw onboard --install-daemon参数解析onboardOpenClaw 环境初始化 / 装机向导完成本地运行环境注册、容器 / 服务配置、权限初始化--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选项释义选 Yes继续正常安装守护进程启用个人单机模式日常本地跑 OpenClaw 完全够用不用复杂权限配置选 No终止本次 daemon 安装流程。✅本地个人电脑自用 → 选 Yes✅ 回车进入下一步。3.2. 配置模型选择* Setup mode| QuickStart (recommended) (Recommended local setup. Change details later with openclaw configure.)| Manual setup—选项释义 QuickStart (recommended)【快速安装推荐】默认选中一键自动配置工作目录、后台服务、网络、缓存全部用软件默认参数后续不满意可以用openclaw configure命令随时修改配置个人本地自用首选。Manual setup【手动自定义配置】一步步手动填写路径、端口、权限、资源限制适合懂配置、需要自定义目录 / 端口的进阶用户。✅直接回车使用默认的 QuickStart✅ 回车进入下一步。后续想改配置随时执行openclaw configureo 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-keyLM 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三个选项解释Keep current (deepseek/deepseek-v4-flash)沿用现有配置继续用 DeepSeek 云端接口必须提前准备 DeepSeek API 密钥才能正常调用。Enter model manually手动自定义填写模型名称适合自己知道具体模型标识的场景。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-reasoner3.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 dmPolicyopen 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⚠️ 不能按时间今天 / 本周过滤大量频繁搜索可能被临时限制但个人正常用完全没问题其他选项对比简单版Brave Search要注册拿 key有免费额度更稳、支持时间过滤Tavily质量好有免费额度也要 keySkip 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暂时跳过安装依赖选项解释Skip for now跳过所有缺失组件安装先把 OpenClaw 主服务装好后续要用对应技能再单独装依赖本地快速部署首选下面一堆带图标的都是各类扩展技能语音转写 Whisper、PDF 解析、GitHub 对接、摄像头截图等全装会下载大量依赖、耗时久大部分你暂时用不上。保持 Skip 勾选先按下空格键选中 然后回车键后续需要某个功能比如 whisper 语音再用命令单独安装openclaw skills install openai-whisper题外话前后步骤是否矛盾这一步操作 前后是不是矛盾上一步我们选择Configure skills now? (recommended)| Yes后面这一步我们又不选择安装任何skill。其实不矛盾两段含义分开Configure skills now → Yes启用技能配置模块、注册全部可用技能清单把 15 个可用技能载入配置软件知道有这些功能。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-memory3.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 GatewayTask script: C:\Users\XIAOM\.openclaw\gateway.cmdo Gateway service installed.Gateway event loop: degraded reasonsevent_loop_delay,event_loop_utilization,cpu max1790ms p991790ms util1 cpu1.077Agents: 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/#tokena87b6cb776e1eca395f4489a0b3cc0e66214022de97d9bfd || 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—选项说明Hatch in Terminal默认选中、推荐在当前终端直接启动 AI 对话装好立刻就能聊天Hatch in Browser自动打开浏览器http://127.0.0.1:18789网页面板聊天Hatch later暂时不启动后续手动输命令启动操作直接回车选用默认Hatch in Terminal回车后终端唤醒 Agent发送预设开场白Wake up, my friend!关键信息留存备用后台面板地址http://127.0.0.1:18789/带免密令牌直达链接http://127.0.0.1:18789/#tokena87b6cb776e1eca395f4489a0b3cc0e66214022de97d9bfd以后打开网页面板命令openclaw dashboard四、启动与运行验证搞定配置后我们来验证 OpenClaw 是否成功跑了起来。4.1. 检查网关状态输入以下命令查看后台守护进程是否正常openclaw gateway status如果看到running或active的绿字提示说明网关已经成功在后台常驻​4.2. 打开控制台面板DashboardOpenClaw 提供了炫酷的 Web 端控制台。在终端输入openclaw dashboard程序会自动在浏览器中打开管理页面。在这里你可以直观地看到 AI 的运行状态、日志、以及大名鼎鼎的Live Canvas画布。​​4.3. 进行第一次 AI 对话测试一下你的本地 AI 助手是否能正常思考# 尝试让它进入思考模式并回答 /think levelmax 你好 OpenClaw请问你现在已经准备好了吗如果收到了 AI 聪明的回复恭喜你OpenClaw 已经彻底安装成功并成功运行​五、安全提醒避坑必看由于 OpenClaw 是一个具备高权限执行能力的 Agent它可以操作你的文件、浏览器等在享受便利的同时请务必注意以下几点安全规范切勿暴露公网确保配置文件中的bind选项为loopback即仅监听127.0.0.1。千万不要改成0.0.0.0否则全世界都能通过网络控制你的电脑如果需要远程访问请使用SSH Tunneling隧道。开启 Token 认证确保auth: { mode: token }处于开启状态。合理配置权限在生产使用前可以在denyCommands列表中限制 AI 访问你的敏感硬件如摄像头、特定私密文件夹等。六、后续精彩玩法现在你的 OpenClaw 已经跑起来了接下来你可以去官方文档探索接入社交渠道把你的 OpenClaw 接入到飞书、企业微信或 Discord 中。ClawHub 技能库去安装各种封装好的专业技能Skills让它帮你自动报税、查机票、写代码。有任何安装问题欢迎在评论区留言交流我们一起调教这只强大的“机械螃蟹”觉得有用的话记得点赞、收藏、关注三连哦