OpenClaw大龙虾机器人完整安装教程OpenClaw 是当前 AI Agent 领域最受关注的开源工具之一，它把 A

OpenClaw 是当前 AI Agent 领域最受关注的开源工具之一，它把 AI 从“只能聊天的助手”升级为“能执行任务的智能体”。通过接入大模型并调用工具，OpenClaw可以自动完成搜索网页、编写代码、管理文件、安排日程等复杂任务，甚至像一个全天候工作的“AI员工”。相比传统聊天机器人，它的核心价值在于让 AI 不只是回答问题，而是能够真正 思考-行动-反馈 的循环执行任务，从而实现自动化工作流和个人 AI 助手的能力。

它不仅在技术上带来了 AI 从“对话”到“执行”的关键跨越，也在开发者社区掀起了巨大的创新热潮。自开源以来，它在 GitHub 上迅速积累了数十万星标，大量创业团队和开发者围绕它开发插件、工具和自动化应用，甚至有人把它称为“AI时代的 Linux”或“Agent 操作系统”。在中国市场尤其火爆，教程、案例和创业项目快速涌现，许多团队正基于 OpenClaw 构建新的 AI 产品和自动化服务，推动 AI Agent 生态迅速成长。

OpenClaw是什么

OpenClaw 是一个开源、本地部署的 AI Agent 网关。它的核心思路不是“只回答问题”，而是让 AI 具备执行动作的能力，例如访问网页、运行命令、调度任务、连接聊天渠道和管理会话。根据资料，它原先还经历过名称变动：先后出现过 Clawdbot、Moltbot，最终在 2026 年 1 月底确定为 OpenClaw。

OpenClaw适合谁使用

如果你只是想体验普通 AI 对话，网页聊天产品已经够用了；但如果你想让 AI 真正“动手做事”，例如：

在本机或服务器上长期运行一个 AI 助手
通过 Web、Slack、Telegram 等入口随时调用它
让它搜索网页、打开页面、执行命令、自动化处理任务
接入自己的模型或中转 API，统一管理模型调用

那 OpenClaw 会更适合。第三方教程也特别强调，它更像“基础设施型 AI 助手”，而不是简单 Demo。

安装配置OpenClaw

**安装前准备，**系统与环境要求

如果你是新手，建议这样理解：

macOS：体验最好，适合本地长期运行
Windows：可用，适合一般用户
Linux：适合开发者和服务器部署
Node.js：建议使用 22+
磁盘/内存：普通本地使用不需要特别高配置，但长期运行建议 8GB 内存以上更稳妥。

Mac本地部署（推荐）

最佳体验：如果你有Mac电脑，强烈推荐本地部署，体验最好、功能最全！

硬件要求：

CPU：M系列芯片或Intel i5以上
内存：8GB以上（推荐16GB）
硬盘：10GB以上空闲空间

系统版本：

macOS 12 Monterey 或更高版本
推荐 macOS 14 Sonoma 或 macOS 15 Sequoia

前置软件：

Node.js 22.0.0+（会自动安装）
Homebrew（可选，用于安装依赖）

安装步骤

第一步：打开终端

按 Command + 空格 打开 Spotlight
输入 Terminal 或终端
按回车打开终端

第二步：安装 OpenClaw

在终端中执行以下命令：

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

安装过程会自动：

检测系统环境
安装Node.js（如果未安装）
下载OpenClaw
配置环境变量

预计时间：2-5分钟

第三步：验证安装

安装完成后，执行以下命令验证：

openclaw --version

如果显示版本号（如 2026.3.7），说明安装成功！

第四步：初始化配置

运行配置向导：

openclaw onboard

配置流程：

1. 接受风险提示：

选择 Yes 继续

2. 选择启动模式：

推荐选择 QuickStart 快速启动：

3. 选择AI模型：

选择你的AI供应商选择Custom Provider：

4. 输入BaseURL和API Key：

输入模型BaseURL：https://api.whatai.cc/v1，输入对应的API Key，选择OpenAI-compatible，输入模型ID如：claude-sonnet-4-6

5. 选择聊天工具：

如果要接入飞书/Telegram，选择对应选项
如果暂时不接入，选择 None（后续可配置）

6. Gateway端口设置：

默认 18789 即可：

