跳转至

Python 工具包

ZeroClaw 提供了 Python 工具包 (zeroclaw-tools),使用 LangGraph 实现一致的工具调用。

安装

pip install zeroclaw-tools

快速开始

from zeroclaw_tools import create_agent, shell, file_read
from langchain_core.messages import HumanMessage

# 创建代理
agent = create_agent(
    tools=[shell, file_read],
    model="glm-5",
    api_key="your-key",
    base_url="https://api.z.ai/api/coding/paas/v4"
)

# 发送消息
result = await agent.ainvoke({
    "messages": [HumanMessage(content="列出 /tmp 中的文件")]
})

print(result["messages"][-1].content)

内置工具

Shell 工具

from zeroclaw_tools import shell

# 执行命令
result = shell.invoke({"command": "ls -la"})
print(result)

文件工具

from zeroclaw_tools import file_read, file_write

# 读取文件
content = file_read.invoke({"path": "README.md"})

# 写入文件
file_write.invoke({
    "path": "output.txt",
    "content": "Hello, World!"
})

自定义工具

from zeroclaw_tools import create_tool

@create_tool
def my_custom_tool(input_data: str) -> str:
    """
    自定义工具说明

    Args:
        input_data: 输入数据

    Returns:
        处理结果
    """
    return f"处理结果:{input_data}"

# 使用自定义工具
agent = create_agent(
    tools=[shell, my_custom_tool],
    model="gpt-4",
    api_key="your-key"
)

Discord Bot 集成

from zeroclaw_tools import create_discord_bot

bot = create_discord_bot(
    token="your-discord-token",
    tools=[shell, file_read],
    model="gpt-4",
    api_key="your-openai-key"
)

# 启动 bot
bot.run()

支持的模型

  • ✅ OpenAI (GPT-4, GPT-3.5)
  • ✅ Anthropic (Claude)
  • ✅ Google (GLM, Gemini)
  • ✅ DeepSeek
  • ✅ 任何 OpenAI 兼容的 API

优势

  1. 一致性 - 跨所有提供商的一致工具调用
  2. 自动循环 - 工具会自动循环直到任务完成
  3. 易于扩展 - 使用 @tool 装饰器添加自定义工具
  4. Bot 集成 - 内置 Discord 支持

更多信息

完整文档:python/README.md