2026 年OpenClaw 部署保姆级教程：一文搞定本地、云端、模型配置全流程2026 最新 OpenClaw 教程：

2026 最新 OpenClaw 教程：本地+云服务器部署全攻略（含飞书/Moonshot 配置）

什么是 OpenClaw？

OpenClaw（原名 Clawdbot，过渡名 Moltbot）是 2026 年 1 月突然爆火的开源个人 AI 助手项目，由 Peter Steinberger（PSPDFKit 创始人）开发。

OpenClaw 是一个可执行任务的智能体，我们给指令，它不仅回答，还能主动操作系统、访问网页、处理邮件、整理文件、发起提醒甚至自动编写代码。

项目名称演变

Clawdbot → Moltbot → OpenClaw

名称	时间线	背景/原因
Clawdbot / Clawbot	2025 年末至 2026 年 1 月初	最初项目名
Moltbot	2026 年 1 月 27 日	因商标顾虑更名（小龙虾 Molty 🦞）
OpenClaw	2026 年 1 月 30 日之后	当前官方名称

官方链接

OpenClaw 官网: openclaw.ai/
Github 地址：github.com/openclaw/op…
OpenClaw 技能合集: github.com/VoltAgent/a…

一、本地安装教程

系统要求

硬件：极低要求，2GB RAM 即可运行
系统：支持 Mac、Windows、Linux
环境：需要安装 Node.js (pnpm) 或使用 Docker

方法一：一键安装（推荐）

这是最简单的安装方式，适合所有用户。

macOS/Linux 系统：

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

Windows 系统（PowerShell）：

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

Windows 系统（CMD）：

curl -fsSL https://openclaw.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

方法二：手动安装

如果你已经安装了 Node.js (≥22)，可以使用 npm 或 pnpm 安装：

npm i -g openclaw
# 或
pnpm add -g openclaw

安装完成后，运行初始化命令：

openclaw onboard

方法三：从源码安装（开发者模式）

git clone https://github.com/openclaw/openclaw.git
cd openclaw

pnpm install
pnpm ui:build
pnpm build

# 初始化并安装为系统服务
pnpm openclaw onboard --install-daemon

# 开发模式
pnpm gateway:watch

二、配置向导详解

安装完成后，会自动启动配置向导。以下是每个步骤的详细说明：

步骤 1：风险确认

系统会提醒你 OpenClaw 功能强大，但也具有一定风险。选择 Yes 继续安装。

步骤 2：选择安装模式

建议首次用户选择 QuickStart 模式，可以快速完成基础配置。

步骤 3：配置 AI 模型

选择你要使用的 AI 供应商。国内外主流模型都支持：

如果没有海外账号，可以选择国内的 Qwen、MiniMax、智谱等。

步骤 4：选择聊天通道

选择你想使用的聊天工具：

海外用户可选：WhatsApp、Telegram、Discord、Slack
国内用户可跳过，后续配置飞书

步骤 5：端口和其他配置

Gateway Port 保持默认 18789 即可：

步骤 6：选择技能包

按空格键选择需要的技能，可以多选：

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

步骤 7：API Key 配置

如果没有相关服务的 API Key，选择 No 跳过：

步骤 8：启用 Hooks

建议启用这些功能，用于内容引导、日志记录和会话管理：

完成配置

配置完成后，会自动打开聊天界面：http://127.0.0.1:18789/chat

三、云服务器部署教程

如果你想把 OpenClaw 部署到云服务器上，可以使用各大云平台提供的一键镜像。

腾讯云详细部署步骤

1. 使用模板重装系统

使用模板重装时，请选择 OpenClaw（Moltbot 不支持飞书）。

386c6ae2-ea4c-4744-a458-23dede64b906

2. 进入服务器终端

找到登录按钮，进入命令终端：

3. 启动配置向导

openclaw onboard

提示：若需修改配置，可执行 openclaw configure 命令重新进入配置界面。

4. 风险确认

选择 Yes 表示已了解 OpenClaw 权限相关风险：

5. 选择安装模式

建议选择 QuickStart 模式：

6. 配置处理

第一次配置使用 Use existing values、Update、Reset 都可以。

7. 模型配置

如果你使用国内模型（如 Moonshot），建议先选择 Skip for now 跳过，后续通过配置文件单独设置：

8. 默认模型选择

任意选择一个模型临时占位，后续会通过配置文件覆盖：

