OpenClaw 部署教程（新手入门）

本教程基于 OpenClaw v2026.4.14 稳定版，面向零基础新手，手把手带你完成从安装到第一条消息的全过程。

目录

  1. 什么是 OpenClaw？
  2. 准备事项
  3. 方式一：飞书妙搭（零门槛，推荐！）
  4. 方式二：npm 命令行安装（通用）
  5. 方式三：宝塔面板部署（有服务器）
  6. 初始化配置（必做）
  7. 配置 AI 模型
  8. 接入消息平台（飞书/企微等）
  9. 第一条消息：验证部署成功
  10. 常用命令速查
  11. 常见问题排查
  12. 成本优化建议

1. 什么是 OpenClaw？

OpenClaw 是一个开源 AI Agent 框架，核心是让 AI 不只是"聊天"，而是能真正"干活"——操作文件、执行命令、调用工具、接入各种消息平台。

核心特点

  • 🔧 Skills 生态：官方技能市场收录 5700+ 技能，覆盖办公、调研、安全等场景
  • 💬 多平台接入：支持飞书、企业微信、Telegram、Discord 等 20+ 平台
  • 🧠 记忆系统：跨会话保留上下文，越用越懂你
  • 🌍 随处运行：本地电脑、服务器、云端均可部署
  • 💰 成本可控：支持国产模型，费用可低至每月几元

OpenClaw vs Hermes Agent

对比项OpenClawHermes Agent
开发方开源社区Nous Research
技术栈Node.jsPython
Skills 生态5700+（ClawHub）开放标准
部署难度低（多种方式）中
推荐新手⭐⭐⭐⭐⭐⭐⭐⭐

2. 准备事项

请确认以下内容后再开始：

项目要求说明
操作系统macOS 12+、Linux、Windows 10/11WSL2 也支持
Node.jsv22.16+（推荐 v24）OpenClaw 基于 Node.js 运行
网络能访问国际互联网（或国内镜像）需要连接 AI 模型 API
消息平台账号可选飞书/企微等，用于接入
AI 模型 API Key需要至少一种详见第 7 节
⚠️ 没有 Node.js？ 先安装：https://nodejs.org（选 LTS 版本）
验证：node --version 应显示 v22.16 以上

3. 方式一：飞书妙搭（零门槛，推荐！）

如果你只想最快体验 OpenClaw，不想折腾服务器，这是最好的选择。

优势

  • ✅ 完全免费
  • ✅ 1 分钟完成
  • ✅ 每日 100 万 Tokens（足够日常使用）
  • ✅ 无需自己准备服务器

步骤

  1. 打开飞书，搜索 "妙搭" 或访问妙搭平台
  2. 找到 OpenClaw 模板，点击一键部署
  3. 按提示授权飞书应用
  4. 部署完成后，在飞书中直接和你部署的 AI 对话
📖 详细图文教程：可搜索「飞书妙搭 OpenClaw 一键部署」

4. 方式二：npm 命令行安装（通用）

适合有一定命令行基础，或需要在自己电脑/服务器上部署的用户。

第一步：确认 Node.js 版本

node --version
# 必须 v22.16 以上，推荐 v24

如果版本太低，先升级 Node.js：https://nodejs.org

第二步：安装 OpenClaw

# 安装稳定版（推荐）
npm install -g openclaw@2026.4.14

# 验证安装
openclaw --version
# 应显示 2026.4.14
⚠️ 不推荐旧版本：v2026.2.12 存在已知 Bug，请勿使用

第三步：初始化

openclaw onboard

按提示完成初始配置（选择 AI 提供商、设置工作目录等）。

5. 方式三：宝塔面板部署（有服务器）

如果你有一台 Linux 服务器，用宝塔面板可以可视化管理，非常适合新手。

步骤

  1. 登录宝塔面板，进入软件商店
  2. 搜索 "OpenClaw"，点击安装
  3. 安装完成后，在面板中点击设置
  4. 按提示配置 AI 模型和消息平台
  5. 启动服务，完成！
💡 宝塔面板可一键配置 Nginx 反向代理、SSL 证书、进程守护等，省去大量运维工作

6. 初始化配置（必做）

