China Localization

中国本地化工具包：中文搜索、天气查询、飞书/微信/钉钉集成。让中国用户零门槛使用 OpenClaw。

China Localization Pack v2 - 中国本地化包（安全优化版）

全中文界面 + 本地服务集成 + 百度搜索支持

🛡️ 安全认证: 符合 ClawHub 安全规范，无硬编码敏感信息

🌟 功能特性

• 🀄 中文语言包 - 全中文界面和提示
• 🔍 百度搜索集成 - 专为中国用户优化的中文搜索
• 📅 飞书集成 - 日历/任务/文档/会议
• 🌤️ 本地天气 - 中文天气查询
• 💬 微信/钉钉集成 - 消息推送（可选）
• 🗺️ 高德地图 - 地理服务（可选）
• 💳 支付宝集成 - 支付服务（可选）

🔒 安全特性

• ✅ 无硬编码 API keys - 所有敏感信息通过环境变量配置
• ✅ 符合 ClawHub 安全规范 - 已通过安全扫描
• ✅ 明确的凭证声明 - _meta.json 中声明所有必需和可选凭证
• ✅ 环境变量驱动 - 安全的配置管理方式

📥 安装

bash

# 克隆到 dev-skills 目录（开发中版本）
git clone https://github.com/vincentlau2046-sudo/china-localization.git /home/Vincent/.openclaw/workspace/dev-skills/china-localization-v2

# 安装依赖
cd /home/Vincent/.openclaw/workspace/dev-skills/china-localization-v2
npm install

⚙️ 配置

环境变量配置

创建 .env 文件或设置环境变量：

bash

# 必需的凭证
TAVILY_API_KEY=tvly-your-api-key

# 可选的本地服务集成
FEISHU_ENABLED=true
FEISHU_APP_ID=cli_xxxxx
FEISHU_APP_SECRET=xxxxx

WECHAT_ENABLED=true
WECHAT_APP_ID=wx_xxxxx
WECHAT_APP_SECRET=xxxxx

DINGTALK_ENABLED=true
DINGTALK_WEBHOOK=https://oapi.dingtalk.com/robot/send?access_token=xxxxx

AMAP_ENABLED=true
AMAP_API_KEY=xxxxx

ALIPAY_ENABLED=true
ALIPAY_APP_ID=xxxxx
ALIPAY_PRIVATE_KEY=xxxxx
ALIPAY_PUBLIC_KEY=xxxxx
ALIPAY_SANDBOX=true

在 OpenClaw 中使用

将环境变量添加到 OpenClaw 配置中：

bash

# 编辑 ~/.openclaw/.env 文件
echo "TAVILY_API_KEY=tvly-your-api-key" >> ~/.openclaw/.env
echo "FEISHU_ENABLED=true" >> ~/.openclaw/.env
# ... 添加其他需要的环境变量

🚀 用法

基础使用

typescript

import ChinaLocalization from './china-localization';

const local = new ChinaLocalization();

// 设置语言（默认为中文）
local.setLanguage('zh-CN');

// 获取飞书日历
const events = await local.getCalendarEvents();

// 获取飞书任务
const tasks = await local.getTasks();

// 中文搜索（默认使用百度搜索）
const results = await local.search('AI 新闻');

// 使用 Tavily 搜索
const tavilyResults = await local.search('AI 新闻', { engine: 'tavily' });

// 查询天气
const weather = await local.getWeather('深圳');

在 OpenClaw 中使用

bash

# 安装后自动可用（需要正确配置环境变量）
china-localization --help

🔍 搜索引擎对比

引擎	优势	适用场景
百度搜索	中文内容覆盖全面，本土化强	国内政策、中文社区、国产技术
Tavily	英文内容质量高，技术文档丰富	国际资讯、技术论文、架构分析
微信搜索	微信生态内容	公众号文章、小程序内容

📊 输出示例

飞书日历

markdown

## 📅 今日安排
- **10:00-11:00** 团队周会 @ 会议室
- **14:00-15:00** 产品评审

飞书任务

markdown

## ✅ 待办事项
- ⬜ 🔴 完成代码审查 (截止：today)
- ⬜ 🟡 准备周报 (截止：tomorrow)

天气查询

markdown

## 🌤️ 深圳天气
- **温度**: 25°C
- **天气**: 晴
- **湿度**: 60%
- **建议**: 天气不错，适合出行，阳光较强，注意防晒

百度搜索结果

markdown

## 🔍 AI 新闻 (百度搜索)

1. **【AI 新闻】人工智能最新进展 - 百度**
   - 内容: 这是关于 "AI 新闻" 的百度搜索结果...
   - [查看详情](https://www.baidu.com/s?wd=AI%20%E6%96%B0%E9%97%BB)

2. **【AI 新闻】大模型技术突破 - 百度**
   - 内容: 最新的人工智能大模型技术突破...
   - [查看详情](https://www.baidu.com/s?wd=AI%20%E6%96%B0%E9%97%BB)

📦 依赖

• Node.js 18+
• Tavily Search API (必需)
• 飞书开放平台（可选）
• 微信开放平台（可选）
• 钉钉开放平台（可选）
• 高德地图 API（可选）
• 支付宝开放平台（可选）

🛡️ 错误处理

• 网络失败：中文错误提示 + 重试建议
• 权限不足：引导用户授权 + 配置指南
• API 失败：友好提示 + 调试信息
• 配置缺失：明确的环境变量设置指引

📈 版本历史

• v2.0.0: 安全优化版，集成百度搜索，符合 ClawHub 规范
• v1.0.0: 初始版本（存在安全问题）

❓ 常见问题

Q: 如何获取飞书 API 权限？

A: 访问 https://open.feishu.cn/app 创建应用，申请权限。

Q: 百度搜索和 Tavily 搜索有什么区别？

A: 百度搜索更适合中文内容和国内资讯，Tavily 搜索更适合英文技术内容和国际资讯。

Q: 可以只使用语言包吗？

A: 可以，语言包是独立的模块，不需要配置任何 API keys。

Q: 为什么需要设置这么多环境变量？

A: 这是为了安全考虑。所有敏感信息都通过环境变量配置，避免在代码中硬编码。

🤝 贡献

欢迎提交 Issue 和 Pull Request！

📄 许可证

MIT License

⭐ 如果觉得有用，请给个 Star！

这个技能让中国用户能够零门槛使用 OpenClaw，如果你觉得有用，请在 ClawHub 上给个 Star！