Skip to content

bbylw/clawdbot-cn

BranchesTags

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

33 Commits
CNAME
CNAME
 
 
LICENSE
LICENSE
 
 
OpenClaw.pdf
OpenClaw.pdf
 
 
README.md
README.md
 
 
README_EN.md
README_EN.md
 
 
index.html
index.html
 
 

Repository files navigation

English

🦞 OpenClaw — 个人 AI 助手

OpenClaw

蜕壳！蜕壳！(EXFOLIATE! EXFOLIATE!)

CI status GitHub release Discord MIT License

OpenClaw 是一个运行在您自己设备上的个人 AI 助手。 它会在您已经使用的渠道上回复您（WhatsApp、Telegram、Slack、Discord、Google Chat、Signal、iMessage、BlueBubbles、IRC、Microsoft Teams、Matrix、Feishu、LINE、Mattermost、Nextcloud Talk、Nostr、Synology Chat、Tlon、Twitch、Zalo、Zalo Personal、WeChat、WebChat）。它可以在 macOS/iOS/Android 上进行语音对话，并且能够渲染一个您可控的实时 Canvas。网关（Gateway）只是控制平面——产品本身就是这个助手。

如果您想要一个感觉本地化、快速且永远在线的个人单用户助手，这就是您的选择。

官网 · 文档 · 愿景 · DeepWiki · 入门指南 · 更新 · 展示 · 常见问题 · 入职 · Nix · Docker · Discord

首选设置方式：在终端中运行 openclaw onboard。 OpenClaw Onboard 会分步引导您完成网关、工作区、渠道和技能的配置。这是推荐的 CLI 设置路径，适用于 macOS、Linux 和 Windows（通过 WSL2，强烈推荐）。 支持使用 npm, pnpm, 或 bun。 新安装？从这里开始：入门指南

赞助商

OpenAI NVIDIA Vercel Blacksmith Convex

订阅 (OAuth):

模型说明：虽然支持多种提供商/模型，但为了更好的体验和更低的提示注入风险，建议优先选择你可用的最新一代强模型。参见 入职指南。

模型 (选择 + 认证)

  • 模型配置 + CLI: Models
  • 认证配置文件轮换 (OAuth vs API keys) + 故障转移: Model failover

安装 (推荐)

运行环境：Node 24（推荐）或 Node 22.16+。

npm install -g openclaw@latest
# 或者: pnpm add -g openclaw@latest

openclaw onboard --install-daemon

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

快速开始 (简版)

运行环境：Node 24（推荐）或 Node 22.16+。

完整新手指南（认证、配对、渠道）：入门指南

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/IRC/Microsoft Teams/Matrix/Feishu/LINE/Mattermost/Nextcloud Talk/Nostr/Synology Chat/Tlon/Twitch/Zalo/Zalo Personal/WeChat/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/openclaw/openclaw.git
cd openclaw

pnpm install
pnpm ui:build # 首次运行时自动安装 UI 依赖
pnpm build

pnpm openclaw onboard --install-daemon

# 开发循环（源码/配置变更自动重载）
pnpm gateway:watch

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

安全默认设置 (私信访问)

OpenClaw 连接到某些真实的消息平台。请将入站私信 (DM) 视为 不可信输入。

完整安全指南：安全

默认行为在 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 来发现有风险/配置错误的私信策略。

亮点

  • 本地优先网关 — 会话、渠道、工具和事件的统一控制平面。
  • 多渠道收件箱 — WhatsApp, Telegram, Slack, Discord, Google Chat, Signal, BlueBubbles (iMessage, 推荐), iMessage (legacy), IRC, Microsoft Teams, Matrix, Feishu, LINE, Mattermost, Nextcloud Talk, Nostr, Synology Chat, Tlon, Twitch, Zalo, Zalo Personal, WebChat, macOS, iOS/Android。
  • 多 Agent 路由 — 将入站渠道/账户/对等端路由到隔离的 Agent（工作区 + 每 Agent 会话）。
  • 语音唤醒 (Voice Wake) + 交谈模式 (Talk Mode) — macOS/iOS/Android 上的始终在线语音，支持 ElevenLabs。
  • Live Canvas — Agent 驱动的可视化工作区，支持 A2UI。
  • 一流工具支持 — 浏览器, Canvas, Nodes, Cron, Sessions 以及 Discord/Slack 动作。
  • 配套应用 — macOS 菜单栏应用 + iOS/Android Nodes。
  • 入职 + 技能 — 以 Onboard 为中心的设置流程，支持捆绑/托管/工作区技能。

Star History

Star History Chart

目前构建的所有功能

核心平台

渠道

应用 + Nodes

工具 + 自动化

运行时 + 安全

运维 + 打包

工作原理 (简述)

WhatsApp / Telegram / Slack / Discord / Google Chat / Signal / iMessage / BlueBubbles / IRC / Microsoft Teams / Matrix / Feishu / LINE / Mattermost / Nextcloud Talk / Nostr / Synology Chat / Tlon / Twitch / Zalo / Zalo Personal / WebChat
               │
               ▼
┌───────────────────────────────┐
│            Gateway            │
│       (control plane)         │
│     ws://127.0.0.1:18789      │
└──────────────┬────────────────┘
               │
               ├─ Pi Agent (RPC)
               ├─ CLI (openclaw …)
               ├─ WebChat UI
               ├─ macOS App
               └─ iOS / Android Nodes

关键子系统

Tailscale 访问 (网关仪表板)

