🦞 OpenClaw 中文版 — 个人 AI 助手

本项目是 OpenClaw 的完整中文汉化版本，包含界面、文档、CLI 输出的全面中文本地化。可通过 npm 一键安装。

OpenClaw 是一个运行在你自己设备上的 个人 AI 助手。 它可以在你日常使用的各种渠道（WhatsApp、Telegram、Slack、Discord、Google Chat、Signal、iMessage、BlueBubbles、IRC、Microsoft Teams、Matrix、飞书、LINE、Mattermost、Nextcloud Talk、Nostr、Synology Chat、Tlon、Twitch、Zalo、Zalo Personal、WebChat）上回复你。它可以在 macOS/iOS/Android 上进行语音对话，还可以渲染你控制的实时 Canvas。Gateway 只是控制平面——产品本身是助手。

如果你想要一个本地优先、快速且始终在线的个人单用户助手，这就是你需要的。

上游项目 · 上游官网 · 上游文档 · 愿景 · DeepWiki · 快速入门 · 更新指南 · 案例展示 · 常见问题 · 入门向导 · Nix · Docker · Discord

推荐方式：运行入门向导（openclaw onboard）。 向导会逐步引导你完成 Gateway、工作区、频道和技能的配置。CLI 向导是推荐路径，适用于 macOS、Linux 和 Windows（通过 WSL2；强烈推荐）。 支持 npm、pnpm 或 bun。 新用户？请从下方"安装"部分开始。

赞助商

本项目的赞助商来自上游 OpenClaw 项目：

| OpenAI | Vercel | Blacksmith | Convex | | ----------------------------------------------------------------- | ----------------------------------------------------------------- | ---------------------------------------------------------------------------- | --------------------------------------------------------------------- | | | | | |

订阅（OAuth）：

• OpenAI（ChatGPT/Codex）

模型说明：虽然支持许多提供商/模型，但为了获得最佳体验和降低提示注入风险，请使用你能获取到的最强最新一代模型。详见 入门引导。

模型（选择 + 认证）

• 模型配置 + CLI：模型
• 认证配置轮换（OAuth vs API 密钥）+ 故障切换：模型故障切换

安装（推荐方式）

前提条件：安装 Node.js

运行环境：Node.js ≥ 22.12.0。

检查是否已安装：

node -v    # 应显示 v22.x.x 或更高
npm -v     # 应显示 10.x.x

如果没有安装或版本过低：

| 系统 | 推荐安装方式 | | ------------------- | ------------------------------------------------------------------------------------------------------ | | macOS | brew install node@22 或访问 nodejs.org | | Windows | 访问 nodejs.org 下载 LTS 版本安装包 | | Ubuntu / Debian | curl -fsSL https://deb.nodesource.com/setup_22.x \| sudo -E bash - && sudo apt-get install -y nodejs | | CentOS / RHEL | curl -fsSL https://rpm.nodesource.com/setup_22.x \| sudo bash - && sudo yum install -y nodejs |

使用 nvm 安装（适用于所有系统）：

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
nvm install 22
nvm use 22

npm 一键安装（推荐）

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

openclaw onboard --install-daemon

如果提示 openclaw: command not found，需要将 npm 全局路径加入 PATH：

export PATH="$(npm prefix -g)/bin:$PATH"

将上面这行添加到你的 ~/.bashrc 或 ~/.zshrc 中。

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

从源码安装

如果你更喜欢从源码构建，或需要自定义修改：

git clone https://github.com/tuwawa-liu/OpenClaw-zh.git
cd OpenClaw-zh

npm install -g pnpm      # 安装 pnpm
pnpm install
pnpm ui:build
pnpm build

pnpm openclaw onboard --install-daemon

卸载

如果需要彻底卸载（例如旧版本冲突），运行项目自带的卸载脚本：

bash uninstall-openclaw.sh

脚本会自动完成以下清理：

1. 停止并移除 launchd 守护进程（ai.openclaw.gateway）
2. 终止残留的 openclaw 进程
3. 卸载所有 Node 版本下的全局 npm 包
4. 删除配置和数据目录（~/.openclaw，配置文件会自动备份到 ~/openclaw.json.backup.*）
5. 清除 npx 缓存中的 openclaw 相关内容

卸载后如需重新安装，回到源码目录执行 pnpm openclaw onboard --install-daemon 即可。