安装完成后，以下两项配置必须完成，否则 OpenClaw 无法正常工作。

⚠️ 必设项一：Gateway 认证

自 v2026.3.7 起，Gateway 必须显式设置认证，否则启动失败：

openclaw config set gateway.auth.mode token
openclaw config set gateway.auth.token "你的密钥"
# 密钥可以自己随便设一个，比如：MySecretToken123
openclaw gateway restart

⚠️ 必设项二：工具 Profile（解决 AI "变哑巴"问题）

v2026.3.2 后默认 profile 是 messaging（纯聊天，不能执行操作），需要切换：

# 切换到完整工具集（推荐）
openclaw config set tools.profile full
openclaw gateway restart

Profile 对比表：

Profile能力说明推荐场景
messaging只能聊天、管理会话不推荐
default默认工具集（不能执行命令）受限场景
coding编程相关工具开发场景
full完整工具集，含命令执行推荐 ✅
all所有工具全开高级用户

7. 配置 AI 模型

OpenClaw 需要连接大语言模型（LLM）才能工作。以下是主流模型的配置方式。

方式 A：交互式登录（推荐）

openclaw models auth login --provider <提供商名>

按提示完成 OAuth 或输入 API Key。

方式 B：手动设置 API Key

# DeepSeek（推荐，便宜好用）
openclaw config set DEEPSEEK_API_KEY sk-your-key-here

# OpenRouter（一个 Key 用所有模型）
openclaw config set OPENROUTER_API_KEY sk-or-v1-xxx

# Anthropic (Claude)
openclaw config set ANTHROPIC_API_KEY sk-ant-xxx

# OpenAI (GPT)
openclaw config set OPENAI_API_KEY sk-xxx

主流模型推荐（按性价比排序）

模型推荐指数月费用参考获取方式
DeepSeek⭐⭐⭐⭐⭐5-30 元https://platform.deepseek.com
Kimi (Moonshot)⭐⭐⭐⭐10-50 元https://platform.moonshot.cn
OpenRouter⭐⭐⭐⭐按量计费https://openrouter.ai
Anthropic (Claude)⭐⭐⭐较高https://console.anthropic.com
Nous Portal⭐⭐⭐⭐有免费额度openclaw models auth login --provider nous

使用本地模型（Ollama）

如果你想完全免费运行，可以用 Ollama 在本地跑开源模型：

# 1. 安装 Ollama（会自动引导）
openclaw setup ollama

# 2. 下载模型（如 qwen3）
ollama pull qwen3:14b

# 3. 在 OpenClaw 中配置
openclaw config set model ollama/qwen3:14b
⚠️ 本地模型需要较好的显卡/内存，上下文窗口需 ≥ 64,000 tokens

8. 接入消息平台（飞书/企微等）

OpenClaw 最强大的功能之一就是可以通过消息平台和你交互，让你在手机上也能使用 AI Agent。

支持的平台

平台配置难度说明
飞书（Feishu）⭐⭐国内最推荐
企业微信（WeCom）⭐⭐⭐需要企业认证
Telegram⭐最简单
Discord⭐适合海外用户
WhatsApp⭐⭐需要 Meta 审核
微信（iLink Bot 等）⭐⭐⭐⭐需要第三方网关

飞书接入步骤

#### 第一步：创建飞书应用

  1. 访问飞书开放平台：https://open.feishu.cn/
  2. 创建企业自建应用
  3. 启用机器人功能
  4. 配置权限（消息读取、消息发送、获取用户信息）
  5. 获取 App ID 和 App Secret
  6. 发布应用

#### 第二步：配置 OpenClaw

openclaw gateway setup
# 选择 Feishu，按提示输入 App ID 和 App Secret

#### 第三步：启动网关

openclaw gateway start

在飞书中 @ 你的机器人，应该能收到回复！

9. 第一条消息：验证部署成功

通过 CLI 测试

openclaw chat
# 然后输入：
你好，介绍一下你自己

通过消息平台测试

在飞书/企微等平台中，发送消息给机器人：

帮我看看今天有什么待办事项

或简单测试：

你好