7. 选择Skills：

使用空格键选择你需要的技能，也可以直接跳过：

8. API Key配置：

没有的可以选择 no 跳过：

9. 启用Hooks：

推荐启用这三个钩子（用于内容引导、日志和会话记录）：

10. 完成配置：

配置完成后，会自动启动Gateway服务并打开Web UI（http://127.0.0.1:18789/chat）

第五步：验证安装

# 检查Gateway状态
openclaw channels status

# 应该显示：
# Gateway reachable.

Windows本地部署

🪟 Windows用户：完全可用，但部分系统集成功能受限。

硬件要求：

CPU：2核以上
内存：4GB以上（推荐8GB）
硬盘：10GB以上空闲空间

操作系统：

Windows 10 或 Windows 11

前置软件：

Node.js 22.0.0+

WSL2 + Ubuntu部署（强烈推荐）

这是官方推荐的Windows部署方式，提供最完整的Linux环境支持。

第一步：启用WSL2

以管理员身份打开PowerShell，执行：

# 启用WSL功能
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

# 设置WSL 2为默认版本
wsl --set-default-version 2

重启计算机。

第二步：安装Ubuntu

方法一：Microsoft Store安装（推荐）

打开Microsoft Store
搜索「Ubuntu 22.04 LTS」或「Ubuntu 24.04 LTS」
点击「获取」并安装
首次启动设置用户名和密码

安装完成后会自动打开Ubuntu终端，按提示设置用户名和密码。

第三步：更新Ubuntu系统

在Ubuntu终端中执行：

# 更新软件包列表
sudo apt update && sudo apt upgrade -y

# 安装基础工具
sudo apt install -y curl git wget build-essential

第四步：安装Node.js 22+

#运行 NVM 安装脚本
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash

#使 NVM 生效
source ~/.bashrc

#安装 Node.js：
nvm install 22

#验证 Node.js 版本（必须≥22.x）
node --version
npm --version

第五步：安装 OpenClaw

一键脚本安装

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

选择AI模型：

选择你的AI供应商选择Custom Provider：

输入BaseURL和API Key：

输入模型BaseURL：https://api.whatai.cc/v1，输入对应的API Key，选择OpenAI-compatible，输入模型ID如：claude-sonnet-4-6

第六步：验证安装

# 查看版本
openclaw --version

# 查看帮助
openclaw --help

# 查看系统状态
openclaw status

第七步：配置Windows访问WSL2服务

由于OpenClaw运行在WSL2中，需要配置端口转发以便Windows访问。

创建启动脚本 start-openclaw.bat：

@echo off
echo Starting OpenClaw Gateway in WSL2...
wsl -d Ubuntu-22.04 -u root service openclaw start
timeout /t 3
start http://localhost:18789

或直接在WSL2中启动：

# 在WSL2 Ubuntu终端中
openclaw gateway run --port 18789

然后在Windows浏览器访问 http://localhost:18789

配置模型Custom Provider

这一步决定 OpenClaw 调用哪个大模型。

常见做法有三种：

1. 直接使用官方模型服务

例如 OpenAI、Anthropic、OpenRouter 等。

2. 使用 OpenAI 兼容中转 API

配置逻辑是：

选择 Custom Provider
输入 BaseURL
输入 API Key
Provider 类型选 OpenAI-compatible
再填写模型 ID

选择你的AI供应商选择Custom Provider：

4. 输入BaseURL和API Key：

输入模型BaseURL：https://api.whatai.cc/v1，输入对应的API Key，选择OpenAI-compatible，输入模型ID如：claude-sonnet-4-6

配置聊天入口

在 openclaw onboard 过程中，还会让你选择聊天渠道。如果暂时不接入 Slack、飞书等外部平台，可以直接选：

None

后续再配置即可。

如果你想在聊天软件里直接使用 OpenClaw，就在向导里选择对应平台并填入 Token。知乎教程重点演示了 Slack 的接入流程，并说明 Gateway 后台运行后，即使关闭 TUI 或 Web 面板，Slack 仍可正常和 Bot 对话。

Gateway 端口与技能选择

1. Gateway 端口

一般保持默认即可：

多个教程都使用这个默认端口。

2. Skills 选择

