Public

WeChat Login

Code Issues Pull requests Events Packages Insights

main

openclaw-dmxapi-cn/README.md

夜松云<983178786@qq.com>

chore: 同步上游仓库至 2026.2.3 并恢复汉化内容

46a6b7fe

PreviewCode viewBlame

OpenClaw-cn — 个人 AI 助手中文版

EXFOLIATE! EXFOLIATE!

DMXAPI

快速开始

安装

使用 DMXAPI 的 npm 镜像源安装：


npm config set registry https://npm.cnb.cool/dmxapi/openclaw-cn/-/packages/
npm install -g openclaw-cn@latest

使用


# 运行引导向导
openclaw-cn onboard --install-daemon

# 启动 Gateway
openclaw-cn gateway --port 18789 --verbose

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

# 与助手对话
openclaw-cn agent --message "Ship checklist" --thinking high

升级


npm update -g openclaw-cn
# 升级后运行 doctor 检查
openclaw-cn doctor

项目简介

OpenClaw 是一个运行在你自己设备上的个人 AI 助手。

它可以在你常用的通讯渠道上回复你（WhatsApp、Telegram、Slack、Discord、Google Chat、Signal、iMessage、Microsoft Teams、WebChat），还支持扩展渠道如 BlueBubbles、Matrix、Zalo 和 Zalo Personal。它可以在 macOS/iOS/Android 上进行语音交互，并可以渲染你控制的实时 Canvas。Gateway 只是控制平面——产品本身是助手。

如果你想要一个本地、快速、常驻的个人单用户助手，这就是它。

系统要求

Node.js: >=22.12.0
包管理器: npm / pnpm / bun

模型（选择 + 认证）

订阅（OAuth）：

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

模型说明：虽然支持任何模型，但强烈推荐 Anthropic Pro/Max (100/200) + Opus 4.5，因为其长上下文能力强，且对提示注入攻击有更好的抵抗力。参见引导向导。

模型配置 + CLI: 模型
认证配置轮换（OAuth vs API 密钥）+ 回退: 模型故障转移

主要功能

本地优先 Gateway — 会话、渠道、工具和事件的单一控制平面
多渠道收件箱 — WhatsApp、Telegram、Slack、Discord、Google Chat、Signal、BlueBubbles (iMessage)、iMessage (传统)、Microsoft Teams、Matrix、Zalo、Zalo Personal、WebChat、macOS、iOS/Android
多代理路由 — 将入站渠道/账户/对等方路由到隔离的代理（工作区 + 每代理会话）
语音唤醒 + 对话模式 — macOS/iOS/Android 上使用 ElevenLabs 的常驻语音
实时 Canvas — 代理驱动的可视化工作区，支持 A2UI
一流的工具 — 浏览器、canvas、节点、定时任务、会话以及 Discord/Slack 操作
配套应用 — macOS 菜单栏应用 + iOS/Android 节点
引导向导 + 技能 — 向导驱动的设置，包含内置/托管/工作区技能

开发渠道

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-cn 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 连接到真实的消息平台。将入站私信视为不可信输入。

完整安全指南: 安全

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

私信配对 (dmPolicy="pairing" / channels.discord.dm.policy="pairing" / channels.slack.dm.policy="pairing"): 未知发送者会收到一个短配对码，机器人不会处理他们的消息
使用以下命令批准: openclaw-cn pairing approve <channel> <code>（然后发送者会被添加到本地白名单存储）
公开入站私信需要明确选择加入: 设置 dmPolicy="open" 并在渠道白名单中包含 "*"

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

配置说明

最小配置 ~/.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（环境变量优先）
可选: 设置 channels.telegram.groups（带 channels.telegram.groups."*".requireMention）


{
  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（环境变量优先）


{
  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 (传统)

传统的仅限 macOS 集成，通过 imsg（Messages 必须已登录）
如果设置了 channels.imessage.groups，它将成为群组白名单

Microsoft Teams

配置 Teams 应用 + Bot Framework，然后添加 msteams 配置部分

WebChat

使用 Gateway WebSocket；无需单独的 WebChat 端口/配置

聊天命令

在 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 — 重启 Gateway（群组中仅限所有者）
/activation mention|always — 群组激活切换（仅限群组）

应用（可选）

Gateway 本身就能提供出色的体验。所有应用都是可选的，用于添加额外功能。

macOS (OpenClaw.app)

Gateway 的菜单栏控制和健康状态
语音唤醒 + 按键说话覆盖层
WebChat + 调试工具
通过 SSH 远程控制 Gateway

注意: 需要签名构建才能使 macOS 权限在重新构建后保持

iOS 节点

通过 Bridge 配对为节点
语音触发转发 + Canvas 界面
通过 openclaw-cn nodes … 控制

运行手册: iOS 连接

Android 节点

通过与 iOS 相同的 Bridge + 配对流程配对
暴露 Canvas、相机和屏幕捕获命令

运行手册: Android 连接

工作原理


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