验证成功的标志：

  • ✅ 机器人正常回复
  • ✅ 回复内容合理，不是乱码或报错
  • ✅ 可以执行简单操作（如查看文件、搜索网页）

10. 常用命令速查

基础命令

命令说明
openclaw启动 CLI 对话
openclaw chat开始聊天会话
openclaw onboard初始化向导
openclaw --version查看版本
openclaw update更新到最新版
openclaw gateway start启动消息网关
openclaw gateway restart重启网关
openclaw gateway status查看网关状态
openclaw gateway stop停止网关
openclaw doctor诊断配置问题

配置命令

命令说明
openclaw config get <key>查看配置项
openclaw config set <key> <value>设置配置项
openclaw config list列出所有配置
openclaw models list列出可用模型
openclaw models auth login模型登录

Skills 管理

命令说明
openclaw skills list查看已安装技能
openclaw skills install <name>安装技能
openclaw skills search <keyword>搜索技能市场

11. 常见问题排查

openclaw: command not found

原因：Node.js 全局路径未加入系统 PATH

解决方法：

# 查看 npm 全局路径
npm config get prefix

# 将该路径加入 PATH（以 bash 为例）
echo 'export PATH=$PATH:$(npm config get prefix)/bin' >> ~/.bashrc
source ~/.bashrc

Gateway 启动失败

原因：未设置 Gateway 认证（v2026.3.7+ 必设）

解决方法：

openclaw config set gateway.auth.mode token
openclaw config set gateway.auth.token "你的密钥"
openclaw gateway restart

AI 回复为空 / 变"哑巴"

原因：tools.profile 设置为 messaging，功能受限

解决方法：

openclaw config set tools.profile full
openclaw gateway restart

API 连接失败 / 401 错误

原因：API Key 错误或过期

解决方法：

  1. 检查 Key 是否复制完整
  2. 确认 Key 对应的提供商和模型匹配
  3. 重新设置 Key：openclaw config set <PROVIDER>_API_KEY <key>
  4. 测试连接：openclaw doctor

飞书 Bot 不回复

排查步骤：

  1. 确认网关正在运行：openclaw gateway status
  2. 确认飞书应用已发布
  3. 确认权限已正确配置（消息读取、发送）
  4. 查看日志：openclaw gateway logs

如何升级到最新版？

npm install -g openclaw@latest
openclaw --version  # 确认版本
openclaw gateway restart

12. 成本优化建议

使用 OpenClaw 的主要成本是 AI 模型 API 调用费。以下是省钱建议：

模型选择建议

场景推荐模型月费用估算
日常使用DeepSeek5-30 元
文档处理Kimi K2.7 Code / K2.6（256K 上下文）10-50 元
最强推理Claude Fable 5 / Opus 4.8100+ 元
完全免费本地 Ollama0 元（电费除外）

省钱技巧

  1. 用国产模型：DeepSeek/Kimi 比 Claude/OpenAI 便宜 50%-95%
  2. 设置 Token 限制：避免长对话消耗过多 Token
  3. 用飞书妙搭：免费 100 万 Tokens/天，日常够用
  4. 本地模型：如果有好显卡，Ollama 完全免费

附录：文件位置说明

OpenClaw 的配置文件都存放在用户目录下：

路径说明
~/.openclaw/主配置目录
~/.openclaw/config.json主配置文件
~/.openclaw/sessions/对话历史
~/.openclaw/skills/自定义技能
~/.openclaw/logs/运行日志

总结与下一步

完成以上步骤后，你已经成功部署了 OpenClaw！

接下来可以探索

  • 📚 安装 Skills：去 ClawHub 找你需要的技能
  • 🧠 配置记忆系统：让 OpenClaw 记住你的偏好和项目信息
  • 🔧 自定义工具：为你的工作流编写专属工具
  • 📱 接入更多平台：Telegram、Discord 等多平台同时在线

获取帮助

  • 官方文档：https://docs.openclaw.ai
  • GitHub 仓库：https://github.com/openclaw/openclaw
  • 中文教程（完整版）：https://github.com/xiangfeigao/openclaw-tutorial
  • 技能市场：https://clawhub.ai

*最后更新：2026 年 6 月 | 基于 OpenClaw v2026.4.14 稳定版*