OpenAI 호환

OpenClaw를 IteraCompute에 연결

텍스트 및 읽기 전용 도구 워크플로를 구성하세요.

3단계로 연결

1. API 키 생성

IteraCompute 계정을 생성하거나 로그인한 다음 콘솔에서 키를 생성하세요.

2. 기본 URL 구성

openai-completions와 환경 변수 SecretRef를 사용하는 iteracompute 제공자를 추가하세요. OpenClaw 내부에서는 전체 provider/model 참조를 사용하세요.

3. 모델을 선택하세요

선택한 모델에 대한 정확한 API 모델 ID를 사용하세요.에이전트 또는 비전 기능을 활성화하기 전에 해당 컨텍스트와 기능을 확인하세요.

모델을 선택하세요

유료 DeepSeek V4.1 Flash 1017이 참조 모델입니다. 키로 이용 가능한 공개 대화 모델로 바꿀 수 있습니다. 변경 후 권한, 가격, 컨텍스트, 도구 지원을 다시 확인하세요. 예제는 선택에 따라 바뀌지만 보존된 테스트 결과는 Qwen에만 해당합니다.

격리 환경 준비

별도 디렉터리에 OpenClaw 2026.11.1을 설치하세요. 보존된 에이전트 테스트는 Bun 1.4.4를 사용했습니다. 설정과 상태를 분리하세요.

Bash / macOS / Linux / WSL
# Node: >=24.16.0 <25 or >=26.1.0; npm <=11.15
node --version
npm --version
umask 077
mkdir -p itera-openclaw-demo
cd itera-openclaw-demo
export ITERA_RUNTIME="$PWD/runtime"
npm install --prefix "$ITERA_RUNTIME" openclaw@2026.11.1 bun@1.4.4 \
  --no-audit --no-fund
export BUN="$ITERA_RUNTIME/node_modules/.bin/bun"
export OPENCLAW_ENTRY="$ITERA_RUNTIME/node_modules/openclaw/openclaw.mjs"
"$BUN" --version
"$BUN" "$OPENCLAW_ENTRY" --version
mkdir -p workspace state home
export OPENCLAW_HOME="$PWD/home"
export OPENCLAW_STATE_DIR="$PWD/state"
export OPENCLAW_CONFIG_PATH="$PWD/openclaw.iteracompute.json"
export OPENCLAW_OFFLINE=1
Bash · 현재 터미널의 키
umask 077
read -rsp 'IteraCompute API key: ' ITERACOMPUTE_API_KEY
printf '\n'
export ITERACOMPUTE_API_KEY

설치 예제는 npm 11.15 이하용입니다. npm 11.16+/12는 공식 안내에 따라 --allow-scripts=openclaw 옵션이 필요합니다. 명시적 Bun 진입점은 보존된 성공 런타임과 일치합니다. OPENCLAW_OFFLINE은 보조 다운로드만 차단하며 모델 API는 차단하지 않습니다. daemon이나 메시징 계정은 필요하지 않습니다.

예시 구성

서버 환경이나 도구 자격 증명 저장소에 API 키를 보관하세요.해당하는 경우 예제 키 필드를 사용자 고유의 키로 바꿉니다.

