OpenClaw 完整安装教程（2026版，全平台通用）

🔧 一款开源本地 AI 助手，支持接入微信/飞书/Telegram/WhatsApp 等聊天工具，多模型可选，开箱即用

标签： AI助手 OpenClaw LLM AI工具 本地部署 Telegram Bot

---

前言

最近在找能本地部署的 AI 助手方案，目标是：

• 支持多个大模型（Claude、GPT、GLM 等）

• 能接入平时用的聊天工具

• 电脑关机再开机不用手动启动

试了几个方案，OpenClaw 最终满足了我的需求。本文是完整安装配置教程，每一步都基于官方文档，踩过的坑都标注了，适合新手参考。

---

OpenClaw 是什么？

OpenClaw 是一款本地运行的个人 AI 助手，核心能力：

• 🤖 多模型支持：Claude、GPT、GLM、本地 Ollama、MiniMax 等

• 📡 多渠道接入：Telegram、WhatsApp、Discord、飞书、钉钉、Signal、微信等

• 🔧 Skills 生态：浏览器自动化、定时任务、社媒管理、文件处理

• 💻 全平台：macOS / Linux / Windows（强烈推荐 WSL2）

• 🛡️ 安全：DM 配对机制、权限分级

---

系统要求

Node.js： Node 24（推荐）或 Node 22.16+ 系统： macOS 12+ / Linux / Windows（WSL2 推荐） 内存： 推荐 4GB+

⚠️ Windows 用户建议用 WSL2，原生 Windows 可以但稳定性不如 WSL2。

验证 Node 版本：node -v

---

安装步骤

第一步：安装 Node.js（如未安装）

macOS / Linux： curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash - && sudo apt-get install -y nodejs

Windows： 直接去 https://nodejs.org/zh-cn 下载 LTS 版（v24）

---

第二步：安装 OpenClaw（官方推荐方式）

curl -fsSL https://openclaw.ai/install.sh | bash

这个脚本会自动检测操作系统、安装 Node（如需要）、安装 OpenClaw，然后启动配置向导。

其他安装方式：

npm install -g openclaw@latest

pnpm add -g openclaw@latest && pnpm approve-builds -g

安装后验证： openclaw --version（查看版本） openclaw doctor（检查配置问题，推荐跑一下）

---

第三步：初始化配置（核心步骤）

openclaw onboard --install-daemon

💡 加 --install-daemon 会自动配置开机自启服务，关机再开机不用手动启动。

---

3.1 选择模式

QuickStart： 每一步用最优默认值，一路回车即可，适合新手 Advanced： 每一步详细配置，自己选，适合有经验的用户

👉 新手选 QuickStart，默认值已经是最优选择。

---

3.2 配置模型（关键步骤）

这是最重要的一步，选用什么模型直接影响使用体验。

如果你使用国内中转 API（如北洋API）：

1. 选择 Custom Provider（自定义提供商）

2. 填入 API 地址：https://api.tsbys.com（具体路径参考你的 API 提供商文档）

3. 填入 API Key（在 API 控制台获取）

4. 填入模型名称：如 claude-3-5-sonnet、gpt-4o 等

OpenClaw 支持的模型提供商：

国际主流：Anthropic (Claude)、OpenAI (GPT)、Google (Gemini)、xAI (Grok) 国内主流：GLM（智谱）、Moonshot（Kimi）、DeepSeek、阿里通义（Qwen）、百度千帆、MiniMax、豆包 本地模型：Ollama、VLLM、SGLang 聚合网关：OpenRouter、Vercel AI Gateway、Cloudflare AI Gateway

⚠️ 安全提醒：如果 AI 助手会执行工具（发消息、读文件、运行命令），建议用最强的新一代模型，弱模型更容易被提示注入攻击。

---

3.3 工作区配置

默认 ~/.openclaw/workspace。👉 直接回车用默认即可。

---

3.4 网关配置

端口：18789（一般不改） 绑定地址：127.0.0.1（本机），外部访问需要内网穿透 认证模式：Token（建议保持开启） Tailscale：Off（普通用户不需要）

👉 默认即可，关闭认证会导致任何本地进程都能连接，不安全。

---

3.5 频道接入（聊天工具）

Telegram： ⭐ 最简单，10分钟搞定，推荐度最高 飞书： 中等，企业用户推荐 Discord： 中等 WhatsApp： 较麻烦，需要手机扫码 钉钉： 中等，企业用户

👉 建议先跳过，后续用 openclaw channels login 单独配置。Telegram 最容易上手，强烈推荐先试这个。

---

3.6 开机自启

openclaw daemon enable

开启后电脑开机自动运行，不需要手动启动。

---

3.7 健康检查

向导会自动验证，显示 ✅ 即成功。

手动验证：openclaw gateway status

---

3.8 技能安装（可选）

常用技能推荐： weather（天气预报） opencli（社媒内容获取：微博、知乎、B站等） juejin-publisher（掘金文章发布） browser（浏览器自动化控制）

安装：openclaw skills install weather 查看所有：openclaw skills list

---

使用方式

方式一：Dashboard（浏览器界面）

openclaw dashboard 浏览器打开 http://localhost:18789，有可视化聊天界面。

方式二：TUI（终端界面）

openclaw tui 直接在终端聊天。

方式三：命令行发消息

openclaw message send --to +1234567890 --message "你好" openclaw agent --message "帮我写一个 README"

---

安全机制（重要）

OpenClaw 默认开启 DM 配对模式，陌生人发消息会被拦截，需要你审批：

陌生人发消息 → 收到配对码 → 你审批 → 审批通过后才能对话

查看待审批：openclaw pairing list 审批请求：openclaw pairing approve channel code

三种 DM 安全模式：

pairing（默认）：陌生消息拦截，需审批 ⭐ 推荐 allowlist：只有白名单用户能发消息 open：任何人可以发 ⚠️ 不推荐，有安全风险

---

常见问题

node: command not found → 先安装 Node.js openclaw: command not found → 重开终端，或检查 PATH 端口 18789 被占用 → openclaw gateway --force 强制重启 收不到消息 → 检查频道是否登录成功 + 配对审批 API 调用失败 → 检查 API Key 是否正确、网络是否可达 陌生人发消息没反应 → DM 模式是 pairing，需审批

---

进阶：零成本方案（本地模型）

不想花钱用 API？用 Ollama 本地跑，完全免费：

macOS：brew install ollama Linux：curl -fsSL https://ollama.com/install.sh | sh ollama pull llama3.2 ollama serve

然后在配置里选择 Ollama 作为模型提供商，不花一分钱。

---

附：北洋API（本文示例使用）

注册地址：https://api.tsbys.com 支持 Claude、GPT、GLM 等主流模型，国内直连

---

总结

1. Node 24 或 Node 22.16+ 必须先安装

2. 安装用 curl -fsSL https://openclaw.ai/install.sh | bash

3. 配置用 openclaw onboard --install-daemon

4. 模型配置是最关键的一步，选错会导致无法使用

5. Telegram 最容易上手，建议先从它开始

6. 安全模式保持默认的 pairing，不要改成 open

祝部署顺利 🎉