必须自行开发skills插件以实现钉钉待办同步等定制流程，前提是openclaw版本≥v2026.3.31、uid一致、docker权限正确；插件需继承skillbase、类名以sync等动词结尾，并在skills_config.yaml中注册启用。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你想让OpenClaw自动完成特定业务流程，比如从钉钉群抓取待办、解析Excel中的审批节点、调用内部API触发工单创建，但官方Skills库不支持——这时候必须自己开发Skills插件。这一步绕不开，没有现成模板可套，必须理解Gateway与Agent间的通信契约。
确认开发环境与权限边界
打开终端，执行openhands-cli --version，确认输出中包含openclaw-v2026.3.31或更高版本。低于此版本的Gateway无法识别Skills注册协议，强行部署会导致Agent启动时直接崩溃。
运行id -u，记录当前用户UID。后续Docker沙盒内所有进程必须以该UID运行，否则Skills读写宿主机文件时会因权限拒绝而静默失败——【这是唯一不可跳过的前提条件】。
检查/var/run/docker.sock是否可被当前用户读写。若提示Permission denied，立即执行sudo usermod -aG docker $USER并重新登录shell，否则Skills无法在沙盒中启动子容器。
编写第一个Skills插件：钉钉待办同步器
在项目根目录下新建skills/dingtalk_todo.py，内容如下：
```python
from openclaw.skills import SkillBase
from openclaw.gateway import Gateway
class DingTalkTodoSync(SkillBase):
def __init__(self, gateway: Gateway):
super().__init__(gateway)
self.api_token = self.config.get("DINGTALK_TOKEN", "")
if not self.api_token:
raise ValueError("DINGTALK_TOKEN未配置，请检查skills_config.yaml")
def execute(self, **kwargs):
# 此处插入实际HTTP请求逻辑
return {"status": "success", "count": 3}
```
使用聊天补全、重试、结构化输出和明确的 User-Agent 标头运行 AIMLAPI LLM 与推理工作流，适用于 Codex 对 AIMLAPI 模型进行脚本化提示/推理调用的场景。
注意：Skills类名必须以Sync、Fetch、Push等动词结尾，Gateway仅扫描符合该命名规则的类并自动注入。
注册Skills到Gateway并启用
第一步：在skills/skills_config.yaml中添加配置块：
```yaml
dingtalk_todo:
class: dingtalk_todo.DingTalkTodoSync
enabled: true
config:
DINGTALK_TOKEN: "your_actual_token_here"
```
第二步：将skills/目录路径加入Python模块搜索路径。编辑gateway/config.py，在SKILLS_PATHS列表末尾追加"./skills"。
第三步：重启Gateway服务。执行docker restart openclaw-gateway，观察日志中是否出现[INFO] Loaded skill: dingtalk_todo。若无此行，说明路径或类名格式错误，需回退检查。