f447bbeb-2d85-48f6-a27a-e3a5642e50de

9. 通道配置

如果使用飞书，可以选 Skip for now 先跳过，后面单独配置：

ef846e73-46e5-46da-8ad6-a2ab45afb80d

10. 技能配置

选择 Yes 安装常用技能：

按空格键选择要安装的技能（可多选）：

05a4d5f1-5d1f-448e-8349-485d41c9d473

11. 完成配置

确认重启服务：

12. 启动方式

选择 Hatch in TUI 通过终端使用：

9f18898c-890e-45ff-8dfc-dce57d34c975

13. 保存信息

保存界面输出的重要信息：

b251944b-9073-4bcb-959f-367c31984cef

四、公网访问配置

如果你需要从外网访问服务器上的 OpenClaw，需要进行以下配置。

WebSocket 配置

如果需要接入 Telegram、WhatsApp 等社交应用，需要配置 WebSocket。

openclaw configure

Gateway 运行位置

选择公网 IP，替换 127.0.0.1：

3248ac61-7cdc-4ebd-af79-f9176d3d0b6d

Gateway 认证

选择 Token 模式，设置访问密码：

Web UI 公网访问

修改配置文件：

nano ~/.openclaw/openclaw.json

将 mode 改成 remote，bind 改成 lan，然后重启：

openclaw gateway stop
openclaw gateway start

查看 token：

cat ~/.openclaw/openclaw.json

630df128-917e-4751-8ad6-5fa47f16c2a7

访问时在地址后面附加 &token=xxx：

22d60d46-bade-4bc3-9332-5942cde504d2

设备授权

如果出现 pairing required 错误，需要授权设备：

openclaw devices list

3f8d2aad-3c14-4822-aa49-b848c4c53aff

找到 Pending 列表，复制 Request 并授权：

openclaw devices approve b8eb70dd...

6dd4cca8-38d7-45f9-93e1-f4758f4b40c2

五、配置国内模型

配置 Moonshot (Kimi) 模型

获取 API Key：platform.moonshot.cn/console/api…
查看支持的模型：platform.moonshot.cn/playground

ef99563e-fffd-4c8f-bbe4-c90c864fc0da

配置 Kimi Code 模型

购买编程模型：www.kimi.com/code

创建 API Key：www.kimi.com/code/consol…

b030bb77-45eb-43e2-b8dc-81742667f569

修改配置文件

编辑配置文件：

nano ~/.openclaw/openclaw.json

替换或添加以下配置（请将 ${MOONSHOT_API_KEY} 和 ${KIMICODE_API_KEY} 替换为你的实际密钥）：

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "moonshot/kimi-k2.5"
      },
      "maxConcurrent": 4,
      "subagents": {
        "maxConcurrent": 8
      },
      "workspace": "/root/.openclaw/workspace"
    }
  },
  "models": {
    "mode": "merge",
    "providers": {
      "moonshot": {
        "baseUrl": "https://api.moonshot.cn/v1",
        "apiKey": "${MOONSHOT_API_KEY}",
        "api": "openai-completions",
        "models": [
          {
            "id": "kimi-k2.5",
            "name": "Kimi K2.5"
          }
        ]
      },
      "kimi-code": {
        "baseUrl": "https://api.kimi.com/coding/v1",
        "apiKey": "${KIMICODE_API_KEY}",
        "api": "openai-completions",
        "models": [
          {
            "id": "kimi-for-coding",
            "name": "Kimi For Coding"
          }
        ]
      }
    }
  }
}

重启服务：

openclaw gateway stop
openclaw gateway start

六、配置飞书集成

步骤 1：创建飞书应用

打开飞书应用管理后台
创建应用 → 添加应用能力 → 选择机器人

步骤 2：配置权限

开通消息与群组的所有权限：

步骤 3：配置事件和回调

使用长连接方式，添加消息相关事件：

625aff5d-48cd-4ee4-86a0-090d8d316eec

步骤 4：配置 OpenClaw

openclaw configure

选择 Channels：

15490039-6f2a-42da-aedb-fcfa8415be54

填入飞书应用的 App ID 和 App Secret：

七、常用命令速查

基础命令

命令	作用	说明
`openclaw status`	查看运行状态	包含健康度与上下文信息
`openclaw health`	健康检查	检测核心依赖与运行环境
`openclaw doctor`	综合诊断	支持 `--deep` 深度检查
`openclaw onboard`	初始化向导	首次使用推荐
`openclaw configure`	配置向导	模型、通道、凭据等