快速开始（精简版）

运行环境：Node ≥22。

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

# npm 安装后
openclaw onboard --install-daemon

openclaw gateway --port 18789 --verbose

# 发送消息
openclaw message send --to +1234567890 --message "你好，来自 OpenClaw 中文版"

# 与助手对话
openclaw agent --message "帮我整理一下今天的待办事项" --thinking high

升级？运行 npm update -g chinese-openclaw 或从上游同步最新代码并重新构建。

Dashboard 语言设置：首次打开网页控制台后，前往 Overview 页面底部，将 Language 切换为 简体中文 (Simplified Chinese)，刷新页面即可显示中文界面。

入门向导流程

运行 openclaw onboard 后，向导会引导你完成以下步骤：

步骤1  ─→  安全风险确认（输入 y 确认）
步骤2  ─→  选择 AI 模型提供商
            ├─ Anthropic Claude（推荐）
            ├─ OpenAI GPT
            ├─ 本地模型（Ollama 等）
            └─ 其他（Moonshot、智谱等）
步骤3  ─→  输入 API Key
步骤4  ─→  选择默认模型
步骤5  ─→  配置网关（端口、认证方式）
步骤6  ─→  配置聊天通道（可跳过）
步骤7  ─→  安装技能（可跳过）
步骤8  ─→  完成！

向导中大部分选项直接按回车用默认值即可。

快速非交互式配置

如果你已经有 API Key，想跳过向导直接配置：

openclaw setup
openclaw config set gateway.mode local
openclaw config set agents.defaults.model anthropic/claude-sonnet-4-20250514
openclaw config set auth.anthropic.apiKey sk-ant-你的API密钥
openclaw config set gateway.auth.token 你设定的密码

模型配置指南

OpenClaw 支持几乎所有主流 AI 模型。模型名使用 提供商/模型ID 格式，例如：openai/gpt-4o、anthropic/claude-sonnet-4-20250514。

国际主流模型

Anthropic Claude（推荐）

openclaw config set agents.defaults.model anthropic/claude-sonnet-4-20250514
openclaw config set auth.anthropic.apiKey sk-ant-你的API密钥

获取 API Key：console.anthropic.com

OpenAI GPT

openclaw config set agents.defaults.model openai/gpt-4o
openclaw config set auth.openai.apiKey sk-你的API密钥

获取 API Key：platform.openai.com

Google Gemini

openclaw config set agents.defaults.model google/gemini-3-pro-preview
openclaw config set auth.google.apiKey 你的API密钥

获取 API Key：aistudio.google.com

国产模型

月之暗面 Moonshot（Kimi）

openclaw config set agents.defaults.model moonshot/kimi-k2.5
openclaw config set auth.moonshot.apiKey 你的API密钥

获取 API Key：platform.moonshot.cn

智谱 Z.AI（GLM）

openclaw config set agents.defaults.model zai/glm-4.7
openclaw config set auth.zai.apiKey 你的API密钥

获取 API Key：open.bigmodel.cn

MiniMax

openclaw config set agents.defaults.model minimax/MiniMax-M2.1
openclaw config set auth.minimax.apiKey 你的API密钥

获取 API Key：platform.minimaxi.com

小米 MiMo

openclaw config set agents.defaults.model xiaomi/mimo-v2-flash
openclaw config set auth.xiaomi.apiKey 你的API密钥

本地模型

Ollama（推荐）

先安装 Ollama 并下载模型：ollama.com

ollama serve
ollama pull llama3.2

openclaw config set agents.defaults.model ollama/llama3.2
openclaw config set auth.openai.apiKey ollama
openclaw config set auth.openai.baseURL http://localhost:11434/v1

Docker 用户注意：容器中 localhost 指容器自身。如果 Ollama 在宿主机运行，使用 http://host.docker.internal:11434/v1。

LM Studio

openclaw config set agents.defaults.model openai/你加载的模型名
openclaw config set auth.openai.apiKey lm-studio
openclaw config set auth.openai.baseURL http://localhost:1234/v1

自定义 OpenAI 兼容接口

适用于：OneAPI、New API、各种中转站、企业私有部署等。只要接口兼容 OpenAI 格式就能用。