openclaw.iteracompute.json
{
  "models": {
    "mode": "replace",
    "providers": {
      "iteracompute": {
        "baseUrl": "https://api.iteracompute.com/v1",
        "api": "openai-completions",
        "apiKey": {
          "source": "env",
          "provider": "default",
          "id": "ITERACOMPUTE_API_KEY"
        },
        "timeoutSeconds": 180,
        "models": [
          {
            "id": "deepseek/deepseek-v4.1-flash-1017",
            "name": "DeepSeek V4.1 Flash 1017",
            "reasoning": true,
            "input": [
              "text"
            ],
            "contextWindow": 1048576,
            "contextTokens": 110000,
            "maxTokens": 512,
            "compat": {
              "maxTokensField": "max_tokens",
              "supportsReasoningEffort": false,
              "supportsUsageInStreaming": true
            }
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "iteracompute/deepseek/deepseek-v4.1-flash-1017",
        "fallbacks": []
      },
      "modelPolicy": {
        "allow": [
          "iteracompute/deepseek/deepseek-v4.1-flash-1017"
        ]
      },
      "models": {
        "iteracompute/deepseek/deepseek-v4.1-flash-1017": {
          "alias": "itera-model",
          "params": {
            "maxTokens": 512,
            "extraBody": {}
          }
        }
      },
      "thinkingDefault": "off",
      "skipBootstrap": true,
      "contextInjection": "never"
    }
  },
  "tools": {
    "deny": [
      "*"
    ],
    "toolSearch": false
  },
  "plugins": {
    "enabled": false
  }
}

위에서 만든 격리 프로필에만 저장하세요. Chat Completions 예제는 출력 512 tokens와 폴백 없이 시작합니다. 컨텍스트 메타데이터는 계정 사용 권한이 아닙니다. OpenClaw는 더 작은 입력 예산을, Qwen은 계정 컨텍스트 128K를 사용합니다. 추론 제어는 모델별로 다르며 Python과 OpenClaw의 reasoning: false는 Qwen에만 추가됩니다.

먼저 직접 API 검증

Python · 직접 텍스트 검증
python3 - <<'PY'
import json
import os
import urllib.error
import urllib.request
payload = {
    'model': 'deepseek/deepseek-v4.1-flash-1017',
    'messages': [{'role': 'user', 'content': 'Reply with exactly: ITERACOMPUTE_API_OK'}],
    'max_tokens': 512,
    **{},
}
request = urllib.request.Request(
    'https://api.iteracompute.com/v1/chat/completions',
    data=json.dumps(payload).encode('utf-8'),
    headers={'Authorization': 'Bearer ' + os.environ['ITERACOMPUTE_API_KEY'],
             'Content-Type': 'application/json'}, method='POST',
)
try:
    with urllib.request.urlopen(request, timeout=180) as response:
        result = json.load(response)
except urllib.error.HTTPError as exc:
    raise SystemExit(f'HTTP {exc.code}; inspect redacted details privately') from None
except (urllib.error.URLError, TimeoutError):
    raise SystemExit('Network or timeout failure; no automatic retry') from None
choice = result['choices'][0]
if ((choice.get('message', {}).get('content') or '').strip() != 'ITERACOMPUTE_API_OK'
        or choice.get('finish_reason') != 'stop'):
    raise SystemExit('FAIL: expected final marker and stop reason not returned')
print('Direct API text passed; test the agent separately')
PY

실행하면 실제 요청 한 건을 보냅니다. 정확한 표시 마커와 finish_reason=stop을 확인하세요. 본문이 빈 HTTP 200은 미완료입니다. 유료 모델은 API 잔액을 사용합니다. 결과가 불확실하면 자동 재시도하지 마세요.

에이전트 텍스트 경로 검증

Bash · 텍스트 검증
"$BUN" "$OPENCLAW_ENTRY" config validate --json
"$BUN" "$OPENCLAW_ENTRY" models list --provider iteracompute --json
"$BUN" "$OPENCLAW_ENTRY" agent exec \
  'Reply with exactly OPENCLAW_ITERACOMPUTE_TEXT_OK. Do not use tools.' \
  --config "$OPENCLAW_CONFIG_PATH" --cwd "$PWD/workspace" \
  --model iteracompute/deepseek/deepseek-v4.1-flash-1017 --code-mode direct \
  --thinking off --timeout 360 --json > text-result.private.json

python3 - <<'PY'
import json
from pathlib import Path
r = json.loads(Path('text-result.private.json').read_text(encoding='utf-8'))
if not (r.get('ok') is True and r.get('provider') == 'iteracompute'
        and r.get('model') == 'deepseek/deepseek-v4.1-flash-1017'
        and (r.get('final') or '').strip() == 'OPENCLAW_ITERACOMPUTE_TEXT_OK'):
    raise SystemExit('FAIL: inspect redacted details privately')
print('OpenClaw text invocation passed')
PY

먼저 아래 직접 API 검증을 실행한 뒤 비어 있지 않은 최종 마커, 지정 provider/model, 에이전트의 정상 종료를 확인하세요. 설정 검증이나 제공자 프로브만으로 에이전트 또는 도구 워크플로를 입증할 수 없습니다.

도구 왕복 한 번 검증

텍스트 검증 후 설정을 복사하고 tools 정책 전체를 작업 공간의 read 전용 권한으로 교체합니다. deny가 allow보다 우선하므로 deny: ["*"]를 제거합니다. 무작위 마커는 파일에만 쓰고 프롬프트에는 넣지 않습니다.

Bash · read 도구 및 검증
python3 - <<'PY'
import json
import secrets
from pathlib import Path
config = json.loads(Path('openclaw.iteracompute.json').read_text(encoding='utf-8'))
config['tools'] = {
    'allow': ['read'], 'fs': {'workspaceOnly': True}, 'toolSearch': False,
}
Path('openclaw.iteracompute.tools.json').write_text(json.dumps(config), encoding='utf-8')
Path('workspace/integration-marker.txt').write_text(
    'OPENCLAW_ITERACOMPUTE_TOOL_' + secrets.token_hex(8) + '\n', encoding='utf-8')
PY

"$BUN" "$OPENCLAW_ENTRY" agent exec \
  'Use read to read integration-marker.txt, then reply with exactly the marker in that file. Do not guess or use other tools.' \
  --config "$PWD/openclaw.iteracompute.tools.json" --cwd "$PWD/workspace" \
  --model iteracompute/deepseek/deepseek-v4.1-flash-1017 --code-mode direct \
  --thinking off --timeout 600 --json > tool-result.private.json

python3 - <<'PY'
import json
from pathlib import Path
r = json.loads(Path('tool-result.private.json').read_text(encoding='utf-8'))
expected = Path('workspace/integration-marker.txt').read_text(encoding='utf-8').strip()
tools = r.get('toolSummary') or {}
checks = [r.get('ok') is True, r.get('provider') == 'iteracompute',
          r.get('model') == 'deepseek/deepseek-v4.1-flash-1017', tools.get('calls') == 1,
          tools.get('tools') == ['read'], tools.get('failures') == 0,
          r.get('assistantTurns') == 2, (r.get('final') or '').strip() == expected]
if not all(checks):
    raise SystemExit('FAIL: inspect redacted details privately')
print('OpenClaw read tool loop passed')
PY

성공 기준: 올바른 provider/model, 정확히 한 번의 성공한 read 호출, assistant 2회 응답, 파일 마커와 일치하는 최종 답변입니다. 모델이 읽었다고 말하는 것만으로는 부족합니다.

버전 및 검증

테스트 버전
OpenClaw 2026.11.1 · Bun 1.4.4
테스트 결과
텍스트 및 읽기 전용 도구 통과.

인증 정보, 도구 및 데이터

모델 API는 원격으로 실행되므로 로컬 GPU나 공개 Gateway 포트가 필요하지 않습니다. 에이전트에는 로컬 CPU, 메모리, 권한이 필요합니다. 키는 시작 프로세스 환경에 보관하고 원본 로그는 비공개로 유지하며 필요한 도구만 켜세요. 외부 서비스는 별도 설정과 비용이 적용됩니다.

연결 테스트

cURL · 채팅 완료
# Bash / zsh / WSL; set ITERACOMPUTE_API_KEY in your environment first.
curl --fail-with-body https://api.iteracompute.com/v1/chat/completions \
  -H "Authorization: Bearer $ITERACOMPUTE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"deepseek/deepseek-v4.1-flash-1017","messages":[{"role":"user","content":"Reply with exactly: Hello!"}],"max_tokens":512}'

choices[0].message.content에 보이는 텍스트가 포함되어 있는지 확인하세요.HTTP 200만으로는 부족합니다.추론은 출력 예산을 소비할 수 있습니다.무료 Qwen을 사용하려면 다음을 사용하세요. 첫 무료 API 호출 예제 사고를 비활성화하려면 도구 내부에 메시지를 보내세요.

선택된 모델 기능

기능은 IteraCompute API의 지원 범위를 나타냅니다. 워크플로에서의 사용 가능 여부는 도구와 설정에도 달려 있으며, 추론 제어는 모델마다 다릅니다.

  • 채팅 완료지원됨
  • 도구 호출지원됨
  • 추론지원됨
  • 이미지 입력지원됨
  • 스트리밍지원됨

문제 해결

401 / 403 / 404

시작 프로세스의 키, 모델 권한, 유료 잔액을 확인하세요. Base URL에는 /v1을 한 번만 넣으세요. API에는 원래 Model ID를 보내고 iteracompute/ 접두사는 OpenClaw 내부 라우팅에만 사용하세요.

400 / 빈 응답 / 429

모델별 추론 매개변수, 출력 예산, 계정 한도를 확인하고 Retry-After를 따르세요. 추론 형식을 겹쳐 쓰거나 HTTP 200만으로 성공을 판단하거나 다른 유료 모델로 자동 전환하지 마세요.

도구 누락 / 잘못된 프로필

Hermes: todo 테스트에서 tool_search를 끄고 Python과 CLI 프로필을 분리하세요. OpenClaw: 도구 테스트에서 deny-all을 read 전용으로 바꾸세요. 이 사용자 지정 설정에 --isolated나 --auth-env-only를 사용하지 마세요.

OpenClaw 설정 참고 문서 →

OpenClaw로 개발을 시작하세요.

키를 연결하고 모델을 선택한 후 첫 번째 요청을 보내세요.