本页内容

本页内容

概览

开始使用

OpenClaw

真正能做事的 AI。任何操作系统,任何平台。龙虾式行动。🦞

新版本v2026.10.4更新和恢复修复、聊天刷新、消息传递和登录修复。阅读发行说明

快速开始

  • 安装 OpenClaw

    macOS / Linux / WSL2

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

    Windows (PowerShell)

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

    安装程序会检测操作系统,按需安装 Node,安装 OpenClaw,然后启动入门引导。npm、pnpm、bun、Docker、Nix 和源码安装等其他方式,请参阅安装。

  • 完成入门引导

    入门引导提供 Quick start 和 Custom setup 两种选项。Quick start 会复用检测到的 AI 访问凭据,通过一次实际的模型请求验证凭据,并打开网页仪表盘,让 Gateway 在前台运行。Custom setup 则会逐项完成全部引导。openclaw onboard --classic 会打开经典的分步设置向导。

  • 安装 Gateway 服务

    Quick start 会让 Gateway 在前台运行。按 Ctrl+C 停止后,再安装后台服务:

    bash
    openclaw gateway install
  • 聊天

    在浏览器中打开Control UI并发送消息:

    bash
    openclaw dashboard

    或者连接一个通道(Telegram 是最快的),然后在手机上聊天。

  • 需要完整的安装和开发设置说明?请参阅入门。

    连接渠道

    在你的聊天应用中使用 OpenClaw。

    所有指南

    核心能力

    什么是 OpenClaw?

    OpenClaw 是一个自托管网关,通过渠道插件,将 Discord、Google Chat、iMessage、Matrix、Microsoft Teams、Signal、Slack、Telegram、WhatsApp、Zalo 等聊天应用连接到 AI 编程智能体。你只需在自己的计算机或服务器上运行一个 Gateway 进程,就能将消息应用连接到随时可用的 AI 助手。

    适合谁使用? 适合希望随时向 AI 助手发送消息,同时保持数据控制权、不依赖托管服务的开发者、进阶用户和团队。同一个 Gateway 既可以在笔记本电脑上充当个人助手,也可以作为共享的团队部署运行,两者仅配置不同。

    它有何不同?

    • 自托管:在你的硬件上运行,按你的规则办
    • 多频道:一个 Gateway 可同时为所有已配置的频道插件提供服务
    • 面向智能体:专为编程智能体构建,支持工具调用、会话、记忆和多智能体路由
    • 开源:MIT 许可,社区驱动

    关于可信网关、不可信执行、由代码强制实施的策略,以及同一产品如何兼顾个人和团队使用的完整架构说明,请参阅为什么选择 OpenClaw。

    需要准备什么? 推荐使用 Node 26,也支持 Node 24.16+ 或 Node 26.1+。你还需要所选提供商的 API 密钥和约 5 分钟时间。为获得更好的质量和安全性,请使用可用的最新一代高性能模型。

    工作原理

    flowchart LR
      A["Chat apps + plugins"] --> B["Gateway"]
      B --> C["OpenClaw agent"]
      B --> D["CLI"]
      B --> E["Web Control UI"]
      B --> F["macOS app"]
      B --> G["iOS and Android nodes"]

    网关是会话、路由和通道连接的唯一事实来源。

    OpenClaw 🦞

    "EXFOLIATE! EXFOLIATE!" — 一只太空龙虾,大概吧

    你的 AI 助手,运行在你自己的硬件上,接入你日常使用的聊天应用。

    一个 Gateway,任意模型,任意设备,无需中间托管服务。 由独立的 501(c)(3) 非营利组织 OpenClaw Foundation 公开开发。没有付费层级,默认仅执行可关闭的版本检查,不收集其他遥测数据,也不隶属于任何 AI 实验室。

    仪表板

    网关启动后打开浏览器Control UI。

    OpenClaw

    配置(可选)

    配置位于 ~/.openclaw/openclaw.json。

    • 如果你什么都不做,OpenClaw 会使用内置的 OpenClaw 代理运行时;私信会共享代理的主会话,而每个群聊都会获得自己的会话。
    • 如果你想加强限制,可以从 channels.whatsapp.allowFrom 和(对于群组)提及规则开始。

    示例:

    json5
    {  channels: {    whatsapp: {      allowFrom: ["+15555550123"],      groups: { "*": { requireMention: true } },    },  },  messages: { groupChat: { mentionPatterns: ["@openclaw"] } },}

    浏览文档

    移动浏览器可能只显示章节菜单,不显示完整的桌面标签栏。你可以通过以下入口,从页面正文访问各个文档分类。

    从这里开始

    了解更多

    社区

    和我们一起构建

    提出问题,分享你的项目,或来打个招呼。

    加入我们的 Discord
    本页有帮助吗?