openclaw config set auth.openai.baseURL https://你的接口地址/v1
openclaw config set auth.openai.apiKey sk-你的密钥
openclaw config set agents.defaults.model openai/gpt-4o

配置后备模型

编辑 ~/.openclaw/openclaw.json，设置多个模型作为后备：

{
  agents: {
    defaults: {
      model: {
        primary: "anthropic/claude-sonnet-4-20250514",
        fallbacks: ["openai/gpt-4o", "google/gemini-3-pro-preview"],
      },
    },
  },
}

环境变量方式

也可以通过环境变量设置 API Key：

| 环境变量 | 对应提供商 | | ------------------- | ---------------- | | ANTHROPIC_API_KEY | Anthropic Claude | | OPENAI_API_KEY | OpenAI | | GEMINI_API_KEY | Google Gemini | | MOONSHOT_API_KEY | Moonshot Kimi | | ZAI_API_KEY | 智谱 GLM | | MINIMAX_API_KEY | MiniMax | | XIAOMI_API_KEY | 小米 MiMo |

模型配置排查

openclaw config get agents.defaults.model   # 检查当前模型
openclaw config get auth                     # 检查 API Key
openclaw doctor                              # 运行诊断

开发频道

上游 OpenClaw 的发布频道：

• stable：已标记的正式发布版本（vYYYY.M.D 或 vYYYY.M.D-<patch>）。
• beta：预发布标签（vYYYY.M.D-beta.N）。
• dev：跟随 main 分支头部。

切换频道（上游 npm 包）：openclaw update --channel stable|beta|dev

本中文版跟随上游 main 分支同步更新，通过 npm 包 chinese-openclaw 发布。

从源码构建（开发）

推荐使用 pnpm 进行源码构建。Bun 可选用于直接运行 TypeScript。

git clone https://github.com/tuwawa-liu/OpenClaw-zh.git
cd OpenClaw-zh

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

pnpm openclaw onboard --install-daemon

# 开发循环（TS 文件更改时自动重载）
pnpm gateway:watch

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

安全默认设置（私信访问）

OpenClaw 连接到真实的消息平台。将收到的私信视为 不可信输入。

完整安全指南：安全

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 来检查有风险/配置错误的私信策略。

亮点

• 本地优先 Gateway — 用于会话、频道、工具和事件的单一控制平面。
• 多频道收件箱 — WhatsApp、Telegram、Slack、Discord、Google Chat、Signal、BlueBubbles（iMessage）、iMessage（旧版）、IRC、Microsoft Teams、Matrix、飞书、LINE、Mattermost、Nextcloud Talk、Nostr、Synology Chat、Tlon、Twitch、Zalo、Zalo Personal、WebChat、macOS、iOS/Android。
• 多智能体路由 — 将入站频道/账户/对等端路由到隔离的智能体（工作区 + 按智能体隔离的会话）。
• 语音唤醒 + 通话模式 — macOS/iOS 上的唤醒词和 Android 上的持续语音（ElevenLabs + 系统 TTS 回退）。
• 实时 Canvas — 智能体驱动的可视化工作区，支持 A2UI。
• 一流的工具支持 — 浏览器、Canvas、节点、定时任务、会话和 Discord/Slack 操作。
• 配套应用 — macOS 菜单栏应用 + iOS/Android 节点。
• 入门向导 + 技能 — 向导式配置，含内置/托管/工作区技能。

Star 历史

我们目前构建的所有功能

核心平台

• Gateway WebSocket 控制平面，包含会话、在线状态、配置、定时任务、Webhooks、控制面板 UI 和 Canvas 宿主。
• CLI 界面：gateway、agent、send、向导 和 doctor。
• Pi 智能体运行时，RPC 模式，支持工具流式传输和块流式传输。
• 会话模型：main 用于直接聊天、群组隔离、激活模式、队列模式、回复转发。群组规则：群组。
• 媒体管道：图片/音频/视频、转录钩子、大小限制、临时文件生命周期。音频详情：音频。

频道

• 频道：WhatsApp（Baileys）、Telegram（grammY）、Slack（Bolt）、Discord（discord.js）、Google Chat（Chat API）、Signal（signal-cli）、BlueBubbles（iMessage，推荐）、iMessage（旧版 imsg）、IRC、Microsoft Teams、Matrix、飞书、LINE、Mattermost、Nextcloud Talk、Nostr、Synology Chat、Tlon、Twitch、Zalo、Zalo Personal、WebChat。
• 群组路由：提及门控、回复标签、按频道分块和路由。频道规则：频道。

