本页内容
本页内容
概览
开始使用
OpenClaw
真正能做事的 AI。任何操作系统,任何平台。龙虾式行动。🦞
快速开始
安装 OpenClaw
macOS / Linux / WSL2
Windows (PowerShell)
安装程序会检测操作系统,按需安装 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 停止后,再安装后台服务:
聊天
在浏览器中打开Control UI并发送消息:
或者连接一个通道(Telegram 是最快的),然后在手机上聊天。
需要完整的安装和开发设置说明?请参阅入门。
连接渠道
在你的聊天应用中使用 OpenClaw。
精选指南
所有指南核心能力
使用单个网关进程即可支持 Discord、iMessage、Signal、Slack、Telegram、WhatsApp、WebChat 等。
通道插件可添加 Matrix、Nostr、Twitch、Zalo 等;官方插件可按需安装。
按智能体、工作区或发送者隔离会话。
发送和接收图像、音频和文档。
用于聊天、配置、会话和节点的浏览器仪表板。
将 iOS 和 Android 节点配对以实现摄像头、屏幕和支持语音的工作流程。
为智能体定义可重复执行的流程,并按需加载。
使用 cron 作业、挂钩和 Webhook 按计划运行工作。
针对插件 SDK 编写您自己的通道、提供商和工具插件。
什么是 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。
- 本地默认地址:http://127.0.0.1:18789/
- 远程访问:Web 界面 和 Tailscale
配置(可选)
配置位于 ~/.openclaw/openclaw.json。
- 如果你什么都不做,OpenClaw 会使用内置的 OpenClaw 代理运行时;私信会共享代理的主会话,而每个群聊都会获得自己的会话。
- 如果你想加强限制,可以从
channels.whatsapp.allowFrom和(对于群组)提及规则开始。
示例:
浏览文档
移动浏览器可能只显示章节菜单,不显示完整的桌面标签栏。你可以通过以下入口,从页面正文访问各个文档分类。
概述、第一步和设置指南。
安装路径、更新、容器、托管和高级设置。
消息渠道、配对、路由、访问组和渠道质量验证。
架构、会话、上下文、记忆和多智能体路由。
工具、技能、cron、webhook 和自动化功能。
插件市场、发布、精选与信任指南。
提供商、模型配置、故障切换和本地模型服务。
macOS、Windows、iOS、Android、节点和 Web 界面。
网关配置、安全性、诊断和运维。
CLI 参考、架构、RPC 和模板。
每个版本的发行说明,包含亮点和源链接。
故障排查、常见问题、测试、诊断和环境检查。








