OpenClaw 是 2026 年最受开发者追捧的开源 AI 个人助手，但不少用户在安装和配置环节遇到了障碍。本文将作为一份完整的 OpenClaw 入门指南，手把手带你完成从零安装到正式上手的全过程，想获取更多中文资源请访问 OpenClaw 中文版官网。

一、OpenClaw 是什么？先简单了解一下

OpenClaw 是一款自托管的开源 AI 智能体框架，运行在你自己的设备上，数据完全本地化。它不是一个普通的聊天机器人——它是一个长期运行的 Node.js 服务，能够将 Claude、ChatGPT、Gemini 等大型语言模型与你本地的文件、应用和通讯平台连接起来，真正自主地替你执行任务。

截至 2026 年 3 月，OpenClaw 在 GitHub 上已突破 24 万颗星标，成为史上增长最快的开源项目之一。访问 OpenClaw 中文版官网 可获取最新版本及中文文档。

二、安装前的准备工作

系统要求

在开始安装之前，请确认你的环境满足以下基本条件：

  • 操作系统：macOS、Linux（推荐 Ubuntu 24.04 LTS）或 Windows（需通过 WSL2，不支持原生 PowerShell 安装）
  • Node.js 版本：v22.16 及以上，或 v24（OpenClaw 对 Node.js 版本有强制检查，版本不符将无法启动）
  • AI 模型 API 密钥：支持 Anthropic Claude、OpenAI、Google Gemini、OpenRouter、Amazon Bedrock 等主流服务商，或本地运行 Ollama / vLLM 私有模型（无需 API 密钥）
  • 内存建议：4GB 及以上（服务器部署推荐 4GB 计划）

如果你使用的是 Windows 系统，请先安装 WSL2，整个过程约 10 分钟，完成后再按照 Linux 流程操作。

提前获取 API 密钥

以 Anthropic Claude 为例：访问 console.anthropic.com，登录后前往 Settings → API Keys 创建一个新密钥。建议将密钥保存至环境变量而非直接写入配置文件，以提高安全性。

三、三种安装方式详解

方式一：npm 全局安装（最快，推荐新手）

这是最简便的安装方式，一条命令即可完成：

npm install -g openclaw@latest

安装完成后，运行以下命令验证是否成功：

openclaw --version

如果显示版本号，说明安装成功。若提示”命令未找到”，通常是因为 npm 全局目录不在系统 PATH 中，执行以下命令修复，并将其添加至 ~/.zshrc 或 ~/.bashrc：

export PATH="$(npm prefix -g)/bin:$PATH"

方式二：Docker 安装（适合服务器部署）

如果你希望将 OpenClaw 完全隔离运行，Docker 是更好的选择：

docker run -it \
  -v ~/.openclaw:/root/.openclaw \
  -v $(pwd):/workspace \
  -e ANTHROPIC_API_KEY=sk-ant-your-key-here \
  openclaw/openclaw:latest \
  run "Summarize the README.md file in /workspace"

Docker 方式下，OpenClaw 无法访问容器外部的文件或进程，除非你主动挂载相应目录，安全性更高。

方式三：DigitalOcean 一键部署（最省心）

DigitalOcean 提供了 OpenClaw 的一键部署方案，预装了所有依赖项，并包含安全加固配置，适合不想折腾本地环境的用户，起步价约 24 美元/月。

四、运行引导向导（Onboarding）

安装完成后，运行以下命令启动配置向导：

openclaw onboard --install-daemon

向导会依次引导你完成以下配置步骤：

  1. 阅读安全提示：OpenClaw 会弹出安全警告，确认后继续
  2. 选择模式：选择 Quickstart（快速上手）或 Manual（手动配置）
  3. 选择 AI 模型服务商：支持 Anthropic、OpenAI、OpenRouter、本地模型等，国内用户也可选择 DeepSeek、智谱 GLM 等中文模型
  4. 输入 API 密钥：粘贴你的 API Key，向导会自动验证有效性
  5. 配置 Gateway 绑定方式：强烈建议选择 Loopback（本机回环），避免 Canvas Host 默认绑定 0.0.0.0 导致局域网内所有设备均可访问你的面板
  6. 安装 Hooks（可选）：建议全部选中，提升使用体验
  7. 完成配置并重启服务：选择 Restart 应用所有配置

配置完成后，终端会显示 Web UI 访问地址，通常为：

http://127.0.0.1:18789

同时会显示一个访问 Token，请务必复制保存，稍后登录 Web 面板时需要用到。

五、检查 Gateway 状态

配置完成后，使用以下命令确认 Gateway 是否正常运行：

openclaw gateway status
openclaw doctor

openclaw doctor 会自动扫描常见配置问题并给出修复建议，是排查故障的首选命令。

六、连接你的消息平台

OpenClaw 最强大的特性之一，就是可以通过你日常使用的通讯软件与 AI 直接对话。目前支持的平台包括 WhatsApp、Telegram、Slack、Discord、微信、Line、iMessage、Microsoft Teams 等几十种。

以 Telegram 为例，连接步骤如下：

  1. 在 Telegram 中找到 @BotFather，创建一个新 Bot，获取 Bot Token
  2. 打开 OpenClaw Web 面板（http://127.0.0.1:18789），进入 Channels 设置
  3. 选择 Telegram，粘贴 Bot Token 并保存
  4. 在 Telegram 中向你的 Bot 发送消息，即可开始对话

微信用户可在 Web 面板的 Skills 中搜索并安装微信相关扩展，按照提示完成授权即可。

七、安装技能扩展（AgentSkills）

OpenClaw 的能力通过”技能（Skills）”进行扩展。目前 ClawHub 上已有超过 3000 个社区构建的扩展可供选择，涵盖文件管理、GitHub 集成、Google Calendar、Notion、智能家居控制等场景。

在 Web 面板中进入 Skills 页面，搜索你需要的功能并点击 Install 即可。安装前建议查看扩展的开源代码，仅从可信来源安装，避免潜在的安全风险。

八、费用说明：使用 OpenClaw 要花多少钱？

OpenClaw 本身完全免费开源，费用主要来自 AI 模型的 API 调用。需要特别注意的是，由于 OpenClaw 是智能体模式，每完成一个任务通常需要 5～10 次 API 调用，且每次调用都会携带完整的上下文历史，因此 Token 消耗远高于普通对话。

以 Claude Sonnet 4.6 为例（2026 年 2 月官方定价），费用约为每百万 Token 输入 3 美元、输出 15 美元。实际月费用因使用频率差异较大，从约 3 美元到 200 美元以上均有可能。建议养成定期开启新会话的习惯，避免因旧上下文积累造成不必要的 Token 浪费。

九、常用命令速查

  • openclaw --version：查看当前版本
  • openclaw doctor：检查配置问题
  • openclaw gateway status：查看 Gateway 运行状态
  • openclaw dashboard：打开 Web 控制面板
  • openclaw daemon restart：重启后台服务
  • openclaw models list：列出当前可用模型
  • npm install -g openclaw@latest：升级至最新版本

总结

OpenClaw 的安装整体并不复杂，按照本文步骤操作，通常在 15～30 分钟内即可完成从安装到首次对话的全流程。核心要点是：确保 Node.js 版本符合要求、选择合适的 AI 模型服务商、并在引导向导中将 Gateway 绑定设置为 Loopback 以保障安全。

如果在安装过程中遇到问题，可运行 openclaw doctor 进行自动诊断，或访问 OpenClaw 中文版官网 查阅官方文档与社区支持，开启你的专属 AI 助手之旅。