openclaw - 💡(How to fix) Fix Custom Provider volcengine-plan Fails with TypeError: Unexpected Keyword Argument 'provider_id' [1 comments, 1 participants]

🐛 Bug Description

When using the custom provider volcengine-plan (Volcano Engine Coding Plan / Doubao models) to make LLM calls, the system throws a TypeError that completely blocks usage:

TypeError: AsyncCompletions.create() got an unexpected keyword argument 'provider_id'

🔍 Root Cause

The custom provider configuration template incorrectly includes provider_id in the generate_kwargs section, which is then passed directly to the OpenAI SDK's chat.completions.create() method. However, provider_id is not a valid OpenAI SDK parameter.

Problematic Configuration (/root/.copaw.secret/providers/custom/volcengine-plan.json):

{
  "id": "volcengine-plan",
  "base_url": "https://ark.cn-beijing.volces.com/api/coding/v3",
  "api_key": "...",
  "chat_model": "OpenAIChatModel",
  "generate_kwargs": {
    "provider_id": "volcengine-plan",  // ❌ BUG: Invalid parameter
    "model": "glm-4.7",
    "scope": "chat"
  }
}

📝 Steps to Reproduce

1. Create custom provider config at /root/.copaw.secret/providers/custom/volcengine-plan.json
2. Include provider_id in generate_kwargs (as shown above)
3. Set provider as active in agent.json
4. Attempt to make any LLM call
5. Result: TypeError exception

✅ Expected Behavior

• Custom providers should work without manual configuration edits
• provider_id should be handled internally by CoPaw (top-level "id" field)
• Only valid OpenAI SDK parameters should be in generate_kwargs

🔧 Proposed Fix

Remove provider_id from generate_kwargs:

// Before (❌ Buggy)
"generate_kwargs": {
  "provider_id": "volcengine-plan",
  "model": "glm-4.7",
  "scope": "chat"
}

// After (✅ Fixed)
"generate_kwargs": {
  "model": "glm-4.7",
  "scope": "chat"
}

🧪 Verification

API Test (works independently):

curl -X POST "https://ark.cn-beijing.volces.com/api/coding/v3/chat/completions" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"model":"Doubao-Seed-2.0-Code","messages":[{"role":"user","content":"test"}]}'
# ✅ Returns successful response

CoPaw Integration (fails):

# Any LLM call through volcengine-plan provider
# ❌ TypeError: AsyncCompletions.create() got an unexpected keyword argument 'provider_id'

📊 Impact

💡 Recommendations

1. Fix configuration template for volcengine-plan provider
2. Add validation to prevent invalid parameters in generate_kwargs
3. Audit other custom providers for the same issue
4. Document correct configuration format
5. Add schema validation for provider configurations

📎 System Information

• OS: Linux 6.8.0-106-generic (Ubuntu)
• Python: 3.12.3
• CoPaw Version: 1.0.0.post3
• Provider: volcengine-plan (Volcano Engine / Doubao)
• Models: Doubao-Seed-2.0-Code, glm-4.7, kimi-k2.5
• Date: 2026-04-03

🏷️ Labels

• bug
• configuration
• provider-integration
• volcengine
• high-severity

Please fix this configuration bug to enable volcengine-plan provider usage. 🙏