🦞 ClawX — 个人 AI 助手

ClawX 汉化版亮点

术语专业化

深度优化 AI 语境，将 Agents 统一为 "智能体"，Raw 模式优化为 "源码模式"。

全量 i18n 架构

集成 lit-i18n，支持中英文即时切换并持久化存储语言偏好。

UI 深度适配

精简中文文本长度，彻底解决中文版常见的布局错位问题。

EXFOLIATE! EXFOLIATE!

ClawX 是一个在你自己设备上运行的 个人 AI 助手。它在你已经使用的频道上回答你（WhatsApp、Telegram、Slack、Discord、Google Chat、Signal、iMessage、Microsoft Teams、WebChat），以及扩展频道如 BlueBubbles、Matrix、Zalo 和 Zalo Personal。它可以在 macOS/iOS/Android 上说话和倾听，并可以渲染一个你控制的实时画布。网关只是控制平面 —— 产品是助手本身。

如果你想要一个个人的、单用户的助手，感觉本地、快速且始终在线，这就是它。

网站 · 文档 · DeepWiki · 入门指南 · 更新 · 展示 · FAQ · 向导 · Nix · Docker · Discord

推荐设置：运行入职向导 (openclaw onboard)。它会引导你完成网关、工作区、频道和技能的设置。CLI 向导是推荐的路径，适用于 macOS、Linux 和 Windows（通过 WSL2；强烈推荐）。适用于 npm、pnpm 或 bun。新安装？从这里开始：入门指南

订阅（OAuth）：

Anthropic (Claude Pro/Max)
OpenAI (ChatGPT/Codex)

模型说明：虽然支持任何模型，但我强烈推荐 Anthropic Pro/Max (100/200) + Opus 4.5，以获得长上下文强度和更好的提示注入抵抗能力。请参阅入职。

模型（选择 + 认证）

模型配置 + CLI：模型
认证配置文件轮换（OAuth 与 API 密钥）+ 回退：模型故障转移

安装（推荐）

运行时：Node ≥22。

npm install -g openclaw@latest
# 或：pnpm add -g openclaw@latest

openclaw onboard --install-daemon

向导会安装网关守护进程（launchd/systemd 用户服务），使其保持运行。

快速开始（TL;DR）

运行时：Node ≥22。

完整的初学者指南（认证、配对、频道）：入门指南

openclaw onboard --install-daemon

openclaw gateway --port 18789 --verbose

# 发送消息
openclaw message send --to +1234567890 --message "Hello from OpenClaw"

# 与助手交谈（可选地将回复发送回任何连接的频道：WhatsApp/Telegram/Slack/Discord/Google Chat/Signal/iMessage/BlueBubbles/Microsoft Teams/Matrix/Zalo/Zalo Personal/WebChat）
openclaw agent --message "Ship checklist" --thinking high

升级？更新指南（并运行 openclaw doctor）。

开发频道

stable：标记版本（vYYYY.M.D 或 vYYYY.M.D-<patch>），npm dist-tag latest。
beta：预发布标签（vYYYY.M.D-beta.N），npm dist-tag beta（可能缺少 macOS 应用）。
dev：main 的移动头部，npm dist-tag dev（发布时）。

切换频道（git + npm）：openclaw update --channel stable|beta|dev。详情：开发频道。

从源码构建（开发）

从源码构建时首选 pnpm。Bun 是可选的，用于直接运行 TypeScript。

git clone https://github.com/hvwin8/ClawX.git
cd ClawX

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 二进制文件运行。

安全默认值（DM 访问）

ClawX 连接到真实的消息界面。将入站 DM 视为 不受信任的输入。

完整的安全指南：安全

Telegram/WhatsApp/Signal/iMessage/Microsoft Teams/Discord/Google Chat/Slack 上的默认行为：

DM 配对（dmPolicy="pairing" / channels.discord.dm.policy="pairing" / channels.slack.dm.policy="pairing"）：未知发件人会收到一个简短的配对代码，机器人不会处理他们的消息。
批准：openclaw pairing approve <channel> <code>（然后发件人会被添加到本地允许列表存储中）。
公共入站 DM 需要明确选择加入：设置 dmPolicy="open" 并在频道允许列表中包含 "*"（allowFrom / channels.discord.dm.allowFrom / channels.slack.dm.allowFrom）。