应用 + 节点

• macOS 应用：菜单栏控制平面、语音唤醒/按键通话、通话模式覆盖层、WebChat、调试工具、远程 Gateway 控制。
• iOS 节点：Canvas、语音唤醒、通话模式、相机、屏幕录制、Bonjour + 设备配对。
• Android 节点：连接标签（设置码/手动）、聊天会话、语音标签、Canvas、相机/屏幕录制和 Android 设备命令（通知/位置/短信/照片/联系人/日历/运动/应用更新）。
• macOS 节点模式：system.run/notify + canvas/相机暴露。

工具 + 自动化

• 浏览器控制：专用 openclaw Chrome/Chromium、快照、操作、上传、配置文件。
• Canvas：A2UI 推送/重置、eval、快照。
• 节点：相机拍照/录制、屏幕录制、location.get、通知。
• 定时任务 + 唤醒；Webhooks；Gmail Pub/Sub。
• 技能平台：内置、托管和工作区技能，支持安装门控 + UI。

运行时 + 安全

• 频道路由、重试策略 和 流式传输/分块。
• 在线状态、输入指示器 和 用量追踪。
• 模型、模型故障切换 和 会话修剪。
• 安全 和 故障排除。

运维 + 打包

• 控制面板 UI + WebChat 直接从 Gateway 提供服务。
• Tailscale Serve/Funnel 或 SSH 隧道，支持令牌/密码认证。
• Nix 模式，声明式配置；Docker 安装方式。
• Doctor 迁移、日志。

工作原理（简述）

WhatsApp / Telegram / Slack / Discord / Google Chat / Signal / iMessage / BlueBubbles / IRC / Microsoft Teams / Matrix / 飞书 / LINE / Mattermost / Nextcloud Talk / Nostr / Synology Chat / Tlon / Twitch / Zalo / Zalo Personal / WebChat
               │
               ▼
┌───────────────────────────────┐
│            Gateway            │
│         （控制平面）            │
│     ws://127.0.0.1:18789      │
└──────────────┬────────────────┘
               │
               ├─ Pi 智能体（RPC）
               ├─ CLI（openclaw …）
               ├─ WebChat UI
               ├─ macOS 应用
               └─ iOS / Android 节点

关键子系统

• Gateway WebSocket 网络 — 面向客户端、工具和事件的单一 WS 控制平面（运维：Gateway 运行手册）。
• Tailscale 公开 — 面向 Gateway 仪表盘 + WS 的 Serve/Funnel（远程访问：远程）。
• 浏览器控制 — openclaw 托管的 Chrome/Chromium，通过 CDP 控制。
• Canvas + A2UI — 智能体驱动的可视化工作区（A2UI 宿主：Canvas/A2UI）。
• 语音唤醒 + 通话模式 — macOS/iOS 上的唤醒词加 Android 上的持续语音。
• 节点 — Canvas、相机拍照/录制、屏幕录制、location.get、通知，以及 macOS 专有的 system.run/system.notify。

Tailscale 访问（Gateway 仪表盘）

OpenClaw 可以自动配置 Tailscale Serve（仅限尾网，tailnet-only）或 Funnel（公开），同时 Gateway 保持绑定到回环地址。配置 gateway.tailscale.mode：

• off：不自动配置 Tailscale（默认）。
• serve：通过 tailscale serve 提供仅限尾网的 HTTPS（默认使用 Tailscale 身份头）。
• funnel：通过 tailscale funnel 提供公开 HTTPS（需要共享密码认证）。

注意事项：

• 启用 Serve/Funnel 时，gateway.bind 必须保持为 loopback（OpenClaw 会强制执行）。
• 可通过设置 gateway.auth.mode: "password" 或 gateway.auth.allowTailscale: false 强制 Serve 也需要密码。
• Funnel 在未设置 gateway.auth.mode: "password" 时拒绝启动。
• 可选：gateway.tailscale.resetOnExit 在关闭时撤销 Serve/Funnel。

详情：Tailscale 指南 · Web 界面

远程 Gateway（Linux 很好用）