Gateway 管理

命令	作用
`openclaw gateway start`	启动服务
`openclaw gateway stop`	停止服务
`openclaw gateway restart`	重启服务
`openclaw gateway status`	服务状态

通道管理

命令	作用
`openclaw channels list`	列出已登录通道
`openclaw channels login`	登录新通道（WhatsApp 二维码）
`openclaw channels add`	添加 Telegram/Discord/Slack
`openclaw channels status --probe`	通道健康检查

模型管理

命令	作用
`openclaw models list`	列出可用模型
`openclaw models status`	模型状态
`openclaw models auth setup-token`	模型鉴权配置

配置管理

命令	作用
`openclaw config get <path>`	获取配置值
`openclaw config set <path> <value>`	设置配置项
`openclaw config unset <path>`	清除配置项

日志和调试

命令	作用
`openclaw logs`	查看日志
`openclaw logs --follow`	实时日志

内存和技能

命令	作用
`openclaw memory search "关键词"`	搜索长期记忆
`openclaw memory index`	重建记忆索引
`openclaw skills list`	列出技能
`clawhub install <slug>`	安装社区技能

卸载命令

命令	作用
`openclaw uninstall`	卸载服务及数据
`openclaw uninstall --all --yes`	全自动卸载
`openclaw uninstall --dry-run`	模拟卸载

八、关键文件路径

路径	说明
`~/.openclaw/openclaw.json`	主配置文件
`~/.openclaw/workspace/`	默认工作区
`~/.openclaw/credentials/`	API 密钥存储
`~/.openclaw/memory/`	向量索引存储
`~/.openclaw/skills/`	全局共享技能
`/tmp/openclaw/*.log`	网关文件日志

工作区文件说明

AGENTS.md：指令说明
USER.md：用户偏好设置
MEMORY.md：长期记忆
HEARTBEAT.md：检查清单
SOUL.md：人格/语气设定
IDENTITY.md：名称/主题
BOOT.md：启动配置

九、聊天内斜杠命令

在聊天界面中可以使用以下命令：

命令	作用
`/status`	查看健康状态和上下文
`/context list`	查看上下文贡献者
`/model <模型名>`	切换模型
`/compact`	释放窗口空间
`/new`	开启全新会话
`/stop`	中止当前运行
`/tts on/off`	开关语音
`/think`	切换推理模式

十、故障排除

常见问题

1. 机器人无响应 → 检查 Gateway 状态：openclaw status

2. 无私信回复 → 检查配对列表并批准设备：openclaw devices list

3. 群组中静默 → 检查提及模式配置

4. 认证过期 → 重新设置认证：openclaw models auth setup-token

5. 网关关闭 → 运行深度诊断：openclaw doctor --deep

6. 内存异常 → 重建索引：openclaw memory index

获取帮助

GitHub Issues：github.com/openclaw/op…
官方文档：openclaw.ai/docs

十一、为什么 OpenClaw 这么火？

核心优势

真正做到了"像 JARVIS 一样"
- 能读写文件
- 跑终端命令
- 操作浏览器
- 收发邮件
- 日程管理
- 写代码
- 订机票
- 清空收件箱
本地优先 + 长期记忆
- 所有对话跨平台共享上下文
- USER.md 和 memory/ 目录会越用越聪明
支持几乎所有大模型
- Claude、Gemini、OpenAI
- Ollama 本地模型
- 国内模型：Moonshot、Qwen、智谱等
社区技能生态爆炸
- ClawHub 上已有 500+ 社区技能
- 支持 Slack、Discord、GitHub
- 浏览器控制、macOS UI 自动化
安装简单，功能强大
- 像 npm install 一样简单
- 实际能力却非常强大

与其他工具对比

能力维度	OpenClaw	Claude Code	OpenCode
任务规划	强	中	中
自动执行	完整	部分	部分
自我修复	有	无	无
工程级操作	强	强	中
本地自动化	原生支持	较弱	较弱

结语

OpenClaw 是一个真正把 本地算力 + 大模型 Agent 自动化 玩到极致的开发者效率工具。它的目标是让 AI 不只是给建议，而是直接完成完整工程任务。

希望本教程能帮助你快速上手 OpenClaw，开启你的 AI 助手之旅！

2026 年OpenClaw 部署保姆级教程：一文搞定本地、云端、模型配置全流程