向导会让你选择 Skills，可以用空格勾选，也可以暂时跳过。第三方教程提到，Skills 主要用于扩展文件管理、知识管理、自动化等能力。

不过根据官方新文档，OpenClaw 现在更强调“一级工具”能力，浏览器、画布、节点、定时任务等已经是原生工具；Skills 和插件仍然存在，但更偏扩展与提示注入，而不是过去那种完全依赖 skill shell 的方式。

完成安装后如何进入界面

当 onboarding 完成后，OpenClaw 会自动启动 Gateway，并打开 Web UI。常见地址为：

http://127.0.0.1:18789/chat

或者用：

openclaw dashboard

直接打开控制面板。知乎文章也提到，某些情况下会生成带 token 的本地访问地址。

如果你偏好终端界面，也可以使用：

openclaw tui

这会进入终端聊天模式。

安装后必会的常用命令

OpenClaw 常用命令一览表：

分类

命令

描述

初始化与安装

openclaw onboard

交互式向导（配置模型、通道、网关、工作区）

初始化与安装

openclaw setup

初始化配置 + 工作区（非交互版）

初始化与安装

openclaw configure

交互式配置向导（模型、通道、技能）

网关管理

openclaw gateway status

查看网关服务状态 + RPC 探活

网关管理

openclaw gateway start

启动网关服务

网关管理

openclaw gateway stop

停止网关服务

网关管理

openclaw gateway restart

重启网关服务

网关管理

openclaw gateway run

直接在前台运行网关（调试用）

网关管理

openclaw gateway health

获取网关健康信息

配置管理

openclaw config file

显示当前配置文件完整路径

配置管理

openclaw config get <path>

读取配置项

配置管理

openclaw config set <path> <value>

修改配置项

配置管理

openclaw config validate

校验配置文件是否合法

诊断与状态

openclaw doctor

一键健康检查 + 自动修复

诊断与状态

openclaw status

显示会话健康状态和最近联系人

诊断与状态

openclaw health

从运行中的网关拉取健康数据

诊断与状态

openclaw logs

实时查看网关日志

其他高频操作

openclaw dashboard

打开网页控制面板

其他高频操作

openclaw channels status

查看已连接的聊天通道

其他高频操作

openclaw agent run

手动触发一次代理运行

改完配置后记得运行 openclaw gateway restart 让改动生效～

OpenClaw的核心工具能力

这一部分最值得理解，因为它决定了 OpenClaw 和普通聊天机器人的区别。

官方工具页显示，OpenClaw 已经内置了大量工具，包括：

exec：执行 shell 命令
web_search / web_fetch：网页搜索与抓取
browser：控制专用浏览器
canvas：界面/内容操作
pdf：PDF 处理
message：消息相关
cron：定时任务
gateway：重启、应用配置、更新网关
sessions_*：会话管理
agents_list：Agent 管理

尤其是 browser 工具，官方列出了很多动作能力，包括打开标签页、截图、点击、输入、导航、上传文件、导出 PDF 等，说明它不只是“看网页”，而是具备较强的页面操作能力。

cron 工具则支持定时任务管理，比如查看、添加、更新、移除和立即触发任务；gateway 工具则支持应用配置后自动重启和唤醒网关。

怎么用 OpenClaw：实际使用方式

安装并完成配置后，你通常会通过下面三种方式使用它。

1. Web 控制面板使用

最直观。打开浏览器访问本地面板后，直接像和 AI 聊天一样下达指令：

帮我搜索今天的科技新闻
打开某个网页并总结内容
帮我写一个 shell 脚本
查看这个项目目录并修改某个文件
创建一个定时提醒任务

2. 终端 TUI 使用

在终端输入：

openclaw tui

适合喜欢命令行的人。退出 TUI 不影响后台 Gateway。

3. 聊天平台使用

如果你接入了 Slack、Telegram 等渠道，只要 Gateway 还在后台运行，就可以直接在这些平台和 OpenClaw 对话。知乎教程特别说明了：Gateway 守护进程才是核心后台服务，TUI/Web 控制面板只是额外入口。

配置文件怎么改

OpenClaw 的配置文件位置通常如下：
系统文件路径示例

Windows:
C:Users用户名.openclawopenclaw.json

macOS:
~/.openclaw/openclaw.json

