OpenClaw Official Hub

OpenClaw（龙虾）专区

把 OpenClaw 的官方主页、系统要求、安装方式、配置方法、首轮使用、频道文档和 FAQ 集中到一个真实入口。

本专区全部内容都以 OpenClaw 官方主页、官方 Getting Started、官方 Channels 文档、官方 Commands 文档、官方 FAQ 和官方 GitHub 仓库为准，避免继续使用泛化介绍或失效占位链接。

官方主页系统要求安装 / 配置首聊 / 频道 / FAQ

当前页面内容已于 2026-04-09 对照官方公开文档和官方仓库核对，可继续点击各来源链接追溯原始说明。

查看官方安装文档阅读使用指南

Official Entry

官方安装入口

直接进入官方主页、系统要求和安装文档，不再展示虚构安装包。

Install Guide

安装指南

把系统要求、安装方式、验证命令和常见问题整理成中文入口。

Usage Guide

使用指南

围绕配置、首聊、频道文档、FAQ 和排障命令做站内整合。

Official Positioning

OpenClaw 现在到底是什么

50+

官方支持渠道

官方主页和 What is OpenClaw 文档都强调它可以覆盖 50+ communication channels。

查看官方来源

5700+

内置技能规模

官方主页和 What is OpenClaw 文档都把 ClawHub 技能规模写成 5,700+。

查看官方来源

Any Model

模型无锁

官方主页与配置文档明确支持 OpenAI、Anthropic、Google、Ollama 和 OpenAI-compatible endpoints。

查看官方来源

Self-Hosted

自托管 + Sandbox

官方主页和 What is OpenClaw 文档都强调 self-hosted、privacy-first 与 sandboxed skills。

查看官方来源

Official Entry

OpenClaw 官方安装入口

官方 Installation 文档已经覆盖 Quick install、npm 安装和源码安装三条路径；首页还提供 Linux/macOS 脚本、Windows PowerShell 脚本和 npm 一行命令。

Linux / macOS / Windows（PowerShell / WSL 2）脚本 / npm / 源码已核对 2026-04-09

打开官方安装页看站内安装指南

安装前先核对

先读 System Requirements，再选择脚本安装、npm 安装或源码安装。

Windows 官方建议优先使用 WSL 2 + Ubuntu，或直接在 PowerShell 里运行安装脚本。

安装完成后，用 openclaw --version、openclaw doctor、openclaw status、openclaw dashboard 做验证。

System Requirements

官方系统要求

系统要求

最低：Linux 5.4+ / macOS 13+ / Windows 10+ + WSL 2

Node.js 与 npm

最低：Node.js 22.16.0 + npm 10

硬件资源

最低：2 GB RAM / 1 GB 磁盘 / 1 核 CPU

推荐：4 GB+ RAM / 5 GB 磁盘 / 2+ 核 CPU

OpenClaw 本体较轻，但活跃技能、会话上下文和本地模型会继续吃资源。

查看官方要求

网络与 Docker

最低：出站 443

推荐：出站 443 + Web UI/API 入站 3000 + Docker 24+（可选）

如果要接 Slack、Telegram 等 webhook，官方要求你的服务能被公网访问。

查看官方要求

Install Methods

官方安装方式

Linux / macOS

Quick Install

官方推荐的单命令安装方式，会自动装依赖并跑 onboarding。

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

默认安装到 ~/.openclaw/。

如果你要换目录，先设置 OPENCLAW_HOME 再执行脚本。

对照官方文档

Windows

PowerShell / WSL 2

官方支持在 PowerShell 里直接跑脚本，也建议在 WSL 2 Ubuntu 里走 Linux 流程。

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

官方建议最佳体验是 WSL 2 + Ubuntu。

PowerShell 遇到权限问题时，文档建议管理员模式并先执行 Set-ExecutionPolicy RemoteSigned。

对照官方文档

跨平台

npm / pnpm

想手动掌控安装步骤时，用官方 CLI 包后再跑 onboarding。

npm install -g openclaw@latest
# or: pnpm add -g openclaw@latest
openclaw onboard --install-daemon

onboard 会配置认证、Gateway、可选频道和后台服务。

GitHub README 还说明 stable 渠道对应 npm dist-tag latest。

对照官方文档

开发 / 二次开发

From Source

官方仓库 README 和 Installation 文档都给了源码构建路径。

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm ui:build
pnpm build
pnpm link --global
openclaw onboard --install-daemon

GitHub README 明确推荐 pnpm 进行源码构建。

README 还列出了 stable / beta / dev 三种 development channels。

对照官方文档

Configuration

配置要点

配置文件与默认账号

官方配置文档把 openclaw.yaml 作为核心配置入口，并给了默认 dashboard 账号示例。

配置文件路径用 openclaw config path 查看；FAQ 还列出 ~/.openclaw/openclaw.json、~/.clawdbot/moltbot.json、~/.config/openclaw/config.json 等位置。

官方配置文档示例默认账号是 admin / changeme123，文档明确要求在暴露到网络前先改默认密码。

环境变量可用 OPENCLAW_ 前缀覆盖配置，例如 OPENCLAW_ADMIN_PASSWORD、OPENCLAW_SERVER_PORT。

查看官方配置文档

模型与提供商

官方 Getting Started 配置文档给出了 OpenAI、Anthropic、Google、Ollama 和 OpenAI-compatible 的最小配置。

OpenAI 示例默认模型写的是 gpt-4o；Anthropic 示例默认模型是 claude-sonnet-4.6。