将 Gateway 运行在小型 Linux 实例上完全没问题。客户端（macOS 应用、CLI、WebChat）可以通过 Tailscale Serve/Funnel 或 SSH 隧道 连接，你仍然可以配对设备节点（macOS/iOS/Android）来执行设备本地操作。

• Gateway 主机 默认运行 exec 工具和频道连接。
• 设备节点 通过 node.invoke 运行设备本地操作（system.run、相机、屏幕录制、通知）。 简言之：exec 在 Gateway 所在位置运行；设备操作在设备所在位置运行。

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

macOS 权限 — 通过 Gateway 协议

macOS 应用可以运行在 节点模式 下，通过 Gateway 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 在启用 + 白名单的情况下切换每会话的提升访问。
• Gateway 通过 sessions.patch（WS 方法）持久化每会话切换，包括 thinkingLevel、verboseLevel、model、sendPolicy 和 groupActivation。

详情：节点 · macOS 应用 · Gateway 协议

智能体间通信（sessions_* 工具）

• 使用这些工具在会话间协调工作，无需在聊天界面之间切换。
• sessions_list — 发现活动会话（智能体）及其元数据。
• sessions_history — 获取会话的对话记录。
• sessions_send — 向另一个会话发送消息；可选的回复乒乓 + 通告步骤（REPLY_SKIP、ANNOUNCE_SKIP）。

详情：会话工具

技能注册表（ClawHub）

ClawHub 是一个极简的技能注册表。启用 ClawHub 后，智能体可以自动搜索技能并按需引入新的技能。

ClawHub

聊天命令

在 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 权限需要签名构建才能在重新构建后保持有效（参见 docs/mac/permissions.md）。

iOS 节点（可选）

• 通过 Gateway WebSocket 作为节点配对（设备配对）。
• 语音触发转发 + Canvas 界面。
• 通过 openclaw nodes … 控制。

指南：iOS 连接。

Android 节点（可选）

• 通过设备配对（openclaw devices ...）作为 WS 节点配对。
• 提供 连接/聊天/语音 标签页加 Canvas、相机、屏幕捕获和 Android 设备命令系列。
• 指南：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-6",
  },
}

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

安全模型（重要）

• 默认： 工具在主机上为 main 会话运行，因此当只有你一个用户时，智能体拥有完全访问权限。
• 群组/频道安全： 设置 agents.defaults.sandbox.mode: "non-main" 以在 非 main 会话（群组/频道）中运行 Docker 沙箱；bash 在这些会话中在 Docker 内运行。
• 沙箱默认设置： 白名单 bash、process、read、write、edit、sessions_list、sessions_history、sessions_send、sessions_spawn；黑名单 browser、canvas、nodes、cron、discord、gateway。

详情：安全指南 · Docker + 沙箱 · 沙箱配置

WhatsApp

• 链接设备：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 或 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（旧版）

• 旧版仅限 macOS 的集成，通过 imsg（需要登录"信息" app）。
• 如果设置了 channels.imessage.groups，它将成为群组白名单；包含 "*" 以允许所有。

Microsoft Teams

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

WebChat

• 使用 Gateway WebSocket；不需要单独的 WebChat 端口/配置。

浏览器控制（可选）：

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

文档

通过入门流程后，使用以下文档获取更深入的参考。

• 从文档索引开始导航，了解 "什么在哪里"。
• 阅读架构概览，了解 Gateway + 协议模型。
• 使用完整配置参考查阅每个配置键和示例。
• 按照运行手册规范运行 Gateway。
• 了解控制面板 UI/Web 界面如何工作以及如何安全地公开它们。
• 了解通过 SSH 隧道或尾网的远程访问。
• 跟随入门向导流程进行引导式配置。
• 通过 Webhook 界面接入外部触发器。
• 设置 Gmail Pub/Sub 触发器。
• 了解 macOS 菜单栏配套应用详情。
• 平台指南：Windows（WSL2）、Linux、macOS、iOS、Android
• 通过故障排除指南调试常见问题。
• 在公开任何内容之前查阅安全指南。

高级文档（发现 + 控制）

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

运维与故障排除

• 健康检查
• Gateway 锁
• 后台进程
• 浏览器故障排除（Linux）
• 日志

深入解读

• 智能体循环
• 在线状态
• TypeBox schema
• RPC 适配器
• 队列

工作区与技能

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

平台内部

