Python结合OpenClaw编写第一个控制程序的实战指南

# 一个简单的技能配置
skills：
  - name： file_operator
    path： ./skills/file_operator
    enabled： true
    permissions：
      - read
      - write

name： MyBot
description： 一个测试用的文件操作智能体
version： 1.0.0
# 基础设置
settings：
  language： zh-CN
  timezone： Asia/Shanghai
  log_level： info
# 模型配置（支持多种LLM）
model：
  provider： openai  # 可选 openai, deepseek, ollama, claude
  model_name： gpt-3.5-turbo
  api_key： ${OPENAI_API_KEY}  # 支持环境变量引用
  parameters：
    temperature： 0.7
    max_tokens： 2000
# 连接的节点
nodes：
  - local_node  # 引用 nodes.yaml 中定义的节点
# 启用的技能
skills：
  - file_operator  # 引用 skills.yaml 中定义的技能
# 主题订阅
topics：
  subscribe：
    - topic： “command/file”
      handler： file_operator.handle_command  # 指定处理函数
# 服务（后台任务）
services：
  - name： heartbeat
    schedule： “*/5 * * * *”  # 每5分钟一次
    action： system.heartbeat

nodes：
  - id： local_node
    name： 本地节点
    type： local
    work_dir： /home/user/openclaw_workspace
    max_concurrent_tasks： 5

skills：
  - id： file_operator
    name： 文件操作器
    entry： file_operator：main  # Python模块：函数
    description： 提供文件的读写、删除、列表功能
    parameters：
      - name： operation
        type： string
        description： 操作类型，可选 read/write/delete/list
        required： true
      - name： path
        type： string
        description： 文件路径
        required： true
      - name： content
        type： string
        description： 写入的内容（当operation=write时需要）
        required： false
    permissions：
      - filesystem：read
      - filesystem：write

- id： docker_node
  type： docker
  image： python：3.10-slim
  command： [“python”， “-m”， “openclaw.node”]
  volumes：
    - /host/data：/data
  environment：
    - ENV=production

services：
  - name： temp_cleaner
    type： cron
    schedule： “0 2 * * *”  # 每天凌晨2点
    action： file_operator.clean_temp
    parameters：
      path： /tmp
      older_than： 7d

mkdir my_openclaw_project
cd my_openclaw_project

name： Commander
description： 指令分发智能体
version： 1.0.0
model：
  provider： openai
  model_name： gpt-3.5-turbo
  api_key： ${OPENAI_API_KEY}
nodes：
  - local_node
skills：
  - command_parser  # 自定义技能
topics：
  publish：
    - topic： “command/#”   # 允许发布到所有command/子主题
  subscribe：
    - topic： “event/result”  # 监听执行结果
      handler： commander.handle_result
services：
  - name： web_interface
    type： http
    port： 8080
    endpoint： /command
    method： POST
    action： commander.web_handler

name： Worker
description： 任务执行智能体
version： 1.0.0
model：
  provider： ollama  # 使用本地模型，节省成本
  model_name： llama3
nodes：
  - local_node
skills：
  - file_operator
  - weather_query
topics：
  subscribe：
    - topic： “command/create_file”
      handler： file_operator.create
    - topic： “command/weather”
      handler： weather_query.get
  publish：
    - topic： “event/result”

nodes：
  - id： local_node
    type： local
    work_dir： ./workspace

# skills/command_parser.py
import re
from openclaw.skill import Skill
class CommandParser(Skill)：
    async def handle(self, message)：
        """
        解析用户自然语言指令，决定发布到哪个主题
        """
        text = message.payload.get('text', '')
        # 简单的规则匹配
        if re.search(r'创建文件|新建文件', text)：
            # 提取文件名和内容（示例中简化处理）
            filename = re.findall(r'文件\s*(\S+)', text)
            content = re.findall(r'内容\s*[是为：]?\s*(.+)', text)
            payload = {
                'path'： filename[0] if filename else 'default.txt',
                'content'： content[0] if content else ''
            }
            await self.publish('command/create_file', payload)
            return {'status'： 'ok', 'message'： '任务已分发'}
        elif re.search(r'天气|气温', text)：
            city = re.findall(r'([\u4e00-\u9fa5]+)天气', text)
            payload = {'city'： city[0] if city else '北京'}
            await self.publish('command/weather', payload)
            return {'status'： 'ok', 'message'： f'正在查询{payload["city"]}天气'}
        else：
            return {'status'： 'error', 'message'： '无法理解指令'}
    async def publish(self, topic, payload)：
        # 实际发送消息到主题
        await self.context.gateway.publish(topic, payload)

skills：
  - id： command_parser
    name： 指令解析器
    entry： command_parser：CommandParser
    description： 解析用户指令并分发给对应主题
  - id： file_operator
    # ... 同上
  - id： weather_query
    name： 天气查询
    entry： weather_query：WeatherQuery
    description： 查询指定城市天气

openclaw gateway start

# 终端1：启动Commander
openclaw agent start --config agent_commander.yaml
# 终端2：启动Worker
openclaw agent start --config agent_worker.yaml

curl -X POST http：//localhost：8080/command \
  -H “Content-Type： application/json” \
  -d ‘{“text”： “帮我创建文件 test.txt，内容为 Hello World”}'