Agent Harness
Connect OpenClaw to SoCLaaS
Give an OpenClaw agent harness an OpenAI-compatible model endpoint backed by SoCLaaS, so multi-step tasks run against your gateway key and model.
No generated config for OpenClaw. The portal's Client Setup page provides ready-made configs for Codex, OpenCode, and Qwen Code. For OpenClaw, use the manual connection values below.
OpenClaw's configuration file name and field names vary by release. Use the connection values below in your version's OpenAI-compatible provider block, then verify against the OpenClaw documentation.
Connection values
| Setting | Value |
|---|---|
| Provider type | OpenAI-compatible |
| Base URL | https://soclaas-api.comp.nus.edu.sg/v1 |
| API key | From the SoCLaaS portal, stored in SOCLAAS_API_KEY |
| Model | A chat-capable ID from GET /v1/models |
Steps
-
Get an API key
Sign in to the SoCLaaS portal from the NUS network and create a personal key.
-
Export the key
export SOCLAAS_API_KEY="YOUR_API_KEY" -
Find a model ID
curl https://soclaas-api.comp.nus.edu.sg/v1/models \ -H "Authorization: Bearer $SOCLAAS_API_KEY"OpenClaw harnesses usually need a model that supports tool calling. Pick a chat-capable ID and note it for the next step.
-
Open the provider settings
Locate the OpenAI-compatible or custom provider section in your OpenClaw configuration. Fill in the base URL, API key reference, and model ID from the table above.
If OpenClaw reads keys from the environment, reference
SOCLAAS_API_KEY. If it stores keys inline, paste the key directly and keep the file out of version control. -
Test the connection
Run a single-step task first, then a task that requires a tool call. This confirms both chat completions and tool support.
Troubleshooting
- 401 or 403: the harness is not reading
SOCLAAS_API_KEY. Check how your version resolves secrets. - Tool calls fail: the selected model may not support tool calling. Try another chat model from
/v1/models. - Timeout: check your network connection and the gateway status.
- Unexpected request path: the base URL should already end in
/v1; do not append another/v1.