去角质!去角质!
OpenClaw 是一个你可以在自己的设备上运行的个人 AI 助手。
它在你已经使用的渠道上与你交流(WhatsApp、Telegram、Slack、Discord、Google Chat、Signal、iMessage、BlueBubbles、IRC、Microsoft Teams、Matrix、飞书、LINE、Mattermost、Nextcloud Talk、Nostr、Synology Chat、Tlon、Twitch、Zalo、Zalo Personal、WebChat)。它可以在 macOS/iOS/Android 上说话和聆听,并能渲染一个你可以控制的实时画布。网关只是控制平面——产品是助手本身。
如果你想要一个感觉本地化、快速、始终在线的个人单用户助手,就是它了。
网站 · 文档 · 愿景 · DeepWiki · 入门指南 · 更新指南 · 展示 · 常见问题 · 向导 · Nix · Docker · Discord
推荐设置:在终端中运行入门向导 (openclaw onboard)。
该向导将逐步指导你设置网关、工作区、渠道和技能。CLI 向导是推荐路径,适用于 macOS、Linux 和 Windows(通过 WSL2;强烈推荐)。
支持 npm、pnpm 或 bun。
新安装?从这里开始:入门指南
| OpenAI | Vercel | Blacksmith | Convex |
|---|---|---|---|
订阅服务(OAuth):
模型说明:虽然支持任何模型,但我强烈推荐 Anthropic Pro/Max (100/200) + Opus 4.6,以获得更长的上下文处理能力和更好的提示注入抵抗力。参见入门指南。
运行时要求:Node ≥22。
npm install -g openclaw@latest
# 或:pnpm add -g openclaw@latest
openclaw onboard --install-daemon
向导会安装网关守护进程(launchd/systemd 用户服务),使其保持运行。
运行时要求:Node ≥22。
完整的新手指南(认证、配对、渠道):入门指南
openclaw onboard --install-daemon
openclaw gateway --port 18789 --verbose
# 发送消息
openclaw message send --to +1234567890 --message "来自 OpenClaw 的问候"
# 与助手对话(可选地发送回任何已连接的渠道:WhatsApp/Telegram/Slack/Discord/Google Chat/Signal/iMessage/BlueBubbles/IRC/Microsoft Teams/Matrix/飞书/LINE/Mattermost/Nextcloud Talk/Nostr/Synology Chat/Tlon/Twitch/Zalo/Zalo Personal/WebChat)
openclaw agent --message "发布清单" --thinking high
升级?参见更新指南(并运行 openclaw doctor)。
vYYYY.M.D 或 vYYYY.M.D-<patch>),npm 分发标签 latest。vYYYY.M.D-beta.N),npm 分发标签 beta(macOS 应用可能缺失)。main 分支的最新提交,npm 分发标签 dev(发布时)。切换渠道(git + npm):openclaw update --channel stable|beta|dev。
详情:开发渠道。
建议使用 pnpm 从源码构建。Bun 可选,用于直接运行 TypeScript。
git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm ui:build # 首次运行时会自动安装 UI 依赖
pnpm build
pnpm openclaw onboard --install-daemon
# 开发循环(TS 更改时自动重载)
pnpm gateway:watch
注意:pnpm openclaw ... 直接运行 TypeScript(通过 tsx)。pnpm build 生成 dist/ 目录,用于通过 Node / 打包的 openclaw 二进制文件运行。
OpenClaw 连接到真实的通信界面。请将传入的私信视为不可信的输入。
完整安全指南:安全
在 Telegram/WhatsApp/Signal/iMessage/Microsoft Teams/Discord/Google Chat/Slack 上的默认行为:
dmPolicy="pairing" / channels.discord.dmPolicy="pairing" / channels.slack.dmPolicy="pairing";旧版:channels.discord.dm.policy, channels.slack.dm.policy):未知发送者会收到一个简短的配对码,机器人不会处理他们的消息。openclaw pairing approve <channel> <code>(然后发送者会被添加到本地允许列表存储中)。dmPolicy="open" 并在渠道允许列表 (allowFrom / channels.discord.allowFrom / channels.slack.allowFrom;旧版:channels.discord.dm.allowFrom, channels.slack.dm.allowFrom) 中包含 "*"。运行 openclaw doctor 以发现风险/配置错误的私信策略。
main 用于直接聊天、群组隔离、激活模式、队列模式、回复返回。群组规则:群组。