1. 为什么中国开发者需要一个专属 Skills 包Openclaw 这类 Agent 框架最迷人的地方是它能自己学技能再干活。但真跑起来你会发现一个尴尬它默认的提示词和工具链是给英文环境设计的。你让它写段 Python它给你print(你好)却忘了# -*- coding: utf-8 -*-你让它装个包它默认走 PyPI 官方源在国内服务器上转圈转到超时你让它输出代码它给你个...省略号让你自己补全。这些坑我一个个踩过。后来想明白了与其每次对话都手动补一句用国内镜像输出完整代码不如把这些高频约束封装成 Skills让 Openclaw 在需要时自动加载。这就是中国开发者必备 Skills的由来——它本质是一组结构化的中文提示词 配置片段覆盖编码规范、镜像源、依赖管理、部署配置等场景。这篇要交付的东西很具体一套可复制的 Skills 目录结构、一份config.toml骨架、TaoToken 统一 Key 的接入片段以及在腾讯云轻量服务器上跑通本地 Skills 调用链路的完整验证流程。适合已经在用 Openclaw、但被中文环境和依赖安装折磨过的开发者。如果你还没装 Openclaw建议先把基础环境跑起来再回来看这篇。2. 前置准备腾讯云服务器与 TaoToken 统一 Key2.1 服务器侧轻量应用服务器 镜像源加速服务器这块腾讯云轻量应用服务器对个人开发者比较友好2C2G4M 的配置跑 Openclaw 加几个 Skills 完全够用。系统模板里直接有 Openclaw 应用镜像重装时选它就行省去手动装依赖的麻烦。地域建议选广州或上海国内访问延迟低。重装完成后第一件事是换镜像源。腾讯云内网访问自家镜像站速度很快pip 和 npm 都建议切过去# pip 永久换源腾讯云内网 pip config set global.index-url https://mirrors.cloud.tencent.com/pypi/simple/ pip config set global.trusted-host mirrors.cloud.tencent.com # npm 换源 npm config set registry https://mirrors.cloud.tencent.com/npm/ # 验证 pip config list npm config get registry换完之后装依赖的速度差别很明显原来装个requests要等十几秒现在基本秒回。这一步不做后面 Skills 里配的镜像源提示词也救不了你——因为 Skills 是给 Agent 看的实际执行还是走系统配置。2.2 Key 侧TaoToken 统一通道Openclaw 支持多种模型后端但如果你想让 Skills 调用链路稳定建议用统一的 Key 通道避免每个 Skill 配一套凭证。TaoToken 提供的就是这种统一入口一个 Key 走通对话、编码、Agent 场景。先去控制台创建 API Key# 控制台地址创建 Key https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentconsole创建后拿到形如sk-xxxxxxxx的 Key先存到环境变量里别硬编码进配置文件echo export TAOTOKEN_API_KEYsk-你的实际Key ~/.bashrc source ~/.bashrc echo $TAOTOKEN_API_KEYAPI 基础地址是https://taotoken.net/api这个地址在后面的config.toml里会用到。注意 API 地址不带任何查询参数保持干净。3. 可复制配置Skills 目录结构与 config.toml 骨架3.1 Skills 目录结构Openclaw 的 Skills 本质是带元信息的提示词文件。我建议按下面这个结构组织每个 Skill 一个目录里面放SKILL.md描述文件~/.openclaw/skills/ ├── chinese-encoding/ │ └── SKILL.md ├── complete-code/ │ └── SKILL.md ├── mirror-sources/ │ └── SKILL.md ├── dependency-mgmt/ │ └── SKILL.md ├── debug-chinese/ │ └── SKILL.md └── deploy-config/ └── SKILL.md每个SKILL.md用 YAML front matter 声明元信息正文写提示词。以mirror-sources为例--- name: mirror-sources description: 提供国内软件包镜像源加速 pip/npm/docker 下载 trigger: 安装依赖、下载包、配置包管理器时 --- ## 中文提示词 请优先推荐和使用国内镜像源来加速包管理和依赖安装避免因网络问题导致的下载失败。 ## 常用镜像源 - pip 腾讯云: https://mirrors.cloud.tencent.com/pypi/simple/ - pip 清华: https://pypi.tuna.tsinghua.edu.cn/simple/ - npm 腾讯云: https://mirrors.cloud.tencent.com/npm/ - npm 淘宝: https://registry.npmmirror.com ## 使用规则 1. 检测到 pip install 时自动追加 -i 参数指向腾讯云源 2. 检测到 npm install 时先检查 registry 配置 3. 企业内网环境需额外确认是否有私有源chinese-encoding这个 Skill 解决的是乱码问题提示词里明确要求 Python 文件头部加编码声明、字符串统一 UTF-8、读写文件显式指定encodingutf-8。complete-code则强制 Agent 输出可运行代码禁止用省略号代替实现。3.2 config.toml 骨架Openclaw 的主配置在~/.openclaw/config.toml。下面这份骨架把 Skills 目录、TaoToken 通道、模型参数都串起来了[agent] name china-dev-agent skills_dir ~/.openclaw/skills auto_load_skills true [provider.taotoken] type openai-compatible base_url https://taotoken.net/api api_key_env TAOTOKEN_API_KEY default_model claude-sonnet-4-5 [provider.taotoken.params] temperature 0.3 max_tokens 8192 timeout 120 [skills] enabled [ chinese-encoding, complete-code, mirror-sources, dependency-mgmt, debug-chinese, deploy-config ] priority trigger-based [daemon] log_level info log_file ~/.openclaw/logs/agent.log几个关键点api_key_env指向环境变量而不是明文避免 Key 泄露temperature设 0.3 是因为编码和配置类任务需要稳定输出太高容易飘priority trigger-based让 Skills 按触发词加载而不是全部塞进上下文浪费 token。4. 启动验证跑通本地 Skills 调用链路4.1 启动 daemon 并检查状态配置写好后先让 daemon 在后台常驻。服务器环境用loginctl开启 linger避免 SSH 断开后进程被杀loginctl enable-linger $(whoami) export XDG_RUNTIME_DIR/run/user/$(id -u) clawdbot daemon install clawdbot daemon start clawdbot daemon statusstatus返回active (running)就说明起来了。如果显示inactive先看日志tail -n 50 ~/.openclaw/logs/agent.log4.2 验证 Skills 加载用一个具体任务验证 Skills 是否生效。我试过让 Agent 装一个包并写段中文注释的代码观察它是否自动走镜像源、是否加了编码声明clawdbot run 帮我写一个读取 CSV 文件并统计行数的 Python 脚本需要中文注释预期结果里应该出现文件头有# -*- coding: utf-8 -*-、open()调用带encodingutf-8、注释是中文。如果它输出的是英文注释或者没加编码声明说明chinese-encoding和complete-code没被触发。再验证镜像源 Skillclawdbot run 在当前环境安装 pandas 并告诉我用了哪个源正常输出会提到mirrors.cloud.tencent.com。如果它说走的是pypi.org检查mirror-sources/SKILL.md的trigger字段是否匹配。4.3 验证 TaoToken 通道单独测一下 Key 通道是否通curl -s https://taotoken.net/api/v1/models \ -H Authorization: Bearer $TAOTOKEN_API_KEY | head -c 500返回模型列表 JSON 就说明 Key 有效。如果返回 401检查环境变量是否在当前 shell 生效返回 404 则确认base_url没写错末尾不要多加/v1Openclaw 会自己拼。5. 本篇常见报错排查5.1 Skills 不生效trigger 字段不匹配最常见的问题是 Skill 文件写了但 Agent 不加载。先确认目录结构对不对ls -R ~/.openclaw/skills/每个 Skill 必须是独立目录里面是SKILL.md不能直接放一个mirror-sources.md在根目录。然后检查 front matter 的trigger是否覆盖了你的实际用词。比如你问装个库但 trigger 写的是安装依赖就可能匹配不上。把 trigger 写宽一点用逗号分隔多个关键词。5.2 依赖安装超时镜像源没生效如果pip install还是慢先确认系统级配置pip config list | grep index-url没输出说明没配成功。另外注意Skills 里的镜像源提示词是给 Agent 看的建议Agent 不一定每次都执行。稳妥做法是系统级配置 Skill 提示词双保险。npm 同理npm config get registry要返回腾讯云或淘宝地址。5.3 daemon 启动失败端口占用或权限问题clawdbot daemon start报错时先看是不是端口被占ss -tlnp | grep clawdbot如果端口被别的进程占了改config.toml里的端口配置。权限问题多见于用 root 装完又用普通用户启动导致~/.openclaw目录属主不对chown -R $(whoami):$(whoami) ~/.openclaw5.4 TaoToken 返回 401/403先确认 Key 没多空格echo [$TAOTOKEN_API_KEY]方括号里如果首尾有空格说明复制时带进去了。重新 export 一次。另外确认config.toml里api_key_env拼写和环境变量名完全一致大小写敏感。5.5 中文乱码编码 Skill 未触发Agent 输出的代码里中文变问号检查chinese-encoding/SKILL.md是否在enabled列表里。另外 Python 3 默认 UTF-8但读文件时如果系统 locale 是POSIX仍可能出问题。在服务器上设一下export LANGen_US.UTF-8 export LC_ALLen_US.UTF-8写进~/.bashrc持久化。6. 把 Key 通道和 Skills 串成日常 workflow跑通之后日常用法就顺了。我的习惯是新项目先在服务器上建好目录把~/.openclaw/skills软链过去这样 Skills 跟着项目走。然后通过 TaoToken 的统一 Key 调用模型不用每个项目配一套凭证。如果你主要做长期编码和 Agent 任务建议看下 Coding Plan它针对高频调用场景做了额度优化https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentcoding-plan需要管理多个 Key 或查看用量去 API Keys 页面https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentapi-keys接入细节和参数说明在文档里https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentdoc想先试试模型对话效果不写代码直接聊https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentmodel-chat最后说个实际经验Skills 不用一次写全十个先把你最烦的三个场景封装起来——我的是编码声明、完整代码输出、镜像源。跑一周看哪些 trigger 没命中再补提示词。这套东西的价值不在于写得多漂亮而在于让 Agent 少问你几句用哪个源要不要加编码声明把重复沟通省下来。
