📰 NEWS!最新动态
2026年2月15日
翻译tui,合并openclaw-china(BytePioneer-AI/openclaw-china/)新特性
2026年2月10日
更新主分支!主分支现已更新中国版UI!新增功能:KOOK,拓展API(来源于cherrystudio)。并且现在你只需要clone主分支就可以了,无需切换分支!
2026年2月9日
中文站点的网页设计已完成!待更新上线。 另外,由于已出现了其他的Openclaw中国版,也有小伙伴提醒不要做重复造轮子的事情。 从现在开始,本repo的性质将会全面发生变化,整体来说提供预制一些实验性的中文区专属特性:
1、我们收集一些有趣的openclaw中文插件,放置在本repo。例如说官方暂无计划的napcat-qq和kook支持。未来也会收集一些有趣的插件,例如适配微博、知乎等国内社交平台,程序员圈子平台等等
2、汉化或者是魔改版本的skills
3、夹杂私货,会放置我们一些自制的插件,例如AI女友等等!
总体而言,如果你有什么好玩的创意或者是有趣的插件,欢迎提交issue自荐、推荐、讨论!欢迎给个star!

2026年2月4日
现已成功接入飞书、钉钉、QQ及微信公众号!感谢相关开源项目的支持!

使用前请注意:截至2026年2月4日,因官方已正式支持飞书及中文国际化(I18N),原飞书相关功能已迁移至 feishu-unoffitial 分支(开发者心声:谁懂代码刚改完官方就更新的痛啊😭)。

🚀 快速开始

1. 克隆仓库:

   git clone https://github.com/CrayBotAGI/OpenCray.git
   cd OpenCray

2. 按照后续教程完成配置即可。

💡 协作邀请
目前我正在深入研究 MolBot(ClawBot) 的架构,致力于优化其对国产环境的支持。当前版本主要适配国际主流工具,在微信、钉钉、QQ 等国内平台的兼容性上仍有不足。
同时对使用deepseek等国内API的朋友们来说不太友好! 我的目标是打造一个全面适配国产生态的 Bot 框架,真正实现「开箱即用」! 将会持续开展研发并承诺完全开源免费,不引入商业化!

🤝 诚邀伙伴加入共建!
如果你对该项目感兴趣,欢迎扫码加入我们的 QQ 群,一起交流、开发、完善 MolBot!

QQ_1769606675643

Todo List

• 1. 接入 QQ API
• 2. 完成汉化脚本:翻译 UI 和各种平台 APP 源码中硬编码的英文单词
• 3. 接入钉钉 API
• 4. 接入微信 API
• 5. 整合飞书 API
• 5. 整合KOOK API

OpenClaw

去角质!去角质!

CI 状态 GitHub 发布版本 Discord MIT 许可证

OpenClaw 是一个你可以在自己设备上运行的 个人AI助手。 它会在你已经使用的频道上回应你(WhatsApp、Telegram、Slack、Discord、Google Chat、Signal、iMessage、Microsoft Teams、WebChat),此外还包括 BlueBubbles、Matrix、Zalo 和 Zalo Personal 这样的扩展频道。它可以在 macOS/iOS/Android 上进行语音和听力,并可以渲染一个你可以控制的实时画布。网关只是控制平面 —— 产品才是助手。

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

网站 · 文档 · DeepWiki · 入门指南 · 更新 · 展示 · 常见问题解答 · 向导 · 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 用户服务),使其保持运行状态。

运行时环境: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/Microsoft Teams/Matrix/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
# 开发循环(TypeScript 更改时自动重新加载)
pnpm gateway:watch

注意:pnpm openclaw ... 直接运行 TypeScript(通过 tsx)。pnpm build 生成 dist/ 用于通过 Node / 打包的 openclaw 二进制文件运行。

OpenClaw 连接到真实的通信界面。将传入的 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、BlueBubbles(iMessage)、iMessage(旧版)、Microsoft Teams、Matrix、Zalo、Zalo Personal、WebChat、macOS、iOS/Android。
• 多代理路由 — 将传入的频道/账户/对等体路由到隔离的代理(工作区 + 每个代理会话)。
• 语音唤醒 + 对话模式 — 在 macOS/iOS/Android 上持续语音对话,使用 ElevenLabs。
• 实时画布 — 代理驱动的可视化工作区,使用 A2UI。
• 一级工具 — 浏览器、画布、节点、cron、会话和 Discord/Slack 动作。
• 配套应用 — macOS 菜单栏应用 + iOS/Android 节点。
• 入站设置 + 技能 — 向导驱动的设置,带有捆绑/管理的工作区技能。

