Skip to content
/ clawdbot-cn Public

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

clawdbot.ndjp.net/

License

MIT license
282 stars 50 forks Branches Tags Activity
Star
Notifications You must be signed in to change notification settings

bbylw/clawdbot-cn

BranchesTags

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

18 Commits
CNAME
CNAME
 
 
LICENSE
LICENSE
 
 
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, Microsoft Teams, WebChat），同时也支持 BlueBubbles, Matrix, Zalo 和 Zalo Personal 等扩展渠道。它可以在 macOS/iOS/Android 上进行语音对话，并且能够渲染一个您可控的实时 Canvas。网关（Gateway）只是控制平面——产品本身就是这个助手。

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

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

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

订阅 (OAuth):

模型说明：虽然支持任何模型，但我强烈推荐 Anthropic Pro/Max (100/200) + Opus 4.5，因为它具有长上下文优势和更好的抗提示注入能力。参见 入职指南。

模型 (选择 + 认证)

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

安装 (推荐)

运行环境：Node ≥22。

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

openclaw onboard --install-daemon

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

快速开始 (简版)

运行环境：Node ≥22。

支持包管理器：npm / pnpm / bun。

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

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/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 连接到某些真实的消息平台。请将入站私信 (DM) 视为 不可信输入。

完整安全指南：安全

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

  • 私信配对 (dmPolicy="pairing" / channels.discord.dm.policy="pairing" / channels.slack.dm.policy="pairing"): 未知发送者会收到一个简短的配对码，机器人不会处理他们的消息。
  • 批准方式：openclaw pairing approve <channel> <code> (然后发送者会被添加到本地允许列表存储中)。
  • 公共入站私信需要显式选择加入：设置 dmPolicy="open" 并在渠道允许列表 (allowFrom / channels.discord.dm.allowFrom / channels.slack.dm.allowFrom) 中包含 "*"。

运行 openclaw doctor 来发现有风险/配置错误的私信策略。

亮点

Star History

Star History Chart

目前构建的所有功能

核心平台

渠道

应用 + Nodes

工具 + 自动化

运行时 + 安全

运维 + 打包

工作原理 (简述)

WhatsApp / Telegram / Slack / Discord / Google Chat / Signal / iMessage / BlueBubbles / Microsoft Teams / Matrix / 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 权限在重新构建后保持不变，需要签名构建 (参见 docs/mac/permissions.md)。

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-5"
  }
}

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

安全模型 (重要)

  • 默认: 工具在 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 or channels.discord.token (环境变量优先)。
  • 可选：按需设置 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 app + Bot Framework, 然后添加 msteams 配置部分。
  • 通过 msteams.allowFrom 允许谁交谈；群组访问通过 msteams.groupAllowFrom 或 msteams.groupPolicy: "open"。

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。 Special thanks to Adam Doppelt for lobster.bot.

感谢所有 clawtributors:

(Contributors list omitted for brevity - same as EN version)

About

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

clawdbot.ndjp.net/

Resources

Readme

License

MIT license
Activity

Stars

282 stars

Watchers

0 watching

Forks

50 forks
Report repository

Releases

No releases published

Packages

No packages published

Languages