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

OpenClaw 完整安装教程2026版全平台通用 一款开源本地 AI 助手支持接入微信/飞书/Telegram/WhatsApp 等聊天工具多模型可选开箱即用标签AI助手OpenClawLLMAI工具本地部署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.jsNode 24推荐或 Node 22.16系统macOS 12 / Linux / WindowsWSL2 推荐内存推荐 4GB⚠️ Windows 用户建议用 WSL2原生 Windows 可以但稳定性不如 WSL2。验证 Node 版本node -v安装步骤第一步安装 Node.js如未安装macOS / Linuxcurl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash - sudo apt-get install -y nodejsWindows直接去 https://nodejs.org/zh-cn 下载 LTS 版v24第二步安装 OpenClaw官方推荐方式curl -fsSL https://openclaw.ai/install.sh | bash这个脚本会自动检测操作系统、安装 Node如需要、安装 OpenClaw然后启动配置向导。其他安装方式npm install -g openclawlatestpnpm add -g openclawlatest pnpm approve-builds -g安装后验证openclaw --version查看版本 openclaw doctor检查配置问题推荐跑一下第三步初始化配置核心步骤openclaw onboard --install-daemon 加 --install-daemon 会自动配置开机自启服务关机再开机不用手动启动。3.1 选择模式QuickStart每一步用最优默认值一路回车即可适合新手Advanced每一步详细配置自己选适合有经验的用户 新手选 QuickStart默认值已经是最优选择。3.2 配置模型关键步骤这是最重要的一步选用什么模型直接影响使用体验。如果你使用国内中转 API如北洋API选择 Custom Provider自定义提供商填入 API 地址https://api.tsbys.com具体路径参考你的 API 提供商文档填入 API Key在 API 控制台获取填入模型名称如 claude-3-5-sonnet、gpt-4o 等OpenClaw 支持的模型提供商国际主流Anthropic (Claude)、OpenAI (GPT)、Google (Gemini)、xAI (Grok) 国内主流GLM智谱、MoonshotKimi、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建议保持开启 TailscaleOff普通用户不需要 默认即可关闭认证会导致任何本地进程都能连接不安全。3.5 频道接入聊天工具Telegram⭐ 最简单10分钟搞定推荐度最高飞书中等企业用户推荐Discord中等WhatsApp较麻烦需要手机扫码钉钉中等企业用户 建议先跳过后续用 openclaw channels login 单独配置。Telegram 最容易上手强烈推荐先试这个。3.6 开机自启openclaw daemon enable开启后电脑开机自动运行不需要手动启动。3.7 健康检查向导会自动验证显示 ✅ 即成功。手动验证openclaw gateway status3.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 本地跑完全免费macOSbrew install ollama Linuxcurl -fsSL https://ollama.com/install.sh | sh ollama pull llama3.2 ollama serve然后在配置里选择 Ollama 作为模型提供商不花一分钱。附北洋API本文示例使用注册地址https://api.tsbys.com 支持 Claude、GPT、GLM 等主流模型国内直连总结Node 24 或 Node 22.16 必须先安装安装用 curl -fsSL https://openclaw.ai/install.sh | bash配置用 openclaw onboard --install-daemon模型配置是最关键的一步选错会导致无法使用Telegram 最容易上手建议先从它开始安全模式保持默认的 pairing不要改成 open祝部署顺利