星星历史图表

• 网关 WS 控制平面 包含会话、在线状态、配置、cron、webhook、控制 UI 和 画布主机。
• CLI 表面:网关、代理、发送、向导 和 医生。
• Pi 代理运行时 以 RPC 模式运行,支持工具流和块流。
• 会话模型:main 用于直接聊天、群组隔离、激活模式、队列模式、回复回传。群组规则:群组。
• 媒体管道:图像/音频/视频,转录钩子,大小限制,临时文件生命周期。音频详情:音频。

• 频道:WhatsApp (Baileys),Telegram (grammY),Slack (Bolt),Discord (discord.js),Google Chat (Chat API),Signal (signal-cli),BlueBubbles (iMessage,推荐),iMessage (旧版 imsg),Microsoft Teams (扩展),Matrix (扩展),Zalo (扩展),Zalo Personal (扩展),WebChat。
• 群组路由:提及门控、回复标签、每个频道分块和路由。频道规则:频道。

• macOS 应用:菜单栏控制平面,语音唤醒/PTT,对话模式 覆盖层,WebChat,调试工具,远程网关 控制。
• iOS 节点:通过桥接配对为节点,[语音触发转发] + 画布表面,通过 openclaw nodes ... 控制。
• Android 节点:通过相同的桥接 + 配对流程与 iOS 配对,暴露 画布、相机和屏幕录制命令,可选短信。
• macOS 节点模式:system.run/notify + canvas/camera 暴露。

• 浏览器控制:专用的 openclaw Chrome/Chromium,快照、动作、上传、配置文件。
• 画布:A2UI 推送/重置、评估、快照。
• 节点:相机快照/片段、屏幕录制、location.get、通知。
• Cron + 唤醒;webhook;Gmail Pub/Sub。
• 技能平台:捆绑、管理和工作区技能,带安装门控 + UI。

• 频道路由、重试策略 和 流式传输/分块。
• 在线状态、正在输入指示符 和 使用情况跟踪。
• 模型、模型故障转移 和 会话修剪。
• 安全 和 故障排除。

• 控制 UI + WebChat 直接由网关提供服务。
• Tailscale Serve/Funnel 或 SSH 隧道 带令牌/密码认证。
• Nix 模式 用于声明性配置;基于 Docker 的安装。
• 医生 迁移、日志记录。

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(远程访问:远程)。
• 浏览器控制 — 由 openclaw 管理的 Chrome/Chromium,带 CDP 控制。
• 画布 + A2UI — 代理驱动的可视化工作区(A2UI 主机:画布/A2UI)。
• 语音唤醒 + 对话模式 — 持续语音和连续对话。
• 节点 — 画布、相机快照/片段、屏幕录制、location.get、通知,加上 macOS 专属的 system.run/system.notify。

OpenClaw 可以自动配置 Tailscale Serve(仅限 tailnet)或 Funnel(公开),同时网关绑定到环回地址。配置 gateway.tailscale.mode:

• off:无 Tailscale 自动化(默认)。
• serve:仅限 tailnet 的 HTTPS 通过 tailscale serve(默认使用 Tailscale 身份头)。
• funnel:公开的 HTTPS 通过 tailscale funnel(需要共享密码认证)。

注意事项:

• 当启用 Serve/Funnel 时,gateway.bind 必须保持为 loopback(OpenClaw 强制执行此设置)。
• 可以通过设置 gateway.auth.mode: "password" 或 gateway.auth.allowTailscale: false 强制 Serve 要求密码。
• 如果未设置 gateway.auth.mode: "password",Funnel 将拒绝启动。
• 可选:gateway.tailscale.resetOnExit 以在关闭时撤销 Serve/Funnel。

详情:Tailscale 指南 · Web 表面

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

• 网关主机 默认运行执行工具和频道连接。
• 设备节点 通过 node.invoke 运行设备本地操作(system.run、相机、屏幕录制、通知)。 简而言之:exec 运行在网关所在的位置;设备操作运行在设备所在的位置。

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

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_list — 发现活跃会话(代理)及其元数据。
• sessions_history — 获取某个会话的对话日志。
• sessions_send — 向另一个会话发送消息;可选回复回传乒乓 + 步骤公告(REPLY_SKIP,ANNOUNCE_SKIP)。

详情:会话工具

ClawHub 是一个最小的技能注册表。启用 ClawHub 后,代理可以自动搜索技能并在需要时拉取新的技能。

ClawHub

在 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 — 群组激活开关(仅限群组)