OpenClaw 可以自动配置 Tailscale Serve (仅 tailnet) 或 Funnel (公开)，同时网关保持绑定到 loopback。配置 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 很棒)

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

  • 网关主机 默认运行 exec 工具和渠道连接。
  • 设备 Nodes 通过 node.invoke 运行设备本地操作 (system.run, 摄像头, 屏幕录制, 通知)。 简而言之：exec 在网关所在位置运行；设备操作在设备所在位置运行。

详情：远程访问 · Nodes · 安全

通过网关协议的 macOS 权限

macOS 应用可以以 node 模式 运行，并通过网关 WebSocket 广播其能力 + 权限映射 (node.list / node.describe)。客户端随后可以通过 node.invoke 执行本地操作：

  • system.run 运行本地命令并返回 stdout/stderr/exit code；设置 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 一样。

详情：Nodes · macOS app · 网关协议

Agent 对 Agent (sessions_* 工具)

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

详情：会话工具

技能注册表 (ClawHub)

ClawHub 是一个极简的技能注册表。启用 ClawHub 后，Agent 可以自动搜索技能并在需要时拉取新技能。

ClawHub

聊天命令

在 WhatsApp/Telegram/Slack/Google Chat/Microsoft Teams/WebChat 中发送这些命令 (群组命令仅限所有者):

  • /status — 精简会话状态 (模型 + tokens, 可用时显示成本)
  • /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 — 群组激活切换 (仅限群组)

Apps (可选)

仅网关就能提供极佳的体验。所有应用都是可选的并增加额外功能。

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

macOS (OpenClaw.app) (可选)

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

注意：要让 macOS 权限在重建后持续生效，需要签名构建（参见 macOS 权限）。

iOS Node (可选)

  • 通过 Bridge 作为 node 配对。
  • 语音触发转发 + Canvas 表面。
  • 通过 openclaw nodes … 控制。

运行手册：iOS 连接。

Android Node (可选)

  • 通过与 iOS 相同的 Bridge + 配对流程配对。
  • 暴露 Canvas, 摄像头, 和屏幕捕获命令。
  • 运行手册：Android 连接。

Agent 工作区 + 技能

  • 工作区根目录：~/.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-6"
  }
}

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

安全模型 (重要)

  • 默认: 工具在 main 会话的主机上运行，因此只有你是用户时 Agent 拥有完全访问权限。
  • 群组/渠道安全: 设置 agents.defaults.sandbox.mode: "non-main" 以在每会话 Docker 沙箱中运行 非 main 会话 (群组/渠道)；这样 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 (环境变量优先)。
  • 可选：设置 channels.telegram.groups (带 channels.telegram.groups."*".requireMention); 设置后，它是群组允许列表 (包含 "*" 以允许所有)。按需设置 channels.telegram.allowFrom or channels.telegram.webhookUrl + channels.telegram.webhookSecret。
{
  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。
  • 可选：按需设置 commands.native, commands.text, 或 commands.useAccessGroups, 加上 channels.discord.allowFrom, channels.discord.guilds, 或 channels.discord.mediaMaxMb。
{
  channels: {
    discord: {
      token: "1234abcd"
    }
  }
}

Signal

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

BlueBubbles (iMessage)

  • 推荐 的 iMessage 集成方案。
  • 配置 channels.bluebubbles.serverUrl + channels.bluebubbles.password 以及 webhook (channels.bluebubbles.webhookPath)。
  • BlueBubbles 服务端运行在 macOS 上；Gateway 可运行在 macOS 或其他平台。

iMessage (legacy)

  • 传统 macOS-only 集成，基于 imsg（Messages 必须已登录）。
  • 如果设置了 channels.imessage.groups，它将成为群组允许列表；包含 "*" 以允许所有。

Microsoft Teams

  • 配置 Teams app + Bot Framework, 然后添加 msteams 配置部分。
  • 通过 msteams.allowFrom 允许谁交谈；群组访问通过 msteams.groupAllowFrom 或 msteams.groupPolicy: "open"。

WeChat

  • 官方腾讯插件：@tencent-weixin/openclaw-weixin（iLink Bot API）。仅支持私聊；v2.x 需要 OpenClaw >=2026.3.22。
  • 安装：openclaw plugins install "@tencent-weixin/openclaw-weixin"，然后运行 openclaw channels login --channel openclaw-weixin 扫码。
  • 需要安装微信 ClawBot 插件（微信 > 我 > 设置 > 插件）；腾讯会逐步放量。

WebChat

  • 使用网关 WebSocket；没有单独的 WebChat 端口/配置。

浏览器控制 (可选):

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

文档

当您通过入职流程并希望获得更深入的参考时使用这些。

高级文档 (发现 + 控制)

运维 & 故障排除

深度探索

工作区 & 技能

平台内部

邮件钩子 (Gmail)

Molty

OpenClaw 是为 Molty 打造的，一只太空龙虾 AI 助手。 🦞 由 Peter Steinberger 和社区构建。

社区

查看 CONTRIBUTING.md 以获取指南、维护者以及如何提交 PR。 欢迎提交 AI/vibe-coded PR! 🤖

特别感谢 Mario Zechner 的支持以及他的 pi-mono。 特别感谢 Adam Doppelt 为 lobster.bot 所做的贡献。

About

Clawdbot 是一个运行在您自己设备上的个人 AI 助手

clawdbot.ndjp.net/

Resources

Readme
MIT license
Activity

Stars

293 stars

Watchers

0 watching

Forks

54 forks
Report repository

Releases

Packages

Contributors

Languages