MMCPMarkets
HC

hvwin8/clawx

Developer tools
61 stars Quality 55 Trend 55
Repository Install

我们的 AI 助手. 海阔天空 自由交互 无所不能... 🦞 (@openclaw界面汉化增强版 支持多语言切换与智能体优化)

Overview

深度优化 AI 语境，将 Agents 统一为 "智能体"，Raw 模式优化为 "源码模式"。 是一个在你自己设备上运行的 个人 AI 助手。它在你已经使用的频道上回答你（WhatsApp、Telegram、Slack、Discord、Google Chat、Signal、iMessage、Microsoft Teams、WebChat），以及扩展频道如 BlueBubbles、Matrix、Zalo 和 Zalo Personal。它可以在 macOS/iOS/Android 上说话和倾听，并可以渲染一个你控制的实时画布。网关只是控制平面 —— 产品是助手本身。 推荐设置：运行入职向导 (openclaw onboard)。它会引导你完成网关、工作区、频道和技能的设置。CLI 向导是推荐的路径，适用于 。 适用于 npm、pnpm 或 bun。 新安装？从这里开始：入门指南 模型说明：虽然支持任何模型，但我强烈推荐 ，以获得长上下文强度和更好的提示注入抵抗能力。请参阅 入职。 - 模型配置 + CLI：模型 - 认证配置文件轮换（OAuth 与 API 密钥）+ 回退：模型故障转移 向导会安装网关守护进程（launchd/systemd 用户服务），使其保持运行。 - ：标记版本（vYYYY.M.D 或 vYYYY.M.D- ），npm dist-tag latest。 - ：预发布标签（vYYYY.M.D-beta.N），npm dist-tag beta（可能缺少 macOS 应用）。 - ：main 的移动头部，npm dist-tag dev（发布时）。 切换频道（git + npm）：openclaw update --channel stable|beta|dev。 详情：开发频道。

README

English Version

🦞 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 Pro/Max (100/200) + Opus 4.5，以获得长上下文强度和更好的提示注入抵抗能力。请参阅 入职。

模型（选择 + 认证）

安装（推荐）

运行时：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-），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 （然后发件人会被添加到本地允许列表存储中）。
  • 公共入站 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 节点。
  • 入职 + 技能 — 向导驱动的设置，带有捆绑/托管/工作区技能。

星标历史

我们迄今为止构建的一切

核心平台

频道

应用 + 节点

工具 + 自动化

运行时 + 安全

运维 + 打包

工作原理（简短版）

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 节点

关键子系统

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 — 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.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 + 沙箱 · 沙箱配置

WhatsApp

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

Telegram

  • 设置 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）

Molty

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

社区

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

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

感谢所有 clawtributors：

View this README on GitHub

Recommended Tools

Try a different keyword or remove a filter.

Install

npx skillfish add hvwin8/clawx