Linux:
~/.openclaw/openclaw.json

需要手动编辑配置文件
~/.openclaw/openclaw.json，指定：

baseUrl：API服务地址
apiKey：认证密钥
api：API协议类型（如
openai-completions、
anthropic-messages）
models：模型列表和参数

配置神马中转API代理

如果你使用API代理服务，配置如下：

{
  "models": {
    "mode": "merge",
    "providers": {
      "whataicc": {
        "baseUrl": "https://api.whatai.cc/v1",
        "apiKey": "sk-xxxxx-你的神马中转API密钥",
        "auth": "api-key",
        "api": "openai-completions",
        "models": [
          {
            "id": "claude-sonnet-4-6",
            "name": "claude-sonnet-4-6",
            "contextWindow": 200000,
            "maxTokens": 8192
          },
          {
            "id": "gpt-4",
            "name": "GPT-4",
            "contextWindow": 128000,
            "maxTokens": 4096
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "whataicc/claude-sonnet-4-6"
      }
    }
  }
}

配置参数说明

参数

说明

示例

baseUrl

API服务地址

https://api.whatai.cc

apiKey

API 密钥

sk-xxx

auth

认证方式

api-key 或
bearer

api

API协议

openai-completions、
anthropic-messages

id

模型ID

deepseek-chat

name

显示名称

DeepSeek Chat

contextWindow

上下文窗口

64000

maxTokens

最大输出

4096

常见API协议类型

openai-completions：OpenAI兼容接口（最常用）
anthropic-messages：Anthropic Claude接口
google-generative-ai：Google Gemini接口

配置后重启服务

# 方式1：重启Gateway
openclaw gateway restart

# 方式2：停止后重新启动
systemctl --user stop openclaw-gateway.service
systemctl --user start openclaw-gateway.service

# 方式3：完全重启
systemctl --user restart openclaw-gateway.service

验证配置

# 查看当前配置的模型
openclaw models list

# 测试模型连接
openclaw models test whataicc/claude-sonnet-4-6

工作台页面也可以可视化编辑：

工具权限与安全配置

这一部分非常重要。

官方文档明确提到，OpenClaw 支持通过 tools.allow / tools.deny 来控制工具权限，还支持 tools.profile 这种基础工具白名单配置，例如：

minimal
coding
messaging
full

例如，官方给出的示例里可以只允许文件工具和浏览器，或者使用 coding 模式但禁用运行时命令。

示意配置如下：

{
  "tools": {
    "profile": "coding",
    "deny": ["group:runtime"]
  }
}

这表示使用 coding 工具集，但禁用 exec/process 这类高风险运行工具。

官方安全提示还明确指出，不应随意使用高风险系统执行能力，并且涉及摄像头、屏幕捕获等操作时要尊重用户授权。

常见问题

1. openclaw --version没输出

大概率是安装不完整，或 Node.js 版本太低。先确认 Node.js ≥ 22，再重新执行一键脚本或 npm 安装。

2. Web 页面打不开

先检查 Gateway 是否正常运行：

openclaw status
openclaw gateway status

必要时手动前台运行观察日志：

openclaw gateway --port 18789 --verbose

3. 不知道配置文件在哪

先执行：

openclaw config file

或者去 ~/.openclaw/ 目录下找 Agent 配置。菜鸟教程指出，认证相关文件通常在 ~/.openclaw/agents//agent/auth-profiles.json。

4. 模型能聊天，但工具不能用

这通常不是模型本身的问题，而是工具配置、权限策略、对应 API Key 或外部依赖未启用。官方工具文档里明确写了：像 web_search、web_fetch 等工具需要先在对应配置中启用，并准备好相关 API Key。

5. 想统一接多模型怎么办

可以采用 OpenAI-compatible 神马中转 API 方案，把 BaseURL 和统一 Key 配到 OpenClaw 中，这样切换模型时不必频繁改多套配置。

如果只说一句结论：OpenClaw 最适合“想把 AI 当成可长期运行助手”的用户。 它的入门门槛主要在安装和首次配置，但一旦用 openclaw onboard 跑通模型、Gateway 和 Web 面板，后续使用体验会比较顺。它已经具备浏览器控制、网页搜索、命令执行、会话管理、定时任务和网关配置等较完整的工具能力。