← Back to Skills Marketplace
vincentlau2046-sudo

China Localization

by vincentlau2046-sudo · GitHub ↗ · v2.0.0 · MIT-0
cross-platform ⚠ suspicious
402
Downloads
0
Stars
1
Active Installs
2
Versions
Install in OpenClaw
/install china-localization
Description
中国本地化工具包:中文搜索、天气查询、飞书/微信/钉钉集成。让中国用户零门槛使用 OpenClaw。
README (SKILL.md)

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!

Usage Guidance
This package generally does what it says (language pack + optional Chinese platform integrations) but has several red flags you should address before installing: 1) Inconsistent metadata — the registry entry listed no required env vars but _meta.json and SKILL.md require many credentials. Treat the listed credentials as real requirements until confirmed. 2) Credential handling — SKILL.md tells you to append many secrets to ~/.openclaw/.env. Prefer storing only the minimal credentials you need, use least privilege, and avoid placing high-value keys (Alipay private key, platform app secrets) in a shared/global file if possible. 3) Verify the source — the clone URL/author is a third party; inspect the GitHub repo yourself (commit history, owner identity) before cloning. 4) Network calls — the code will POST to https://api.tavily.com/search (requires TAVILY_API_KEY). Confirm that 'Tavily' is a trusted service for you. 5) Functional mismatches — SKILL.md promises a CLI and '已通过安全扫描' which are not supported by package.json and the provided scan metadata; and config contains a sandbox-default bug for Alipay. 6) Test in a sandbox — run in an isolated environment and only enable optional integrations you actually use. If you need help verifying the remote repo or specific lines of code, provide the repository URL or a copy and I can point to exact lines to inspect.
Capability Analysis
Type: OpenClaw Skill Name: china-localization Version: 2.0.0 The China Localization Pack v2 is a legitimate utility bundle providing Chinese language support and integrations for services like Baidu, Feishu, and Tavily. The code follows security best practices by using environment variables for sensitive API keys (config.ts) and lacks any signs of data exfiltration, malicious execution, or prompt injection. Most features are currently implemented as safe wrappers for external APIs or mock data for development.
Capability Tags
requires-wallet
Capability Assessment
Purpose & Capability
Name/description (Chinese localization, Baidu/Tavily/Feishu/WeChat/Alipay integrations) match the code which implements a language pack, simulated Baidu search, Tavily API calls, and integration config. However registry metadata listed no required environment variables while _meta.json and SKILL.md declare many required/optional credentials (TAVILY_API_KEY, FEISHU_*, WECHAT_*, DINGTALK_WEBHOOK, AMAP_API_KEY, ALIPAY_*). Also SKILL.md claims an after-install CLI (china-localization --help) but package.json provides no bin/script — an inconsistency between claimed user surface and included files.
Instruction Scope
Runtime instructions tell the user to clone a GitHub repo and echo secrets into ~/.openclaw/.env (modifying global agent config). The code reads many environment variables and will POST to an external Tavily API URL. SKILL.md instructs storing multiple high-sensitivity credentials in a single OpenClaw env file which increases blast radius. The Baidu search module is mocked (no real scraping) while Tavily calls are real — SKILL.md and code are not fully aligned about which network calls actually occur.
Install Mechanism
There is no formal install spec in the registry (instruction-only), but files are included in the bundle. SKILL.md suggests cloning from a third-party GitHub repo (vincentlau2046-sudo) — relying on an external repo is a supply-chain risk if users follow those instructions. npm install is called (package.json has only dev-type deps: typescript/ts-node/@types/node) — no postinstall scripts present, lowering immediate install risk.
Credentials
_meta.json and SKILL.md request a large set of credentials spanning search (TAVILY_API_KEY), messaging platforms (FEISHU, WECHAT, DINGTALK), maps (AMAP_API_KEY) and payments (ALIPAY_*). While these align with optional integrations, the quantity is high and the registry-level metadata earlier listed none — a contradictory record. The instructions encourage appending secrets to ~/.openclaw/.env (global storage). Also config.ts has a bug: ALIPAY_CONFIG.sandbox defaults to true unconditionally (process.env.ALIPAY_SANDBOX === 'true' || true), indicating sloppy code.
Persistence & Privilege
The skill does not request 'always: true' and does not appear to modify other skills' configurations. It instructs the user to add env vars to ~/.openclaw/.env (user-level persistent config) — normal for integrated services but increases credential exposure. The skill bundle contains code (not just instructions) but no elevated platform privileges are requested.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install china-localization
  3. After installation, invoke the skill by name or use /china-localization
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v2.0.0
china-localization v2.0.0 - 安全重构,所有敏感信息和 API keys 采用环境变量配置,符合 ClawHub 安全规范 - 新增百度搜索引擎,默认中文优先,增强本地化体验 - 文档全面升级,涵盖环境变量声明、安装、用法示例、错误处理和常见问题 - 明确声明必需和可选集成(飞书、微信、钉钉、高德地图、支付宝),凭证管理更规范 - 停用硬编码、移除旧配置方法,全面采用最佳安全实践
v1.0.0
China Localization Pack 1.0.0 - Initial release providing a toolkit for Chinese localization. - Features Chinese search (Tavily), weather queries (wttr.in, Tavily), and integration with Feishu, WeChat, DingTalk, and Amap. - Includes example shell commands for setup, configuration, and common use cases. - No npm installation required; all functionality works via curl API calls. - Supports error handling and quick-start guides for each service.
Metadata
Slug china-localization
Version 2.0.0
License MIT-0
All-time Installs 1
Active Installs 1
Total Versions 2
Frequently Asked Questions

What is China Localization?

中国本地化工具包:中文搜索、天气查询、飞书/微信/钉钉集成。让中国用户零门槛使用 OpenClaw。 It is an AI Agent Skill for Claude Code / OpenClaw, with 402 downloads so far.

How do I install China Localization?

Run "/install china-localization" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is China Localization free?

Yes, China Localization is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does China Localization support?

China Localization is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created China Localization?

It is built and maintained by vincentlau2046-sudo (@vincentlau2046-sudo); the current version is v2.0.0.

💬 Comments