• macOS 开发环境设置
• macOS 菜单栏
• macOS 语音唤醒
• iOS 节点
• Android 节点
• Windows（WSL2）
• Linux 应用

邮件钩子（Gmail）

• docs.openclaw.ai/gmail-pubsub

配置文件说明

所有配置存储在 ~/.openclaw/ 目录下：

~/.openclaw/
├── openclaw.json          # 主配置文件
├── workspace/             # 工作区（AI 的文件空间）
├── sessions/              # 会话历史记录
├── credentials/           # OAuth 凭证
└── logs/                  # 日志文件

Windows 路径：%USERPROFILE%\.openclaw\

查看和修改配置：

openclaw config get                        # 查看所有配置
openclaw config get agents.defaults.model  # 查看某个配置项
openclaw config set gateway.port 18789     # 修改配置

守护进程管理

安装守护进程后，OpenClaw 会在后台自动运行，开机自启。

openclaw onboard --install-daemon  # 安装守护进程
openclaw gateway status            # 查看状态

| 操作 | macOS | Linux | | ------------ | ------------------------------------------------------------------------------- | ------------------------------------------- | | 查看状态 | launchctl list \| grep openclaw | systemctl --user status openclaw-gateway | | 停止 | launchctl bootout gui/$UID/ai.openclaw.gateway | systemctl --user stop openclaw-gateway | | 启动 | launchctl bootstrap gui/$UID ~/Library/LaunchAgents/ai.openclaw.gateway.plist | systemctl --user start openclaw-gateway | | 重启 | 先停止再启动 | systemctl --user restart openclaw-gateway | | 查看日志 | cat /tmp/openclaw/*.log | journalctl --user -u openclaw-gateway |

Linux 保持后台运行（SSH 退出后不停止）：sudo loginctl enable-linger $USER

Windows 用户注意：如果 gateway install 失败（提示 schtasks 不可用），可使用 gateway start 启动后台进程，或使用 Docker 部署方案。

常见问题排查

原因：OpenClaw 的安全机制要求设备配对或 Token 验证。

# token mismatch — 用 dashboard 命令自动带 Token 打开
openclaw dashboard

# pairing required — 批准设备
openclaw devices list           # 查看待批准设备 ID
openclaw devices approve <ID>   # 批准该设备

检查 baseURL 是否正确：

openclaw config get auth.openai.baseURL
# 应为 http://localhost:11434/v1

# Docker 用户应使用
openclaw config set auth.openai.baseURL http://host.docker.internal:11434/v1

可能系统上残留了英文原版 openclaw，其优先级高于汉化版。

npm uninstall -g openclaw
npm install -g chinese-openclaw@latest

# 验证
openclaw status

默认只监听本机，需要改为局域网监听：

openclaw config set gateway.bind lan
openclaw gateway restart

然后通过 http://你的电脑IP:18789 访问。

更多问题请运行 openclaw doctor 进行诊断，或查看 故障排除指南。

常用命令速查

| 命令 | 说明 | | ----------------------------------- | ------------------------- | | openclaw | 启动 OpenClaw（前台模式） | | openclaw onboard | 运行初始化向导 | | openclaw onboard --install-daemon | 初始化 + 安装守护进程 | | openclaw dashboard | 打开网页控制台 | | openclaw status | 查看运行状态 | | openclaw doctor | 诊断检查 | | openclaw config get | 查看配置 | | openclaw config set KEY VALUE | 修改配置 | | openclaw gateway start | 启动网关 | | openclaw gateway stop | 停止网关 | | openclaw gateway restart | 重启网关 | | openclaw channels list | 查看通道列表 | | openclaw skills list | 查看技能列表 | | openclaw --help | 查看帮助 | | openclaw --version | 查看版本 |

Molty

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

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

关于本项目

本项目是 OpenClaw 的完整中文汉化版本，由 @tuwawa-liu 维护。

• npm 包名：chinese-openclaw
• GitHub 仓库：tuwawa-liu/OpenClaw-zh

汉化内容包括：

• 用户界面（Web UI、CLI 输出）
• 全部文档（350+ 文档文件）
• README、CONTRIBUTING、SECURITY、VISION 等项目文件
• 所有运行时错误消息和提示文本

上游项目：openclaw/openclaw

社区

参见 CONTRIBUTING.md 了解指南、维护者信息和提交 PR 的方式。