Public

WeChat Login

Code Issues Pull requests Events Packages Insights

main

openclaw-dmxapi-cn/README.md

夜松云<983178786@qq.com>

docs: 更新 README 的标题样式和布局

0e8fee5d

PreviewCode viewBlame

Raw

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

DMXAPI

🚀 快速开始

安装

使用 DMXAPI 的 npm 镜像源安装：


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

使用


# 重置配置
openclaw-cn reset

# 运行引导向导
openclaw-cn onboard

# 启动 Gateway
openclaw-cn gateway

升级


npm update -g openclaw-cn

📖 项目简介

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

✨ 主要功能

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

📱 通讯渠道配置

链接设备: openclaw-cn 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: {
      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.dm.allowFrom、channels.discord.guilds 或 channels.discord.mediaMaxMb


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

Signal

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

iMessage

仅限 macOS；需要登录 Messages
如果设置了 channels.imessage.groups，它将成为群组白名单；包含 "*" 以允许所有

Microsoft Teams

配置 Teams 应用 + Bot Framework，然后添加 msteams 配置部分
通过 msteams.allowFrom 设置白名单；通过 msteams.groupAllowFrom 或 msteams.groupPolicy: "open" 设置群组访问

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 — 群组激活切换（仅限群组）

🔒 安全模型

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" 并在渠道白名单中包含 "*"（allowFrom / channels.discord.dm.allowFrom / channels.slack.dm.allowFrom）

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

安全配置

默认: 工具在主机上为 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 + 沙箱 · 沙箱配置

⚙️ 配置说明

最小配置 ~/.openclaw/openclaw.json（模型 + 默认值）：


{
  agent: {
    model: "anthropic/claude-opus-4-5"
  }
}

完整配置参考（所有键 + 示例）

浏览器控制（可选）


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

🏗️ 工作原理


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

🔧 关键子系统

Gateway WebSocket 网络 — 客户端、工具和事件的单一 WS 控制平面（运维: Gateway 运行手册）
Tailscale 暴露 — Gateway 仪表板 + WS 的 Serve/Funnel（远程访问: 远程）
浏览器控制 — openclaw 管理的 Chrome/Chromium，支持 CDP 控制
Canvas + A2UI — 代理驱动的可视化工作区（A2UI 主机: Canvas/A2UI）
语音唤醒 + 对话模式 — 常驻语音和连续对话
节点 — Canvas、相机拍照/录制、屏幕录制、location.get、通知，以及 macOS 专属的 system.run/system.notify