网关本身就能提供出色体验。所有应用程序都是可选的,添加额外功能。

如果你计划构建/运行配套应用程序,请遵循以下平台运行手册。

• 网关和健康状况的菜单栏控制。
• 语音唤醒 + 推送对讲覆盖层。
• WebChat + 调试工具。
• 通过 SSH 进行远程网关控制。

注意:macOS 权限需要签名构建才能在重建后保持(参见 docs/mac/permissions.md)。

• 通过桥接配对为节点。
• 语音触发转发 + 画布表面。
• 通过 openclaw nodes ... 控制。

运行手册:iOS 连接。

• 通过相同的桥接 + 配对流程与 iOS 配对。
• 暴露画布、相机和屏幕捕捉命令。
• 运行手册: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",
 },
}

完整配置参考(所有键 + 示例)。

• 默认:主会话中的工具在主机上运行,因此只有你自己时代理拥有完全访问权限。
• 群组/频道安全性:设置 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(环境变量优先)。
• 可选:设置 channels.telegram.groups(带 channels.telegram.groups."*".requireMention);设置后成为群组允许列表(包含 "*" 允许所有人)。也可以根据需要设置 channels.telegram.allowFrom 或 channels.telegram.webhookUrl + channels.telegram.webhookSecret。

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

• 设置 SLACK_BOT_TOKEN + SLACK_APP_TOKEN(或 channels.slack.botToken + channels.slack.appToken)。

• 设置 DISCORD_BOT_TOKEN 或 channels.discord.token(环境变量优先)。
• 可选:设置 commands.native、commands.text 或 commands.useAccessGroups,以及根据需要设置 channels.discord.dm.allowFrom、channels.discord.guilds 或 channels.discord.mediaMaxMb。

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

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

• 推荐 的 iMessage 集成。
• 配置 channels.bluebubbles.serverUrl + channels.bluebubbles.password 和一个 webhook (channels.bluebubbles.webhookPath)。
• BlueBubbles 服务器运行在 macOS 上;网关可以运行在 macOS 或其他地方。

• 仅限 macOS 的旧版集成,通过 imsg(必须登录 Messages)。
• 如果设置了 channels.imessage.groups,则成为群组允许列表;包含 "*" 允许所有人。

• 配置 Teams 应用 + Bot Framework,然后添加 msteams 配置部分。
• 通过 msteams.allowFrom 允许谁可以对话;通过 msteams.groupAllowFrom 或 msteams.groupPolicy: "open" 允许群组访问。

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

可选的浏览器控制:

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

当你完成入站设置流程并且想要更深入的参考时使用这些文档。

• 从文档索引开始导航和了解"内容在哪里"。
• 阅读网关 + 协议模型的架构概述。
• 需要每个键和示例时使用完整的配置参考。
• 按照运营手册按部就班地运行网关。
• 了解控制 UI/Web 表面如何工作以及如何安全地暴露它们。
• 了解通过 SSH 隧道或 tailnets 的远程访问。
• 跟随入站向导流程进行引导式设置。
• 通过 webhook 表面连接外部触发器。
• 设置 Gmail Pub/Sub 触发器。
• 了解 macOS 菜单栏配套应用的详细信息。
• 平台指南:Windows (WSL2),Linux,macOS,iOS,Android
• 使用故障排除指南解决常见问题。
• 在暴露任何内容之前查看安全指导。

• 发现 + 传输
• Bonjour/mDNS
• 网关配对
• 远程网关 README
• 控制 UI
• 仪表盘

• 健康检查
• 网关锁
• 后台进程
• Linux 上的浏览器故障排除
• 日志记录

• 代理循环
• 在线状态
• TypeBox 架构
• RPC 适配器
• 队列

• 技能配置
• 默认 AGENTS
• 模板:AGENTS
• 模板:BOOTSTRAP
• 模板:IDENTITY
• 模板:SOUL
• 模板:TOOLS
• 模板:USER

• macOS 开发设置
• macOS 菜单栏
• macOS 语音唤醒
• iOS 节点
• Android 节点
• Windows (WSL2)
• Linux 应用

• docs.openclaw.ai/gmail-pubsub

OpenClaw 是为 Molty 构建的,一个太空甲壳虫 AI 助手。🦞 由 Peter Steinberger 和社区共同打造。

• openclaw.ai
• soul.md
• steipete.me
• @openclaw

查看 CONTRIBUTING.md 获取贡献指南、维护者信息以及如何提交 PR。 欢迎提交 AI/氛围编码的 PR!🤖

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