Google（Gemini）示例默认模型是 gemini-2.0-flash。

Ollama 可本地跑模型，不需要 API key，但文档要求先确保 Ollama 服务已经启动。

查看官方配置文档

配置验证

官方文档明确建议在启动或重启前先做配置校验。

命令是 openclaw config validate。

文档说明它会检查 YAML 结构、逻辑错误和 deprecated 字段，并指出具体报错行。

官方建议把这一步也放进 CI/CD。

查看官方配置文档

First Conversation

首次启动与首聊

onboard 与 dashboard

官方 Commands 文档把 openclaw onboard 当成首装主入口，dashboard 是最直接的管理界面。

openclaw onboard 会引导认证、默认模型和频道设置；加 --install-daemon 会一起装后台服务。

openclaw dashboard 会打开 Web dashboard；也支持 --no-open 和 --port 3000。

Commands 文档里的 onboard 示例输出提到监听 18789；而 Installation 文档默认 Web UI/API 端口示例是 3000。

查看官方步骤

首次启动与登录

官方 First Conversation 文档给了启动、打开浏览器和默认登录账号示例。

启动命令是 openclaw start；后台运行可以用 openclaw start --daemon。

文档默认在浏览器打开 http://localhost:3000。

默认 dashboard 登录示例仍然是 admin / changeme123，登录后会看到聊天界面和配置入口。

查看官方步骤

第一条消息怎么发

官方 First Conversation 文档建议先发一条简单消息确认模型、技能和界面都正常。

先发送“Hello, OpenClaw! What can you do?”确认文本响应。

再测试一个技能触发问题，例如询问天气，看它是否会调用技能。

官方文档建议接着去 dashboard 查看 conversation log 和 agent actions。

查看官方步骤

Channels

频道与接入难度

Easy

Channels Overview 里把 Telegram 列成 easy，支持 inline keyboards，适合作为最快的上手频道之一。

查看 Channels Overview

Discord

Easy

Channels Overview 里把 Discord 列成 easy，支持 embeds、buttons、select menus。

查看 Channels Overview

Slack

Medium

官方列为 medium，需要开发者应用和 webhook / token 配置。

查看 Channels Overview

WeChat

Hard

官方列为 hard，并明确提示需要 ICP filing 等额外条件。

查看 Channels Overview

Microsoft Teams

Hard

官方列为 hard，需要 Azure subscription 与外部集成配置。

查看 Channels Overview

WebChat

Easy

官方列为 easy，适合先把一个 agent 挂到自己网站上验证对话体验。

查看 Channels Overview

Diagnostics

排障与健康检查

安装后健康检查

Installation 文档建议至少跑这几条命令。

openclaw --version

openclaw doctor

openclaw status

openclaw dashboard

查看官方排障文档

最常见安装问题

官方 Installation 文档集中写了几类高频问题。

npm install 权限错误时，不要 sudo 跑 npm，改 npm prefix。

node: command not found 说明 Node.js 没装好或 PATH 不对。

内存不足时可先设置 NODE_OPTIONS=--max-old-space-size=4096。

查看官方排障文档

FAQ 里的排障点

官方 FAQ 对 Docker / Unraid / macOS 权限 / 401 / 404 / 429 都有独立条目。

FAQ 明确写 Node.js 需要 22+，并提醒检查端口冲突。

macOS 需授予 Screen Recording、Accessibility、Full Disk Access。

如果容器里访问本机模型失败，FAQ 建议把 localhost 改成 host.docker.internal。

查看官方排障文档

Official Sources

官方资料地图

官方主页与入门

先建立全局认识，再按 getting started 顺序往下走。

官方主页

官方首页，包含 50+ channels、5700+ skills、Quick Start 和核心定位。

打开原始来源

What is OpenClaw?

官方架构、Agents / Skills / Channels / Models 概念解释。

打开原始来源

System Requirements

官方系统要求，覆盖 OS、Node.js、npm、RAM、磁盘、Docker 和网络。

打开原始来源

Installation

官方安装文档，包含 Quick install、npm、源码、验证与常见问题。

打开原始来源

配置、首聊与频道

安装完之后，官方建议继续看这几页。

Configuration

官方配置文档，包含 openclaw.yaml、provider、model、admin 和 validation。

打开原始来源

Your First Conversation

官方首次启动、打开 localhost、登录 dashboard、发第一条消息。

打开原始来源

Channels Overview

官方频道总览，包含平台难度、富消息能力、文件上传与群支持。

打开原始来源

Setup & Initialization

官方命令文档，覆盖 onboard、setup、configure、doctor、dashboard、tui。

打开原始来源

FAQ 与仓库

排障、版本渠道和源码构建都在这两处最集中。

官方 FAQ

官方常见问题，覆盖端口、macOS 权限、API key、BaseURL、通道连接等。

打开原始来源

官方 GitHub 仓库

官方源码仓库，README 里有 stable / beta / dev channels 和源码构建说明。

打开原始来源

Article Links

站内教程文章

OpenClaw（龙虾）安装指南：系统要求、安装方式与验证

把官方 requirements、installation、verification 和 common issues 汇总成中文文章。

阅读全文

OpenClaw（龙虾）使用指南：配置、首聊、频道与排障

把官方 configuration、first conversation、channels、FAQ 和 commands 汇总成中文文章。

阅读全文

维护原则

这个专区后续只补两类内容：一类是官方来源的新链接，另一类是基于官方来源整理出来的中文索引与中文教程。没有官方出处的内容，不再放进专区主页面。