运行 openclaw doctor 来显示风险/配置错误的 DM 策略。

亮点

本地优先网关 — 用于会话、频道、工具和事件的单一控制平面。
多频道收件箱 — WhatsApp、Telegram、Slack、Discord、Google Chat、Signal、iMessage、BlueBubbles、Microsoft Teams、Matrix、Zalo、Zalo Personal、WebChat、macOS、iOS/Android。
多智能体路由 — 将入站频道/账户/对等方路由到隔离的智能体（工作区 + 每个智能体的会话）。
语音唤醒 + 通话模式 — 用于 macOS/iOS/Android 的始终在线语音，带有 ElevenLabs。
实时画布 — 带有 A2UI 的智能体驱动的视觉工作区。
一流工具 — 浏览器、画布、节点、 cron、会话和 Discord/Slack 操作。
companion 应用 — macOS 菜单栏应用 + iOS/Android 节点。
入职 + 技能 — 向导驱动的设置，带有捆绑/托管/工作区技能。

星标历史

![Star History Chart](https://www.star-history.com/#openclaw/openclaw&type=date&legend=top-left)

我们迄今为止构建的一切

核心平台

网关 WS 控制平面，带有会话、状态、配置、cron、webhooks、控制 UI 和画布主机。
CLI 界面：网关、智能体、发送、向导和医生。
Pi 智能体运行时，采用 RPC 模式，带有工具流和块流。
会话模型：用于直接聊天的 main，组隔离，激活模式，队列模式，回复。组规则：组。
媒体管道：图像/音频/视频，转录钩子，大小限制，临时文件生命周期。音频详情：音频。

频道

频道：WhatsApp（Baileys），Telegram（grammY），Slack（Bolt），Discord（discord.js），Google Chat（Chat API），Signal（signal-cli），iMessage（imsg），BlueBubbles（扩展），Microsoft Teams（扩展），Matrix（扩展），Zalo（扩展），Zalo Personal（扩展），WebChat。
组路由：提及门控，回复标签，每个频道的分块和路由。频道规则：频道。

应用 + 节点

macOS 应用：菜单栏控制平面，语音唤醒/PTT，通话模式覆盖，WebChat，调试工具，远程网关控制。
iOS 节点：画布，语音唤醒，通话模式，相机，屏幕录制，Bonjour 配对。
Android 节点：画布，通话模式，相机，屏幕录制，可选 SMS。
macOS 节点模式：system.run/notify + 画布/相机曝光。

工具 + 自动化

浏览器控制：专用的 openclaw Chrome/Chromium，快照，操作，上传，配置文件。
画布：A2UI 推送/重置，评估，快照。
节点：相机快照/剪辑，屏幕录制，location.get，通知。
Cron + 唤醒；webhooks；Gmail Pub/Sub。
技能平台：带有安装门控 + UI 的捆绑、托管和工作区技能。

运行时 + 安全

运维 + 打包

控制 UI + WebChat 直接从网关提供。
Tailscale Serve/Funnel 或 SSH 隧道，带有令牌/密码认证。
Doctor 迁移，日志记录。

工作原理（简短版）

WhatsApp / Telegram / Slack / Discord / Google Chat / Signal / iMessage / BlueBubbles / Microsoft Teams / Matrix / Zalo / Zalo Personal / WebChat
               │
               ▼
┌───────────────────────────────┐
│            网关            │
│       (控制平面)         │
│     ws://127.0.0.1:18789      │
└──────────────┬────────────────┘
               │
               ├─ Pi 智能体 (RPC)
               ├─ CLI (openclaw …)
               ├─ WebChat UI
               ├─ macOS 应用
               └─ iOS / Android 节点

关键子系统

网关 WebSocket 网络 — 用于客户端、工具和事件的单一 WS 控制平面（以及运维：网关运行手册）。
Tailscale 曝光 — 为网关仪表板 + WS 提供 Serve/Funnel（远程访问：远程）。
浏览器控制 — 带有 CDP 控制的 openclaw 管理的 Chrome/Chromium。
画布 + A2UI — 智能体驱动的视觉工作区（A2UI 主机：Canvas/A2UI）。
语音唤醒 + 通话模式 — 始终在线的语音和连续对话。
节点 — 画布、相机快照/剪辑、屏幕录制、location.get、通知，以及仅 macOS 的 system.run/system.notify。

Tailscale 访问（网关仪表板）

ClawX 可以自动配置 Tailscale Serve（仅 tailnet）或 Funnel（公共），而网关保持绑定到环回。配置 gateway.tailscale.mode：

off：无 Tailscale 自动化（默认）。
serve：通过 tailscale serve 的仅 tailnet HTTPS（默认使用 Tailscale 身份标头）。
funnel：通过 tailscale funnel 的公共 HTTPS（需要共享密码认证）。

注意：

启用 Serve/Funnel 时，gateway.bind 必须保持 loopback（ClawX 强制执行此操作）。
可以通过设置 gateway.auth.mode: "password" 或 gateway.auth.allowTailscale: false 强制 Serve 需要密码。
除非设置了 gateway.auth.mode: "password"，否则 Funnel 拒绝启动。
可选：gateway.tailscale.resetOnExit 在关闭时撤销 Serve/Funnel。

详情：Tailscale 指南 · Web 界面

远程网关（Linux 很棒）

在小型 Linux 实例上运行网关完全没问题。客户端（macOS 应用、CLI、WebChat）可以通过 Tailscale Serve/Funnel 或 SSH 隧道 连接，你仍然可以配对设备节点（macOS/iOS/Android）在需要时执行设备本地操作。

网关主机 默认运行执行工具和频道连接。
设备节点 通过 node.invoke 运行设备本地操作（system.run、相机、屏幕录制、通知）。

简而言之：exec 在网关所在的地方运行；设备操作在设备所在的地方运行。

详情：远程访问 · 节点 · 安全

通过网关协议的 macOS 权限

macOS 应用可以在 节点模式 下运行，并通过网关 WebSocket（node.list / node.describe）通告其功能和权限映射。然后客户端可以通过 node.invoke 执行本地操作：

system.run 运行本地命令并返回 stdout/stderr/退出代码；设置 needsScreenRecording: true 以要求屏幕录制权限（否则你会得到 PERMISSION_MISSING）。
system.notify 发布用户通知，如果通知被拒绝则失败。
canvas.、camera.、screen.record 和 location.get 也通过 node.invoke 路由，并遵循 TCC 权限状态。

提升的 bash（主机权限）与 macOS TCC 分开：

使用 /elevated on|off 在启用并允许列表时切换每个会话的提升访问。
网关通过 sessions.patch（WS 方法）持久化每个会话的切换，以及 thinkingLevel、verboseLevel、model、sendPolicy 和 groupActivation。

详情：节点 · macOS 应用 · 网关协议

智能体到智能体（sessions_* 工具）

使用这些工具跨会话协调工作，而无需在聊天界面之间跳转。
sessions_list — 发现活跃会话（智能体）及其元数据。
sessions_history — 获取会话的转录日志。
sessions_send — 向另一个会话发送消息；可选的回复 ping-pong + 宣布步骤（REPLY_SKIP，ANNOUNCE_SKIP）。

详情：会话工具

技能注册表（ClawdHub）

ClawdHub 是一个最小的技能注册表。启用 ClawdHub 后，智能体可以自动搜索技能并根据需要引入新技能。

ClawdHub

聊天命令

在 WhatsApp/Telegram/Slack/Google Chat/Microsoft Teams/WebChat 中发送这些（组命令仅所有者可用）：

/status — 紧凑的会话状态（模型 + 令牌，可用时的成本）
/new 或 /reset — 重置会话
/compact — 压缩会话上下文（摘要）
/think <level> — off|minimal|low|medium|high|xhigh（仅 GPT-5.2 + Codex 模型）
/verbose on|off
/usage off|tokens|full — 每个响应的使用情况页脚
/restart — 重启网关（组中仅所有者）
/activation mention|always — 组激活切换（仅组）

应用（可选）

仅网关就能提供出色的体验。所有应用都是可选的，并添加额外功能。

如果你计划构建/运行 companion 应用，请遵循以下平台运行手册。

macOS（OpenClaw.app）（可选）

网关和健康的菜单栏控制。
语音唤醒 + 一键通话覆盖。
WebChat + 调试工具。
通过 SSH 进行远程网关控制。

注意：签名构建对于 macOS 权限在重建之间保持不变是必需的（请参阅 docs/mac/permissions.md）。

iOS 节点（可选）

通过 Bridge 配对为节点。
语音触发转发 + 画布表面。
通过 openclaw nodes … 控制。

运行手册：iOS 连接。

Android 节点（可选）

通过与 iOS 相同的 Bridge + 配对流程配对。
公开画布、相机和屏幕捕获命令。
运行手册：Android 连接。

智能体工作区 + 技能

工作区根目录：~/.openclaw/workspace（可通过 agents.defaults.workspace 配置）。
注入的提示文件：AGENTS.md，SOUL.md，TOOLS.md。
技能：~/.openclaw/workspace/skills/<skill>/SKILL.md。

配置

最小的 ~/.openclaw/openclaw.json（模型 + 默认值）：

{
  agent: {
    model: "anthropic/claude-opus-4-5"
  }
}

完整配置参考（所有键 + 示例）。

安全模型（重要）

默认值： 工具在 main 会话的主机上运行，因此当只有你时，智能体拥有完全访问权限。
组/频道安全： 设置 agents.defaults.sandbox.mode: "non-main" 在每个会话的 Docker 沙箱中运行 非主会话（组/频道）；然后 bash 在这些会话的 Docker 中运行。
沙箱默认值： 允许列表 bash，process，read，write，edit，sessions_list，sessions_history，sessions_send，sessions_spawn；拒绝列表 browser，canvas，nodes，cron，discord，gateway。

详情：安全指南 · Docker + 沙箱 · 沙箱配置

链接设备：pnpm openclaw channels login（将凭证存储在 ~/.openclaw/credentials 中）。
通过 channels.whatsapp.allowFrom 允许谁可以与助手交谈。
如果设置了 channels.whatsapp.groups，它将成为组允许列表；包含 "*" 以允许所有。

设置 TELEGRAM_BOT_TOKEN 或 channels.telegram.botToken（env 优先）。
可选：设置 channels.telegram.groups（带有 channels.telegram.groups."".requireMention）；设置后，它是一个组允许列表（包含 "" 以允许所有）。还需要 channels.telegram.allowFrom 或 channels.telegram.webhookUrl。

{
  channels: {
    telegram: {
      botToken: "123456:ABCDEF"
    }
  }
}

Slack

设置 SLACK_BOT_TOKEN + SLACK_APP_TOKEN（或 channels.slack.botToken + channels.slack.appToken）。

Discord

设置 DISCORD_BOT_TOKEN 或 channels.discord.token（env 优先）。
可选：设置 commands.native，commands.text，或 commands.useAccessGroups，以及 channels.discord.dm.allowFrom，channels.discord.guilds，或 channels.discord.mediaMaxMb。

{
  channels: {
    discord: {
      token: "1234abcd"
    }
  }
}

Signal

需要 signal-cli 和 channels.signal 配置部分。

iMessage

仅 macOS；消息必须已登录。
如果设置了 channels.imessage.groups，它将成为组允许列表；包含 "*" 以允许所有。

Microsoft Teams

配置 Teams 应用 + Bot Framework，然后添加 msteams 配置部分。
通过 msteams.allowFrom 允许谁可以交谈；通过 msteams.groupAllowFrom 或 msteams.groupPolicy: "open" 进行组访问。

WebChat

使用网关 WebSocket；无需单独的 WebChat 端口/配置。

浏览器控制（可选）：

{
  browser: {
    enabled: true,
    color: "#FF4500"
  }
}

文档

当你完成入职流程并想要更深入的参考时，请使用这些文档。

高级文档（发现 + 控制）

运维与故障排除

深度探讨

工作区与技能

平台内部

电子邮件钩子（Gmail）

docs.openclaw.ai/gmail-pubsub

Molty

ClawX 是为 Molty 构建的，一个太空龙虾 AI 助手。🦞 由 Peter Steinberger 和社区创建。

社区

请参阅 CONTRIBUTING.md 了解指南、维护者和如何提交 PR。欢迎 AI/氛围编码的 PR！🤖

特别感谢 Mario Zechner 的支持和 pi-mono。特别感谢 Adam Doppelt 为 lobster.bot。

感谢所有 clawtributors：

whatsapp

Summary

Install to Claude Code