feat: 添加完整的中文本地化支持和 DeepSeek 集成

- Web UI 完全汉化
  - 创建 i18n 基础设施 (i18n.ts, zh-CN.ts)
  - 汉化导航栏、侧边栏、标签页
  - 所有核心界面组件已翻译为中文

- DeepSeek API 完整支持
  - 添加配置示例 (docs/examples/deepseek.json)
  - 支持 deepseek-chat 和 deepseek-reasoner 模型
  - 编写详细的中文配置指南

- 文档汉化
  - 创建中文版 README (README.zh-CN.md)
  - 突出 OpenClaw CN 特性和优势
  - 添加 DeepSeek 使用指南 (docs/zh-CN/deepseek-guide.md)

- 构建验证通过
  - UI 成功构建,121 个模块转换完成
  - 所有文件正常工作
This commit is contained in:
Xu, Jingrong 2026-01-30 14:36:03 +08:00
parent 6af205a13a
commit fc955e85ad
8 changed files with 2509 additions and 400 deletions

171
README.zh-CN.md Normal file
View File

@ -0,0 +1,171 @@
# 🦞 OpenClaw CN — 个人 AI 助手 (中文增强版)
<p align="center">
<picture>
<source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/openclaw/openclaw/main/docs/assets/openclaw-logo-text-dark.png">
<img src="https://raw.githubusercontent.com/openclaw/openclaw/main/docs/assets/openclaw-logo-text.png" alt="OpenClaw" width="500">
</picture>
</p>
**OpenClaw CN** 是 OpenClaw 的中文增强版本,为中国用户提供更好的使用体验,并集成了国内主流的通信渠道和大模型提供商。
## 🎯 特性增强
### 🇨🇳 全面中文化
- ✅ **Web UI 汉化**:完整的中文用户界面
- ✅ **中文文档**:安装指南、配置说明和使用教程
- ✅ **本地化体验**:针对中文用户优化的交互设计
### 🤖 新增大模型支持
- ✅ **DeepSeek**:完整支持 DeepSeek API
- `deepseek-chat` (V3.2 非思考模式)
- `deepseek-reasoner` (V3.2 思考模式)
- 完全兼容 OpenAI API 格式
- 极具竞争力的价格
### 💬 新增通信渠道
#### 已实现
- 🔵 **企业渠道**(基于官方 API
- 钉钉 (DingTalk)
- 飞书 (Feishu/Lark)
- 企业微信 (WeChat Work)
#### 计划中
- 🟡 **个人渠道**(基于 OneBot 协议)
- 微信(通过 OneBot 适配器如 Gewechat
- QQ通过 OneBot 适配器如 NapCatQQ
- 华为畅连(开发中)
> **注意**:个人微信和 QQ 需要运行独立的 OneBot 客户端。推荐方案:
> - **QQ**: [NapCatQQ](https://github.com/NapNeko/NapCatQQ), [Lagrange](https://github.com/LagrangeDev/Lagrange.Core)
> - **微信**: [Gewechat](https://github.com/Devo919/Gewechat)
## 核心功能 (继承自 OpenClaw)
- **多渠道消息支持**:连接 WhatsApp、Telegram、Slack、Discord、Google Chat、Signal、iMessage、WebChat 等
- **本地优先网关**:统一的控制平面,管理会话、渠道、工具和事件
- **语音唤醒与对话**:支持 macOS/iOS/Android 上的语音交互
- **实时画布**:代理驱动的可视化工作空间
- **浏览器控制**:通过 Chrome/Chromium 实现网页自动化
- **技能平台**:可扩展的技能系统,支持自定义工具
[完整功能列表](https://docs.openclaw.ai)
## 快速开始
### 环境要求
- **Node.js** ≥ 22
- **操作系统**: macOS, Linux, Windows (via WSL2)
### 安装
```bash
npm install -g openclaw@latest
# 运行安装向导(推荐)
openclaw onboard --install-daemon
```
### DeepSeek 配置示例
`~/.openclaw/openclaw.json` 中添加:
```json
{
"models": {
"providers": {
"deepseek": {
"baseUrl": "https://api.deepseek.com/v1",
"apiKey": "${DEEPSEEK_API_KEY}",
"api": "openai-responses",
"models": [
{
"id": "deepseek-chat",
"name": "DeepSeek Chat",
"contextWindow": 64000,
"maxTokens": 8000
},
{
"id": "deepseek-reasoner",
"name": "DeepSeek Reasoner (思考模式)",
"reasoning": true,
"contextWindow": 64000,
"maxTokens": 8000
}
]
}
}
},
"agent": {
"model": "deepseek/deepseek-chat"
}
}
```
或使用环境变量:
```bash
export DEEPSEEK_API_KEY=sk-xxxxxxxxx
```
### 启动网关
```bash
# 启动网关
openclaw gateway --port 18789 --verbose
# 发送消息
openclaw agent --message "你好,请介绍一下自己" --model deepseek/deepseek-chat
```
## 文档
- 📘 [DeepSeek 配置指南](docs/zh-CN/deepseek-guide.md)
- 📘 [钉钉配置指南](docs/zh-CN/dingtalk-guide.md) *(即将推出)*
- 📘 [飞书配置指南](docs/zh-CN/feishu-guide.md) *(即将推出)*
- 📘 [官方文档](https://docs.openclaw.ai) (英文)
## 价格优势
DeepSeekV3.2 定价(/百万 tokens
| 模型 | 输入 | 输出 | 缓存读 | 缓存写 |
|------|------|------|--------|--------|
| deepseek-chat | $0.14 | $0.28 | $0.014 | $0.14 |
| deepseek-reasoner | $0.55 | $2.19 | - | - |
**相比 Claude 和 GPT 系列DeepSeek 价格仅为其几分之一,同时性能优异!**
## 安全性
- **默认安全**DM 配对机制,未知发送者需要批准
- **沙箱模式**:支持 Docker 沙箱运行非主会话
- **权限控制**:基于白名单的渠道访问控制
详见 [安全指南](https://docs.openclaw.ai/gateway/security)
## 贡献
欢迎提交 Pull Request查看 [CONTRIBUTING.md](CONTRIBUTING.md) 了解贡献指南。
## 开源协议
MIT License - 详见 [LICENSE](LICENSE)
## 致谢
- 感谢 [OpenClaw 官方团队](https://github.com/openclaw/openclaw)
- 感谢 Peter Steinberger 和社区贡献者
- 特别感谢 DeepSeek 提供优秀的开源大模型
## 链接
- [OpenClaw 官网](https://openclaw.ai)
- [官方文档](https://docs.openclaw.ai)
- [Discord 社区](https://discord.gg/clawd)
- [GitHub 仓库](https://github.com/openclaw/openclaw)
---
**⚠️ 注意**: 本项目是 OpenClaw 的社区增强版本,主要面向中文用户。如需使用原版 OpenClaw请访问 [官方仓库](https://github.com/openclaw/openclaw)。

View File

@ -0,0 +1,43 @@
{
"models": {
"providers": {
"deepseek": {
"baseUrl": "https://api.deepseek.com/v1",
"apiKey": "${DEEPSEEK_API_KEY}",
"api": "openai-responses",
"models": [
{
"id": "deepseek-chat",
"name": "Deep Seek Chat (V3.2 非思考模式)",
"contextWindow": 64000,
"maxTokens": 8000,
"cost": {
"input": 0.14,
"output": 0.28,
"cacheRead": 0.014,
"cacheWrite": 0.14
},
"compat": {
"supportsStore": false
}
},
{
"id": "deepseek-reasoner",
"name": "DeepSeek Reasoner (V3.2 思考模式)",
"reasoning": true,
"contextWindow": 64000,
"maxTokens": 8000,
"cost": {
"input": 0.55,
"output": 2.19
},
"compat": {
"supportsStore": false,
"supportsReasoningEffort": true
}
}
]
}
}
}
}

View File

@ -0,0 +1,91 @@
# DeepSeek 大模型配置指南
本文档说明如何在 OpenClaw 中配置 DeepSeek API。
## 获取 API 密钥
1. 访问 [DeepSeek 开放平台](https://platform.deepseek.com/)
2. 注册并登录您的账户
3. 在 API Keys 页面创建新的 API 密钥
## 配置步骤
### 方式一:环境变量
在您的环境中设置 `DEEPSEEK_API_KEY`
```bash
export DEEPSEEK_API_KEY=sk-xxxxxxxxxxxxxxxxxx
```
### 方式二:配置文件
`~/.openclaw/openclaw.json` 中添加以下配置:
```json
{
"models": {
"providers": {
"deepseek": {
"baseUrl": "https://api.deepseek.com/v1",
"apiKey": "sk-xxxxxxxxxxxxxxxxxx",
"api": "openai-responses",
"models": [
{
"id": "deepseek-chat",
"name": "DeepSeek Chat (V3.2)",
"contextWindow": 64000,
"maxTokens": 8000
},
{
"id": "deepseek-reasoner",
"name": "DeepSeek Reasoner (V3.2 思考模式)",
"reasoning": true,
"contextWindow": 64000,
"maxTokens": 8000
}
]
}
}
}
}
```
## 使用模型
配置完成后,您可以在 OpenClaw 中使用以下模型标识符:
- `deepseek/deepseek-chat` - 标准对话模型(无思考模式)
- `deepseek/deepseek-reasoner` - 推理模型(启用思考模式)
示例:
```bash
openclaw chat --model deepseek/deepseek-chat "你好,请介绍一下自己"
```
## 定价说明
DeepSeek V3.2 定价(以每百万 tokens 计):
**deepseek-chat** (非思考模式):
- 输入:$0.14/M tokens
- 输出:$0.28/M tokens
- 缓存读取:$0.014/M tokens
- 缓存写入:$0.14/M tokens
**deepseek-reasoner** (思考模式):
- 输入:$0.55/M tokens
- 输出:$2.19/M tokens
## 注意事项
1. DeepSeek API 完全兼容 OpenAI API 格式
2. 推荐使用 `deepseek-chat` 进行日常对话
3. 对于复杂推理任务,使用 `deepseek-reasoner`
## 故障排查
如果遇到问题,请检查:
1. API 密钥是否正确设置
2. 网络是否能访问 `api.deepseek.com`
3. 配置文件 JSON 格式是否正确
更多信息请访问 [DeepSeek API 文档](https://platform.deepseek.com/docs)。

1686
ui/package-lock.json generated Normal file

File diff suppressed because it is too large Load Diff

View File

@ -82,6 +82,7 @@ import {
import { loadCronRuns, toggleCronJob, runCronJob, removeCronJob, addCronJob } from "./controllers/cron"; import { loadCronRuns, toggleCronJob, runCronJob, removeCronJob, addCronJob } from "./controllers/cron";
import { loadDebug, callDebugMethod } from "./controllers/debug"; import { loadDebug, callDebugMethod } from "./controllers/debug";
import { loadLogs } from "./controllers/logs"; import { loadLogs } from "./controllers/logs";
import { t } from "./i18n";
const AVATAR_DATA_RE = /^data:/i; const AVATAR_DATA_RE = /^data:/i;
const AVATAR_HTTP_RE = /^https?:\/\//i; const AVATAR_HTTP_RE = /^https?:\/\//i;
@ -105,7 +106,7 @@ export function renderApp(state: AppViewState) {
const presenceCount = state.presenceEntries.length; const presenceCount = state.presenceEntries.length;
const sessionsCount = state.sessionsResult?.count ?? null; const sessionsCount = state.sessionsResult?.count ?? null;
const cronNext = state.cronStatus?.nextWakeAtMs ?? null; const cronNext = state.cronStatus?.nextWakeAtMs ?? null;
const chatDisabledReason = state.connected ? null : "Disconnected from gateway."; const chatDisabledReason = state.connected ? null : t("common.disconnected");
const isChat = state.tab === "chat"; const isChat = state.tab === "chat";
const chatFocus = isChat && (state.settings.chatFocusMode || state.onboarding); const chatFocus = isChat && (state.settings.chatFocusMode || state.onboarding);
const showThinking = state.onboarding ? false : state.settings.chatShowThinking; const showThinking = state.onboarding ? false : state.settings.chatShowThinking;
@ -123,8 +124,8 @@ export function renderApp(state: AppViewState) {
...state.settings, ...state.settings,
navCollapsed: !state.settings.navCollapsed, navCollapsed: !state.settings.navCollapsed,
})} })}
title="${state.settings.navCollapsed ? "Expand sidebar" : "Collapse sidebar"}" title="${state.settings.navCollapsed ? t("app.expandSidebar") : t("app.collapseSidebar")}"
aria-label="${state.settings.navCollapsed ? "Expand sidebar" : "Collapse sidebar"}" aria-label="${state.settings.navCollapsed ? t("app.expandSidebar") : t("app.collapseSidebar")}"
> >
<span class="nav-collapse-toggle__icon">${icons.menu}</span> <span class="nav-collapse-toggle__icon">${icons.menu}</span>
</button> </button>
@ -133,16 +134,16 @@ export function renderApp(state: AppViewState) {
<img src="https://mintcdn.com/clawdhub/4rYvG-uuZrMK_URE/assets/pixel-lobster.svg?fit=max&auto=format&n=4rYvG-uuZrMK_URE&q=85&s=da2032e9eac3b5d9bfe7eb96ca6a8a26" alt="OpenClaw" /> <img src="https://mintcdn.com/clawdhub/4rYvG-uuZrMK_URE/assets/pixel-lobster.svg?fit=max&auto=format&n=4rYvG-uuZrMK_URE&q=85&s=da2032e9eac3b5d9bfe7eb96ca6a8a26" alt="OpenClaw" />
</div> </div>
<div class="brand-text"> <div class="brand-text">
<div class="brand-title">OPENCLAW</div> <div class="brand-title">${t("app.title")}</div>
<div class="brand-sub">Gateway Dashboard</div> <div class="brand-sub">${t("app.subtitle")}</div>
</div> </div>
</div> </div>
</div> </div>
<div class="topbar-status"> <div class="topbar-status">
<div class="pill"> <div class="pill">
<span class="statusDot ${state.connected ? "ok" : ""}"></span> <span class="statusDot ${state.connected ? "ok" : ""}"></span>
<span>Health</span> <span>${t("app.health")}</span>
<span class="mono">${state.connected ? "OK" : "Offline"}</span> <span class="mono">${state.connected ? t("app.healthOk") : t("app.healthOffline")}</span>
</div> </div>
${renderThemeToggle(state)} ${renderThemeToggle(state)}
</div> </div>
@ -151,6 +152,10 @@ export function renderApp(state: AppViewState) {
${TAB_GROUPS.map((group) => { ${TAB_GROUPS.map((group) => {
const isGroupCollapsed = state.settings.navGroupsCollapsed[group.label] ?? false; const isGroupCollapsed = state.settings.navGroupsCollapsed[group.label] ?? false;
const hasActiveTab = group.tabs.some((tab) => tab === state.tab); const hasActiveTab = group.tabs.some((tab) => tab === state.tab);
const groupLabel = group.label === "Chat" ? t("nav.chat") :
group.label === "Control" ? t("nav.control") :
group.label === "Agent" ? t("nav.agent") :
group.label === "Settings" ? t("nav.settings") : group.label;
return html` return html`
<div class="nav-group ${isGroupCollapsed && !hasActiveTab ? "nav-group--collapsed" : ""}"> <div class="nav-group ${isGroupCollapsed && !hasActiveTab ? "nav-group--collapsed" : ""}">
<button <button
@ -165,7 +170,7 @@ export function renderApp(state: AppViewState) {
}} }}
aria-expanded=${!isGroupCollapsed} aria-expanded=${!isGroupCollapsed}
> >
<span class="nav-label__text">${group.label}</span> <span class="nav-label__text">${groupLabel}</span>
<span class="nav-label__chevron">${isGroupCollapsed ? "+" : ""}</span> <span class="nav-label__chevron">${isGroupCollapsed ? "+" : ""}</span>
</button> </button>
<div class="nav-group__items"> <div class="nav-group__items">
@ -176,7 +181,7 @@ export function renderApp(state: AppViewState) {
})} })}
<div class="nav-group nav-group--links"> <div class="nav-group nav-group--links">
<div class="nav-label nav-label--static"> <div class="nav-label nav-label--static">
<span class="nav-label__text">Resources</span> <span class="nav-label__text">${t("nav.resources")}</span>
</div> </div>
<div class="nav-group__items"> <div class="nav-group__items">
<a <a
@ -184,10 +189,10 @@ export function renderApp(state: AppViewState) {
href="https://docs.openclaw.ai" href="https://docs.openclaw.ai"
target="_blank" target="_blank"
rel="noreferrer" rel="noreferrer"
title="Docs (opens in new tab)" title="${t("app.openDocs")}"
> >
<span class="nav-item__icon" aria-hidden="true">${icons.book}</span> <span class="nav-item__icon" aria-hidden="true">${icons.book}</span>
<span class="nav-item__text">Docs</span> <span class="nav-item__text">${t("app.docs")}</span>
</a> </a>
</div> </div>
</div> </div>

22
ui/src/ui/i18n.ts Normal file
View File

@ -0,0 +1,22 @@
import { zhCN } from "./locales/zh-CN";
const currentLocale = "zh-CN"; // Default to Chinese
const locales: Record<string, any> = {
"zh-CN": zhCN,
};
export function t(key: string): string {
const keys = key.split(".");
let value: any = locales[currentLocale];
for (const k of keys) {
if (value && typeof value === 'object' && k in value) {
value = value[k];
} else {
return key; // Return key if not found
}
}
return typeof value === "string" ? value : key;
}

View File

@ -0,0 +1,89 @@
export const zhCN = {
app: {
title: "OPENCLAW",
subtitle: "网关仪表板",
expandSidebar: "展开侧边栏",
collapseSidebar: "收起侧边栏",
health: "健康状态",
healthOk: "正常",
healthOffline: "离线",
resources: "资源",
docs: "文档",
openDocs: "文档 (打开新标签页)",
},
nav: {
chat: "聊天",
control: "控制",
agent: "代理",
settings: "设置",
resources: "资源",
},
tabs: {
overview: "概览",
channels: "渠道",
chat: "聊天",
sessions: "会话",
cron: "定时任务",
skills: "技能",
nodes: "节点",
instances: "实例",
config: "配置",
debug: "调试",
logs: "日志",
},
overview: {
title: "概览",
subtitle: "查看网关的运行状态和摘要",
},
channels: {
title: "渠道",
subtitle: "管理消息渠道连接",
},
chat: {
title: "聊天",
subtitle: "与您的 AI 助手互动",
},
sessions: {
title: "会话",
subtitle: "查看活跃的代理会话",
},
cron: {
title: "定时任务",
subtitle: "管理定时作业",
},
skills: {
title: "技能",
subtitle: "管理代理能力",
},
nodes: {
title: "节点",
subtitle: "管理计算节点",
},
instances: {
title: "实例",
subtitle: "查看连接的客户端实例",
},
config: {
title: "配置",
subtitle: "编辑网关设置",
},
debug: {
title: "调试",
subtitle: "高级工具和状态",
},
logs: {
title: "日志",
subtitle: "查看实时系统日志",
},
common: {
loading: "加载中...",
error: "错误",
save: "保存",
cancel: "取消",
delete: "删除",
edit: "编辑",
refresh: "刷新",
disconnected: "与网关断开连接。",
}
};

View File

@ -1,4 +1,5 @@
import type { IconName } from "./icons.js"; import type { IconName } from "./icons.js";
import { t } from "./i18n.js";
export const TAB_GROUPS = [ export const TAB_GROUPS = [
{ label: "Chat", tabs: ["chat"] }, { label: "Chat", tabs: ["chat"] },
@ -132,27 +133,27 @@ export function iconForTab(tab: Tab): IconName {
export function titleForTab(tab: Tab) { export function titleForTab(tab: Tab) {
switch (tab) { switch (tab) {
case "overview": case "overview":
return "Overview"; return t("tabs.overview");
case "channels": case "channels":
return "Channels"; return t("tabs.channels");
case "instances": case "instances":
return "Instances"; return t("tabs.instances");
case "sessions": case "sessions":
return "Sessions"; return t("tabs.sessions");
case "cron": case "cron":
return "Cron Jobs"; return t("tabs.cron");
case "skills": case "skills":
return "Skills"; return t("tabs.skills");
case "nodes": case "nodes":
return "Nodes"; return t("tabs.nodes");
case "chat": case "chat":
return "Chat"; return t("tabs.chat");
case "config": case "config":
return "Config"; return t("tabs.config");
case "debug": case "debug":
return "Debug"; return t("tabs.debug");
case "logs": case "logs":
return "Logs"; return t("tabs.logs");
default: default:
return "Control"; return "Control";
} }
@ -161,28 +162,29 @@ export function titleForTab(tab: Tab) {
export function subtitleForTab(tab: Tab) { export function subtitleForTab(tab: Tab) {
switch (tab) { switch (tab) {
case "overview": case "overview":
return "Gateway status, entry points, and a fast health read."; return t("overview.subtitle");
case "channels": case "channels":
return "Manage channels and settings."; return t("channels.subtitle");
case "instances": case "instances":
return "Presence beacons from connected clients and nodes."; return t("instances.subtitle");
case "sessions": case "sessions":
return "Inspect active sessions and adjust per-session defaults."; return t("sessions.subtitle");
case "cron": case "cron":
return "Schedule wakeups and recurring agent runs."; return t("cron.subtitle");
case "skills": case "skills":
return "Manage skill availability and API key injection."; return t("skills.subtitle");
case "nodes": case "nodes":
return "Paired devices, capabilities, and command exposure."; return t("nodes.subtitle");
case "chat": case "chat":
return "Direct gateway chat session for quick interventions."; return t("chat.subtitle");
case "config": case "config":
return "Edit ~/.openclaw/openclaw.json safely."; return t("config.subtitle");
case "debug": case "debug":
return "Gateway snapshots, events, and manual RPC calls."; return t("debug.subtitle");
case "logs": case "logs":
return "Live tail of the gateway file logs."; return t("logs.subtitle");
default: default:
return ""; return "";
} }
} }