OpenClaw 从安装到运行全流程（npm 安装版）保姆级指南

一、前置准备

• 已安装 Node.js ≥ 22（可通过 node -v 验证版本）
• 已注册 Moonshot AI（Kimi） 账号，用于获取 API Key
• 系统：Windows /macOS/ Linux（Windows 推荐使用 WSL2）

---

二、npm 安装 OpenClaw

打开终端 / 命令提示符，执行以下命令完成全局安装：

bash运行

# 全局安装 OpenClaw
npm install -g openclaw

# 验证安装（查看版本）
openclaw -v

安装成功后，终端会显示 OpenClaw 的版本号，例如 v2026.3.7。

---

三、初始化配置（Onboarding 向导）

1. 启动初始化向导

   bash运行

   openclaw onboard
   

2. 按向导逐步配置（核心步骤拆解）

   表格

   步骤	选项	操作说明
   安全提示确认	Yes	输入 Yes 确认理解安全风险
   配置模式	QuickStart	选择快速启动，后续可精细调整
   AI 服务商	Moonshot AI (Kimi K2.5)	选择你要接入的模型服务商
   Kimi 授权方式	Kimi API key (.ai)	选择通用 API Key 认证
   API Key 存储	Paste API key now	直接将密钥存储在配置文件中
   输入 API Key	-	粘贴从 Kimi 开发者平台 获取的 sk- 开头密钥
   默认模型确认	Keep current (moonshot/kimi-k2.5)	确认使用 Kimi 作为默认模型
   聊天渠道配置	Skip for now	先跳过，后续可配置 Telegram / 微信等
   Web 搜索配置	Skip for now	先跳过，后续可开启联网能力
   技能配置	No	先跳过，后续可开启代码执行等能力
   Hooks 配置	Skip for now	用空格键选中后回车，跳过自动化钩子
   孵化方式	Open the Web UI	自动打开浏览器管理面板

---

四、启动服务与访问面板

1. 手动启动服务（若向导未自动启动）

   bash运行

   openclaw start
   

2. 访问管理面板

   • 浏览器会自动打开地址：http://127.0.0.1:18789
   • 若未自动打开，可手动运行 openclaw dashboard 唤起面板
   • 使用向导中提供的 Token 登录，即可开始与 AI 对话

---

五、常见问题：认证失败（Invalid Authentication）

若终端出现 Invalid Authentication 或 HTTP 401 错误，说明 Kimi API Key 无效或已过期：

1. 重新生成 API Key

   • 访问 Kimi 开发者平台
   • 进入「API 密钥」页面，创建新的 sk- 开头密钥

2. 重新配置模型

   bash运行

   openclaw configure --section model
   

3. 重启服务

   bash运行

   openclaw stop
   openclaw start
   

---

OpenClaw 常用命令与配置技巧清单

一、核心运行命令

表格

命令	作用
openclaw start	启动 OpenClaw 服务（后台运行）
openclaw stop	停止 OpenClaw 服务
openclaw restart	重启服务
openclaw status	查看服务运行状态（端口、进程等）
openclaw dashboard	打开 Web 管理面板
openclaw onboard	重新进入初始化配置向导
openclaw -v / openclaw version	查看 OpenClaw 版本

二、精细化配置命令

表格

命令	作用
openclaw configure	进入全量配置向导
openclaw configure --section model	仅修改 AI 模型 / API Key 配置
openclaw configure --section channel	配置聊天渠道（Telegram / 微信等）
openclaw configure --section web	配置 Web 搜索能力
openclaw configure --section skills	开启 / 关闭技能（文件读写、代码执行等）
openclaw configure --section hooks	配置自动化钩子

三、实用配置技巧

1. 切换 AI 模型

   运行 openclaw configure --section model，选择其他模型（如 OpenAI/gpt-4o），按提示输入对应 API Key 即可。

2. 配置 Telegram 机器人

   • 运行 openclaw configure --section channel，选择 Telegram (Bot API)
   • 在 Telegram 中搜索 @BotFather，创建机器人并获取 Bot Token
   • 粘贴 Token 到终端，重启服务后即可在 Telegram 中对话

3. 启用 Kimi 联网搜索

   运行 openclaw configure --section web，选择 Kimi (Moonshot)，复用已配置的 API Key，无需额外密钥即可让 AI 联网查资料。

4. 解决端口冲突

   若默认端口 18789 被占用，运行 openclaw configure --section server，修改 port 参数为其他值（如 18790）。

5. 查看日志排错

   bash运行

   openclaw logs          # 查看实时运行日志
   openclaw logs --tail 100  # 查看最后 100 行日志
   

---

总结

• 快速上手：npm 安装 → 初始化配置（重点填 Kimi API Key）→ 启动服务 → 访问 Web 面板
• 日常管理：优先掌握 start/stop/dashboard/configure 命令，精细化配置用 --section 指定模块
• 排错优先：认证失败先重新生成 API Key，再通过日志定位问题

注：本文基于 OpenClaw v2026.3.7 版本编写，不同版本操作可能略有差异，以官方文档为准。