China Localization

Other

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

Install

openclaw skills install china-localization

China Localization Pack v2 - 中国本地化包(安全优化版)

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

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

🌟 功能特性

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

🔒 安全特性

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

📥 安装

# 克隆到 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 文件或设置环境变量:

# 必需的凭证
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 配置中:

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

🚀 用法

基础使用

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 中使用

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

🔍 搜索引擎对比

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

📊 输出示例

飞书日历

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

飞书任务

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

天气查询

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

百度搜索结果

## 🔍 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!