Python 工具包¶
ZeroClaw 提供了 Python 工具包 (zeroclaw-tools),使用 LangGraph 实现一致的工具调用。
安装¶
快速开始¶
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 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
优势¶
- 一致性 - 跨所有提供商的一致工具调用
- 自动循环 - 工具会自动循环直到任务完成
- 易于扩展 - 使用
@tool装饰器添加自定义工具 - Bot 集成 - 内置 Discord 支持
更多信息¶
完整文档:python/README.md