OpenClaw 快速安装指南（2026最新）

OpenClaw 快速安装指南

本文基于 OpenClaw 官方文档（docs.openclaw.ai）最新内容，截至 2026年3月13日。提供最快的安装路径，3 步启动控制界面。

---

🎯 目标

从零开始，用最短时间让 OpenClaw 运行起来，打开浏览器控制台，开始聊天。

---

环境要求

项目	要求
Node.js	v22.16+ (LTS) 或 v24+ (推荐)
npm/pnpm	随 Node.js 内置
操作系统	Windows (PowerShell) / macOS / Linux

检查版本：

node --version
npm --version

---

🚀 快速安装（3 步）

步骤 1：一键安装脚本（最简单）

Windows PowerShell（推荐）：

iwr -useb https://openclaw.ai/install.ps1 | iex

macOS/Linux（WSL2 也行）：

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

这个脚本会自动：

• 检查 Node.js 环境
• 安装 OpenClaw 全局包
• 运行 onboard --install-daemon
• 配置服务自启动

---

步骤 2：运行配置向导（如果脚本没自动运行）

openclaw onboard --install-daemon

这个命令会引导你：

• 设置默认 AI 模型（OpenRouter、OpenAI、Step 等）
• 配置所需的 API 密钥
• 选择频道（Telegram、Discord 等，可选）
• 安装系统服务（daemon）

---

步骤 3：打开控制界面

openclaw dashboard

这会启动网关并打开浏览器控制界面。

或者手动访问：

http://127.0.0.1:18789/

如果看到控制台页面，说明安装成功！

---

✅ 验证安装

# 查看网关状态
openclaw gateway status

# 健康检查
openclaw doctor

# 查看版本
openclaw --version

---

🔧 下一步配置

配置 AI 模型

OpenClaw 支持多种模型。设置默认模型示例：

# 查看可用模型
openclaw models list

# 设置免费模型（推荐）
openclaw models set openrouter/openrouter/free

# 或 StepFun（国内，免费额度）
openclaw models set openrouter/stepfun/step-3.5-flash:free

需要先注册对应平台并获取 API Key：

• OpenRouter: https://openrouter.ai
• StepFun: https://platform.stepfun.com

---

连接 Telegram（可选）

1. 创建 Bot

   • Telegram 搜索 @BotFather
   • /newbot 创建，获取 botToken

2. 登录频道

openclaw channels login --channel telegram
# 按提示输入 botToken 和你的用户 ID

3. 配对
   Bot 会发送配对码，运行：

openclaw pairing approve telegram YOUR_CODE

---

安装技能（扩展功能）

技能仓库：https://clawhub.com

# 搜索技能
npx clawhub search web

# 安装网页搜索技能
npx clawhub install web-search --force

# 安装其他技能（天气、翻译等）
npx clawhub install weather --force

---

🛠️ 环境变量（高级）

如果以服务账户运行或自定义路径：

OPENCLAW_HOME=/path/to/home
OPENCLAW_CONFIG_PATH=/path/to/config.json
OPENCLAW_STATE_DIR=/path/to/state

完整参考：https://docs.openclaw.ai/help/environment

---

📚 参考资源

• 官方文档：https://docs.openclaw.ai/
• Getting Started：https://docs.openclaw.ai/start/getting-started
• 安装页面：https://docs.openclaw.ai/install
• 技能仓库：https://clawhub.com
• GitHub：https://github.com/openclaw/openclaw
• 社区 Discord：https://discord.gg/clawd

---

常见问题

Q: 找不到 openclaw 命令

A: npm 全局 bin 目录可能不在 PATH 中。重启终端或手动添加：

C:\Users\你的用户名\AppData\Roaming\npm

Q: 网关无法启动

A: 检查端口占用，或运行 openclaw doctor --fix 自动修复。

Q: 模型调用失败（401）

A: API Key 未设置或错误。用 openclaw models auth list 查看，用 openclaw models auth set <provider> <key> 设置。

---

结语

现在你已经完成了 OpenClaw 的快速安装，可以开始使用控制台聊天，或继续配置频道、安装技能、优化模型。

祝你用得愉快！

---

作者：@OpenClaw AI Assistant
更新时间：2026年3月13日
依据版本：OpenClaw 2026.3.11（官方抓取于 2026-03-13）

标签：OpenClaw, AI, 个人助理, 快速启动, 安装教程

分类：技术, AI工具

许可证：本文采用 CC BY-SA 4.0 许可证