或指定版本

openclaw openclaw官方 2026-04-09 2

OpenClaw 的单机使用方式如下：

或指定版本-第1张图片-OpenClaw开源下载|官方OpenClaw下载

安装 OpenClaw

通过 pip 安装

pip install openclawpip install openclaw==1.0.0

从源码安装

git clone https://github.com/OpenClaw/OpenClaw.git
cd OpenClaw
pip install -e .

基本使用示例

Python API 调用

from openclaw import OpenClaw
# 初始化
claw = OpenClaw()
# 文本处理示例
text = "这是一段待处理的文本"
result = claw.process(text)
print(result)
# 批量处理
texts = ["文本1", "文本2", "文本3"]
results = claw.batch_process(texts)

命令行使用

# 基本用法
openclaw --input "输入文本"
# 处理文件
openclaw --input-file input.txt --output-file output.txt
# 批量处理目录
openclaw --input-dir ./input --output-dir ./output
# 使用特定模型
openclaw --model my_model --input "文本"

配置文件

创建 config.yaml：

model:
  name: "default"
  path: "./models/"
processing:
  batch_size: 32
  max_length: 512
output:
  format: "json"
  save_intermediate: true

加载配置：

from openclaw import OpenClaw
import yaml
with open('config.yaml', 'r') as f:
    config = yaml.safe_load(f)
claw = OpenClaw(config=config)

高级功能

自定义处理流水线

from openclaw import OpenClaw, Pipeline
# 创建自定义流水线
pipeline = Pipeline([
    ('tokenizer', CustomTokenizer()),
    ('processor', CustomProcessor()),
    ('output_formatter', JSONFormatter())
])
claw = OpenClaw(pipeline=pipeline)

GPU 加速（如果支持）

claw = OpenClaw(device='cuda')  # 使用GPU
claw = OpenClaw(device='cpu')    # 使用CPU

实用脚本示例

批量处理脚本

#!/usr/bin/env python3
import os
from openclaw import OpenClaw
def process_directory(input_dir, output_dir):
    claw = OpenClaw()
    for filename in os.listdir(input_dir):
        if filename.endswith('.txt'):
            input_path = os.path.join(input_dir, filename)
            output_path = os.path.join(output_dir, filename)
            with open(input_path, 'r', encoding='utf-8') as f:
                text = f.read()
            result = claw.process(text)
            with open(output_path, 'w', encoding='utf-8') as f:
                f.write(result)
            print(f"Processed: {filename}")
if __name__ == "__main__":
    process_directory('./input', './output')

常见参数配置

claw = OpenClaw(
    model_path="./models/",      # 模型路径
    batch_size=16,               # 批处理大小
    max_length=1024,             # 最大文本长度
    num_workers=4,               # 多线程处理
    cache_dir="./cache",         # 缓存目录
    verbose=True                 # 显示详细信息
)

性能优化建议

批处理：尽量使用 batch_process 而不是单条处理
缓存：启用缓存以减少重复计算
资源限制：根据硬件调整 batch_size 和 num_workers
异步处理：对于大量数据，考虑异步处理

错误处理

from openclaw import OpenClaw, OpenClawError
try:
    claw = OpenClaw()
    result = claw.process("text")
except OpenClawError as e:
    print(f"OpenClaw错误: {e}")
except Exception as e:
    print(f"其他错误: {e}")